IFileSaveDialog：：SetCollectedProperties 方法 (shobjidl_core.h)

  • 项目

指定将在保存对话框中收集哪些属性。

语法

HRESULT SetCollectedProperties(
  [in] IPropertyDescriptionList *pList,
  [in] BOOL                     fAppendDefault
);

参数

[in] pList

类型： IPropertyDescriptionList*

指向接口的指针，该接口表示要收集的属性列表。 此参数可以为 NULL。

[in] fAppendDefault

类型： BOOL

如果为 TRUE ，则除了显示 pList 指定的属性外，还显示当前所选文件类型的默认属性。 如果为 FALSE ，则仅显示 pList 指定的属性。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

调用应用程序可以使用 PSGetPropertyDescriptionListFromString 函数从字符串（如“prop：Comments;”）构造 IPropertyDescriptionList Subject;”。

有关属性架构的详细信息，请参阅 属性架构。

可以在显示对话框之前或显示对话框时随时调用 IFileSaveDialog：：SetCollectedProperties。 如果要根据所选文件类型收集不同的属性，则可以调用 IFileSaveDialog：：SetCollectedProperties 以响应 OnTypeChange。

注意 默认情况下，不会在保存对话框中收集任何属性。
 

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h

另请参阅

IFileSaveDialog

IFileSaveDialog：：SetProperties