DTBLCHECKBOX
Aplica-se a: Outlook 2013 | Outlook 2016
Contém informações sobre uma caixa de marcar que será usada em uma caixa de diálogo criada a partir de uma tabela de exibição.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapidefs.h |
| Macro relacionada: |
SizedDtblCheckBox |
typedef struct _DTBLCHECKBOX
{
ULONG ulbLpszLabel;
ULONG ulFlags;
ULONG ulPRPropertyName;
} DTBLCHECKBOX, FAR *LPDTBLCHECKBOX;
Members
ulbLpszLabel
Posicione na memória da cadeia de caracteres exibida com a caixa marcar.
ulFlags
Bitmask de sinalizadores usados para designar o formato do rótulo da caixa marcar. 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.
ulPRPropertyName
Marca de propriedade para uma propriedade do tipo PT_BOOLEAN. O valor dessa propriedade é afetado pelo estado da caixa marcar.
Comentários
Uma estrutura DTBLCHECKBOX descreve uma caixa marcar um controle que reflete um dos dois estados: habilitado (uma caixa marcada) ou desabilitado (uma caixa vazia).
O membro ulPRPropertyName descreve uma propriedade booliana cujo valor é manipulado alterando o estado da caixa marcar. Quando a caixa marcar é exibida pela primeira vez, a MAPI chama o método GetProps da implementação IMAPIProp associada à tabela de exibição para recuperar um conjunto de propriedades padrão. Se uma das propriedades for mapeada para a marca de propriedade na estrutura DTBLCHECKBOX, o valor dessa propriedade será exibido como o valor inicial da caixa marcar.
Os controles da caixa de seleção podem ser modificáveis. Isso permite que um usuário altere seus estados. Caixas de marcar modificáveis definem o sinalizador DT_EDITABLE no membro ulCtlFlags de sua estrutura DTCTL e na propriedade PR_CONTROL_FLAGS (PidTagControlFlags). Quando uma caixa de marcar altera seu estado, a MAPI chama IMAPIProp::SetProps para definir a propriedade identificada no membro da marca de propriedade da estrutura DTBLCHECKBOX para o novo estado.
Por exemplo, um provedor de catálogo de endereços pode incluir um controle de caixa de marcar modificável em sua caixa de diálogo de configuração para ajustar a configuração da propriedade PR_SEND_RICH_INFO (PidTagSendRichInfo) de um destinatário. Quando o usuário seleciona a caixa marcar, o MAPI define essa propriedade como TRUE. Quando a caixa marcar não for selecionada, a propriedade será definida como FALSE.
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.