PC SOFT

AYUDA EN LÍNEA
DE WINDEV, WEBDEV Y WINDEV MOBILE


Este contenido proviene de una traducción automática.. Haga clic aquí para ver la versión original en inglés.
  • Controles numéricos (excepto los controles de divisas)
  • Controles monetarios
  • Controles de Moneda + Euro
  • Controles de fecha
  • Controles de tiempo
  • Controles de DateTime
  • Controles de duración
  • Tipo de máscara de visualización
  • Las expresiones regulares en las máscaras de exhibición
  • Límites
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Otros
Procedimientos almacenados
La propiedad ..DisplayMask permite:
  • Averigua la máscara de visualización.
  • Modificar la máscara de visualización.
Esta máscara de visualización se muestra cuando el control está en sólo lectura o cuando el control no tiene enfoque.
La propiedad ..DisplayMask se aplica a:
  • los controles de edición Numérico, Moneda, Fecha, Hora y Duración.
  • las columnas Numérico, Moneda, Fecha, Hora y Duración de una control Tabla.
  • WINDEVWindows a controles Combo Box editables o no editables.
  • WINDEVWindows de un control Tabla mostrado por los controles Combo Box.
Versiones 20 y posteriores
WINDEV MobileAndroidiPhone/iPad Esta propiedad está ahora disponible para las columnas de tabla en las aplicaciones de Android y iPhone/iPad.
AndroidiPhone/iPad Observación: Esta propiedad está disponible para las columnas de una control Tabla en aplicaciones Android e iPhone/iPad.
Nueva funcionalidad versión 20
WINDEV MobileAndroidiPhone/iPad Esta propiedad está ahora disponible para las columnas de tabla en las aplicaciones de Android y iPhone/iPad.
AndroidiPhone/iPad Observación: Esta propiedad está disponible para las columnas de una control Tabla en aplicaciones Android e iPhone/iPad.
WINDEV MobileAndroidiPhone/iPad Esta propiedad está ahora disponible para las columnas de tabla en las aplicaciones de Android y iPhone/iPad.
AndroidiPhone/iPad Observación: Esta propiedad está disponible para las columnas de una control Tabla en aplicaciones Android e iPhone/iPad.
Ejemplo
EDT_DATE..InputMask = "DD/MM/YYYY"
EDT_DATE..DisplayMask = "DDD, D MMMM YYY"  // ex: "Tuesday, 3 March 2011"
WINDEVWindows
// Modify the mask of a column in a Table control displayed by a Combo Box
COMBO_TableInput.COL_DateCol..DisplayMask = "DDD, the D MMMM YYY"
Sintaxis

Descubrir la máscara de visualización de un control Ocultar los detalles

<Result> = <Control used>..DisplayMask
<Result>: Constante o cadena de caracteres
Máscara de visualización del control especificado. La máscara de visualización depende del tipo de control. Vea la observaciones para más detalles.
<Control used>: Nombre del control
Nombre del control a manipular.

Modificar la máscara de visualización de un control Ocultar los detalles

<Control used>..DisplayMask = <New display mask>
<Control used>: Nombre del control
Nombre del control a manipular.
<New display mask>: Constante o cadena de caracteres
Nueva máscara de visualización para el control especificado. La máscara de visualización depende del tipo de control. Para más detalles, ver la observaciones.
Si este parámetro corresponde a una cadena vacía (""), la máscara de visualización será idéntica a la máscara de entrada definida para el control.
Observaciones

Controles numéricos (excepto los controles de divisas)

Hay tres tipos de máscaras disponibles:
  1. Máscaras de visualización preestablecidas
  2. Máscaras de visualización personalizadas
  3. Máscaras de visualización especiales personalizadas
