SSortOrderSetSSortOrderSet

適用されます: OutlookApplies to: Outlook

標準またはカテゴリ別に並べ替えに使用されるテーブルの並べ替えキーのコレクションを定義します。Defines a collection of sort keys for a table that is used for standard or categorized sorting.

ヘッダー ファイル:Header file:
Mapidefs.hMapidefs.h
関連するマクロ:Related macros:
CbNewSSortOrderSetCbSSortOrderSetSizedSSortOrderSetCbNewSSortOrderSet, CbSSortOrderSet, SizedSSortOrderSet
typedef struct _SSortOrderSet
{
  ULONG cSorts;
  ULONG cCategories;
  ULONG cExpanded;
  SSortOrder aSort[MAPI_DIM];
} SSortOrderSet, FAR *LPSSortOrderSet;

メンバーMembers

cSortscSorts

ASortメンバーに含まれるSSortOrder構造体の数です。Count of SSortOrder structures that are included in the aSort member.

cCategoriescCategories

カテゴリの列として指定されている列の数。Count of columns that are designated as category columns. 使用可能な値の範囲は、分類なし] または [標準の並べ替えを示す、ゼロからcSortsのメンバーによって指定された番号です。Possible values range from zero, which indicates a non-categorized or standard sort, to the number indicated by the cSorts member.

cExpandedcExpanded

すべてのカテゴリに該当する行がテーブル ビューに表示される、展開した状態で始まる分類の数です。Count of categories that start in an expanded state, where all of the rows that apply to the category are visible in the table view. 使用可能な値の範囲は、0 からcCategoriesで指定された番号です。Possible values range from 0 to the number indicated by cCategories.

aSortaSort

並べ替え順序を定義する各SSortOrderの構造体の配列です。Array of SSortOrder structures, each defining a sort order.

備考Remarks

SSortOrderSet構造体は、標準的なカテゴリ別に並べ替えのさまざまな並べ替え順序を定義するために使用されます。A SSortOrderSet structure is used for defining multiple sort orders for standard and categorized sorting.

SSortOrderSetの各構造体には、並べ替えと並べ替えキーとして使用される列の方向を定義するには、少なくとも 1 つのSSortOrder構造が含まれています。Each SSortOrderSet structure contains at least one SSortOrder structure defining the direction of the sort and the column that will be used as the sort key. カテゴリ別の並べ替えでは、この列がカテゴリとして使用されます。For categorized sorting, this column is used as the category. CSortsメンバーの値は、 cCategoriesメンバーの値を超えているとカテゴリより多くの並べ替えキーがあるカテゴリは、 SSortOrder配列の最初に表示される列から作成されます。When the value of the cSorts member exceeds the value of the cCategories member, there are more sort keys than categories, and categories are created from the columns that appear first in the SSortOrder array.

などのcSortsを 3 に設定し、 cCategoriesが 2 に設定されて、する場合は、 SSortOrder配列内の最初の 2 つのエントリのulPropTagのメンバーが記載されている列がカテゴリの列として使用されます。For example, if cSorts is set to 3 and cCategories is set to 2, the columns described by the ulPropTag member of the first two entries in the SSortOrder array are used as the category columns. 最初のエントリは、グループ化は最上位のカテゴリとして機能します。セカンダリ ・ グループと 2 番目のエントリです。The first entry serves as the top-level category grouping; the second entry as the secondary grouping. 3 番目のエントリで定義されている並べ替えキーを使用してすべての列の 2 つのカテゴリと一致する行が並べ替えられます。All of the rows that match the two category columns are sorted by using the sort key defined in the third entry.

CExpandedメンバーは、最初に展開される項目の数を指定します。The cExpanded member specifies the number of categories that are at first expanded. 複数のカテゴリが存在する場合、テーブルの実装から始まり、カテゴリとして指定するのには、最初の列、まで、それ以降のカテゴリ列に順番にcCategoriesの数を超えています。When there are multiple categories, the table implementation starts with the first column to be designated as a category and continues in sequential order with the subsequent category columns until the number of cCategories has been exceeded. 拡張された列の数よりも多くのカテゴリの列がある場合は、カテゴリの列が折りたたまれます。If there are more category columns than there are expanded columns, the category columns are collapsed. CExpandedがゼロに等しい場合は、最上位レベルの見出しの行だけが表示のテーブルのユーザーが利用できます。If cExpanded is equal to zero, only the top level heading row is available to the table user for display. CExpandedの項目の数より 1 小さい値に等しい場合、し、すべての見出し行とリーフ行の [なし] を利用できます。If cExpanded is equal to one less than the number of categories, then all of the heading rows and none of the leaf rows are available. CExpandedは、カテゴリの数に等しく、し、テーブルは完全に展開します。If cExpanded is equal to the number of categories, then the table is fully expanded.

詳細については、標準的なカテゴリ別に並べ替え、並べ替えや分類を参照してください。For more information about standard and categorized sorting, see Sorting and Categorization.

関連項目See also

SSortOrderSSortOrder

IMAPITable::ExpandRowIMAPITable::ExpandRow

IMAPITable::CollapseRowIMAPITable::CollapseRow

MAPI の構造MAPI Structures