IMAPITable::CollapseRow
Область применения: Outlook 2013 | Outlook 2016
Сворачивает расширенную категорию таблицы, удаляя все заголовки нижнего уровня и конечные строки, принадлежащие категории, из представления таблицы.
HRESULT CollapseRow(
ULONG cbInstanceKey,
LPBYTE pbInstanceKey,
ULONG ulFlags,
ULONG FAR * lpulRowCount
);
Параметры
cbInstanceKey
[в] Количество байтов в свойстве PR_INSTANCE_KEY, на которое указывает параметр pbInstanceKey .
pbInstanceKey
[в] Указатель на свойство 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 сворачивает категорию таблицы и удаляет ее из табличного представления. Строки свернуты, начиная со строки, определяемой свойством PR_INSTANCE_KEY , на которое указывает параметр pbInstanceKey . Количество строк, удаленных из представления, возвращается в содержимом параметра lpulRowCount .
Уведомления никогда не создаются для строк таблицы, которые удаляются из представления в результате операции сворачивания.
При сворачивании строки, определенной закладкой, она перемещается, чтобы указать на следующую видимую строку.
Дополнительные сведения о таблицах с классификацией см. в разделе Сортировка и классификация.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oExpandCollapse |
MFCMAPI использует метод IMAPITable::CollapseRow для свертывания категории таблицы. |