1. Máscaras de visualización de configuraciones prefijadas
maskFileSizeMáscara numérica para los tamaños de archivo y disco.
maskSystemNumeralMáscara numérica utilizada por el sistema. Corresponde a la máscara seleccionada en los ajustes regionales del sistema ("Opciones regionales" en el panel de control).
Ejemplo:
EDT_Edit1..DisplayMask = maskFileSize
EDT_Edit1 = 5681234 // Displays 5,68 MB
El cambio de unidad (de KB a MB por ejemplo) se realiza para cada múltiplo de 1024. Por lo tanto, la máscara puede mostrar 1003 KB.
2. Máscaras de visualización personalizadas
Las máscaras de visualización se definen utilizando los siguientes caracteres: "9", ".", ", ",", "+" y "-", "$" y espacios en blanco.
Por ejemplo: "99.999,99".
Las máscaras de visualización tienen en cuenta el separador de decimales, el separador de miles y el símbolo de la moneda definido para el idioma.
En programación (independientemente del idioma):
  • " " (espacio) es reemplazado por el separador de mil
  • "," (coma) es reemplazado por el separador decimal
  • "$" se sustituye por el símbolo de moneda (escriba "$$" para evitar esta sustitución)
3. Máscaras de visualización especiales a medida
  • Con el símbolo %:
    El valor asignado por la programación al control se multiplica por 100 y se muestra el símbolo "%"..
    Puedes escribir "%%" para mostrar el % de carácter sin multiplicar el valor por 100.
    Ejemplo: Asignación del control por programación
    EDT_Edit1..DisplayMask = "999,9%"
    EDT_Edit1 = 0.562 // Displays 56,2 %

    EDT_Edit1..DisplayMask = "999,9%%"
    EDT_Edit1 = 0.562 // Displays 0,6 %
  • Uso de paréntesis: visualización de los números negativos.
    Ejemplo:
    EDT_Edit1..DisplayMask = "(999 999)"
    EDT_Edit1 = -1234      // Displays (1 234)
    EDT_Edit1 = 1234       // Displays 1 234
  • Usando el signo - al final de la cadena: mostrar números negativos (capacidad de escribir "--" para mostrar el signo - al final de la cadena)
    Ejemplo:
    EDT_Edit1..DisplayMask = "999 999 -"
    EDT_Edit1 = -1234      // Displays 1 234-
  • Máscara de visualización múltiple: máscara de visualización utilizada para definir el formato de los números positivos, el formato de los números negativos, el valor si se utiliza 0, el valor si se utiliza NULL. Se utiliza la siguiente sintaxis:
    <Formato de números positivos>;<Formato de números negativos>;<Valor si 0>;<Valor si NULL>
    Ejemplo:
    EDT_Edit1..DisplayMask = "999 999;-999 999;0;<NULL>"
    EDT_Edit1 = -1234      // Displays - 1 234

    Observación: Se puede especificar un color utilizando [<Color>] al lado de la máscara deseada. <Color> puede corresponder a:
    • una de las siguientes constantes: Rojo, Verde, Azul, Negro, Blanco, Amarillo, Naranja
    • un valor hexadecimal en formato "#BBGGRR".
    Ejemplo:
    EDT_Edit1..DisplayMask = "999 999;-999 999[Red];0;<NULL>"
    EDT_Edit1 = -1234      // Displays - 1 234 in red

    EDT_Edit1..DisplayMask = "999 999;-999 999[#FF0000];0;<NULL>"
    EDT_Edit1 = -1234      // Displays - 1 234 in blue

    Observación: El color especificado en la máscara de visualización tiene prioridad sobre ..Color. Se ignora si el control está en gris.
Observaciones:
  • Si desea que el número se llene de ceros a la izquierda, utilice el carácter "0" a la izquierda de la máscara.. Por ejemplo: "099.999,99".
  • Si desea que la parte decimal del número se llene de ceros, utilice el carácter "9" a la derecha del punto decimal.. Por ejemplo, cuando se utiliza la máscara "9999,99000", el número 12 se visualiza como "12,00" y no como "12,00000"..
    Sin embargo, el número "12.368" se visualiza correctamente: su valor se mantiene, sin ser truncado o redondeado.
  • Para forzar los signos, utilice el carácter "+" a la izquierda. Por ejemplo: "+9999"

