IPropertySystem::GetPropertyDescriptionListFromString 方法 (propsys.h)

获取实现 IPropertyDescriptionList 的子系统对象的实例,以基于提供的字符串获取属性说明的有序集合。

语法

HRESULT GetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

参数

[in] pszPropList

类型: LPCWSTR

指向标识属性列表的字符串的指针。

[in] riid

类型: REFIID

对所需 IID 的引用。

[out] ppv

类型: void**

IPropertyDescriptionList 接口指针的地址。

返回值

类型: HRESULT

返回以下值之一。

返回代码 说明
S_OK
指示已获取接口。
E_INVALIDARG
指示 ppvNULL

注解

属性说明列表字符串 (“proplist”) 语法包含一系列规范属性名称,以及与每个属性名称关联的标志。 字符串以“prop:”开头。 语法如下所示: prop:[flags]propertyname[endflags];

标志是可选的,可以是以下任一标志。 注意:这些标志转换为 PROPDESC_VIEW_FLAGS 枚举。

标志 含义
- (PDVF_REVERSESORT) 按相反顺序排序。
0 默认在主列表和辅助列表中显示 (PDVF_SHOWBYDEFAULT |PDVF_SHOWINPRIMARYLIST |PDVF_SHOWINSECONDARYLIST) 。
1 在主列表和辅助列表中显示 (PDVF_SHOWINPRIMARYLIST |PDVF_SHOWINSECONDARYLIST) 。
2 在辅助列表 (PDVF_SHOWINSECONDARYLIST) 中显示。
^ 开始 (PDVF_BEGINNEWGROUP) 新组。
/ 右对齐 (PDVF_RIGHTALIGN) 。
* 如果值不存在,则隐藏。
| 居中对齐。 (PDVF_CENTERALIGN) 。
~ 隐藏标签。 (PDVF_HIDELABEL) 。
# 填充区域。 (PDVF_FILLAREA) 。
? 如果属性处理程序 (PDVF_HIDEIFUNSUPPORTED) 不支持,则隐藏。
< 分析为链接 (PDVF_PARSEASLINK) 。
& 显示为整个链接 (PDVF_SHOWASWHOLELINK) 。
 

从 dbfolder 和 file folder 的角度来看:

0 在 defview、列选择器菜单和列选择器对话框中显示为列。
1 在列选择器菜单和对话框中显示。
2 在列选择器对话框中显示。
NULL 包含在搜索结果中,但在 UI 中隐藏。
 

尾标志也是可选的,可以是以下内容:

EndFlag 含义
] 用于扩展磁贴视图) 的结束列 (。
 

建议使用 objbase.h 中定义的 IID_PPV_ARGS 宏打包 riidppv 参数。 此宏基于 ppv 中的 值指向的接口提供正确的 IID,消除了编码错误的可能性。

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

要求

   
最低受支持的客户端 Windows XP SP2、Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 propsys.h
DLL Propsys.dll (5.0 或更高版本)
可再发行组件 Windows 桌面搜索 (WDS) 3.0

另请参阅

IPropertySystem