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
返回以下值之一。
返回代码 | 说明 |
---|---|
|
指示已获取接口。 |
|
指示 ppv 为 NULL。 |
注解
属性说明列表字符串 (“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 宏打包 riid 和 ppv 参数。 此宏基于 ppv 中的 值指向的接口提供正确的 IID,消除了编码错误的可能性。
有关属性架构的详细信息,请参阅 属性架构。
要求
最低受支持的客户端 | Windows XP SP2、Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] |
目标平台 | Windows |
标头 | propsys.h |
DLL | Propsys.dll (5.0 或更高版本) |
可再发行组件 | Windows 桌面搜索 (WDS) 3.0 |