Propriedade Canônica PidTagControlFlags

Artigo
04/04/2023

Aplica-se a: Outlook 2013 | Outlook 2016

Contém um bitmask de sinalizadores que regem o comportamento de um controle usado em uma caixa de diálogo criada a partir de uma tabela de exibição.

Propriedade	Valor
Propriedades associadas:	PR_CONTROL_FLAGS
Identificador:	0x3F00
Tipo de dados:	PT_LONG
Área:	Tabela de exibição MAPI

Comentários

Um ou mais dos seguintes sinalizadores podem ser definidos para esta propriedade:

DT_ACCEPT_DBCS

O controle pode ter caracteres DBCS (Conjunto de Caracteres) Double-Byte nele. Esse sinalizador é usado com controles de edição. Ele permite conjuntos de caracteres de vários bytes.

DT_EDITABLE

O controle pode ser editado; o valor associado ao controle pode ser alterado. Quando esse sinalizador não é definido, o controle é somente leitura. Esse valor é ignorado em rótulo, caixa de grupo, botão push padrão, caixa de lista suspensa multivalida e controles de caixa de listagem.

DT_MULTILINE

O controle de edição pode conter várias linhas. Isso significa que um caractere de retorno pode ser inserido no controle. Esse sinalizador é válido somente para controles de edição.

DT_PASSWORD_EDIT

Aplica-se a controles de edição. O controle de edição é tratado como uma senha. O valor é exibido usando asteriscos em vez de ecoar os caracteres reais inseridos.

DT_REQUIRED

Se o controle permitir alterações (DT_EDITABLE), ele deverá ter um valor antes de IMAPIProp::SaveChanges ser chamado.

DT_SET_IMMEDIATE

Habilita a configuração imediata de um valor; assim que um valor no controle é alterado, o MAPI chama o método SetProps para a propriedade associada a esse controle. Quando esse sinalizador não é definido, os valores são definidos quando a caixa de diálogo é descartada.

DT_SET_SELECTION

Quando uma seleção é feita dentro da caixa de lista, a coluna de índice dessa caixa de lista é definida como uma propriedade. Sempre usado com DT_SET_IMMEDIATE.

Essa propriedade é armazenada no membro ulCtlFlags da estrutura DTCTL de um controle. A maioria dos sinalizadores de controle se aplica a todos os controles que permitem a entrada do usuário; alguns se aplicam apenas ao controle de edição. Controles que não permitem a entrada do usuário, como um botão ou um rótulo, definem 0 para seus sinalizadores de controle.

Muitos dos valores de sinalizador são auto-explicativos. Por exemplo, quando DT_REQUIRED é definido para um controle, ele deve conter um valor antes que a caixa de diálogo possa ser descartada. O provedor de serviços pode fornecer um valor por meio de sua implementação IMAPIProp ou o usuário pode inserir um. DT_EDITABLE indica que o valor do controle pode ser modificado. DT_MULTILINE permite que o valor de um controle de edição abrange várias linhas.

Alguns sinalizadores de controle não são tão óbvios em seu significado. Quando um controle define o sinalizador DT_SET_IMMEDIATE, todas as alterações no valor são afetadas assim que o usuário passa para um novo controle. MAPI faz uma única chamada para o método IMAPIProp::SetProps da interface da propriedade do controle. Isso é diferente do comportamento padrão, que é adiar a realização de alterações nos valores de controle até que o usuário selecione o botão OK ou descarte a caixa de diálogo. O sinalizador DT_SET_IMMEDIATE geralmente é usado em combinação com notificações de tabela de exibição.

A tabela a seguir lista os tipos de controles e todos os valores de sinalizador que podem ser definidos para cada tipo.

Control	Valores válidos para essa propriedade
Botão	Deve ser zero
Caixa de seleção	DT_EDITABLE, DT_SET_IMMEDIATE
Caixa de combinação	DT_EDITABLE, DT_REQUIRED, DT_SET_IMMEDIATE
Caixa de lista suspensa	DT_EDITABLE, DT_SET_IMMEDIATE
Editar	DT_ACCEPT_DBCS, DT_MULTILINE, DT_EDITABLE, DT_PASSWORD_EDIT, DT_REQUIRED, DT_SET_IMMEDIATE
Caixa de grupo	Deve ser zero
Rótulo	Deve ser zero
Caixa de listagem	Deve ser zero
Caixa de lista suspensa multivalue	Deve ser zero
Caixa de lista de vários valores	Deve ser zero
Página com tabbed	Deve ser zero
Botão de rádio	Deve ser zero