Decimal

Permite a los usuarios especificar o ver solo valores decimales. Utilice los valores de configuración de esta vista para especificar el formato del número decimal visualizado.

Enlace de datos

Defina o modifique el enlace de datos para la vista en la pestaña de propiedades Generales. La vista Decimal puede estar vinculada a una variable de tipo Decimal.

Propiedades de configuración

En Configuración, establezca o modifique las propiedades de aspecto y comportamiento de la vista. En Sucesos, establezca las propiedades de configuración de la fórmula.

Tamaño de pantalla
Una propiedad de configuración que tenga el icono Tamaños de pantalla El icono Tamaños de pantalla junto al nombre de propiedad puede tener distintos valores para cada tamaño de pantalla. Si no define un valor, el tamaño de la pantalla hereda el valor del siguiente tamaño de pantalla más grande como valor predeterminado.
Definiciones de temas
Las definiciones de temas especifican los colores y los estilos de una vista y determinan su aspecto. Puede obtener una vista previa del aspecto de las vistas en el editor de temas. Consulte Temas.
Las propiedades de configuración de aspecto para Decimal están listadas en la tabla siguiente:
Tabla 1. Propiedades de configuración de aspecto para Decimal
Propiedad de configuración del aspecto Descripción Tipo de datos
Ancho El icono Tamaños de pantalla El ancho de la vista. Puede especificar el ancho en px (píxeles), % (porcentaje) o en unidades. Por ejemplo, 50px, 20% o 0,4em. Si no se especifica ningún tipo de unidad, se asume px. String
Tamaño El icono Tamaños de pantalla El tamaño del texto en la vista. String
Colocación de etiqueta El icono Tamaños de pantalla La colocación de etiqueta para esta vista. Si la colocación de etiqueta es a la izquierda, se cambia la anchura especificada de la vista. String
Ancho de etiqueta Icono de pantalla grande El ancho de la etiqueta. Puede especificar el ancho en px (píxeles), % (porcentaje) o en unidades. Por ejemplo, 50px, 20% o 0,4em. Si no se especifica ningún tipo de unidad, se asume px. String
Las propiedades de configuración del comportamiento para Decimal están listadas en la tabla siguiente:
Tabla 2. Propiedades de configuración del comportamiento para Decimal
Propiedad de configuración del comportamiento Descripción Tipo de datos
Índice de pestañas El índice de secuencia de pestañas. Los índices de tabulado empiezan en 1 y se pueden establecer de forma dispersa. Por ejemplo, puede utilizar 1, 5, 10. La propiedad Índice de pestañas controla la secuencia de las pestañas al desplazarse entre las distintas áreas de interfaz de usuario pulsando la tecla Tabulador. Integer
Texto de marcador El texto de marcador que se visualiza cuando no se especifica ningún valor. String
Formato numérico Determina si el separador de millares y el separador decimal se basan en la configuración regional del usuario actual o se especifican como opciones de configuración personalizada. Las opciones disponibles son Automático y Personalizado. String
Ocultar separador de millares Oculta el separador de miles. Boolean
Separador de miles Separa los millares en agrupaciones de dígitos. Generalmente, se utiliza una coma como separador de millares. Según la configuración regional del usuario, se pueden utilizar otros símbolos (como por ejemplo puntos) o caracteres personalizados como separadores de millares. String
Separador de decimales Separa la parte integral de la parte fraccional de un número decimal. Generalmente, se utiliza un punto como separador decimal. Según la configuración regional del usuario, se pueden utilizar otros símbolos (como por ejemplo comas) o caracteres personalizados como separador decimal. String
Posiciones decimales El número máximo de lugares decimales que se mostrarán. Integer
Moneda La moneda para la que está formateado el número decimal.
  • Cuando se especifica un valor de Moneda, el formato de moneda sobrescribe los valores que se hayan especificado en Separador de millares y Separador decimal.
  • En su lugar, para especificar un formato personalizado para los números decimales, utilice las propiedades de configuración Prefijo y Postfijo.
String
Símbolo de moneda El símbolo de moneda cuyo valor altera temporalmente el valor de Moneda. En su lugar, para especificar un formato personalizado para los números decimales, utilice las propiedades de configuración Prefijo y Postfijo. String
Prefijar Un símbolo que precede los valores de entrada numéricos. String
Postfijo Un símbolo que sucede a los valores de entrada numéricos. String

Ejemplo

Para especificar el formato de un número decimal que desea que se visualice en la página de interfaz de usuario, añada una vista Decimal al diseño de página y, a continuación, establezca las propiedades de configuración como se indica a continuación:
  1. En General, especifique Total como nombre de la vista Decimal.
  2. En Sucesos, especifique el siguiente valor en valor de fórmula: @{Value1} + @{Value2}. Esta fórmula acepta los valores de entrada de otras dos vistas decimales denominadas Value1 y Value2 y los suma.
  3. En Aspecto, establezca Estilo de tamaño en Largey Colocación de etiqueta en Top.
  4. En Comportamiento, establezca Separador de miles en , (coma), Separador decimal en . (punto), Posiciones decimales en 2y Prefijo en $.
  5. Guarde los cambios.

El resultado es un campo decimal que añade los valores de entrada de Value1 y Value2, va precedido del símbolo $ y muestra dos decimales después del separador. Si el valor de entrada de Value1 es $100.00 y el valor de entrada de Value2 es $200.00, el valor del número decimal será $300.00

Sucesos

Establezca o modifique las propiedades de configuración de la fórmula y los manejadores de sucesos de la vista en las propiedades de Sucesos. Puede establecer que los sucesos se activen mediante programación o cuando un usuario interactúe con la vista. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario.

Las propiedades de configuración de fórmula para Decimal se muestran en la tabla siguiente:
Tabla 3. Propiedades de configuración de fórmula para Decimal
Propiedad de configuración de fórmula Descripción Tipo de datos
Fórmula de valor La fórmula que especifica cómo se visualiza el valor en la vista. Puede utilizar valores de String estático o bien fórmulas o funciones de agregación.

Para obtener más información sobre fórmulas, consulte Fórmulas.

String
Decimal tiene los tipos siguientes de manejadores de sucesos:
  • On load: activado cuando se carga la página. Por ejemplo:
    me.setValue(0.00);
  • On change: Se activa cuando cambia el valor. Por ejemplo:
    ${Decimal1}.setValue(oldValue); ${Decimal2}.setValue(newValue);
  • On focus: Se activa cuando el foco se desplaza al campo decimal. Por ejemplo:
    ${Tooltip1}.setTooltipVisible(true)
  • On blur: Se activa cuando la vista pierde el foco. Por ejemplo:
    ${Tooltip1}.setTooltipVisible(false);
  • On format: Se activa cuando el usuario aplica formato personalizado a los valores de entrada. El formato se basa en el valor return de la sentencia. Por ejemplo:
    var neg = me.getValue() < 0; if (neg){return "(" + formattedValue + ")"}

Según el suceso específico, puede utilizar lógica de JavaScript para modificar los efectos de la vista. Puede encontrar más información sobre cómo utilizar sucesos con vistas en el tema Sucesos definidos por el usuario.

Métodos

Para obtener información detallada sobre los métodos disponibles para Decimal, consulte API de JavaScript decimal.

Recursos adicionales

Para obtener información sobre cómo crear un coach o una página, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidady Atributos HTML), consulte Ver propiedades.