IShellFolderView::GetArrangeParam 方法 (shlobj_core.h)

获取视图的排列参数,这是视图的排序方式。

注意 从 Windows Vista 开始,此方法已弃用。 它在后续版本的 Windows 中可能已更改或不可用。 建议改用 IFolderView2::GetSortColumns
 

语法

HRESULT GetArrangeParam(
  [out] LPARAM *plParamSort
);

参数

[out] plParamSort

类型: LPARAM*

plParamSort 的下 16 位定义排序规则。 大多数应用程序将排序规则设置为默认值零,指示应按名称对项进行排序。 系统不定义任何其他排序规则。 某些文件夹对象可能允许调用应用程序使用 plParamSort 的低 16 位来指定特定于文件夹的排序规则。 规则及其关联的 plParamSort 值由 文件夹定义。

当系统文件夹视图对象调用 IShellFolderView::GetArrangeParam 时plParamSort 的下 16 位用于指定要用于排列的列。

plParamSort 的上 16 位用于修改排序规则的标志。 系统当前定义以下修饰符标志。

SHCIDS_ALLFIELDS

版本 5.0。 排列 ITEMIDLIST 结构中包含的所有信息,而不仅仅是显示名称。 此标志仅对支持 IShellFolder2 接口的文件夹对象有效。 例如,如果这两个项是文件,则文件夹会排列其名称、大小、文件时间、属性以及结构中的任何其他信息。 如果设置了此标志,则 plParamSort 的下 16 位必须为零。

SHCIDS_CANONICALONLY

版本 5.0。 按名称排列时,请排列系统名称,而不是显示名称。 传递此标志时,只要 Shell 文件夹实现一致的排序函数,两个项将按 Shell 文件夹确定的最有效条件排列。 此标志不能与其他标志组合使用。

返回值

类型: HRESULT

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

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h