Un componente de selección única permite a un usuario hacer una selección de una lista de
valores. La selección del usuario se almacena en un área de datos de manejador de páginas.
Los botones de selección, los recuadros de lista de selección única y los cuadros combinados son
componentes JavaServer Faces de selección única.
Un enlace es una relación entre el componente y un área de datos. El área de datos debe
declararse en el manejador de páginas para poder enlazar un componente. Un componente de selección
única necesita dos clases diferentes de enlaces:
- Un enlace a una o varias áreas de datos que contengan los valores entre los que el usuario
puede realizar una selección
- Un enlace a un área de datos que recibirá la selección del usuario
para enlazar un componente de selección única de JavaServer Faces con áreas de datos de
manejador de páginas de EGL, haga lo siguiente:
- Abra un archivo JSP Faces en Page Designer. Si no tiene un archivo JSP abierto, en el Explorador de
proyectos pulse dos veces en el archivo JSP. El JSP se abre en Page
Designer. Pulse en la pestaña Diseño para acceder a la vista
Diseño.
- En el menú Ventana, seleccione Mostrar
vista > Otras >Básica >
Paleta.
- En la vista Paleta, pulse la bandeja Componentes Faces para
visualizar los tipos de objeto de Componentes Faces.
- Arrastre un componente de selección única de la paleta al JSP. El objeto de componente se coloca en el
JSP.
- Para enlazar el componente a una o varias áreas de datos del manejador de páginas que contienen
los valores que desea mostrar al usuario, siga uno de los procedimientos siguientes:
- Puede enlazar el componente con áreas de datos de manejadores de páginas individuales, cada una
de las cuales contiene un elemento de lista. Realice el procedimiento siguiente para cada área de
datos:
- Seleccione el componente de objeto en el JSP.
- En la vista Propiedades, pulse Añadir opción. Los campos Nombre y
Valor se pueblan con valores por omisión.
- Pulse el campo Nombre y teclee el texto que debe mostrarse al
usuario.
- Pulse el campo Valor y después pulse el botón situado junto al campo
Valor. Seleccione un área de datos individual en la lista Seleccionar
objeto de datos de página y pulse Aceptar.
Este área contiene el valor que se moverá al área de datos de recepción.
- Puede enlazar el componente con un área de datos de matriz de manejador de páginas que contenga
los valores que desea mostrar al usuario. Lleve a cabo el procedimiento siguiente para enlazar el
componente a un área de datos de matriz:
- Seleccione el componente de objeto en el JSP.
- En la vista Propiedades, pulse Añadir conjunto de opciones.
Los campos Nombre y
Valor se pueblan con valores por omisión.
- Pulse el campo Valor y después pulse el botón situado junto al campo
Valor. Seleccione un área de datos de matriz en la lista Objeto de datos
de página y pulse Aceptar. Los valores del área de datos de matriz son los valores que se mostrarán al usuario. Las
propiedades que se describen más adelante determinan si los valores del área de datos de matriz o
los valores de índice equivalentes se moverán al área de datos de recepción.
- Si está utilizando un área de datos para proporcionar los valores mostrados al usuario debe
definir el área de datos de recepción con dos propiedades:
selectFromListItem y selectType. La propiedad
selectFromListItem señala la matriz que alberga los elementos de lista.
La propiedad selectType indica si el área de datos de recepción debe poblarse con un valor de texto
o un valor de índice. A continuación se proporcionan ejemplos de áreas de datos de
recepción:
colorSelected char(10)
{selectFromListItem = "colorsArray",
selectType = value};
colorSelectIdx smallInt
{selectFromListItem = "colorsArray",
selectType = index};
- Para enlazar el componente con un área de datos de manejador de páginas que recibirá la
selección del usuario, lleve a cabo una de las acciones siguientes:
- Arrastre el área de datos desde la vista Datos de página al objeto de componente en el JSP.
- Seleccione el objeto de componente en el JSP, pulse con el botón derecho del ratón el área de
datos de la vista Datos de página y seleccione Enlazar a 'nombre de componente'.
- Seleccione el objeto de componente en el JSP. Pulse el botón situado junto al campo
Valor en la vista Propiedades, seleccione un área de datos de la lista
Seleccionar objeto de datos de página y pulse Aceptar.