Controle MaskedEdit
O Controle MaskedEdit é um controle de campo de edição que contém uma máscara no campo de texto do controle. Você pode associar o controle a uma propriedade de valor de cadeia de caracteres inserindo o nome da propriedade na coluna Propriedade da tabela de controle .
Você pode usar o Controle MaskedEdit para criar um modelo para entrada de informações do usuário, como um número de telefone ou código de ID do produto. Por exemplo, a propriedade PIDKEY pode ser inserida pelo usuário por meio de um Controle MaskedEdit especificado definindo a Propriedade PIDTemplate para uma cadeia de caracteres como a seguinte:
12345<### -%%%%%%%>@@@@@
A cadeia de caracteres define o modelo de máscara para a entrada da propriedade PIDKEY pelo usuário. O segmento visível da cadeia de caracteres é colocado por um par de caracteres de colchete (<>).
A tabela a seguir identificou a sintaxe da máscara.
| Personagem | Significado |
|---|---|
| < | A extremidade esquerda do segmento visível do modelo. Esse caractere e tudo à esquerda estão ocultos na interface do usuário. Não deve haver mais de uma instância desse caractere no modelo. |
| > | A extremidade direita do segmento visível do modelo. Esse caractere e tudo à direita estão ocultos na interface do usuário. Esse caractere é substituído por um traço durante a validação. Se houver um segmento visível iniciado com <, ele deverá ser encerrado com um >correspondente. |
| # | Esse caractere pode ser um dígito (numeral).) |
| % | Esse caractere pode ser um dígito alternativo (numeral) que permite que a máscara controle a maneira como uma ação personalizada diferencia campos. |
| @ | Esse caractere pode ser um dígito aleatório (numeral).) Esse caractere não deve aparecer na parte visível do modelo. |
| & | Esse caractere pode ser qualquer caractere. |
| ^ | Esse caractere pode ser um caractere alternativo que permite que a máscara controle a maneira como uma ação personalizada diferencia campos. |
| ? | Esse caractere pode ser um caractere alternativo que permite que a máscara controle a maneira como uma ação personalizada diferencia campos. |
| ` | As marcas de acento grave ' (valor ASCII 96) podem representar um caractere alternativo que permite que a máscara controle a maneira como uma ação personalizada diferencia campos. |
| _ | Esse caractere é um caractere de sublinhado literal. |
| = | Esse caractere é o terminador de campo. Isso deve seguir um #, %, ^ou '. Isso cria mais uma posição de entrada do mesmo tipo que as posições anteriores e termina o campo com um separador '-'. |
Qualquer outro caractere é tratado como uma constante literal.
Para caracteres que podem ser editados, o controle cria janelas de edição separadas com uma janela para cada bloco de caracteres contíguos do mesmo tipo.
Atributos de controle
Para alterar o valor de um atributo que está usando um evento, assine o controle em um evento control no tabela EventMapping e liste o identificador de atributo na coluna Atributo. Insira o identificador do evento Control na coluna Evento. Você pode usar os seguintes atributos com o Controle MaskedEdit.
| Atributo | Hexadecimal Bit | Descrição |
|---|---|---|
| indirectPropertyName | Esse é o nome de uma propriedade indireta associada ao controle. Se o bit de atributo indireto for definido, o controle exibirá ou alterará o valor da propriedade que tem esse nome. Se o bit de atributo indireto estiver definido, esse nome também será o valor da propriedade listada na coluna Propriedade da tabela de controle . | |
| de Posição | Posição do controle na caixa de diálogo. Insira a largura do controle, a altura e as coordenadas do canto esquerdo do controle nas colunas Width, Height, X e Y da tabela de controle . Use de Unidades do Instalador para comprimento e distância. |
|
| PropertyName | Esse é o nome da propriedade associada a esse controle. Se o bit de atributo indireto não estiver definido, o controle exibirá ou alterará o valor da propriedade que tem esse nome. Esse atributo é especificado na coluna Propriedade da tabela de controle . | |
| PropertyValue | Valor atual da propriedade que é exibida ou alterada por esse controle. Se o bit de atributo indireto não estiver definido, esse será o valor de PropertyName. Se o bit de atributo indireto estiver definido, esse será o valor de IndirectPropertyName. Se o atributo for alterado, o controle refletirá o novo valor. | |
| de Texto | Para definir a fonte e o estilo de fonte de uma cadeia de caracteres de texto, prefixe a cadeia de caracteres exibida com {\style} ou {&style}. Onde o estilo é um identificador listado na coluna Estilo do de TabelaTextStyle. Se nenhum deles estiver presente, mas a propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada. A cadeia de caracteres que especifica o modelo de máscara segue esse prefixo e usa a sintaxe descrita anteriormente neste tópico. | |
| Visíveis | 0x00000000 0x00000001 |
Controle oculto. Controle visível. Inclua esse bit na palavra bit da coluna Atributos na tabela de controle para tornar o controle visível ou oculto quando ele for criado. Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition. |
| habilitado | 0x00000000 0x00000002 |
Controlar em um estado desabilitado. Controlar em um estado habilitado. Inclua esse bit na palavra bit na coluna Atributos da tabela de controle para habilitar o controle na criação. Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition. |
| submersa | 0x00000000 0x00000004 |
Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D submersa. Inclua esses bits na palavra bit na coluna Atributos da tabela de controle . |
| Indireto | 0x00000000 0x00000008 |
O controle exibe ou altera o valor da propriedade na coluna Propriedade da tabela de controle . O controle exibe ou altera o valor da propriedade que tem o identificador listado na coluna Propriedade da tabela de controle . Determina se a propriedade associada a esse controle é referenciada indiretamente. |
Observações
O Controle MaskedEdit cria uma janela pai da classe BUTTON com os estilos BS_OWNERDRAW e WS_EX_CONTROLPARENT. Ele cria várias janelas filho para esta janela.
- Para partes de texto constantes, ele cria janelas ESTÁTICAs com os estilos SS_LEFT e WS_CHILD.
- Para campos editáveis, ele cria uma janela EDIT com os estilos WS_CHILD, WS_BORDERe WS_TABSTOP.
- Para campos numéricos, a janela também tem o estilo ES_NUMBER.
Os campos de dígito alternativo, %e caracteres alfanuméricos alternativos, ^, ?e ' permitem que ações personalizadas diferenciem entre campos de uma maneira que possa ser controlada pela máscara, por exemplo, ^ pode ser usado para campos que devem ser maiúsculos.