IMAPITable::CollapseRow
適用於:Outlook 2013 |Outlook 2016
折疊展開的數據表類別,從數據表檢視中移除屬於類別目錄的任何較低層級標題和分葉數據列。
HRESULT CollapseRow(
ULONG cbInstanceKey,
LPBYTE pbInstanceKey,
ULONG ulFlags,
ULONG FAR * lpulRowCount
);
參數
cbInstanceKey
[in] pbInstanceKey 參數所指向PR_INSTANCE_KEY屬性中的位元組計數。
pbInstanceKey
[in] PR_INSTANCE_KEY (PidTagInstanceKey) 屬性的指標,可識別類別目錄的標題列。
ulFlags
保留;必須是零。
lpulRowCount
[out]要從數據表檢視中移除之數據列總數的指標。
傳回值
S_OK
折疊作業已成功。
MAPI_E_NOT_FOUND
pbInstanceKey 參數所識別的數據列不存在。
MAPI_E_INVALID_ENTRYID
pbInstanceKey 參數所識別的數據列不存在。 此錯誤是MAPI_E_NOT_FOUND的替代方案;服務提供者可以傳回其中一個。
註解
IMAPITable::CollapseRow 方法會折迭數據表類別目錄,並將其從數據表檢視中移除。 數據列會從 pbInstanceKey 參數所指向PR_INSTANCE_KEY屬性所識別的數據列開始折疊。 從檢視中移除的數據列數目會在 lpulRowCount 參數的內容中傳回。
永遠不會針對因折疊作業而從檢視中移除的數據表數據列產生通知。
當書籤所定義的數據列折疊在檢視外時,會移動書籤以指向下一個可見的數據列。
如需分類數據表的詳細資訊,請參閱 排序和分類。
MFCMAPI 參考
如需 MFCMAPI 範例程式代碼,請參閱下表。
檔案 | Function | Comment |
---|---|---|
ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oExpandCollapse |
MFCMAPI 使用 IMAPITable::CollapseRow 方法折疊數據表類別。 |