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 Property da tabela Control.
Use o controle MaskedEdit para criar um modelo para a entrada de informações do usuário, como um número de telefone ou o código de ID do produto. Por exemplo, a propriedade PIDKEY pode ser inserida pelo usuário por meio de um controle MaskedEdit especificado pela definição da propriedade PIDTemplate como uma cadeia de caracteres da seguinte forma:
12345<### -%%%%%%%>@@@@@
A cadeia de caracteres define o modelo de mascaramento para a entrada da propriedade PIDKEY pelo usuário. O segmento visível da cadeia de caracteres é delimitado por um par de caracteres de colchete (<>).
A tabela a seguir identificou a sintaxe da máscara.
| Caractere | Significado |
|---|---|
| < | A extremidade esquerda do segmento visível do modelo. Esse caractere e tudo à esquerda dele ficam 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 dele ficam ocultos na interface do usuário. Esse caractere é substituído por um traço durante a validação. Se houver um segmento visível que começa com <, ele precisará ser terminado 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 os campos. |
| @ | Esse caractere pode ser um dígito aleatório (numeral). Ele 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 os campos. |
| ? | Esse caractere pode ser um caractere alternativo que permite que a máscara controle a maneira como uma ação personalizada diferencia os 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 os campos. |
| _ | Esse caractere é um caractere de sublinhado literal. |
| = | Esse caractere é o terminador de campo. Ele precisa vir após #, %, ^ ou '. Isso cria mais uma posição de entrada do mesmo tipo das posições anteriores e termina o campo com o separador '-'. |
Qualquer outro caractere é tratado como uma constante literal.
Para os 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 usa um evento, assine o controle em um evento Control na tabela EventMapping e liste o identificador de atributo na coluna Attribute. Insira o identificador do evento Control na coluna Event. Use os atributos a seguir com o controle MaskedEdit.
| Atributo | Bit hexadecimal | Descrição |
|---|---|---|
| IndirectPropertyName | Esse é o nome de uma propriedade indireta associada ao controle. Se o bit de atributo indireto for definido, o controle vai exibir ou alterar o valor da propriedade que tem esse nome. Se o bit de atributo indireto for definido, esse nome também será o valor da propriedade listada na coluna Property da tabela Control. | |
| 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 Control. Use Unidades do instalador para definir o comprimento e a distância. |
|
| PropertyName | Esse é o nome da propriedade associada a esse controle. Se o bit do atributo Indirect não for definido, o controle vai exibir ou alterar o valor da propriedade que tem esse nome. Esse atributo é especificado na coluna Property da tabela Control. | |
| PropertyValue | Valor atual da propriedade que é exibida ou alterada por esse controle. Se o bit do atributo Indirect não for definido, esse será o valor de PropertyName. Se o bit do atributo Indirect for definido, esse será o valor de IndirectPropertyName. Se o atributo for alterado, o controle refletirá o novo valor. | |
| Texto | Para definir a fonte e o estilo da fonte de uma cadeia de texto, acrescente à cadeia de caracteres exibidos o prefixo {\style} ou {&style}. Sendo que style é um identificador listado na coluna Style da tabela TextStyle. 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 mascaramento segue esse prefixo e usa a sintaxe já descrita neste tópico. | |
| Visível | 0x00000000 0x00000001 |
Controle oculto. Controle visível. Inclua esse bit na palavra de bit da coluna Attributes na tabela Control 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. |
| Enabled | 0x00000000 0x00000002 |
Controle em um estado desabilitado. Controle em um estado habilitado. Inclua esse bit na palavra de bit na coluna Attributes da tabela Control para habilitar o controle na criação. Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition. |
| Sunken | 0x00000000 0x00000004 |
Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D em baixo-relevo. Inclua esses bits da palavra de bit da coluna Attributes da tabela Control. |
| Indireto. | 0x00000000 0x00000008 |
O controle exibe ou altera o valor da propriedade na coluna Property da tabela Control. O controle exibe ou altera o valor da propriedade que tem o identificador listado na coluna Property da tabela Control. Determina se a propriedade associada a esse controle é referenciada indiretamente. |
Comentários
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 essa janela.
- Em partes de texto constantes, ele cria janelas STATIC com os estilos SS_LEFT e WS_CHILD.
- Em campos editáveis, ele cria uma janela EDIT com os estilos WS_CHILD, WS_BORDER e WS_TABSTOP.
- Em campos numéricos, a janela também tem o estilo ES_NUMBER.
Os campos de dígito alternativo, %, e de caracteres alfanuméricos alternativos, ^, ? e ` permitem que ações personalizadas diferenciem os campos de uma forma que possa ser controlada pela máscara, por exemplo, ^ pode ser usado para campos que devem ter letras maiúsculas.