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