Listák

A listákhoz (com.sun.star.awt.UnoControlListBox szolgáltatás) a következő tulajdonságok tartoznak:

• ItemCount (rövid egész szám) - az elemek száma, csak olvasható

• SelectedItem (karakterlánc) - a kijelölt bejegyzés szövege, csak olvasható

• SelectedItems (karakterlánctömb) - a kijelölt bejegyzések tömbje, csak olvasható

• SelectItemPos (rövid egész szám) - a jelenleg kijelölt bejegyzés sorszáma, csak olvasható

• SelectItemsPos (karakterlánctömb) - a kijelölt bejegyzések sorszámainak tömbje (a többszörös kijelölést engedélyező listáknál), csak olvasható

• MultipleMode (logikai érték) - a True érték engedélyezi a többszörös kijelölést, a False érték tiltja azt (ez a tulajdonság csak az IsMultipleMode tulajdonságon keresztül érhető el)

• IsMultipleMode (logikai érték) - több elem kijelölésének engedélyezése, csak olvasható

A listákkal a következő metódusok használhatók:

• addItem (Item, Pos) - az Item paraméterben megadott karakterlánc beszúrása a Pos helyen a listába

• addItems (ItemArray, Pos) - a karakterlánc ItemArray adatmezőjében megadott elemek beszúrása a listába a Pos helyen

• removeItems (Pos, Count) - a Count paraméterben megadott számú elem eltávolítása a Pos helytől kezdve

• selectItem (Item, SelectMode) - aktiválja vagy deaktiválja az Item paraméterben megadott elem kijelölését a SelectMode paraméterben megadott érték szerint

• makeVisible (Pos) - végiglapozza a listát, hogy a Pos paraméterben megadott elem legyen látható

A lista modellobjektumán keresztül a következő tulajdonságok érhetők el:

• Model.BackgroundColor (hosszú egész szám) - a vezérlőelem hátterének színe

• Model.Border (rövid egész szám) - a szegély típusa (0: nincs szegély, 1: térhatású szegély, 2: egyszerű szegély)

• Model.FontDescriptor (struktúra) - a használni kívánt betűtípus adatait tartalmazó struktúra (a com.sun.star.awt.FontDescriptor szerint)

• Model.LineCount (rövid egész szám) - a vezérlőelem sorainak száma

• Model.MultiSelection (logikai érték) - több elem kijelölésének engedélyezése

• Model.SelectedItems (karakterlánctömb) - a kijelölt elemek listája

• Model.StringItemList (karakterlánctömb) - az összes elem listája

• Model.Printable (logikai érték) - a vezérlőelem nyomtatható

• Model.ReadOnly (logikai érték) - a vezérlőelem tartalma csak olvasható

• Model.Tabstop (logikai érték) - a vezérlőelem elérhető a Tab billentyűvel

• Model.TextColor (hosszú egész szám) - a vezérlőelem szövegének színe

• Model.HelpText (karakterlánc) - automatikusan megjelenő súgószöveg, amely akkor látható, ha az egérmutatót a vezérlőelem fölött tartják

• Model.HelpURL (karakterlánc) - az adott vezérlőelem súgójának URL-címe

Megjegyzés - A listaelemek kiegészítő numerikus értékkel való kiadására szolgáló VBA tulajdonságot (ItemData) a StarOffice Basic nem tartalmazza. Ha a természetes nyelvű szövegen kívül numerikus értéket is kezelnünk kell (például adatbázis-azonosítót), egy kiegészítő adatmezőt kell létrehoznunk, amely a listával párhuzamosan működik.