Entero

Utilice Entero para crear un campo en el cual un usuario puede ver o especificar un valor numérico.

Enlace de datos

Defina o modifique el enlace de datos para el control Entero en la pestaña de propiedades General. El control está enlazado a una variable Entero.

Propiedades de configuración

Puede definir o modificar las propiedades de configuración del control Entero, como por ejemplo las propiedades de aspecto y comportamiento, en la pestaña de propiedades de Configuración. Puede definir las propiedades de configuración de la fórmula en la pestaña Sucesos.

Tamaño de pantalla
Una propiedad de configuración que tenga el icono Tamaños de pantalla icono Tamaños de pantalla además del 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 su valor predeterminado. Si está utilizando el editor de escritorio de Process Designer (en desuso), está estableciendo el valor para el tamaño de pantalla grande. Los otros tamaños de pantalla heredan este valor.
Definiciones de temas
Las definiciones de temas especifican los colores y estilos de un control y determinan el aspecto del control. Puede obtener una vista previa del aspecto de los controles en el editor de temas. Consulte Temas.
En la tabla siguiente se enumeran las propiedades de configuración del aspecto del control Entero.
Tabla 1. Propiedades de configuración de aspecto para Entero
Propiedad de configuración del aspecto Descripción Tipo de datos
Anchura icono Tamaños de pantalla La anchura del control. Puede especificar la anchura en px (píxeles), % (porcentaje) o en unidades em. Por ejemplo, 50px, 20%, o 0.4em. Si no se especifica ningún tipo de unidad, se presupone px. String
Estilo de tamaño icono Tamaños de pantalla El tamaño del texto en el control. String
Colocación de etiqueta icono Tamaños de pantalla La colocación de etiqueta para este control. Si la colocación de etiqueta es a la izquierda, se cambia la anchura especificada del control. String
En la tabla siguiente se enumeran las propiedades de configuración del comportamiento del control Entero:
Tabla 2. Propiedades de configuración del comportamiento para Entero
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 pestañas 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 un coach pulsando la tecla Tabulador. Integer
Texto de marcador de posición El texto de marcador que se visualiza cuando no se especifica ningún valor. String
Formato numérico Determina si el separador de millares se basa en la configuración regional del usuario actual o se especifica como una opción de configuración personalizada. Las opciones disponibles son Automático y Personalizado. String
Ocultar separador de millares Oculta el separador de millares. De forma predeterminada, esta opción no está seleccionada. Boolean
Separador de millares 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
Prefijo 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 entero que desea que se visualice en su coach, añada un control Entero en el diseño del coach y después establezca sus propiedades de configuración como se indica a continuación:
  1. En Aspecto, establezca Estilo de tamaño en Predeterminado, y Colocación de etiqueta en Arriba.
  2. En Comportamiento, establezca Separador de millares en , (coma) y Prefijo en $.
  3. Guarde los cambios.

En el resultado un valor de entrada de 1500 se visualiza como $1,500.

Sucesos

Establezca o modifique las propiedades de configuración de la fórmula o los manejadores de sucesos del control en la pestaña Sucesos. Puede definir que los sucesos se desencadenen mediante programación o cuando el usuario interactúa con el control. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario.

En la tabla siguiente se muestran las propiedades de configuración de la fórmula para el control Entero:
Tabla 3. Propiedades de configuración de fórmula para Entero
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 el control. Puede utilizar valores de String estático o bien fórmulas o funciones de agregación.

Si desea más información sobre fórmulas, consulte Fórmulas.

String

El control Entero tiene los siguientes tipos de manejadores de sucesos:

  • Al cargar: Se activa cuando se carga la página. Por ejemplo:
    me.setValue(0.00);
  • Al cambiar: Se activa cuando se modifica el valor. Por ejemplo:
    ${Decimal1}.setValue(oldValue); ${Decimal2}.setValue(newValue);
  • Al enfocar: Se activa cuando se desplaza el foco al campo de entero. Por ejemplo:
    ${Tooltip1}.setTooltipVisible(true)
  • Al desenfocar: Se activa cuando el campo de entero pierde el foco. Por ejemplo:
    ${Tooltip1}.setTooltipVisible(false);
  • Al formatear: Se activa cuando el usuario aplica un 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 del control. Puede obtener más información sobre la utilización de sucesos con controles en el tema Sucesos definidos por el usuario.

Métodos

Si desea información detallada sobre los métodos disponibles para Entero, consulte la API JavaScript Entero.

Recursos adicionales

Para obtener información sobre cómo crear un coach, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidad y Atributos HTML), consulte Propiedades de vista de coach.