Cuadros combinados
Un cuadro combinado ofrece elementos en una lista desplegable. Los elementos de la lista se pueden seleccionar de varias formas (ver a continuación) y esta lista se puede usar de varias formas en el documento HTML de salida (por ejemplo, el HTML de salida se puede procesar para que la lista del cuadro combinado incluya las opciones de un formulario HTML.
•A partir de las enumeraciones del esquema para el nodo seleccionado.
•A partir de una lista definida en el cuadro de diálogo "Editar el cuadro combinado". Introduzca la entrada visible y su valor XML correspondiente, que puede ser diferente. En las ediciones Enterprise y Professional Edition el "valor XML" hace referencia al valor XML asignado a la selección realizada por el usuario de la vista Authentic. Los usuarios de la edición Basic Edition pueden dejar esta columna en blanco (porque la edición Basic Edition no incluye la vista Authentic).
•A partir de la secuencia de resultados de una expresión XPath relativa al nodo actual. Los elementos de la secuencia de resultados aparecen como entradas en la lista desplegable. Se trata de una potente manera de usar entradas dinámicas en el cuadro combinado. El nodo que se utiliza para crear el cuadro combinado es muy importante. Por ejemplo, imagine que tiene un elemento llamado ListaNombres que puede incluir un número ilimitado de elementos Nombre, que a su vez pueden tener elementos secundarios Nombre y Apellido. Si crea un cuadro combinado a partir del elemento Nombre y selecciona el elemento secundario Apellido para la lista de valores, obtendrá tantos cuadros combinados como elementos Nombre haya en el documento XML y cada cuadro combinado incluirá en la lista desplegable el contenido de los secundarios Apellido. Para crear un solo cuadro combinado cuya lista desplegable incluya todos los elementos Apellido es necesario usar el nodo primario ListaNombres y después seleccionar el elemento Apellido en la expresión XPath.
Abrir el cuadro de diálogo "Editar el cuadro combinado"
Cuando se crea un cuadro combinado en el diseño SPS, aparece el cuadro de diálogo "Editar el cuadro combinado". También puede insertar un cuadro combinado en el diseño con el comando de menú Insertar | Insertar controles de formulario | Cuadro combinado). Si más tarde quiere volver a abrir el cuadro de diálogo "Editar el cuadro combinado":
1.Seleccione el cuadro combinado en el diseño.
2.En la ventana Propiedades seleccione el componente cuadro combinado y después expanda el grupo de propiedades cuadro combinado (imagen siguiente).
![WinPropsComboBoxEditStd](./images/winpropscomboboxeditstd.png)
3. | Haga clic en el botón Editar ![]() |
Usar el cuadro de diálogo "Editar el cuadro combinado"
![dlg_edit_combobox](./images/dlg_edit_combobox.png)
Para definir las opciones y los valores del cuadro combinado:
1. | Seleccione un método para definir las opciones y los valores: (i) Utilizar enumeraciones de esquema, (ii) Utilizar lista de valores o (iii) Utilizar expresión XPath. |
2. | Si selecciona el botón de opción Utilizar enumeraciones de esquema, las enumeraciones del esquema asignadas al nodo se introducen automáticamente (i) como entradas visibles de la lista desplegable del cuadro combinado y (ii) sus correspondientes valores XML (imagen siguiente). En el panel situado bajo la opción Utilizar lista de valores la columna Entrada visible muestra las opciones que aparecerán en la lista desplegable del cuadro combinado. Cada entrada visible de la lista desplegable tiene asignado un valor XML. El valor XML correspondiente a la entrada visible que seleccione el usuario de Authentic será el valor XML que se introduce en el archivo XML. En la imagen siguiente, por ejemplo, las entradas visibles y sus valores aparecen atenuados porque todos ellos se obtienen de las enumeraciones del esquema y no se pueden editar. |
![dlg_edit_combobox_enums](./images/dlg_edit_combobox_enums.png)
Si selecciona el botón de opción Utilizar lista de valores, podrá insertar, anexar, editar y eliminar opciones para la lista desplegable del cuadro combinado, así como sus valores XML. Estos cambios se realizan en el panel situado justo debajo. También puede usar una expresión XPath para crear las entradas visibles y sus valores XML. Los elementos de la secuencia que devuelve la expresión XPath se usarán para las entradas visible y los valores XML. Además puede especificar: (i) si se utiliza la misma expresión XPath para las entradas visibles y para los valores XML o (ii) si se utilizan expresiones XPath distintas. En caso de utilizar expresiones XPath distintas, la correspondencia entre una entrada visible y un valor XML se determina mediante una asignación de índice entre los elementos de las dos secuencias. Si las secuencias no tienen el mismo número de elementos, se emite un error.
3. | Si quiere que los elementos de la lista desplegable del cuadro combinado aparezcan ordenados en la vista Authentic, marque la casilla Ordenar los valores en Authentic. |
4. | Para terminar haga clic en Aceptar. |
Nota
•Utilice una expresión XPath para seleccionar las entradas de la lista desplegable del cuadro combinado y así podrá crear cuadros combinados con entradas dinámicas a partir del archivo XML mismo.
•Si los elementos de la lista desplegable del cuadro combinado se obtienen de las enumeraciones del esquema, los elementos aparecen por orden alfabético. Si los elementos se obtienen de un archivo XML, entonces aparecen en orden de documento.
•En los documentos de salida en formato texto los cuadros combinados muestran el valor seleccionado.