SSortOrderSet
Область применения: Outlook 2013 | Outlook 2016
Определяет коллекцию ключей сортировки для таблицы, которая используется для стандартной или классификации сортировки.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapidefs.h |
| Связанные макросы: |
CbNewSSortOrderSet, CbSSortOrderSet, SizedSSortOrderSet |
typedef struct _SSortOrderSet
{
ULONG cSorts;
ULONG cCategories;
ULONG cExpanded;
SSortOrder aSort[MAPI_DIM];
} SSortOrderSet, FAR *LPSSortOrderSet;
Members
cSorts
Количество структур SSortOrder , включенных в член aSort .
Категории c
Количество столбцов, которые обозначены как столбцы категории. Возможные значения варьируются от нуля, что указывает на неупорядоченную или стандартную сортировку, до числа, указанного членом cSorts .
cExpanded
Количество категорий, которые начинаются в развернутом состоянии, когда все строки, относящиеся к категории, видны в табличном представлении. Возможные значения варьируются от 0 до числа, указанного cCategories.
aSort
Массив структур SSortOrder , каждый из которых определяет порядок сортировки.
Замечания
Структура SSortOrderSet используется для определения нескольких заказов сортировки для стандартной и классификации сортировки.
Каждая структура SSortOrderSet содержит по крайней мере одну структуру SSortOrder , определяющую направление сортировки и столбец, который будет использоваться в качестве ключа сортировки. Для сортировки по категориям этот столбец используется в качестве категории. Если значение элемента cSorts превышает значение элемента cCategories , то ключей сортировки больше, чем категорий, а категории создаются из столбцов, которые появляются первыми в массиве SSortOrder .
Например, если параметр cSorts имеет значение 3, а cCategories — значение 2, столбцы, описанные элементом ulPropTag первых двух записей в массиве SSortOrder , используются в качестве столбцов категорий. Первая запись служит группированием категорий верхнего уровня; вторая запись в качестве вторичной группировки. Все строки, соответствующие двум столбцам категории, сортируются с помощью ключа сортировки, определенного в третьей записи.
Элемент cExpanded указывает количество категорий, которые сначала развернуты. При наличии нескольких категорий реализация таблицы начинается с первого столбца, обозначаемого в качестве категории, и продолжается в последовательном порядке с последующими столбцами категории до тех пор, пока не будет превышено число категорий c . Если столбцов категории больше, чем развернутых, столбцы категории свернуты. Если параметр cExpanded равен нулю, пользователю таблицы доступна только строка заголовка верхнего уровня. Если параметр cExpanded равен одному меньше количества категорий, то доступны все строки заголовков и ни одна из конечных строк. Если параметр cExpanded равен числу категорий, таблица будет полностью развернута.
Дополнительные сведения о стандартной и классифицированной сортировке см. в разделе Сортировка и классификация.