Utilisation de colonnes à valeurs multiples
S’applique à : Outlook 2013 | Outlook 2016
Une colonne à valeurs multiples contient les données d’une propriété à valeurs multiples, qui est une propriété qui a un tableau de valeurs du type de base au lieu d’une valeur unique. Étant donné qu’aucune des tables n’inclut de propriétés à valeurs multiples dans leurs jeux de colonnes par défaut, les propriétés à valeurs multiples ne sont incluses dans une table que si l’utilisateur de la table le demande.
Les colonnes à plusieurs valeurs peuvent être affichées dans des tables :
Dans une seule ligne, toutes les valeurs de propriété s’affichent dans la colonne unique instance. Valeur par défaut.
- Ou-
Dans une série de lignes, avec une ligne pour chacune des valeurs de propriété. Chaque valeur unique apparaît dans la colonne de sa propre ligne avec autant de lignes que de valeurs dans la propriété à valeurs multiples. Chaque ligne a une valeur unique pour la propriété PR_INSTANCE_KEY (PidTagInstanceKey), mais les mêmes valeurs pour les autres colonnes. Si une ligne contient plusieurs colonnes avec plusieurs valeurs, par exemple deux colonnes avec des valeurs M et N respectivement, les instances M*N de la ligne apparaissent dans la table.
Un utilisateur de table demande le type d’affichage non défini par défaut en appelant la méthode IMAPITable ::SetColumns avec l’indicateur MVI_FLAG défini dans le type de propriété de la colonne à valeurs multiples. L’indicateur MVI_FLAG est une constante définie suite à la combinaison des indicateurs MV_FLAG et MV_INSTANCE avec une opération OR logique. En plus d’être utilisé dans SetColumns, MVI_FLAG peuvent également être passés à IMAPITable ::SortTable dans le paramètre lpSortCriteria et IMAPITable ::Restrict dans le membre ulPropTag du paramètre lpRestriction . Lorsque la MVI_FLAG est transmise, SortTable fonctionne de la même façon que SetColumns, en ajoutant une ligne pour chaque valeur de la colonne à valeurs multiples et en triant les valeurs uniques dans les instances. Une ligne est ajoutée pour chaque valeur.
Toutefois, restreindre ne développe pas la colonne à valeurs multiples en lignes calculées supplémentaires. Une colonne à valeurs multiples avec l’ensemble MVI_FLAG indique au fournisseur de services d’utiliser cette colonne pour restreindre la table. S’il existe une valeur de propriété dans la restriction, il doit s’agir d’une balise de propriété de valeur unique identique à celle qui serait retournée par IMAPITable ::QueryRows pour la colonne.
Les implémenteurs de table sont nécessaires uniquement pour prendre en charge le type d’affichage par défaut et peuvent retourner la valeur MAPI_E_TOO_COMPLEX lorsqu’un appelant demande l’autre alternative. La possibilité de prendre en charge les deux types d’affichage est la plus importante pour les fournisseurs de magasins de messages qui implémentent des tables de contenu de dossier.