IMAPITable::CollapseRow
Aplica-se a: Outlook 2013 | Outlook 2016
Colapsa uma categoria de tabela expandida, removendo todos os títulos de nível inferior e linhas de folha pertencentes à categoria do modo de exibição de tabela.
HRESULT CollapseRow(
ULONG cbInstanceKey,
LPBYTE pbInstanceKey,
ULONG ulFlags,
ULONG FAR * lpulRowCount
);
Parâmetros
cbInstanceKey
[in] A contagem de bytes na propriedade PR_INSTANCE_KEY apontada pelo parâmetro pbInstanceKey .
pbInstanceKey
[in] Um ponteiro para a propriedade PR_INSTANCE_KEY (PidTagInstanceKey) que identifica a linha de título para a categoria.
ulFlags
Reservados; deve ser zero.
lpulRowCount
[out] Um ponteiro para o número total de linhas que estão sendo removidas da exibição da tabela.
Valor de retorno
S_OK
A operação de colapso foi bem-sucedida.
MAPI_E_NOT_FOUND
A linha identificada pelo parâmetro pbInstanceKey não existe.
MAPI_E_INVALID_ENTRYID
A linha identificada pelo parâmetro pbInstanceKey não existe. Esse erro é uma alternativa ao MAPI_E_NOT_FOUND; os provedores de serviços podem retornar qualquer um deles.
Comentários
O método IMAPITable::CollapseRow colapsa uma categoria de tabela e a remove da exibição da tabela. As linhas são recolhidas a partir da linha identificada pela propriedade PR_INSTANCE_KEY apontada pelo parâmetro pbInstanceKey . O número de linhas removidas do modo de exibição é retornado no conteúdo do parâmetro lpulRowCount .
As notificações nunca são geradas para linhas de tabela que são removidas de uma exibição como resultado de uma operação de colapso.
Quando uma linha definida por um indicador é recolhida fora de exibição, o indicador é movido para apontar para a próxima linha visível.
Para obter mais informações sobre tabelas categorizadas, consulte Classificação e Categorização.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::D oExpandCollapse |
O MFCMAPI usa o método IMAPITable::CollapseRow para recolher uma categoria de tabela. |