Grupo de botones de selección

Permite a los usuarios seleccionar una opción de una lista de botones de selección. Puede llenar la lista de forma estática o bien utilizando un servicio.

La vista Grupo de botones de selección proporciona una alternativa a la vista Selección única para seleccionar un elemento en una lista de elementos disponibles.

Enlace de datos

Establezca o modifique el enlace de datos para la vista Grupo de botones de selección en las propiedades de General. La vista se puede enlazar a cualquier tipo de datos simple (por ejemplo, Serie, Booleano, Entero, Decimal). El enlace se actualiza con el valor de la selección.

Propiedades de configuración

En Configuración, establezca o modifique las propiedades de aspecto y elementos de la vista.

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

En la tabla siguiente se enumeran las propiedades de configuración del aspecto de la vista Grupo de botones de selección:

Tabla 1. Propiedades de configuración de aspecto para Grupo de botones de selección
Propiedad de configuración del aspecto	Descripción	Tipo de datos
Ancho	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`
Colocación de etiqueta	La posición de la etiqueta de la vista. Las opciones disponibles son `Left` y `Right`. Tenga en cuenta que la colocación de la etiqueta a la izquierda cambia la anchura especificada de la vista.	`String`
Ancho de etiqueta	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`
Mostrar marcador de validación	Mostrar un icono de validación y un borde cuando la vista no es válida.	`Boolean`

En la tabla siguiente se enumeran las propiedades de configuración de elementos de la vista Grupo de botones de selección:

Tabla 2. Propiedades de configuración de elementos para Grupo de botones 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 llenar la lista de elementos de los que puede seleccionar el usuario. Nota: Asegúrese de seleccionar la opción correcta o la lista no se rellenará correctamente. Inicio vacío Rellene mediante programación la lista de selección utilizando el`appendItem(value, displayText)`. Elementos de servicio La lista de selección se rellena a partir de un servicio que se especifica en la opción Servicio de elementos de lista. Elementos de lista estática La lista de selección se rellena a partir de propiedades especificadas en la opción Lista estática. Elementos de opción de configuración La lista de selección se rellena a partir de una lista de objetos de negocio que se especifica en la opción Datos de entrada de elementos.	`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 para enlazar la vista a un objeto de lista. Sugerencia: El servicio de elementos de lista utiliza dos variables: una variable de entrada de tipo `string` named `data`y una variable de salida de tipo `list` named `results`, que genera el resultado como los datos enlazados a la vista. Si el nombre de variable de salida no es `results` del servicio de elementos de lista, no habrá valores disponibles para utilizar.	`Ajax Service`
Datos de entrada de servicio	Un objeto de negocio que proporciona los datos de entrada que se pasan al flujo de servicios que rellena la lista de selección. Esta opción se utiliza cuando la Modalidad de búsqueda de elementos es Elementos del servicio.	`ANY`
Ignorar cambios de datos de entrada	Inhabilita la llamada de servicio automática cuando los datos de entrada de servicio cambian. Esta opción solo se utiliza cuando Modalidad de búsqueda de elementos se establece en Elementos del servicio.	`Boolean`
Datos de entrada de elemento	Una lista de objetos de negocio que rellena la lista de selección. Esta propiedad sólo se utiliza si 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 del objeto de negocio para que se muestre 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 `nombre` para Propiedad de valor y `valor` para Propiedad de visualización.	`String` Propiedad del valor de opción: `String` Propiedad de visualización de opción: `String`
Lista estática	.Una lista estática de elementos para llenar la lista de selección. Utilice esta opción únicamente para una lista estática. No especifique ninguna 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

Para añadir un grupo de botones de selección para una selección de rango de edad a la página de IU, añada una vista de Grupo de botones de selección al diseño de página y, a continuación, establezca las opciones de configuración como se muestra en el ejemplo siguiente:

En General, especifique una etiqueta para el grupo de botones de selección, por ejemplo, Age range:.
En Elementos:
- Establezca Modalidad de búsqueda de elementos en Items From Static List.
- 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
  
  25 25 e inferior
  
  40 40 e inferior
  
  64 64 e inferior
  
  65 Más de 65
- En Aspecto, establezca Ancho en 200pxy Colocación de etiqueta en Top.
- Guarde los cambios.

Nombre	Valor
25	25 e inferior
40	40 e inferior
64	64 e inferior
65	Más de 65

Durante el tiempo de ejecución, el grupo de botones de selección lista las siguientes opciones entre las que elegir:

25 e inferior
40 e inferior
64 e inferior
Más de 65

Sucesos

Establezca o modifique los manejadores de sucesos para 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.

On load: activado cuando se carga la página. Por ejemplo:
```
console.log(me.getItemCount())
```
On service items: Activado cuando el flujo de servicio devuelve la lista de elementos. Se activa cuando la Modalidad de búsqueda de elementos se establece en Items From Service. Por ejemplo:
```
console.log("RadioButtonGroup1 item service retrieved items successfully")
```
On service error: Activado cuando el servicio de selección devuelve un error. Se activa cuando la Modalidad de búsqueda de elementos se establece en Items From Service. Por ejemplo:
```
me.clearItems()
```
On change: Activado cuando se cambian los datos enlazados, por ejemplo cuando se selecciona un botón de selección. Por ejemplo:
```
${RadioButtonGroup2}.reloadServiceItems(me.getSelectedIndices())
```

Métodos

Para obtener información detallada sobre los métodos disponibles para el grupo de botones de selección, consulte la API de Grupo de botones de selección JavaScript .

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.