SSortOrderSet
適用対象: Outlook 2013 | Outlook 2016
標準または分類された並べ替えに使用されるテーブルの並べ替えキーのコレクションを定義します。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapidefs.h |
| 関連するマクロ: |
CbNewSSortOrderSet、 CbSSortOrderSet、 SizeSSortOrderSet |
typedef struct _SSortOrderSet
{
ULONG cSorts;
ULONG cCategories;
ULONG cExpanded;
SSortOrder aSort[MAPI_DIM];
} SSortOrderSet, FAR *LPSSortOrderSet;
メンバー
cSorts
aSort メンバーに含まれる SSortOrder 構造体の数。
cCategories
カテゴリ列として指定されている列の数。 指定できる値の範囲は、分類されていない並べ替えまたは標準の並べ替えを示す 0 から 、cSorts メンバーによって示される数値までです。
cExpanded
展開された状態で開始されるカテゴリの数。このカテゴリに適用されるすべての行がテーブル ビューに表示されます。 指定できる値の範囲は、0 から cCategories で示される数値までです。
aSort
並べ替え順序を定義する SSortOrder 構造体の配列。
注釈
SSortOrderSet 構造体は、標準並べ替えと分類された並べ替えの複数の並べ替え順序を定義するために使用されます。
各 SSortOrderSet 構造体には、並べ替えの方向と並べ替えキーとして使用される列を定義する少なくとも 1 つの SSortOrder 構造体が含まれています。 分類された並べ替えでは、この列がカテゴリとして使用されます。 cSorts メンバーの値が cCategories メンバーの値を超えると、カテゴリよりも多くの並べ替えキーが存在し、SSortOrder 配列の最初に表示される列からカテゴリが作成されます。
たとえば、cSorts が 3 に設定され、cCategories が 2 に設定されている場合、SSortOrder 配列の最初の 2 つのエントリの ulPropTag メンバーによって記述された列がカテゴリ列として使用されます。 最初のエントリは、最上位のカテゴリ グループとして機能します。2 番目のエントリをセカンダリ グループとして指定します。 2 つのカテゴリ列に一致するすべての行は、3 番目のエントリで定義されている並べ替えキーを使用して並べ替えられます。
cExpanded メンバーは、最初に展開されるカテゴリの数を指定します。 複数のカテゴリがある場合、テーブルの実装は、カテゴリとして指定される最初の列から始まり、 cCategories の数を超えるまで後続のカテゴリ列を順番に続行します。 展開された列よりも多くのカテゴリ列がある場合、カテゴリ列は折りたたまれます。 cExpanded が 0 に等しい場合、テーブル ユーザーは最上位レベルの見出し行のみを表示できます。 cExpanded がカテゴリの数より 1 未満の場合、すべての見出し行とリーフ行は使用できません。 cExpanded がカテゴリの数と等しい場合、テーブルは完全に展開されます。
標準並べ替えと分類の詳細については、「 並べ替えと分類」を参照してください。