MaskedEdit (control)
MaskedEdit Control es un control de campo de edición que contiene una máscara en el campo de texto del control. Para asociar el control a una propiedad de valor de cadena, escriba el nombre de propiedad en la columna Propiedad de la tabla de control de .
Puede usar el control MaskedEdit para crear una plantilla para la entrada de información del usuario, como un número de teléfono o un código de id. de producto. Por ejemplo, el usuario puede escribir el PIDKEY Property a través de un control MaskedEdit especificado estableciendo el PIDTemplate Property en una cadena similar a la siguiente:
12345<### :%%%%%%%>@@@@@
La cadena define la plantilla de enmascaramiento para la entrada del PIDKEY Property por el usuario. El segmento visible de la cadena se incluye entre un par de caracteres de corchete (<>).
En la tabla siguiente se identificó la sintaxis de la máscara.
Carácter | Significado |
---|---|
< | Extremo izquierdo del segmento visible de la plantilla. Este carácter y todo lo que se encuentra a su izquierda están ocultos en la interfaz de usuario. No debe haber más de una instancia de este carácter en la plantilla. |
> | Extremo derecho del segmento visible de la plantilla. Este carácter y todo a su derecha están ocultos en la interfaz de usuario. Este carácter se reemplaza por un guión durante la validación. Si hay un segmento visible comienza con <, debe finalizarse con un >coincidente. |
# | Este carácter puede ser un dígito (numeral). |
% | Este carácter puede ser un dígito alternativo (numeral) que permite que la máscara controle la forma en que una acción personalizada diferencia los campos. |
@ | Este carácter puede ser un dígito aleatorio (numeral). Este carácter no debe aparecer en la parte visible de la plantilla. |
& | Este carácter puede ser cualquier carácter. |
^ | Este carácter puede ser un carácter alternativo que permite que la máscara controle la forma en que una acción personalizada diferencia los campos. |
? | Este carácter puede ser un carácter alternativo que permite que la máscara controle la forma en que una acción personalizada diferencia los campos. |
` | Las marcas de énfasis grave ' (valor ASCII 96) pueden representar un carácter alternativo que permite que la máscara controle la forma en que una acción personalizada diferencia los campos. |
_ | Este carácter es un carácter de subrayado literal. |
= | Este carácter es el terminador de campo. Esto debe seguir un archivo #, %, ^o '. Esto crea una posición de entrada más del mismo tipo que las posiciones anteriores y finaliza el campo con un separador "-". |
Cualquier otro carácter se trata como una constante literal.
Para los caracteres que se pueden editar, el control crea ventanas de edición independientes con una ventana para cada bloque de caracteres contiguos del mismo tipo.
Atributos de control
Para cambiar el valor de un atributo que usa un evento, suscríbase el control a un evento Control en el EventMapping Table y enumere el identificador de atributo en la columna Atributo. Escriba el identificador del evento Control en la columna Evento. Puede usar los atributos siguientes con el control MaskedEdit.
Atributo | Hexadecimal Bit | Descripción |
---|---|---|
IndirectPropertyName | Este es el nombre de una propiedad indirecta asociada al control . Si se establece el bit de atributo indirecto, el control muestra o cambia el valor de la propiedad que tiene este nombre. Si se establece el bit de atributo indirecto, este nombre también es el valor de la propiedad que aparece en la columna Propiedad de la tabla de control de . | |
posición | Posición del control en el cuadro de diálogo. Escriba el ancho del control, el alto y las coordenadas de la esquina izquierda del control en las columnas Width, Height, X e Y de la tabla de control de . Use unidades del instalador para la longitud y la distancia. |
|
PropertyName de | Este es el nombre de la propiedad asociada a este control. Si no se establece el bit de atributo indirecto, el control muestra o cambia el valor de la propiedad que tiene este nombre. Este atributo se especifica en la columna Propiedad de la tabla de control de . | |
PropertyValue | Valor actual de la propiedad que muestra o cambia este control. Si no se establece el bit de atributo indirecto, este es el valor de PropertyName. Si se establece el bit de atributo indirecto, este es el valor de IndirectPropertyName. Si el atributo cambia, el control refleja el nuevo valor. | |
text | Para establecer el estilo de fuente y fuente de una cadena de texto, prefijo la cadena de caracteres mostrados con {\style} o {&style}. Donde style es un identificador que aparece en la columna Style de la tabla TextStyle de . Si ninguno de estos elementos está presente, pero el DefaultUIFont Property se define como un estilo de texto válido, esa fuente se usa. La cadena que especifica la plantilla de enmascaramiento sigue este prefijo y usa la sintaxis descrita anteriormente en este tema. | |
visible | 0x00000000 0x00000001 |
Control oculto. Control visible. Incluya este bit en la palabra bit de la columna Atributos de la tabla de control para que el control esté visible o oculto cuando se cree. También puede ocultar o mostrar un control mediante el tabla ControlCondition. |
habilitado para | 0x00000000 0x00000002 |
Controlar en un estado deshabilitado. Controlar en un estado habilitado. Incluya este bit en la palabra bit de la columna Atributos del tabla de control para habilitar el control sobre la creación. También puede habilitar o deshabilitar un control mediante el tabla ControlCondition. |
hundido | 0x00000000 0x00000004 |
Muestra el estilo visual predeterminado. Muestra el control con un aspecto 3D hundido. Incluya estos bits en la palabra bit de la columna Atributos de la tabla de control de . |
indirecto | 0x00000000 0x00000008 |
El control muestra o cambia el valor de la propiedad en la columna Propiedad del Tabla de control. El control muestra o cambia el valor de la propiedad que tiene el identificador enumerado en la columna Propiedad de la tabla de control de . Determina si la propiedad asociada a este control se hace referencia indirectamente. |
Observaciones
MaskedEdit Control crea una ventana primaria de la BUTTON clase con los estilos BS_OWNERDRAW y WS_EX_CONTROLPARENT. Crea varias ventanas secundarias en esta ventana.
- Para las partes de texto constante, crea ventanas ESTÁTICAs con los estilos SS_LEFT y WS_CHILD.
- Para los campos editables, crea una ventana EDIT con los estilos WS_CHILD, WS_BORDERy WS_TABSTOP.
- Para los campos numéricos, la ventana también tiene el estilo ES_NUMBER.
Los campos de dígito alternativo, %y alfanuméricos alternativos, ^, ?y ' permiten que las acciones personalizadas diferencien entre campos de una manera que se pueda controlar mediante la máscara, por ejemplo, ^ se puede usar para los campos que deben estar en mayúsculas.