Részletes információk az űrlap-vezérlőelemekről

Az űrlapokban elérhető vezérlőelemek hasonlóak a párbeszédpanelekéihez. Ezek az egyszerű szövegmezőtől a listákon és kombinált listákon át egészen a különböző gombokig terjednek.

Az alábbiakban láthatunk egy listát az űrlap-vezérlőelemek legfontosabb tulajdonságairól. Minden tulajdonság a megfelelő modellobjektum része.

A normál vezérlőelemeken felül az űrlapokon elérhetők a tábla-vezérlőelemek is, így az adatbázistáblák használata is lehetővé válik. Erről bővebben a Fejezet 12, Űrlapok, az Adatbázisűrlapok című részben olvashatunk.

Gombok

Az űrlapgomb modellobjektuma a következő tulajdonságokkal rendelkezik:

• BackgroundColor (hosszú egész szám) - a háttérszín.

• DefaultButton (logikai érték) - a gomb az alapértelmezett gomb. Ebben az esetben akkor is reagál az Enter billentyűre, ha nincs rajta fókusz.

• Enabled (logikai érték) - a vezérlőelem aktiválható.

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

• TabIndex (hosszú egész) - a Tab billentyűvel történő bejárási sorrendben elfoglalt hely.

• FontName (karakterlánc) - a betűtípus neve.

• FontHeight (egyszeres pontosságú érték) - a karaktermagasság pontban (pt) megadva.

• Tag (karakterlánc) - további információkat tartalmazó karakterlánc, amely menthető a gombban a programvezérelt eléréshez.

• TargetURL (karakterlánc) - az URL típusú gombok cél-URL-je.

• TargetFrame (karakterlánc) - az ablak (vagy keret) neve, amelyben a TargetURL célját meg kell nyitni a gomb aktiválásakor (az URL típusú gomboknál).

• Label (karakterlánc) - a gomb címkéje.

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

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

• HelpURL (karakterlánc) - az adott vezérlőelem online súgójának URL-je.

• ButtonType (enumeráció) - a gombhoz tartozó művelet (alapértelmezett érték a com.sun.star.form.FormButtonType állandócsoportból).

A ButtonType tulajdonsággal megadhatunk egy műveletet, amelyet a program automatikusan végrehajt, ha megnyomják a gombot. A hozzá tartozó com.sun.star.form.FormButtonType állandócsoport a következő értékeket tartalmazza:

• PUSH - normál gomb.

• SUBMIT - bevitel befejezése (főleg HTML-űrlapokon).

• RESET - az űrlap összes értékét visszaállítja az eredeti értékükre.

• URL - a TargetURL tulajdonságban megadott URL meghívása (a TargetFrame tulajdonságban megadott ablakban nyílik meg).

A párbeszédablakok OK és a Cancel gombtípusa nem támogatott az űrlapokban.

Választógombok

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

• Enabled (logikai érték) - a vezérlőelem aktiválható.

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

• TabIndex (hosszú egész) - a Tab billentyűvel történő bejárási sorrendben elfoglalt hely.

• FontName (karakterlánc) - a betűtípus neve.

• FontHeight (egyszeres pontosságú érték) - a karaktermagasság pontban (pt) megadva.

• Tag (karakterlánc) - további információkat tartalmazó karakterlánc, amely menthető a gombban a programvezérelt eléréshez.

• Label (karakterlánc) - a gomb felirata.

• Enabled (logikai érték) - a vezérlőelem kinyomtatható.

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

• RefValue (karakterlánc) - karakterlánc további információk mentéséhez (például adatrekord-azonosítók kezeléséhez).

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

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

• HelpURL (karakterlánc) - az adott vezérlőelem online súgójának URL-je.

A választógombok csoportosításának módja különbözik a párbeszédablakoknál és az űrlapoknál. Míg a párbeszédablakokban egymás után megjelenő vezérlőelemek automatikusan egy csoportba tartoznak, addig az űrlapokban a csoportosítás a neveken alapul. A csoportosításhoz az összes választógombnak ugyanolyan nevűnek kell lennie a csoportban. A StarOffice a csoportosított vezérlőelemeket egy tömbbé kombinálja, így a StarOffice Basic-program egyes választógombjai ugyanúgy elérhetők, mint azelőtt.

A következő példa bemutatja, hogyan határozható meg egy vezérlőelem-csoport modellje.

Dim Doc As Object

Dim Forms As Object

Dim Form As Object

Dim Ctl As Object

Dim I as Integer

   

Doc = StarDesktop.CurrentComponent

Forms = Doc.Drawpage.Forms



For I = 0 To Forms.Count - 1

   Form = Forms.GetbyIndex(I)

   If Form.HasByName("SajátVálasztógombok") Then

      Ctl = Form. GetGroupbyName("SajátVálasztógombok")

      Exit Function

   End If

Next I