Implementação da tabela de exibição
Aplica-se a: Outlook 2013 | Outlook 2016
Uma tabela de exibição é usada para mostrar uma folha de propriedades, uma caixa de diálogo especial composta por uma ou mais páginas de propriedades com guias dedicadas à exibição e possivelmente edição de uma ou mais propriedades. Associado a cada tabela de exibição está uma implementação de interface IAttach : IMAPIProp . A implementação IMAPIProp mantém os dados de propriedade apresentados na folha de propriedades.
As linhas em uma tabela de exibição representam os controles na folha de propriedades. A maioria dos controles pode ser associada a propriedades mantidas com a implementação IMAPIProp . Quando um usuário altera o valor de um controle modificável, a propriedade correspondente é atualizada.
As colunas em uma tabela de exibição representam propriedades do controle, como sua posição na folha de propriedades, seu tipo, estrutura associada e identificador. Para obter uma lista completa das colunas de tabela de exibição necessárias, consulte Tabelas de Exibição.
O MAPI exibe uma folha de propriedades para o usuário de um aplicativo cliente lendo valores de propriedade da implementação IMAPIProp associada à tabela de exibição ou da tabela de exibição diretamente. Como o usuário trabalha com a folha de propriedades, alterando valores nos controles, MAPI chama IMAPIProp::SetProps para salvar um controle alterado se o sinalizador DT_SET_IMMEDIATE do controle estiver definido. Para controles sem o conjunto de sinalizadores DT_SET_IMMEDIATE, as alterações nas propriedades são salvas quando o usuário descarta a caixa de diálogo clicando no botão OK ou Aplicar Agora . Quando um desses botões ou o botão Cancelar é clicado, MAPI remove a folha de propriedades do modo de exibição.
O MAPI obtém acesso à tabela de exibição chamando o método IMAPIProp::OpenProperty na implementação IMAPIProp e solicitando a propriedade PR_DETAILS_TABLE (PidTagDetailsTable) ou herdando-a em uma chamada que você fez ao MAPI, como IMAPISupport::D oConfigPropsheet.
A primeira técnica de acesso é usada quando provedores de catálogo de endereços são solicitados a mostrar detalhes sobre usuários de mensagens ou listas de distribuição. O seguinte processamento ocorre:
Um cliente chama o método IAddrBook::D etails .
MAPI chama o método IABLogon::OpenEntry do provedor de catálogo de endereços para acessar o usuário de mensagens que representa a entrada selecionada.
O MAPI chama o método IMAPIProp::OpenProperty do usuário de mensagens para recuperar a propriedade PR_DETAILS_TABLE , a tabela de exibição da caixa de diálogo detalhes.
O MAPI exibe a caixa de diálogo, manipula a interação do usuário com as informações e a remove quando o usuário termina.