IMAPITable::CollapseRow
Gilt für: Outlook 2013 | Outlook 2016
Reduziert eine erweiterte Tabellenkategorie und entfernt alle Überschriften auf niedrigerer Ebene und Blattzeilen, die zu der Kategorie gehören, aus der Tabellenansicht.
HRESULT CollapseRow(
ULONG cbInstanceKey,
LPBYTE pbInstanceKey,
ULONG ulFlags,
ULONG FAR * lpulRowCount
);
Parameter
cbInstanceKey
[in] Die Anzahl der Bytes in der PR_INSTANCE_KEY Eigenschaft, auf die der pbInstanceKey-Parameter verweist.
pbInstanceKey
[in] Ein Zeiger auf die eigenschaft PR_INSTANCE_KEY (PidTagInstanceKey), die die Überschriftenzeile für die Kategorie identifiziert.
ulFlags
Reserviert; muss null sein.
lpulRowCount
[out] Ein Zeiger auf die Gesamtzahl der Zeilen, die aus der Tabellenansicht entfernt werden.
Rückgabewert
S_OK
Der Vorgang zum Reduzieren war erfolgreich.
MAPI_E_NOT_FOUND
Die durch den pbInstanceKey-Parameter identifizierte Zeile ist nicht vorhanden.
MAPI_E_INVALID_ENTRYID
Die durch den pbInstanceKey-Parameter identifizierte Zeile ist nicht vorhanden. Dieser Fehler ist eine Alternative zum MAPI_E_NOT_FOUND. Dienstanbieter können beides zurückgeben.
Hinweise
Die IMAPITable::CollapseRow-Methode reduziert eine Tabellenkategorie und entfernt sie aus der Tabellenansicht. Die Zeilen werden ab der Zeile reduziert, die durch die PR_INSTANCE_KEY Eigenschaft identifiziert wird, auf die der pbInstanceKey-Parameter verweist. Die Anzahl der Zeilen, die aus der Ansicht entfernt werden, wird im Inhalt des lpulRowCount-Parameters zurückgegeben.
Benachrichtigungen werden nie für Tabellenzeilen generiert, die aufgrund eines Vorgangs zum Reduzieren aus einer Ansicht entfernt werden.
Wenn eine Zeile, die durch ein Lesezeichen definiert wird, aus der Ansicht reduziert wird, wird das Lesezeichen verschoben, um auf die nächste sichtbare Zeile zu zeigen.
Weitere Informationen zu kategorisierten Tabellen finden Sie unter Sortieren und Kategorisieren.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oExpandCollapse |
MFCMAPI verwendet die IMAPITable::CollapseRow-Methode , um eine Tabellenkategorie zu reduzieren. |