Controles monetarios

Las máscaras de visualización y las máscaras numéricas tienen el mismo tipo. La diferencia está en la precisión: las monedas tienen 17 dígitos significativos para la parte entera y hasta 6 dígitos para la parte decimal.
Por ejemplo: "99 999 999 999 999 999,999999".
Observación: También se puede utilizar una máscara de preajuste para los controles de Moneda:
máscaraSistemaMoneda Máscara de divisas utilizada por el sistema. Corresponde a la máscara seleccionada en los ajustes regionales del sistema ("Opciones regionales" en el panel de control).

Controles de Moneda + Euro

Las máscaras de exhibición y las máscaras de moneda tienen el mismo tipo. El carácter del dólar ("$") puede ser añadido a la máscara para mostrar la moneda actual.
Por ejemplo: "999,99 $" mostrará "250,25 E" si la moneda actual es el Euro.

Controles de fecha

Las máscaras de visualización para los controles de fecha son:
  • una máscara personalizada:
    • "DD/MM/AAAA"
    • "DD/MM/AA"
    • "DDD DD"
    • "DD/MM/AAAA"
    • "DD/MM/AA"
    • "AAAA/MM/DD"
    • "AA/MM/DD"
    • "DD/MM/AAAA HH:MM:SS"
    • "MM/DD/AAAA HH:mm:SS"
    • "DD/MM/AAAA HH:mm:SS:CCC"
    • "MM/DD/AAAA HH:mm:SS:CCC"
    • "DDDD DD MMMM AAAA"
    • "Dddd DD Mmmm AAAA"
    • "Dddd DD Mmm AAAA"
