OOo Basic. Interface.

Diálogo (d) Listbox.

Un cuadro de lista (listbox) (en adelante Lista) es un control de apariencia similar al cuadro de texto, pero cuyas entradas están establecidas mediante una lista de opciones entre las cuales debe escoger el usuario la que considere adecuada. Esta lista, a la vez que facilita la entrada de información, limita también las opciones de respuesta, por lo que resulta adecuado como control cuando se conocen de antemano las posibles respuestas.

Sobre la base del docap-agenda que creamos [anteriormente], vamos a crear en ésta un docap-Listado simple, con tres campos, dos mediante control cuadro de texto (1) y un tercero utilizando un control Lista. El documento-soporte será, con en los anteriores, un documento del servicio Writer y la utilidad supuesta del docap será la creación de un listado simple de alumnos con los datos nombre, apellidos y curso o nivel escolar. Los dos primeros se ajustan al control Cuadro de texto, pero para el segundo caben varias opciones, siendo una de ellas el control Lista, dado que son conocidos los valores de respuesta: los cursos escolares comprendidos entre 1º de EI2 y 6º de EP (2).

Considerado resuelto la implementación del control en el Diálogo, paso directamente a explicar el acceso a su contenido, procedimiento también válido para el trabajo con este control en un documento Calc.

Dim olstCurso As Object

Dim sCurso As String

olstCurso = oDialogo.getControl("lstCurso")

sCurso = olstCurso.SelectedItem

En relación con el control Lista...

• Declaramos dos variables, una de tipo Object (olstCurso As Object), para referenciar el objeto Lista (olstCurso = oDialogo.getControl("lstCurso"))
• y otra de tipo String (sCurso As String) para referenciar el elemento seleccionado dentro de los disponibles en el listado de opciones de Lista. (sCurso = olstCurso.SelectedItem)

Como puedes observar, la única diferencia entre trabajar con un Cuadro de texto y una Lista en cuanto al acceso al dato del control es que para ésta empleamos el atributo .SelectedItem. Además esa instrucción debe ubicarse después de haber accedido al dialogo, haber asociado los objetos-controles a sus respectivas variables-objeto y haber ejecutado la visualización del dialogo (oDialogo.execute()).

Documento

• Lista simple
  

En el IDE de este documento puedes encontrar el código que incluye el acceso al control Lista implementado sobre el diálogo que se activa con el comando Dialogo Lista.

NOTAS

(1) No comentaré nada sobre ellos, ya que fueron explicados [en su momento].

(2) Empleo la abreviatura EI2 para referirme al segundo ciclo de la etapa de Educación Infantil, esto es: los curso EI 3 años (EI21), 4 años (EI22) y 5 años (EI23). Para los curso de Educación Primaria utilizaré las iniciales EP1 a EP6.