Üzenet- és beviteli ablakok (OpenOffice.org futásidejű programkönyvtár)

From Apache OpenOffice Wiki
Jump to: navigation, search
Book.png

Az OpenOffice.org 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.

Documentation note.png 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).
Personal tools