DTBLBUTTON
Aplica-se a: Outlook 2013 | Outlook 2016
Contém informações sobre um controle de botão para uma caixa de diálogo criada a partir de uma tabela de exibição.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapidefs.h |
| Macro relacionada: |
SizedDtblButton |
typedef struct _DTBLBUTTON
{
ULONG ulbLpszLabel;
ULONG ulFlags;
ULONG ulPRControl;
} DTBLBUTTON, FAR *LPDTBLBUTTON;
Members
ulbLpszLabel
Posicione-se na memória da cadeia de caracteres exibida no botão.
ulFlags
Bitmask de sinalizadores usados para designar o formato do rótulo apontado pelo membro ulbLpszLabel . O seguinte sinalizador pode ser definido:
MAPI_UNICODE
O rótulo está no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, o rótulo estará no formato ANSI.
ulPRControl
Marca de propriedade para uma propriedade do tipo PT_OBJECT que implementa a interface IMAPIControl . Quando o botão é clicado, MAPI chama o método IMAPIProp::OpenProperty para a implementação IMAPIProp da tabela de exibição para recuperar essa propriedade.
Comentários
Uma estrutura DTBLBUTTON descreve um botão de um controle que, quando clicado, permite que um usuário inicie uma operação. Normalmente, clicar em um botão faz com que uma caixa de diálogo modal seja exibida ou uma tarefa programática seja invocada. Os provedores de serviços podem implementar qualquer coisa por meio de um controle de botão. Se o botão deve executar uma tarefa com base nos valores de outros controles, esses controles devem ter definido o sinalizador DT_SET_IMMEDIATE.
O membro ulbLpszLabel é a posição na memória da cadeia de caracteres exibida no botão. Os provedores de serviços podem adicionar um caractere ampersand (&) para indicar um acelerador windows no rótulo de botão. Pressionar uma tecla de acelerador tem o mesmo efeito que clicar no botão.
O membro ulPRControl descreve uma propriedade de objeto que, quando aberta com o método IMAPIProp::OpenProperty , retorna um ponteiro para um objeto de controle. Implementar um objeto de controle que dá suporte à interface IMAPIControl é uma maneira de estender o conjunto de recursos MAPI e definir a operação ou tarefa que ocorre quando o botão é clicado. O IMAPIControl fornece dois métodos para manipular botões: GetState para desabilitar ou habilitar botões e Ativar para manipular cliques de botão.
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.