Partager via


SSortOrderSet

S’applique à : Outlook 2013 | Outlook 2016

Définit une collection de clés de tri pour une table utilisée pour le tri standard ou classé.

Propriété Valeur
Fichier d’en-tête :
Mapidefs.h
Macros associées :
CbNewSSortOrderSet, CbSSortOrderSet, SizedSSortOrderSet
typedef struct _SSortOrderSet
{
  ULONG cSorts;
  ULONG cCategories;
  ULONG cExpanded;
  SSortOrder aSort[MAPI_DIM];
} SSortOrderSet, FAR *LPSSortOrderSet;

Members

cSorts

Nombre de structures SSortOrder incluses dans le membre aSort .

cCategories

Nombre de colonnes désignées comme colonnes de catégorie. Les valeurs possibles vont de zéro, ce qui indique un tri non classé ou standard, au nombre indiqué par le membre cSorts .

cExpanded

Nombre de catégories qui commencent dans un état développé, où toutes les lignes qui s’appliquent à la catégorie sont visibles dans la vue de table. Les valeurs possibles sont comprises entre 0 et le nombre indiqué par cCategories.

aSort

Tableau de structures SSortOrder , chacune définissant un ordre de tri.

Remarques

Une structure SSortOrderSet est utilisée pour définir plusieurs ordres de tri pour le tri standard et classé.

Chaque structure SSortOrderSet contient au moins une structure SSortOrder définissant la direction du tri et la colonne qui sera utilisée comme clé de tri. Pour le tri catégorisé, cette colonne est utilisée comme catégorie. Lorsque la valeur du membre cSorts dépasse la valeur du membre cCategories , il y a plus de clés de tri que de catégories, et les catégories sont créées à partir des colonnes qui apparaissent en premier dans le tableau SSortOrder .

Par exemple, si cSorts a la valeur 3 et que cCategories a la valeur 2, les colonnes décrites par le membre ulPropTag des deux premières entrées du tableau SSortOrder sont utilisées comme colonnes de catégorie. La première entrée sert de regroupement de catégories de niveau supérieur ; la deuxième entrée comme regroupement secondaire. Toutes les lignes qui correspondent aux deux colonnes de catégorie sont triées à l’aide de la clé de tri définie dans la troisième entrée.

Le membre cExpanded spécifie le nombre de catégories qui sont d’abord développées. Lorsqu’il existe plusieurs catégories, l’implémentation de la table commence par la première colonne à désigner comme catégorie et se poursuit dans l’ordre séquentiel avec les colonnes de catégorie suivantes jusqu’à ce que le nombre de cCategories soit dépassé. S’il y a plus de colonnes de catégorie que de colonnes développées, les colonnes de catégorie sont réduites. Si cExpanded est égal à zéro, seule la ligne d’en-tête de niveau supérieur est disponible pour l’utilisateur de la table pour l’affichage. Si cExpanded est égal à une de moins que le nombre de catégories, toutes les lignes de titre et aucune ligne feuille ne sont disponibles. Si cExpanded est égal au nombre de catégories, la table est entièrement développée.

Pour plus d’informations sur le tri standard et catégorisé, consultez Tri et catégorisation.

Voir aussi

SSortOrder

IMAPITable::ExpandRow

IMAPITable::CollapseRow

Structures MAPI