IFileSaveDialog::SetCollectedProperties 方法 (shobjidl_core.h)
指定将在保存对话框中收集哪些属性。
语法
HRESULT SetCollectedProperties(
[in] IPropertyDescriptionList *pList,
[in] BOOL fAppendDefault
);
参数
[in] pList
指向接口的指针,该接口表示要收集的属性列表。 此参数可以为 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 |