Grupo de entrada

Utilice Grupo de entrada para añadir un icono, texto o menú a controles que utilizan los usuarios para proporcionar entradas como, por ejemplo, fecha, hora, texto, etc.

Normalmente, utilice el control Grupo de entrada para añadir un efecto visual a controles de entrada como, por ejemplo, el Área de texto, Selector de fecha y hora o Entero. Por ejemplo, podría desear añadir un botón de calendario al selector de fecha. El control Grupo de entrada sirve para ajustar su tamaño al tamaño del control de formulario contenido. Los grupos de entrada se pueden anidar uno dentro de otros.

Propiedades de configuración

Puede definir o modificar las propiedades de configuración del control Grupo de entrada en la pestaña de propiedades Configuración.

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 Grupo de entrada:
Tabla 1. Propiedades de configuración de aspecto para Grupo de entrada
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
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
Estilo de color El estilo de color del control. Los colores corresponden a variables en el tema especificado. String
Ubicación de botón La ubicación del botón en relación al campo. String
Tipo de botón Puede crear el control como un icono pulsable, un campo de texto o un menú. Utilice la opción Menú con un control Menú emergente. Para obtener más información sobre este control, consulte Menú emergente. String
Información de botón El nombre del icono.

Consulte Font Awesome para obtener una lista completa de iconos.

String

Ejemplo

Para crear un Grupo de entrada con un icono de calculadora junto a un campo de entrada Entero Imagen de un control Entero, suelte un control Entero en un control Grupo de entrada y establezca las opciones de Grupo de entrada del modo siguiente:

  • Deje Anchura en blanco.
  • Establezca Colocación de etiqueta en Arriba.
  • Establezca Estilo de color en Primario.
  • Establezca Ubicación de botón en Izquierda.
  • Establezca Tipo de botón en Icono.
  • Establezca Información de botón en calculadora.

Configuración del Grupo de entrada en una sección de sólo lectura.

Si el grupo de entrada está anidado dentro de una sección que está establecida en solo lectura, como un diseño horizontal, diseñovertical o control, el icono queda ligeramente más tenue.

Imagen de un control Entero tenue

Un icono tenue puede ser inconveniente si hay otros controles de icono fuera de la sección de sólo lectura del mismo color. Para asegurarse de que el color del icono no cambia cuando está anidado en una sección de sólo lectura, puede establecer el manejador de sucesos al cargar para que utilice el método setEnabled.
me.setEnabled(true)

Sucesos

Establezca o modifique 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.
Puede utilizar lógica de JavaScript para modificar los efectos del control. Para el control Grupo de entrada, puede activar los siguientes tipos de manejadores de sucesos:
  • Al cargar cuando se carga la página, por ejemplo me.setIcon("rocket");
  • Al pulsar botón cuando se pulsa en un icono utilizado como botón, por ejemplo ${PopupMenu1}.setMenuVisible(!${PopupMenu1}.isMenuVisible())

Métodos

Para obtener más información sobre los métodos disponibles, consulte API JavaScript Grupo de entrada.

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.

Para obtener más información sobre los controles de entrada, consulte Texto, Área de texto, Selector de fecha y hora, Entero.