SELECT LISTBOX ROW

versión 11.2 (Modificado)

SELECT LISTBOX ROW ({*; }objeto; posicion{; accion})

El comando SELECT LISTBOX ROW selecciona la fila cuyo número se pasa en posicion en el list box designado por los parámetros objeto y *.

Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (cadena). Si omite este parámetro, indica que el parámetro objeto es una variable. En ese caso, no pasa una cadena, sino una referencia de variable. Para mayor información sobre nombres de objetos, consulte la sección Propiedades de los objetos.

El parámetro opcional accion, si se pasa, se utiliza para definir la acción de selección a ejecutar cuando una selección de filas ya existe en el list box. Puede pasar un valor o una de las siguientes constantes (ubicadas en el tema "List box"):

• Replace listbox selection (0): La fila seleccionada se convierte en la nueva selección y reemplaza la selección existente. El comando tiene el mismo efecto que un clic del usuario sobre una fila. Esta es la acción por defecto (cuando se omite el parámetro accion).

• Add to listbox selection (1): La fila seleccionada se añade a la selección actual. Si la fila especificada ya pertenece a la selección actual, el comando no hace nada.

• Remove from listbox selection (2): La fila seleccionada se elimina de la selección existente. Si la fila especificada no pertenece a la selección existente, el comando no hace nada.

Cuando el parámetro posicion no corresponde exactamente a un número de fila existente, el comando actúa de la siguiente manera:

• Si posicion es <0, el comando no hace nada, cualquiera que sea el valor del parámetro accion.

• Si posicion es 0 y el parámetro accion contiene Replace listbox selection o se omite, todas las filas del list box son seleccionadas. Si el parámetro accion contiene Remove from listbox selection, todas las filas del list box son deseleccionadas.

• Si el valor de posicion es superior al número total de filas contenidas en el list box, el array booleano asociado a el list box es redimensionado automáticamente y la acción de selección se efectúa. Este mecanismo permite utilizar SELECT LISTBOX ROW con los comandos "estándar" de gestión de arrays (tales como APPEND TO ARRAY) que no provocan la sincronización inmediata del listbox.

Después de la ejecución del método, los arrays son sincronizados: si el array fuente del listbox ha sido redimensionado efectivamente, la acción de selección se lleva a cabo. De lo contrario, el array booleano asociado con el list box vuelve a su tamaño inicial y el comando no hace nada.

Notas:

• Si quiere que el list box se desplace automáticamente para mostrar la fila seleccionada, utilice el comando SCROLL LINES.

• Para pasar una fila a modo edición (para permitir la entrada de datos), utilice el comando EDIT ITEM.

DELETE LISTBOX ROW, EDIT ITEM, INSERT LISTBOX ROW, SCROLL LINES.