SSortOrderSet

适用于:Outlook 2013 | Outlook 2016

定义用于标准排序或分类排序的表的排序键集合。

属性
标头文件:
Mapidefs.h
相关宏:
CbNewSSortOrderSetCbSSortOrderSetSizedSSortOrderSet
typedef struct _SSortOrderSet
{
  ULONG cSorts;
  ULONG cCategories;
  ULONG cExpanded;
  SSortOrder aSort[MAPI_DIM];
} SSortOrderSet, FAR *LPSSortOrderSet;

Members

cSorts

aSort 成员中包含的 SSortOrder 结构的计数。

cCategories

指定为类别列的列的计数。 可能的值范围从零(表示非分类或标准排序)到 cSorts 成员指示的数字。

cExpanded

以展开状态开头的类别计数,其中应用于该类别的所有行都在表视图中可见。 可能的值范围为 0 到 cCategories 指示的数字。

aSort

SSortOrder 结构的数组,每个结构定义排序顺序。

备注

SSortOrderSet 结构用于为标准和分类排序定义多个排序顺序。

每个 SSortOrderSet 结构至少包含一个 SSortOrder 结构,用于定义排序方向以及将用作排序键的列。 对于分类排序,此列用作类别。 当 cSorts 成员的值超过 cCategories 成员的值时,排序键多于类别,并且从 SSortOrder 数组中首先显示的列创建类别。

例如,如果 cSorts 设置为 3 且 cCategories 设置为 2,则 SSortOrder 数组中前两个条目的 ulPropTag 成员描述的列将用作类别列。 第一个条目用作顶级类别分组;作为辅助分组的第二个条目。 使用第三个条目中定义的排序键对匹配这两个类别列的所有行进行排序。

cExpanded 成员指定最初展开的类别数。 当有多个类别时,表实现从要指定为类别的第一列开始,并按顺序继续与后续类别列一起,直到超过 cCategories 的数目。 如果类别列多于展开的列,则会折叠类别列。 如果 cExpanded 等于零,则只有顶级标题行可供表用户显示。 如果 cExpanded 小于类别数的一个,则所有标题行和叶行都不可用。 如果 cExpanded 等于类别数,则表将完全展开。

有关标准和分类排序的详细信息,请参阅 排序和分类

另请参阅

SSortOrder

IMAPITable::ExpandRow

IMAPITable::CollapseRow

MAPI 结构