IMAPITable::CollapseRow
S’applique à : Outlook 2013 | Outlook 2016
Réduit une catégorie de table développée, en supprimant les en-têtes de niveau inférieur et les lignes feuilles appartenant à la catégorie de la vue de tableau.
HRESULT CollapseRow(
ULONG cbInstanceKey,
LPBYTE pbInstanceKey,
ULONG ulFlags,
ULONG FAR * lpulRowCount
);
Paramètres
cbInstanceKey
[in] Nombre d’octets dans la propriété PR_INSTANCE_KEY pointée par le paramètre pbInstanceKey .
pbInstanceKey
[in] Pointeur vers la propriété PR_INSTANCE_KEY (PidTagInstanceKey) qui identifie la ligne d’en-tête de la catégorie.
ulFlags
Réservés au; doit être égal à zéro.
lpulRowCount
[out] Pointeur vers le nombre total de lignes qui sont supprimées de la vue de table.
Valeur renvoyée
S_OK
L’opération de réduction a réussi.
MAPI_E_NOT_FOUND
La ligne identifiée par le paramètre pbInstanceKey n’existe pas.
MAPI_E_INVALID_ENTRYID
La ligne identifiée par le paramètre pbInstanceKey n’existe pas. Cette erreur est une alternative à MAPI_E_NOT_FOUND ; les fournisseurs de services peuvent retourner l’un ou l’autre d’eux.
Remarques
La méthode IMAPITable ::CollapseRow réduit une catégorie de table et la supprime de la vue de table. Les lignes sont réduites à partir de la ligne identifiée par la propriété PR_INSTANCE_KEY pointée par le paramètre pbInstanceKey . Le nombre de lignes supprimées de la vue est retourné dans le contenu du paramètre lpulRowCount .
Les notifications ne sont jamais générées pour les lignes de table qui sont supprimées d’une vue à la suite d’une opération de réduction.
Lorsqu’une ligne définie par un signet est réduite hors de vue, le signet est déplacé pour pointer vers la ligne visible suivante.
Pour plus d’informations sur les tables classées, consultez Tri et catégorisation.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl ::D oExpandCollapse |
MFCMAPI utilise la méthode IMAPITable ::CollapseRow pour réduire une catégorie de table. |