SSortOrder
Gilt für: Outlook 2013 | Outlook 2016
Definiert, wie die Zeilen einer Tabelle sortiert werden, welche Spalte als Sortierschlüssel verwendet werden soll, und die Sortierrichtung.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
typedef struct _SSortOrder
{
ULONG ulPropTag;
ULONG ulOrder;
} SSortOrder, FAR *LPSSortOrder;
Members
ulPropTag
Eigenschaftstag, das den Sortierschlüssel oder bei einer kategorisierten Sortierung die Kategoriespalte angibt.
ulOrder
Die Reihenfolge, in der die Daten sortiert werden sollen. Mögliche Werte sind wie folgt:
TABLE_SORT_ASCEND: Die Tabelle sollte in aufsteigender Reihenfolge sortiert werden.
TABLE_SORT_COMBINE: Der Sortiervorgang sollte eine Kategorie erstellen, die die Eigenschaft, die als Sortierschlüsselspalte im ulPropTag-Element identifiziert wurde, mit der Sortierschlüsselspalte kombiniert, die in der vorherigen SSortOrder-Struktur angegeben wurde.
TABLE_SORT_COMBINE kann nur verwendet werden, wenn die SSortOrder-Struktur als Eintrag in einer SSortOrderSet-Struktur verwendet wird, um mehrere Sortierreihenfolgen für eine kategorisierte Sortierung anzugeben. TABLE_SORT_COMBINE können nicht in der ersten SSortOrder-Struktur in einer SSortOrderSet-Struktur verwendet werden.
TABLE_SORT_DESCEND: Die Tabelle sollte in absteigender Reihenfolge sortiert werden.
TABLE_SORT_CATEG_MAX: Die Tabelle sollte nach dem maximalen Wert des ulPropTag-Elements für die Datenzeilen in den Kategorien sortiert werden, die durch die vorherige Sortierreihenfolge in der SSortOrderSet-Struktur angegeben wurden.
TABLE_SORT_CATEG_MIN: Die Tabelle sollte nach dem Minimalwert des ulPropTag-Elements für die Datenzeilen in den Kategorien sortiert werden, die durch die vorherige Sortierreihenfolge in der -Struktur in SSortOrderSet angegeben wurden.
Hinweise
Eine SSortOrder-Struktur wird verwendet, um zu beschreiben, wie entweder ein Standardsortiervorgang oder ein kategorisierter Sortiervorgang ausgeführt wird. SSortOrder-Strukturen werden in der Regel in einer SSortOrderSet-Struktur kombiniert, um mehrere Sortierschlüssel und -richtungen zu beschreiben. SSortOrderSet-Strukturen werden in den folgenden Funktionen und Schnittstellenmethoden verwendet:
Der Bereich der zulässigen Spalten in einer Tabelle, der als Sortierschlüssel verwendet werden kann, hängt vom Anbieter ab. Spalten, die Teil des aktuellen Spaltensatzes sind, können immer als Sortierschlüssel verwendet werden. Jeder Anbieter bestimmt jedoch, ob Sortierschlüssel mithilfe verfügbarer Spalten definiert werden können, die nicht im aktuellen Spaltensatz enthalten sind. Eine verfügbare Spalte ist eine Spalte, die von IMAPITable::QueryColumns zurückgegeben wird, wenn das flag TBL_ALL_COLUMNS festgelegt wird.
Das ulOrder-Element gibt sowohl direktionale Reihenfolge als auch Kategorisierungsinformationen an, z. B. nach Konversation (PidTagConversationTopic), d. h. Konversationsthread, bei dem es sich um eine Reihe von Nachrichten und Antworten handelt. Zeilen können entweder in aufsteigender oder absteigender Reihenfolge sortiert werden, wobei alle NULL-Einträge zuletzt positioniert sind.
Der wert TABLE_SORT_COMBINE gibt an, dass die in ulPropTag angegebene Spalte mit der vorherigen Kategoriespalte kombiniert werden soll, um eine zusammengesetzte Kategorie zu bilden. Das heißt, anstatt nach eindeutigen Werten einzelner Spalten zu kategorisieren, ermöglicht TABLE_SORT_COMBINE die Kategorisierung eindeutiger Werte einer Kombination von Spalten. Beispielsweise könnte eine einzelne Kategorie definiert werden, um Nachrichten zu gruppieren, die von einem bestimmten Absender zu einem bestimmten Thema empfangen wurden. Wenn Sie den Wert auf TABLE_SORT_COMBINE festlegen, wird die Anzahl der angezeigten Kategoriezeilen reduziert.
Die Sortierung nach spalten mit mehreren Werten wird nicht von allen Tabellenimplementierungen universell unterstützt. Falls unterstützt, wenden Sie die MV_FLAG mithilfe des makros MVI_PROP auf das Eigenschaftstag im element ulPropTag an, um den Sortierschlüssel als mehrwertige Spalte zu identifizieren. Die Sortierung nach einer mehrwertigen Spalte basiert auf der Verwendung der einzelnen Werte.
Wichtig
Die ulOrder-Memberwerte TABLE_SORT_CATEG_MAX und TABLE_SORT_CATEG_MIN sind möglicherweise nicht in der herunterladbaren Headerdatei definiert, über die Sie derzeit verfügen. In diesem Fall können Sie sie Ihrem Code mithilfe der folgenden Werte hinzufügen:
#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
Weitere Informationen zur standardmäßigen und kategorisierten Sortierung finden Sie unter Sortieren und Kategorisieren.