Control Cuadro de lista (ListBox) para los diálogos en OOo Basic
Los cuadros de lista están basados en el servicio com.sun.star.awt.UnoControlListBox (ver Service UnoControlListBox).
Propiedades del control cuadro de lista
El control cuadro de lista presenta, entre otras, las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
ItemCount |
Short | Propiedad de solo lectura, indica el número de ítems del control. |
SelectedItem |
String | Propiedad de solo lectura, devuelve el texto del ítem actualmente seleccionado. |
SelectedItems |
Array Of Strings | Propiedad de solo lectura, si Selección múltiple está activada, devuelve un array de texto de los ítems seleccionados. |
SelectedItemPos |
Short | Propiedad de solo lectura, indica la posición en la lista del ítem actualmente seleccionado. |
SelectedItemsPos |
Array of Short | Propiedad de solo lectura, si Selección múltiple está activada, devuelve un array de enteros de la posición en la lista de los ítems seleccionados. |
MultipleMode |
Boolean | Permite o bloquea la Selección múltiple (seleccionar más de un ítem de la lista). La propiedad no se puede establecer directamente, sino que se establece a través de IsMultipleMode. |
IsMultipleMode |
Boolean | Propiedad de solo lectura, indica si Selección múltiple está activada. |
Métodos del control cuadro de lista
Los cuadros de lista presentan, entre otros, los siguientes métodos:
| Método | Descripción |
|---|---|
AddItem (Item, Pos) |
Inserta el texto especificado en Item en la lista, en la posición indicada por Pos. Si Pos es 0, siempre se inserta en la primera posición; si es -1, se inserta en la última. |
AddItems (ItemArray, Pos) |
Inserta los textos especificados en el array de texto ItemArray en la lista, en la posición indicada por Pos. Si Pos es 0, siempre se inserta en la primera posición; si es -1, se inserta en la última. |
GetItem (Pos) |
Devuelve el ítemde la lista en la posición Pos. |
GetItems () |
Devuelve un array de texto con todos los ítems del control. |
GetSelectedItem () |
Devuelve el texto del ítem seleccionado. |
GetSelectedItems () |
Devuelve un array de texto con los ítems seleccionados. |
GetSelectedItemPos () |
Devuelve la posición del ítem seleccionado. |
GetSelectedItemsPos () |
Devuelve un array de enteros con las posiciones de los ítems seleccionados. |
GetItems () |
Devuelve un array de texto con todos los ítems del control. |
RemoveItems (Pos, Count) |
Elimina el número de ítems definidos por Count a partir de la posición Pos de la lista. |
SelectItem (Item, SelectMode) |
Selecciona o deselecciona en función del valor de SelectMode (booleano) el ítem de la lista cuyo texto coincide con Item. |
SelectItemPos (Pos, SelectMode) |
Selecciona o deselecciona en función del valor de SelectMode (booleano) el ítem de la lista en la posición Pos. |
SelectItemsPos (ItemPosArray, SelectMode) |
Selecciona o deselecciona en función del valor de SelectMode (booleano) los ítems de la lista en las posiciones definidas por ItemPosArray. |
SetMultipleMode (Boolean) |
Activa o desactiva la Selección múltiple. |
MakeVisible (Pos) |
Desplaza los elementos de la lista arriba o abajo (scroll) hasta que el ítem que ocupa la posición Pos sea visible. |
|
El control cuadro de lista de VBA permite agregar nuevos ítems con dos datos, una cadena que forma el Texto del ítem y un entero largo que forma el Id que deseamos asignarle. No es así en Apache OpenOffice, por lo que si lo precisa, deberá implementar usted mismo un sistema que administre los Id de forma paralela |
Propiedades del objeto Model del cuadro de lista
El objeto Evento que se pasa al controlador de eventos de este control permite alcanzar las siguientes propiedades a través del objeto Model:
| Propiedad | Tipo | Descripción |
|---|---|---|
Align |
Short | Alineación horizontal del texto del control. Las opciones posibles son:
|
BackgroundColor |
Long | Color RGB de fondo |
Border |
Short | Estilo del borde (marco) del control. Las opciones posibles son:
|
BorderColor |
Long | Color RGB del borde (marco) |
Enabled |
Boolean | Define si el control está activado o desactivado. |
FontDescriptor |
Struct | Propiedades de fuente utilizadas en el control, en concordancia con la estructura com.sun.star.awt.FontDescriptor. (Ver Struct FontDescriptor). |
HelpText |
String | Texto de ayuda que se muestra cuando se sitúa el cursor del ratón sobre el control. |
HelpURL |
String | URL de la ayuda en línea asociada al control. |
LineCount |
Short | Hemos encontrado dos descripciones distintas para esta propiedad:
|
MultiSelection |
Boolean | Activa o desactiva la Selección múltiple. |
Printable |
Boolean | Define si el control se imprime. Si es FALSE, el control no se muestra al ser impreso. |
ReadOnly |
Boolean | El contenido del control es de sólo lectura. |
SelectedItems |
Array of Strings | Si Selección múltiple está activada, devuelve un array de texto de los ítems seleccionados. |
StringItemList |
Array of Strings | Establece con un array de texto los ítems de la lista, o devuelve un array de texto con el texto de los ítems de la lista. |
Tabstop |
Boolean | Define si el control es seleccionable mediante la tecla Tab. |
TextColor |
Long | Color RGB del texto. |
TextLineColor |
Long | Color RGB de la línea del texto. |
|
|
Para conocer más propiedades, ver Service UnoControlListBoxModel |
|
Texto, imágenes y código bajo licencia 
|