DTBLDDLBX
Aplica-se a: Outlook 2013 | Outlook 2016
Descreve um controle de lista suspensa que será usado em uma caixa de diálogo criada a partir de uma tabela de exibição.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapidefs.h |
typedef struct _DTBLDDLBX
{
ULONG ulFlags;
ULONG ulPRDisplayProperty;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLDDLBX, FAR *LPDTBLDDLBX;
Members
ulFlags
Reservado, deve ser zero.
ulPRDisplayProperty
Marca de propriedade para uma propriedade do tipo PT_TSTRING. Essa propriedade é uma das colunas na tabela identificada pelo membro ulPRTableName . Os valores dessa propriedade são exibidos na lista.
ulPRSetProperty
Marca de propriedade para uma propriedade de qualquer tipo. Essa propriedade é uma das colunas na tabela identificada pelo membro ulPRTableName . Quando o usuário da lista seleciona um valor de propriedade para o membro ulPRDisplayProperty das linhas da tabela identificadas pelo membro ulPRTableName , o membro ulPRSetProperty correspondente é definido.
ulPRTableName
Marca de propriedade para uma propriedade de tabela do tipo PT_OBJECT que pode ser aberta usando uma chamada OpenProperty . A tabela deve ter duas colunas: ulPRDisplayProperty e ulPRSetProperty. As linhas da tabela devem corresponder a itens na lista.
Comentários
Uma estrutura DTBLDDLBX descreve um controle de lista suspensa que é exibido como um único item até que o usuário opte por expandi-lo.
As três propriedades identificadas pelas marcas de propriedade funcionam juntas para exibir as informações na lista e definir uma propriedade relacionada. O membro ulPRTableName é um objeto de tabela acessado por meio de uma chamada para IMAPIProp::OpenProperty. A tabela tem duas colunas: uma coluna para a propriedade identificada pelo membro ulPRDisplayProperty e outra para a propriedade identificada pelo membro ulPRSetProperty .
A propriedade ulPRDisplayProperty impulsiona a exibição da lista. Quando um usuário seleciona um dos valores da exibição, MAPI chama IMAPIProp::SetProps para definir a propriedade correspondente conforme identificado pelo membro ulPRSetProperty . Isso significa que a propriedade na mesma linha que a propriedade de exibição selecionada. O membro ulPRSetProperty não pode ser definido como PR_NULL (PidTagNull).
Um valor inicial será exibido na lista se MAPI tiver recuperado a propriedade representada pelo membro ulPRSetProperty por meio de uma chamada para IMAPIProp::GetProps e localizar uma linha na tabela com o valor do membro ulPRSetProperty . O valor inicial exibido é o conteúdo da coluna ulPRDisplayProperty dessa linha que corresponde à propriedade no membro ulPRDisplayProperty da estrutura. O valor retornado por GetProps para a propriedade identificada pelo membro ulPRDisplayProperty torna-se o valor inicial mostrado quando a lista é exibida pela primeira vez.
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. Para obter informações sobre tipos de propriedade, consulte Visão geral do tipo de propriedade MAPI.