La propiedad
selectedIndexItem se utiliza para
una matriz de
campos VGUI y hace referencia al
elemento de índice seleccionado, que es un campo
VGUI cuyo valor indica dos aspectos del proceso de tiempo de ejecución:
- si hay un control
(por ejemplo, un recuadro de selección) preseleccionado cuando se visualiza la página
Web
- si el usuario ha seleccionado un control
El campo al que la propiedad hace referencia debe ser de tipo NUM sin posiciones
decimales, pero puede ser una matriz.
Considere el caso siguiente:
- Un campo de registro VGUI es una matriz y tiene una propiedad selectedIndexItem
que hace referencia a un campo (el elemento de índice seleccionado) que no es una matriz
- La propiedad uiType es input o inputOutput
En este caso, la página Web generada contendrá botones de selección desde los que el
usuario puede elegir sólo un valor. El elemento de índice seleccionado identifica el
botón de selección por el número, con el número 1 haciendo referencia al primer botón de
selección.
Si en el mismo caso el elemento de índice seleccionado es una matriz, la página Web
generada contendrá un conjunto de recuadros de selección, y ocurrirá lo siguiente:
- Cuando los datos se preparen para la visualización, la matriz contendrá los índices
de las entradas que deban establecerse como preseleccionadas
- Cuando se devuelvan los datos, la matriz contendrá
los índices
de las entradas que el usuario ha seleccionado. Por ejemplo, si el usuario ha
seleccionado entradas visualizadas con los índices 1, 3 y 5, el primer elemento de la
matriz contendrá 1. el segundo elemento contendrá 3, el tercero 5 y el resto contendrá 0.
El código HTML generado es diferente si el valor de la propiedad uiType es output:
- Si el elemento de índice seleccionado no es una matriz, la página Web generada contendrá un par
de estructuras: la etiqueta del elemento, que se visualiza en negrita, y una estructura HTML
<SELECT> (visualizada como lista desplegable) en la que el usuario puede elegir un valor. Si el elemento de índice seleccionado tiene un valor 2, por
ejemplo, la segunda entrada estará preseleccionada.
- Si el elemento de índice seleccionado es una matriz, la página Web
generada contendrá un par similar de estructuras, pero el usuario podrá elegir varios
valores. Si el valor del primer elemento del elemento de índice seleccionado es 1 y el
valor del elemento 2 es 3, el navegador visualizará una lista desplegable y la primera y
tercera entradas estarán preseleccionadas.