Метод IShellFolderView::GetArrangeParam (shlobj_core.h)

Статья
03/02/2024

Возвращает параметр расположения представления, который представляет собой способ сортировки представления.

Примечание Этот метод не рекомендуется использовать в Windows Vista. Она может быть изменена или недоступна в последующих версиях Windows. Рекомендуется использовать IFolderView2::GetSortColumns .

Синтаксис

HRESULT GetArrangeParam(
  [out] LPARAM *plParamSort
);

Параметры

[out] plParamSort

Тип: LPARAM*

Более низкие шестнадцать битов plParamSort определяют правило сортировки. Большинство приложений устанавливают для правила сортировки нулевое значение по умолчанию, указывая, что элементы должны быть отсортированы по имени. Система не определяет другие правила сортировки. Некоторые объекты папок могут позволить вызывающим приложениям использовать менее шестнадцать битов plParamSort для указания правил сортировки для конкретных папок. Правила и связанные с ними значения plParamSort определяются папкой .

Когда объект представления системных папок вызывает IShellFolderView::GetArrangeParam, для указания столбца, используемого для упорядочения, используются более низкие шестнадцать битов plParamSort .

Верхние шестнадцать битов plParamSort используются для флагов, которые изменяют правило сортировки. В настоящее время система определяет следующие флаги модификаторов.

SHCIDS_ALLFIELDS

Версия 5.0. Упорядочить все сведения, содержащиеся в структуре ITEMIDLIST , а не только отображаемые имена. Этот флаг действителен только для объектов папок, поддерживающих интерфейс IShellFolder2 . Например, если два элемента являются файлами, папка упорядочивает их имена, размеры, время файла, атрибуты и любую другую информацию в структурах. Если этот флаг установлен, нижние шестнадцать битов plParamSort должны быть равны нулю.

SHCIDS_CANONICALONLY

Версия 5.0. При упорядочении по имени упорядочение системных имен, но не отображаемых имен. При передаче этого флага два элемента упорядочены по любым критериям, которые папка оболочки определяет наиболее эффективно, при условии, что она реализует согласованную функцию сортировки. Этот флаг нельзя сочетать с другими флагами.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h

Поделиться через