Grupo de recuadros de selección

El control Grupo de recuadros de selección es control de selección múltiple que crea un grupo de recuadros de selección que permiten seleccionar varios elementos en una lista de opciones disponibles.

Enlace de datos

Establezca o modifique el enlace de datos para el Grupo de recuadros de selección en la pestaña de propiedades General. El enlace para este control de selección múltiple es una lista de ANY (ANY []), que representa los recuadros de selección que ha seleccionado el usuario.

Propiedades de configuración

Establezca o modifique propiedades de configuración para el Grupo de recuadros de selección como, por ejemplo, propiedades de aspecto y elementos, en la pestaña de propiedades de Configuración.

Tamaño de pantalla: Una propiedad de configuración que tenga el 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.

Las propiedades de configuración de aspecto para el Grupo de recuadros de selección se listan en la tabla siguiente:

Tabla 1. Propiedades de configuración de aspecto para Grupo de recuadros de selección
Propiedad de configuración del aspecto	Descripción	Tipo de datos
Anchura	Especifica la anchura del control Grupo de recuadros de selección Puede especificar la anchura en `px` (píxeles), en `%` (porcentaje) o en unidades `em`. Por ejemplo, `50px`, `20%` o `0.4em`. Si no se especifica ningún tipo de unidad, se presupone que es `px`	`String`
Colocación de etiqueta	Especifica dónde poner la etiqueta. Las opciones disponibles son `Arriba` e `Izquierda`. Tenga en cuenta que si se coloca la etiqueta a la izquierda, cambia la anchura especificada del control.	`String`

Las propiedades de configuración de elementos para el Grupo de recuadros de selección aparecen listadas en la tabla siguiente:

Tabla 2. Propiedades de configuración de elementos para Grupo de recuadros de selección
Propiedad de configuración de elementos	Descripción	Tipo de datos
Modalidad de búsqueda de elementos	El método utilizado para rellenar la lista de elementos entre los que el usuario puede seleccionar. Nota: Asegúrese de seleccionar la opción correcta, de lo contrario, la lista no se rellenará correctamente. Inicio vacío Puede llenar mediante programación la lista de selección utilizando el método `appendItem(value, displayText)`. Elementos de servicio La lista de selección se llena a partir del servicio que se especifique en la opción Servicio de lista de elementos. Elementos de lista estática La lista de selección se llena a partir de las propiedades que se especifiquen en la opción Lista estática. Elementos de opción de configuración La lista de selección se llena a partir del objeto de negocio que se especifique en la opción Datos de entrada de elemento.	`String`
Servicio de lista de elementos	El servicio utilizado para llenar la lista de elementos que aparecen en la lista de selección. El servicio se utiliza cuando la modalidad de búsqueda de elementos es Elementos de servicio. El servicio es un flujo de servicios con el acceso a Ajax adecuado que proporciona la lista de selección en base a los datos proporcionados por el objeto de negocio Datos de entrada de servicio. Puede utilizar esta opción como alternativa a enlazar el control a un objeto de lista.	`AJAX Service`
Datos de entrada de servicio	Un objeto de negocio que proporciona los datos de entrada que se pasan al flujo de servicios con el que se llena la lista de selección. Esta opción se utiliza cuando la modalidad de búsqueda de elementos es Elementos de servicio.	`ANY`
Datos de entrada de elemento	SUna lista de objetos de negocio que llena la lista de selección. Esta propiedad solo se utiliza cuando la modalidad de búsqueda de elementos es Elementos de opción de configuración.	`ANY[]`
Datos de selección de elemento	En el campo Propiedad de visualización, establezca la propiedad de objeto de negocio para mostrar en la lista de selección. Si no se especifica ningún valor para las propiedades de correlación de datos, los valores predeterminados son `name` para Propiedad de valor y `value` para Propiedad de visualización.	`String` Propiedad de valor de opción: `Serie` Propiedad de visualización de opción: `Serie`
Lista estática	Una lista estática de elementos para rellenar la lista de selección. Utilice esta opción únicamente para una lista estática. No especifique una variable para esta opción. Para una lista de variables, utilice la modalidad de búsqueda Elementos de opción de configuración.	`NameValuePair[]`

Ejemplo

Imagine que desea crear un inventario para realizar el seguimiento de los suministros necesarios de su oficina a lo largo de un periodo de tiempo especificado. En el inventario, los suministros de oficina se presentan como una lista de elementos precedidos de recuadros de selección, que puede seleccionar o deseleccionar según los suministros de oficina que se necesiten. Para añadir la lista de recuadros de selección al coach, añada un control Grupo de recuadros de selección en el diseño del coach, y después establezca las opciones de configuración del control como se indica a continuación.

En General, especifique un nombre para el grupo de recuadros de selección, por ejemplo, Suministros de oficina necesarios:.
En Elementos:
- Establezca Modalidad de búsqueda de elementos en Elementos de lista estática.
- En Lista de elementos, expanda Lista estática y utilice los botones con el signo más (+) para añadir los siguientes pares de nombre y valor a la lista.
  Nombre Valor
  
  1 Blocs de notas
  
  2 Bolígrafos
  
  3 Tinta de impresora
  
  4 Archivadores
- En Aspecto, establezca Anchura en 350px y Colocación de etiqueta en Izquierda.
- Guarde los cambios.

Nombre	Valor
1	Blocs de notas
2	Bolígrafos
3	Tinta de impresora
4	Archivadores

Cuando se ejecuta el coach, se muestra una lista de categorías de suministros de oficina que incluye los siguientes elementos. En la lista, puede seleccionar uno o varios elementos a la vez:

Blocs de notas
Bolígrafos
Tinta de impresora
Archivadores

Sucesos

El Grupo de recuadros de selección de Establezca o modifique los manejadores de sucesos para el 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. tiene los tipos siguientes de manejadores de sucesos:

Al cargar: Se activa cuando se carga la página. Por ejemplo:
```
console.log(me.getItemCount())
```
En los elementos de servicio: Se activa cuando el flujo de servicios devuelve la lista de elementos. Se activa cuando la Modalidad de búsqueda de elementos está establecida en Elementos de servicio. Por ejemplo:
```
console.log("CheckboxGroup1 item service retrieved items successfully")
```
En error de servicio: Se activa cuando el servicio de selección devuelve un error. Se activa cuando la Modalidad de búsqueda de elementos está establecida en Elementos de servicio. Por ejemplo:
```
me.clearItems()
```
Al cambiar: Se activa cuando cambian los datos enlazados, como por ejemplo cuando hay un recuadro de selección seleccionado. Por ejemplo:
```
${CheckboxGroup2}.reloadServiceItems(me.getSelectedIndices())
```

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

Para obtener más información sobre los métodos disponibles para el Grupo de recuadros de selección, consulte la API JavaScript Grupo de recuadros de selección.

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.