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

こちらもご覧ください

IFileSaveDialog

IFileSaveDialog::GetProperties

IFileSaveDialog::SetCollectedProperties