IFileSaveDialog_SetProperties

保存されるアイテムに使用される既定値を定義するプロパティストアを提供する。

IFileSaveDialog_SetProperties this, pStore

this : [comobj] IFileSaveDialog インターフェースの COM オブジェクト変数
pStore : [comobj] 型: IPropertyStore* 関連するメタデータを含むプロパティストアを表すインターフェースへのポインター。

(プラグイン / モジュール : com_misc.dll)

解説

保存されるアイテムに使用される既定値を定義するプロパティストアを提供する。

[戻り値]
型: HRESULT このメソッドが成功した場合 S_OK を返す。そうでなければ HRESULT エラーコードを返す。

[備考]

このメソッドはダイアログを開く前、および表示中ならいつでも呼び出せる。アイテムに固有のプロパティがある場合、ダイアログを表示する前にそれらのプロパティを渡してこのメソッドを呼び出すべきである。名前を付けて保存を使用する際、アプリケーションは保存するアイテムのプロパティをセーブダイアログに提供すべきである。これらのプロパティは、元のアイテムから
GPS_HANDLERPROPERTIESONLY フラグを指定して GetPropertyStore
を呼び出すことで取得する。ダイアログが閉じられた後に保存済みアイテムのプロパティ（ユーザーによって変更されている可能性がある）を取得するには、IFileSaveDialog::GetProperties
を呼び出す。プロパティ収集を有効にし、セーブダイアログに表示するプロパティを指示するには
IFileSaveDialog::SetCollectedProperties を使用する。

情報