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

Метод IShellFolder2::GetDefaultColumn (shobjidl_core.h)

  • Статья

Возвращает столбцы сортировки и отображения по умолчанию.

Синтаксис

HRESULT GetDefaultColumn(
  [in]  DWORD dwRes,
  [out] ULONG *pSort,
  [out] ULONG *pDisplay
);

Параметры

[in] dwRes

Тип: DWORD

Зарезервировано. Задайте нулевое значение.

[out] pSort

Тип: ULONG*

Указатель на значение, которое получает индекс отсортированного столбца по умолчанию.

[out] pDisplay

Тип: ULONG*

Указатель на значение, которое получает индекс отображаемого столбца по умолчанию.

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

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения, или значение ошибки COM в противном случае.

Комментарии

Заметки для пользователей

Оба индекса столбцов, возвращаемые этим методом, предназначены для использования приложением, предоставляющим представление папки этой папки.

Столбец, указанный в pSort , должен использоваться для сортировки элементов в папке. Чтобы определить порядок сортировки для любой пары элементов, передайте их PID в CompareIDs. Укажите столбец, задав для параметра lParamобъекта CompareIDs значение, на которое указывает pSort.

Если в представлении отображается только одна строка для представления элемента, она должна быть взята из столбца, указанного в pDisplay. Передайте индекс столбца и PIDL элемента в IShellFolder2::GetDetailsOf , чтобы получить строку.

Примечания для разработчиков

Этот метод является частью реализации объекта папки расширения пространства имен. Обычно он вызывается объектом представления папки, чтобы задать объекту папки, какой столбец в представлении Сведений Microsoft Windows Обозреватель следует использовать для сортировки элементов в папке. Например, объект папки, представляющий журнал транзакций, может задать для pSort столбец, отображающий время транзакции. Элементы будут отсортированы по времени транзакции, а не по имени.

Некоторые клиенты могут вызывать этот метод, чтобы запросить индекс столбца с именами, которые должны отображаться в представлении в виде дерева. Задайте для параметра pDisplay соответствующий индекс столбца. Затем клиент получит отображаемые имена, вызвав IShellFolder2::GetDetailsOf.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)
DLL Shell32.dll (версия 5.0 или более поздняя)