Üzenet- és beviteli ablakok (Apache OpenOffice futásidejű programkönyvtár)
Az Apache OpenOffice Basic az MsgBox és az InputBox függvényt biztosítja a felhasználóval végzett alapszintű kommunikációhoz.
Üzenetek megjelenítése
Az MsgBox függvény egy információs ablakot jelenít meg, amely egy vagy több gombbal rendelkezhet. Az MsgBox legegyszerűbb változata csak a szöveget és az OK gombot tartalmazza.
MsgBox "Ez itt egy információs üzenet!"
Az információs ablak megjelenése egy paraméterrel módosítható. A paraméterrel további gombok jeleníthetők meg, megadható az alapértelmezett gomb, és megjeleníthető egy ikon.
 |
A hagyomány szerint az alább megadott szimbolikus neveket NAGYBETŰKKEL írjuk, hogy hangsúlyozzuk előre definiált mivoltukat, azaz hogy nem felhasználó által definiáltak. Ennek ellenére a nevek írásánál a kis- és nagybetűk között nem tesz különbséget a rendszer. |
A gombok beállítására szolgáló értékek a következők:
- 0, MB_OK - OK gomb
- 1, MB_OKCANCEL - OK és Mégse gomb
- 2, MB_ABORTRETRYIGNORE - Megszakítás, Ismét és Mellőzés gombok
- 3, MB_YESNOCANCEL - Igen, Nem és Mégse gomb
- 4, MB_YESNO - Igen és Nem gomb
- 5, MB_RETRYCANCEL - Ismét és Mégse gomb
Ha egy gombot alapértelmezett gombként akarunk beállítani, akkor gombok értékéhez adjuk hozzá a következő értékek egyikét. Ha például az Igen, Nem és Mégse gombot (3-as érték) akarjuk megjeleníteni, és azt akarjuk, hogy a Mégse gomb legyen az alapértelmezett (512-es érték), akkor a paraméter értéke 3+ 512 = 515. Az MB_YESNOCANCEL + MB_DEFBUTTON3 kifejezést nehezebb leírni, de megérteni könnyebb.
- 0, MB_DEFBUTTON1 - Az első gomb az alapértelmezett.
- 256, MB_DEFBUTTON2 - A második gomb az alapértelmezett.
- 512, MB_DEFBUTTON3 - A harmadik gomb az alapértelmezett.
Végül a következő információs jelek is megjeleníthetők a megfelelő paraméterérték hozzáadásával:
- 16, MB_ICONSTOP - Stopjel
- 32, MB_ICONQUESTION - Kérdőjel
- 48, MB_ICONEXCLAMATION - Felkiáltójel
- 64, MB_ICONINFORMATION - Tippikon
A következő függvény megjelenít egy információs ablakot az Igen és a Nem gombbal (4-es érték), amelyek közül a második (Nem) az alapértelmezett gomb (256-os érték), valamint egy kérdőjelet (32-es érték): 4+256+32 = 292.
MsgBox "Szeretné folytatni?", 292
' vagy
MsgBox "Szeretné folytatni?", MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
Ha egy információs ablak több gombot tartalmaz, akkor a visszatérési értéket meg kell vizsgálni, hogy a felhasználó melyik gombot nyomta meg- Itt a következő visszatérési értékek szerepelhetnek:
- 1, IDOK - OK
- 2, IDCANCEL - Mégse
- 3, IDABORT - Megszakítás
- 4, IDRETRY - Ismét
- 5 - Mellőzés
- 6, IDYES - Igen
- 7, IDNO - Nem
Az előző példában a következőképpen lehet ellenőrizni a visszatérési értéket:
Dim iBox as Integer
iBox = MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
If MsgBox ("Szeretné folytatni?", iBox) = IDYES Then
' vagy
If MsgBox ("Szeretné folytatni?", 292) = 6 Then
' Az Igen gombot nyomták meg.
Else
' A Nem gombot nyomták meg.
End IF
Az információs szövegen és az üzenetpanel elrendezését meghatározó paraméteren felül az MsgBox engedélyezi egy harmadik paraméter használatát is, amely megadja az ablak címét:
MsgBox "Szeretné folytatni?", 292, "Ablak címe"
Ha nincs megadva cím, akkor a „soffice” karakterlánc jelenik meg.
Beviteli ablak egyszerű karakterláncok beolvasásához
Az InputBox függvénnyel egyszerű karakterláncokat lehet beolvasni a felhasználótól. Ezért ez egy egyszerű alternatívája a párbeszédablakok használatának. Az InputBox három szabványos paramétert használt:
- egy információs szöveget,
- egy ablakcímet
- és egy alapértelmezett értéket, amely megjelenik a beviteli mezőben.
InputVal = InputBox("Adjon meg egy értéket:", "Teszt", "alapértelmezett érték")
Visszatérési értékként az InputBox a felhasználó által beírt szöveget adja vissza.
| Content on this page is licensed under the Public Documentation License (PDL). |
