Microsoft DirectX 8.0 (Visual Basic)

DirectXFile.CreateSaveObject

保存オブジェクトを作成する。

object.CreateSaveObject( _
    FileName As String, _
    Flags As Long) As DirectXFileSave

指定項目

object
DirectXFile オブジェクトを表すオブジェクト式。
FileName
データの保存に使用するファイルを示す String 値。
Flags
DirectX ファイルの保存時に使用するフォーマットを示す CONST_DXFILEFORMATFLAGS 列挙のメンバ。

戻り値

作成された保存オブジェクトを表す DirectXFileSave オブジェクトを返す。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

DXFILEERR_BADALLOC
DXFILEERR_BADFILE
DXFILEERR_BADVALUE

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

このメソッドを使用した後は、DirectXFileSave クラスのメソッドを使用してデータ オブジェクトを作成し、テンプレートまたはデータを保存する。

ファイル フォーマットのデフォルト値は DXFILEFORMAT_BINARY である。ファイル フォーマットの値を論理和で結合し、圧縮テキスト ファイルまたは圧縮バイナリ ファイルを作成できる。バイナリ (0) とテキスト (1) の両方を指定した場合は、テキスト ファイル フォーマットの値と区別がつかないため (0 + 1 = 1)、テキスト ファイルとして保存される。ファイル フォーマットとしてテキストかつ圧縮を指定すると、ファイルは最初にテキストとして書き込まれた後、圧縮される。ただし、圧縮テキスト ファイルはバイナリ テキスト ファイルほど効率がよくないので、ほとんどの場合は、バイナリかつ圧縮を指定する必要がある。フォーマットを指定しないでファイルを圧縮するように設定すると、バイナリ圧縮ファイルが作成される。

参照

DirectXFileSave