DTBLLBX
Aplica-se a: Outlook 2013 | Outlook 2016
Descreve uma lista que será usada em uma caixa de diálogo que é criada a partir de uma tabela de exibição.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapidefs.h |
typedef struct _DTBLLBX
{
ULONG ulFlags;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLLBX, FAR *LPDTBLLBX
Members
ulFlags
Bitmask de sinalizadores usados para eliminar uma barra de rolagem horizontal ou vertical da lista. Os seguintes sinalizadores podem ser definidos:
MAPI_NO_HBAR
Nenhuma barra de rolagem horizontal deve ser mostrada com a lista.
MAPI_NO_VBAR
Nenhuma barra de rolagem vertical deve ser mostrada com a lista.
ulPRSetProperty
Marca de propriedade para uma propriedade de qualquer tipo. Essa propriedade é uma das colunas na tabela identificada pelo membro ulPRTableTable .
ulPRTableName
Marca de propriedade para uma propriedade de tabela do tipo PT_OBJECT que pode ser aberta usando uma chamada OpenProperty . O número de colunas que a tabela deve ter depende se a lista é uma lista de seleção única ou múltipla. Se o membro ulPRSetProperty estiver definido como PR_NULL (PidTagNull), a lista permitirá várias seleções.
Comentários
Uma estrutura DTBLLBX descreve uma lista de um controle que é usado para mostrar vários itens e permitir que um usuário selecione um ou mais itens.
O membro ulPRSetProperty e o membro ulPRTableName trabalham juntos; quando um valor é escolhido da tabela, ele é gravado de volta para ulPRSetProperty quando a caixa de diálogo é descartada.
O valor de sinalizadores indica se uma barra de rolagem horizontal ou vertical deve ser exibida com a lista. O padrão é fazer com que tipos de barras de rolagem sejam exibidos se for necessário. Os provedores de serviços podem definir MAPI_NO_HBAR para suprimir uma barra de rolagem horizontal e MAPI_NO_VBAR para suprimir uma barra de rolagem vertical.
Os dois membros da marca de propriedade trabalham juntos para exibir valores na lista e definir propriedades correspondentes quando um item na lista é selecionado. Quando MAPI exibe a lista pela primeira vez, ela chama o método OpenProperty da implementação IMAPIProp para recuperar a tabela identificada no membro ulPRTableName. O número de colunas na tabela depende do valor do membro ulPRSetProperty . Se ulPRSetProperty estiver definido como PR_NULL, a lista será uma lista de várias seleções com base em um objeto que contém destinatários, como um contêiner de catálogo de endereços, uma tabela de destinatário para uma mensagem ou uma tabela de conteúdo de lista de distribuição.
Uma tabela para uma lista de várias seleções deve incluir as seguintes colunas:
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ENTRYID (PidTagEntryId)
PR_INSTANCE_KEY (PidTagInstanceKey)
PR_DISPLAY_TYPE (PidTagDisplayType) e um máximo de cinco outras propriedades de cadeia de caracteres multivalorizadas também podem ser exibidas com as três colunas necessárias.
Se o membro ulPRSetProperty não estiver definido como PR_NULL, a lista será uma única lista de seleção. O valor inicial de ulPRSetProperty determina a primeira linha selecionada. Quando um usuário seleciona uma das linhas, o membro ulPRSetProperty é definido como o valor selecionado e esse valor é gravado novamente na implementação da interface da propriedade com uma chamada para IMAPIProp::SetProps.
Para obter uma visão geral das tabelas de exibição, consulte Tabelas de Exibição. Para obter informações sobre como implementar uma tabela de exibição, consulte Implementando uma tabela de exibição.