SSortOrder
Область применения: Outlook 2013 | Outlook 2016
Определяет порядок сортировки строк таблицы, какой столбец следует использовать в качестве ключа сортировки и направление сортировки.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapidefs.h |
typedef struct _SSortOrder
{
ULONG ulPropTag;
ULONG ulOrder;
} SSortOrder, FAR *LPSSortOrder;
Members
ulPropTag
Тег свойства, определяющий ключ сортировки или столбец категории для сортировки по категориям.
ulOrder
Порядок сортировки данных. Возможны следующие значения:
TABLE_SORT_ASCEND: таблица должна быть отсортирована по возрастанию.
TABLE_SORT_COMBINE. Операция сортировки должна создать категорию, которая объединяет свойство, указанное в качестве ключевого столбца сортировки в элементе ulPropTag , с ключевым столбцом сортировки, указанным в предыдущей структуре SSortOrder .
TABLE_SORT_COMBINE можно использовать только в том случае, если структура SSortOrder используется в качестве записи в структуре SSortOrderSet для указания нескольких заказов сортировки для сортировки по категориям. TABLE_SORT_COMBINE нельзя использовать в первой структуре SSortOrder в структуре SSortOrderSet .
TABLE_SORT_DESCEND. Таблица должна быть отсортирована по убыванию.
TABLE_SORT_CATEG_MAX. Таблица должна быть отсортирована по максимальному значению члена ulPropTag для строк данных в категориях, указанных в предыдущем порядке сортировки в структуре SSortOrderSet .
TABLE_SORT_CATEG_MIN. Таблица должна быть отсортирована по минимальному значению элемента ulPropTag для строк данных в категориях, указанных в предыдущем порядке сортировки в структуре SSortOrderSet .
Замечания
Структура SSortOrder используется для описания выполнения стандартной или классифицированной операции сортировки. Структуры SSortOrder обычно объединяются в структуру SSortOrderSet для описания нескольких ключей сортировки и направлений. Структуры SSortOrderSet используются в следующих функциях и методах интерфейса:
Диапазон допустимых столбцов в таблице, которые можно использовать в качестве ключа сортировки, зависит от поставщика. Столбцы, входящие в текущий набор столбцов, всегда можно использовать в качестве ключей сортировки. Однако каждый поставщик определяет, можно ли определить ключи сортировки с помощью доступных столбцов, которых нет в текущем наборе столбцов. Доступный столбец — это столбец, который возвращается из IMAPITable::QueryColumns при установке флага TBL_ALL_COLUMNS.
Элемент ulOrder указывает сведения о порядке направления и классификации, например по беседе (PidTagConversationTopic), то есть потоку беседы, который представляет собой серию сообщений и ответов. Строки можно отсортировать в последовательности по возрастанию или убыванию со всеми записями NULL, размещенными последним.
Значение TABLE_SORT_COMBINE указывает, что столбец, указанный в ulPropTag , должен быть объединен со столбцом предыдущей категории, чтобы сформировать составную категорию. То есть вместо классификации по уникальным значениям отдельных столбцов TABLE_SORT_COMBINE позволяет классифицировать по уникальным значениям сочетания столбцов. Например, можно определить одну категорию для группирования сообщений, полученных от определенного отправителя по определенной теме. Установка значения TABLE_SORT_COMBINE уменьшает количество отображаемых строк категорий.
Сортировка по столбцам с несколькими значениями не поддерживается всеми реализациями таблиц. Если это поддерживается, примените MV_FLAG с помощью макроса MVI_PROP к тегу свойства в элементе ulPropTag , чтобы определить ключ сортировки как многозначный столбец. Сортировка по многозначным столбцам основана на использовании отдельных значений.
Важно!
Значения элементов ulOrder TABLE_SORT_CATEG_MAX и TABLE_SORT_CATEG_MIN могут не быть определены в текущем загружаемом файле заголовка. В этом случае его можно добавить в код, используя следующие значения:
#ifndef TABLE_SORT_CATEG_MAX
#define TABLE_SORT_CATEG_MAX ((ULONG) 0x00000004)
#endif
#ifndef TABLE_SORT_CATEG_MIN
#define TABLE_SORT_CATEG_MIN ((ULONG) 0x00000008)
#endif
Дополнительные сведения о стандартной и классифицированной сортировке см. в разделе Сортировка и классификация.