AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Propiedades WLanguage / Propiedades de ventanas, páginas y controles
  • 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
  • Limitaciones
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
El DisplayMask Property se utiliza para:
  • 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 foco.
El DisplayMask Property se aplica a:
  • Controles de edición numéricos, de moneda, de fecha, de hora y de duración.
  • Columnas numéricas, de moneda, de fecha, de hora y de 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.
AndroidiPhone/iPadIOS Widget Observación: Esta Property está disponible para las columnas de una control Tabla en las aplicaciones Android y 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 una control Ocultar los detalles

<Result> = <Control used>.DisplayMask
<Result>: Constante o cadena de caracteres
La máscara de visualización de la control especificada. La máscara de visualización depende del tipo de control. Para más detalles, consulte la página web de comentarios.
<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, consulte la página web de 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 la 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
maskBitcoinMáscara de entrada numérica utilizada para Bitcoins. Aparece el símbolo de Bitcoin.
WINDEV Mobile Esta constante no está disponible.
maskFileSizeMáscara numérica para los tamaños de archivo y disco.
Observación: 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.
maskScientificMáscara de entrada numérica para la notación científica.
WINDEV Mobile Esta constante no está disponible.
maskSystemNumeralMáscara numérica utilizada por el sistema.
Corresponde a la máscara seleccionada en la configuración regional del sistema ("Opciones regionales" en el panel de control).

Ejemplos:
// File size mask
EDT_Edit1.DisplayMask = maskFileSize
EDT_Edit1 = 5681234 // Displays 5,68 MB
// Bitcoin mask
EDT_Edit2.DisplayMask = maskBitcoin
EDT_Edit2 = 5681234 // Displays 0,05 681 234 B
// Scientific mask
EDT_Edit3.DisplayMask = maskScientific
EDT_Edit3 = 5681234 // Displays 5,681234E+06
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 el código (independientemente del idioma):
  • " "(espacio) se sustituye por el separador de miles
  • "," (coma) se sustituye por el separador decimal
  • "$" se sustituye por el símbolo de la moneda (escriba "$$" para evitar esta sustitución)
3. Máscaras de visualización especiales a medida
  • Con el símbolo %:
    El valor asignado mediante programación a la 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 de la control mediante 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: Puede especificar una Color utilizando [<Color>] junto a la máscara deseada. <Color> puede corresponder a:
    • una de las siguientes constantes: Rojo, Verde, Azul, Negro, White, 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 el Color Property. Se ignora si el control es Grayed.
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:
maskSystemCurrencyMáscara de moneda utilizada por el sistema. Corresponde a la máscara seleccionada en la configuración regional 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 de la semana correspondiente, por ejemplo, "jueves"). Las mayúsculas y minúsculas dependen de las opciones de idioma del proyecto.
  • "Dddd" (día de la semana con la primera letra en mayúscula, por ejemplo: Lunes)
  • "dddd" (día de la semana con la primera letra en minúscula, por ejemplo: lunes)
  • "DDD" (abreviatura del día de la semana, "Thu" por ejemplo). Las mayúsculas y minúsculas dependen de las opciones de idioma del proyecto.
  • "Ddd" (abreviatura del día de la semana con la primera letra en mayúscula, por ejemplo: Lun)
  • "ddd" (abreviatura del día de la semana con la primera letra en minúscula, por ejemplo: lun)
  • "MM" (mes en dígitos, por ejemplo: 12)
  • "MMMM" (mes no abreviado, por ejemplo "enero"). Las mayúsculas y minúsculas dependen de las opciones de idioma del proyecto.
  • "Mmmm" (mes escrito con la primera letra en mayúscula, por ejemplo: Enero)
  • "mmmm" (mes escrito con la primera letra en minúscula, por ejemplo: enero)
  • "MMM" (abreviatura del mes, "Jan" por ejemplo). Las mayúsculas y minúsculas dependen de las opciones de idioma del proyecto.
  • "Mmm" (abreviatura del mes con la primera letra en mayúscula, por ejemplo: Ene)
  • "mmm" (abreviatura del mes con la primera letra en minúscula, por ejemplo: jan)
  • "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:
    maskDateEmailEl formato utilizado corresponde al formato de fecha del estándar RFC-5322 utilizado para cifrar un correo electrónico, una fuente RSS, etc., ...
    El resultado se expresa en la zona horaria local.
    AndroidJava No disponible.
    maskDateEmailUTCEl formato utilizado corresponde al formato de fecha del estándar RFC-5322 utilizado para cifrar un correo electrónico, una fuente RSS, etc., ...
    El resultado se expresa en tiempo universal (UTC).
    AndroidJava No disponible.
    maskDateInternetEl formato utilizado corresponde al estándar RFC-3339 utilizado para comunicaciones internacionales.
    El resultado se expresa en la zona horaria local.
    maskDateInternetUTCEl formato utilizado corresponde al estándar RFC-3339 utilizado para comunicaciones internacionales.
    El resultado se expresa en tiempo universal (UTC).
    maskDateRelativeDurationMáscara utilizada para expresar el tiempo transcurrido (o que transcurrirá) entre la fecha de hoy 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".
    maskDateSystem
    Máscara de sistema definida en el proyecto description 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 las configuraciones del sistema regional ("Opciones regionales" en el panel de control).
    maskSystemTimeMá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 la columna control (o tabla) a Fecha (pestaña "Detalles" de la ventana description de la columna control o).
  2. Cambiar la máscara de visualización de este control o columna (pestaña "Detalles" de la ventana del control o columna description, o DisplayMask Property).

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).
  • A: 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).
  • S: 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 sustituida por una máscara del tipo same. Por ejemplo, la máscara de visualización de una FECHA control no puede ser sustituida por la máscara de visualización de una HORA control.
Asignar una máscara de visualización incorrecta provocará un mensaje de error.

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

Las expresiones regulares utilizadas en esta Property no deben ser las utilizadas en MatchRegularExpression.
En las máscaras de visualización, las expresiones regulares impiden que se muestren determinados caracteres o secuencias de caracteres.
En MatchRegularExpression, se utilizan expresiones regulares para comprobar el formato de las cadenas.
Ejemplo: Comprobando si la cadena T1 contiene una letra y un dígito:
  • con la función MatchRegularExpression: la expresión regular utilizada es [ A-Za-z][ 0-9]
  • con el DisplayMask Property: la expresión regular utilizada es [ A-Za-z]{0,1}[ 0-9]{0,1}

Limitaciones

En una ventana, el DisplayMask Property se aplica sólo 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.
El DisplayMask Property no se aplica a los controles en un reporte.
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

Última modificación: 09/07/2022

Señalar un error o enviar una sugerencia | Ayuda local