SSortOrder
S’applique à : Outlook 2013 | Outlook 2016
Définit comment trier les lignes d’une table, la colonne à utiliser comme clé de tri et la direction du tri.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapidefs.h |
typedef struct _SSortOrder
{
ULONG ulPropTag;
ULONG ulOrder;
} SSortOrder, FAR *LPSSortOrder;
Members
ulPropTag
Balise de propriété identifiant la clé de tri ou, pour un tri classé, la colonne de catégorie.
ulOrder
Ordre dans lequel les données doivent être triées. Les valeurs possibles sont les suivantes :
TABLE_SORT_ASCEND : la table doit être triée dans l’ordre croissant.
TABLE_SORT_COMBINE : l’opération de tri doit créer une catégorie qui combine la propriété identifiée comme colonne clé de tri dans le membre ulPropTag avec la colonne de clé de tri spécifiée dans la structure SSortOrder précédente.
TABLE_SORT_COMBINE ne peut être utilisé que lorsque la structure SSortOrder est utilisée comme entrée dans une structure SSortOrderSet pour spécifier plusieurs ordres de tri pour un tri classé. TABLE_SORT_COMBINE ne peut pas être utilisé dans la première structure SSortOrder d’une structure SSortOrderSet .
TABLE_SORT_DESCEND : la table doit être triée dans l’ordre décroissant.
TABLE_SORT_CATEG_MAX : la table doit être triée sur la valeur maximale du membre ulPropTag pour les lignes de données dans les catégories spécifiées par l’ordre de tri précédent dans la structure SSortOrderSet .
TABLE_SORT_CATEG_MIN : la table doit être triée sur la valeur minimale du membre ulPropTag pour les lignes de données dans les catégories spécifiées par l’ordre de tri précédent dans la structure dans SSortOrderSet .
Remarques
Une structure SSortOrder est utilisée pour décrire comment effectuer une opération de tri standard ou une opération de tri catégorisée. Les structures SSortOrder sont généralement combinées dans une structure SSortOrderSet pour décrire plusieurs clés de tri et directions. Les structures SSortOrderSet sont utilisées dans les fonctions et méthodes d’interface suivantes :
La plage de colonnes autorisées dans une table qui peut être utilisée comme clé de tri dépend du fournisseur. Les colonnes qui font partie de l’ensemble de colonnes actuel peuvent toujours être utilisées comme clés de tri. Toutefois, chaque fournisseur détermine si les clés de tri peuvent être définies à l’aide de colonnes disponibles qui ne figurent pas dans l’ensemble de colonnes actuel. Une colonne disponible est une colonne qui est retournée à partir de IMAPITable ::QueryColumns lorsque l’indicateur TBL_ALL_COLUMNS est défini.
Le membre ulOrder indique à la fois l’ordre directionnel et les informations de catégorisation, par exemple, par conversation (PidTagConversationTopic), c’est-à-dire, thread conversationnel, qui est une série de messages et de réponses. Les lignes peuvent être triées dans une séquence ascendante ou décroissante avec toutes les entrées NULL positionnées en dernier.
La valeur TABLE_SORT_COMBINE indique que la colonne spécifiée dans ulPropTag doit être combinée avec la colonne de catégorie précédente pour former une catégorie composite. Autrement dit, au lieu de catégoriser sur des valeurs uniques de colonnes individuelles, TABLE_SORT_COMBINE autorise la catégorisation sur les valeurs uniques d’une combinaison de colonnes. Par exemple, une seule catégorie peut être définie pour regrouper les messages reçus d’un expéditeur particulier sur un sujet particulier. La définition de la valeur sur TABLE_SORT_COMBINE réduit le nombre de lignes de catégorie affichées.
Le tri sur des colonnes à valeurs multiples n’est pas pris en charge universellement par toutes les implémentations de table. S’il est pris en charge, appliquez la MV_FLAG à l’aide de la macro MVI_PROP à la balise de propriété dans le membre ulPropTag pour identifier la clé de tri en tant que colonne à valeurs multiples. Le tri sur une colonne à valeurs multiples est basé sur l’utilisation des valeurs individuelles.
Importante
Les valeurs de membre ulOrder TABLE_SORT_CATEG_MAX et TABLE_SORT_CATEG_MIN peuvent ne pas être définies dans le fichier d’en-tête téléchargeable que vous avez actuellement, auquel cas vous pouvez l’ajouter à votre code à l’aide des valeurs suivantes :
#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
Pour plus d’informations sur le tri standard et catégorisé, consultez Tri et catégorisation.