Választógombok

Ezeket a gombokat általában csoportosítva használjuk, amikor több beállítás közül csak egy megadása lehetséges. Ha bejelölünk egy beállítást, a csoport összes többi eleme kikapcsolt lesz. Ezzel biztosítható, hogy egyidejűleg mindig csak egy választógomb legyen beállítva.

A választógomb vezérlőelem két tulajdonsággal rendelkezik:

• State (logikai érték) - a gomb aktiválása

• Label (karakterlánc) - a gomb mellett megjelenő felirat

A választógomb modellobjektumán keresztül a következő tulajdonságok érhetők el:

• 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.Label (karakterlánc) - a vezérlőelemen megjelenő felirat

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

• Model.State (rövid egész szám) - ha értéke 1, akkor a választógomb aktiválva van, egyébként nem

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

• Model.HelpText (karakterlánc) - súgószöveg, amely akkor jelenik meg, 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

Több választógomb csoportba szervezéséhez ezeket megszakítás nélkül, egymás után kell elhelyezni a bejárási sorrendben (Model.TabIndex tulajdonság). Ha a bejárási sorrendet egy másik vezérlőelem megszakítja, a StarOffice automatikusan új vezérlőelem-csoportot kezd, amely a vezérlőelemek első csoportjától függetlenül aktiválható.

Megjegyzés - A VBA rendszerrel ellentétben a StarOffice Basic nem teszi lehetővé választógombok beszúrását vezérlőelemek csoportjába. A StarOffice Basic rendszerben a vezérlőelemek csoportosítása csak a vizuális elkülönítésére szolgál a vezérlőelemek köré rajzolt kerettel.

Jelölőnégyzetek

A jelölőnégyzetek a Yes vagy a No érték rögzítésére szolgálnak, és az üzemmódtól függően két vagy három állapottal rendelkezhetnek. A jelölőnégyzetek a Yes és a No állapot mellett egy köztes állapotot is felvehetnek, ha a megfelelő Yes vagy No állapotnak egynél több vagy nem egyértelmű jelentése van.

A jelölőnégyzetek a következő tulajdonságokkal rendelkeznek:

• State (rövid egész szám) - a jelölőnégyzet állapota (0: No, 1: Yes, 2: köztes állapot)

• Label (karakterlánc) - a vezérlőelem felirata

• enableTriState (logikai érték) - a be- és a kikapcsolt állapot mellett a köztes állapot használatának engedélyezése

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

• 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.Label (karakterlánc) - a vezérlőelem felirata

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

• Model.State (rövid egész szám) - a jelölőnégyzet állapota (0: No, 1: Yes, 2: köztes állapot)

• 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) - súgószöveg, amely akkor jelenik meg, 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

Szövegmezők

A szövegmezők segítségévvel a felhasználók számokat és szöveget írhatnak be. A szövegmezők alapját a com.sun.star.awt.UnoControlEdit. szolgáltatás képezi.

A szövegmezők egy vagy több sorból állhatnak, és tartalmuk szerkeszthető, illetve tiltható a szövegbevitel. A szövegmezők speciális pénznem vagy numerikus, illetve különleges feladatokra képernyőmezőként is használhatók. Mivel ezek a vezérlőelemek az UnoControlEdit szolgáltatáson alapulnak, programvezérelt kezelésük is ennek megfelelő.

A szövegmezők a következő tulajdonságokat tartalmazzák:

• Text (karakterlánc) - az aktuális szöveg

• SelectedText (karakterlánc) - a jelenleg kijelölt szöveg

• Selection (struktúra) - a részletek csak olvasható kiemelése (struktúra a com.sun.star.awt.Selection szerint, a Min és a Max tulajdonság határozza meg az aktuális kiemelés kezdetét és végét)

• MaxTextLen (rövid egész szám) - a mezőbe írható karakterek maximális száma

• Editable (logikai érték) - a True érték engedélyezi a szövegbevitelt, a False érték tiltja azt (ez a tulajdonság csak az IsEditable tulajdonságon keresztül érhető el)

• IsEditable (logikai érték) - a vezérlőelem tartalma módosítható, illetve csak olvasható

Emellett a kapcsolódó modellobjektumon keresztül a következő tulajdonságok érhetők el:

• Model.Align (rövid egész szám) - a szöveg igazítása (0: balra igazított, 1: középre igazított, 2: jobbra igazított)

• 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.EchoChar (karakterlánc) - a jelszómezőkben megjelenő karakter

• 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.HardLineBreaks (logikai érték) - az automatikus sortörések beszúrása a vezérlőelem szövegébe

• Model.HScroll (logikai érték) - a szöveghez vízszintes görgetősáv tartozik

• Model.MaxTextLen (rövid egész szám) - a szöveg maximális hossza, a 0 érték korlátlan szöveghosszt jelent

• Model.MultiLine (logikai érték) - többsoros szöveg engedélyezése

• 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.Text (karakterlánc) - a vezérlőelemhez tartozó szöveg

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

• Model.VScroll (logikai érték) - a szöveghez függőleges görgetősáv tartozik

• Model.HelpText (karakterlánc) - súgószöveg, amely akkor jelenik meg, 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