IFileSaveDialog::SetProperties メソッド (shobjidl_core.h)
保存される項目に対して使用される既定値を定義するプロパティ ストアを提供します。
構文
HRESULT SetProperties(
[in] IPropertyStore *pStore
);
パラメーター
[in] pStore
種類: IPropertyStore*
関連付けられたメタデータを含むプロパティ ストアを表すインターフェイスへのポインター。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
このメソッドは、ダイアログを開く前、またはダイアログが表示されている間にいつでも呼び出すことができます。 アイテムに固有のプロパティがある場合は、ダイアログを表示する前に、これらのプロパティを使用してこのメソッドを呼び出す必要があります。
[名前を付けて保存] を使用する場合、アプリケーションは保存するアイテムのプロパティを [保存] ダイアログに提供する必要があります。 これらのプロパティは、GPS_HANDLERPROPERTIESONLY フラグを指定して GetPropertyStore を呼び出すことによって、元のアイテムから取得する必要があります。
ダイアログが閉じられた後に保存されたアイテム (ユーザーが変更した可能性がある) のプロパティを取得するには、 IFileSaveDialog::GetProperties を呼び出します。
プロパティ コレクションを有効にし、[ 保存] ダイアログに表示するプロパティを指定するには、 IFileSaveDialog::SetCollectedProperties を使用します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shobjidl_core.h |