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. Associada a cada tabela de exibição está uma implementação de interface IAttach : IMAPIProp . A implementação IMAPIProp mantém os dados de propriedade que são 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 obrigatórias da tabela de exibição, consulte Exibir tabelas.

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 diretamente da tabela de exibição. À medida que o usuário trabalha com a folha de propriedades, alterando valores nos controles, o MAPI chama IMAPIProp::SetProps para salvar um controle alterado se o sinalizador de DT_SET_IMMEDIATE do controle estiver definido. Para controles sem o sinalizador DT_SET_IMMEDIATE definido, 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, o MAPI remove a folha de propriedades da exibição.

O MAPI obtém acesso à sua 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 para MAPI, como IMAPISupport::D oConfigPropsheet.

A técnica de primeiro acesso é usada quando os 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:

1. Um cliente chama o método IAddrBook::D etails .

2. O 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.

3. 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 de detalhes.

4. O MAPI exibe a caixa de diálogo, manipulando a interação do usuário com as informações, e a remove quando o usuário conclui.

Confira também

Provedores de Serviço MAPI