Propriedade Canônica PidTagControlFlags
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 |
Recursos relacionados
Arquivos de cabeçalho
Mapidefs.h
Fornece definições de tipo de dados.
Mapitags.h
Contém definições de propriedades listadas como nomes alternativos.