Una máscara personalizada puede ser construida a partir de los siguientes elementos:
  • "DD" (correspondiente al día de la semana en dígitos, por ejemplo: 12)
  • "DDDD" (día correspondiente de la semana, "jueves" por ejemplo). El caso utilizado depende de las opciones lingüísticas del proyecto.
  • "Dddd" (correspondiente al día de la semana con la primera letra en mayúsculas, por ejemplo: Lunes)
  • "dddd" (correspondiente al día de la semana con la primera letra en minúsculas, por ejemplo: lunes)
  • "DDD" (abreviatura del día de la semana, "Thu" por ejemplo). El caso utilizado depende de las opciones lingüísticas del proyecto.
  • "Ddd" (abreviatura del día de la semana con la primera letra en mayúsculas, por ejemplo: lun)
  • "ddd" (abreviatura del día de la semana con la primera letra en minúsculas, por ejemplo: lun)
  • "MM" (mes en dígitos, por ejemplo: 12)
  • "MMMM" (mes deletreado, "enero" por ejemplo). El caso utilizado depende de las opciones lingüísticas del proyecto.
  • "Mmmm" (mes deletreado con la primera letra en mayúsculas, por ejemplo: Enero)
  • "mmmm" (mes deletreado con la primera letra en minúsculas, por ejemplo: Enero)
  • "MMM" (abreviatura del mes, "Jan" por ejemplo). El caso utilizado depende de las opciones lingüísticas del proyecto.
  • "Mmm" (abreviatura del mes con la primera letra en mayúsculas, por ejemplo: Ene)
  • "mmm" (abreviatura del mes con la primera letra en minúsculas, por ejemplo: ene)
  • "YYYYY" (año en cuatro dígitos, "2001" por ejemplo)
  • "YY" (dos últimos dígitos del año, "01" por ejemplo)
  • una constante que corresponde a una máscara preestablecida:
    Versiones 18 y posteriores
    maskDateRelativeDuration
    Nueva funcionalidad versión 18
    maskDateRelativeDuration
    maskDateRelativeDuration
    Máscara utilizada para expresar la duración pasada (o la duración futura) entre la fecha del día y la fecha especificada. Esta máscara se expresa en lenguaje natural. Las expresiones se pueden configurar en la descripción del proyecto para el idioma actual:
    1. En la pestaña "Proyecto", en el grupo "Proyecto", haga clic en "Descripción".
    2. En la pestaña "Idiomas":
      • seleccione el idioma que desea configurar.
      • seleccione la pestaña "Fecha".
    3. Haga clic en el botón "Fechas y Horas en lenguaje natural".
    4. Si es necesario, defina los títulos personalizados que desea utilizar. Estos títulos se utilizarán:
      • en el resultado de la función DateToString.
      • para los controles que utilizan la máscara de visualización "Duración relativa".
    Versiones 16 y posteriores
    maskDateEmail
    Nueva funcionalidad versión 16
    maskDateEmail
    maskDateEmail
    El formato utilizado corresponde al formato de fecha del estándar RFC-5322 utilizado para cifrar un correo electrónico, un flujo RSS, ...
    El resultado se expresa en la zona horaria local.
    AndroidJava No disponible.
    Versiones 25 y posteriores
    Máscara maskDateEmailUTC
    Nueva funcionalidad versión 25
    Máscara maskDateEmailUTC
    Máscara maskDateEmailUTC
    El formato utilizado corresponde al formato de fecha del estándar RFC-5322 utilizado para cifrar un correo electrónico, un flujo RSS, ...
    El resultado se expresa en tiempo universal (UTC).
    AndroidJava No disponible.
    Versiones 25 y posteriores
    maskDateInternet
    Nueva funcionalidad versión 25
    maskDateInternet
    maskDateInternet
    El formato utilizado corresponde al estándar RFC-3339 utilizado para las comunicaciones internacionales..
    El resultado se expresa en la zona horaria local.
    Versiones 25 y posteriores
    maskDateInternetUTC
    Nueva funcionalidad versión 25
    maskDateInternetUTC
    maskDateInternetUTC
    El formato utilizado corresponde al estándar RFC-3339 utilizado para las comunicaciones internacionales..
    El resultado se expresa en tiempo universal (UTC).
    maskDateSystemMáscara del sistema, definida en la descripción del proyecto para el idioma actual (Proyecto .. Descripción del proyecto", pestaña "Idiomas").
    La máscara del sistema definida en la descripción del proyecto para el lenguaje actual:
    1. En la pestaña "Proyecto", en el grupo "Proyecto", haga clic en "Descripción".
    2. Seleccione la pestaña "Idiomas" y enseguida la pestaña "Fecha".
    3. El formato utilizado corresponde a:
      • los parámetros del sistema operativo,
      • los parámetros especificados (con los días y meses definidos).
Estas máscaras se pueden combinar. Por ejemplo: "Ddd DD Mmmm YYYYY at HH:mm" devolverá un resultado en el siguiente formato: "Jue 01 Febrero 1979 a las 21:35".

Controles de tiempo

Las máscaras de visualización para los controles de tiempo son:
  • "HH:MM"
  • "HH h MM"
  • "HH:MM:SS"
  • "HH:MM:SS AM": Permite gestionar la hora en formato AM/PM.
  • "HH:MM:SS:CC"
  • La máscara de preajuste corresponde a la hora del sistema. La hora del sistema depende de la máscara seleccionada en los ajustes del sistema regional ("Opciones regionales" en el panel de control)..
    máscaraSystemTimeMáscara utilizada por el sistema durante el tiempo.

Controles de DateTime

Para especificar una máscara de visualización DateTime, debe:
  1. Cambie el tipo de control (o columna tabla) a Date (pestaña "Detalles" en la ventana de descripción del control o columna).
  2. Modifique la máscara de visualización de este control o columna (pestaña "Detalles" de la ventana de descripción del control o columna, o propiedad ..DisplayMask).

Controles de duración

Se pueden utilizar los siguientes elementos para definir una máscara personalizada (distinguiendo entre mayúsculas y minúsculas). Para presentar las máscaras personalizadas, tomemos una duración igual a 0 día 04 horas 15 minutos 03 segundos y 412 milésimas de segundo:
  • +1: sólo se mostrará la unidad más significativa (el número de horas en nuestro ejemplo).
  • +2: sólo se mostrarán las dos unidades más significativas (el número de horas y el número de minutos en nuestro ejemplo).
    Especifique"+3" o"+4" para mostrar las tres o cuatro unidades más significativas.
  • D: el número de días se mostrará si este número es mayor que 0 (el número de días no se mostrará en nuestro ejemplo).
  • H: el número de horas se mostrará si este número (o si el número de días) es mayor que 0. Si este número contiene un solo dígito, este dígito se mostrará (el número de horas será '4' en nuestro ejemplo).
  • HH: el número de horas se mostrará si este número (o si el número de días) es mayor que 0. Si este número contiene un solo dígito, este dígito estará precedido por '0' (el número de horas será '04' en nuestro ejemplo).
  • M: el número de minutos se mostrará si este número (o el número de días, o el número de horas) es mayor que 0. Si este número contiene un solo dígito, este dígito se mostrará (el número de minutos será '15' en nuestro ejemplo).
  • MM: el número de minutos se mostrará si este número (o el número de días, o el número de horas) es mayor que 0. Si este número contiene un solo dígito, este dígito estará precedido por '0' (el número de minutos será '15' en nuestro ejemplo).
  • T: el número de segundos se mostrará si este número (o si el número de días, o el número de horas, o el número de minutos) es mayor que 0. Si este número contiene un solo dígito, este dígito se mostrará (el número de segundos será '3' en nuestro ejemplo).
  • SS: el número de segundos se mostrará si este número (o si el número de días, o el número de horas, o el número de minutos) es mayor que 0. Si este número contiene un solo dígito, este dígito estará precedido por '0' (el número de segundos será '03' en nuestro ejemplo).
  • CC: se mostrará el número de centésimas de segundo (el número de centésimas de segundo será '41' en nuestro ejemplo).
  • CCC: se mostrará el número de milésimas de segundo (el número de milésimas de segundo será '412' en nuestro ejemplo).
Observaciones:
  • Si el separador corresponde al carácter ":", se añadirá la letra correspondiente a la unidad más significativa (h para hora, m para minuto, s para segundo, cs para centésimas de segundo y ms para miles de segundos).
  • Para visualizar una duración en un control Campo de entrada en formato horas/minutos (en lugar de días/horas/minutos), debe definir una máscara como la siguiente: "+5 HHhMMm", donde "+5" indica el número de dígitos que deben mostrarse para las horas..

Tipo de máscara de visualización

Una máscara puede ser reemplazada por una máscara del tipo mismo escribir a máquina. Por ejemplo, la máscara de visualización de un control de FECHA no puede ser sustituida por la máscara de visualización de un control de HORA.
Asignar una máscara de visualización incorrecta le dará a trigger un mensaje de error.

Las expresiones regulares en las máscaras de exhibición

Las expresiones regulares utilizadas en esta propiedad no deben ser las utilizadas en MatchRegularExpression.
En las máscaras de visualización, las expresiones regulares se utilizan para impedir que se teclee algún carácter específico o una secuencia de caracteres.
En MatchRegularExpression, las expresiones regulares se utilizan para comprobar si una cadena cumple con un formato.
Ejemplo: Comprobando si la cadena T1 contiene una letra y un dígito:
  • con MatchRegularExpression: la expresión regular utilizada es [ A-Za-z][ 0-9]
  • con ..DisplayMask: la expresión regular es [ A-Za-z]{0,1}[ 0-9]{0,1}

Límites

En una ventana, la propiedad ..DisplayMask solo se aplica a:
  • Controles de edición Numérico, Moneda, Fecha, Hora y Duración,
  • Columnas numéricas, de moneda, fecha, hora y duración de una control Tabla,
  • grupos de controles de edición,
  • WINDEVWindows controles Combo Box editables o no editables.
  • WINDEVWindows de un control Tabla mostrado por los controles Combo Box.
Versión mínima requerida
  • Versión 17
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario