Asztali Access-adatbázisokban a MsgBox függvény megjelenít egy üzenetet egy párbeszédpanelen, megvárja, amíg a felhasználó kiválaszt egy gombot, majd egy Integer olyan gombot ad vissza, amely jelzi, hogy a felhasználó melyik gombot választotta.
Szintaxis
MsgBox(prompt[, buttons][, title][, helpfile][, context])
A MsgBox függvény szintaxisa az alábbi argumentumokat foglalja magában:
| argumentumok | Leírás |
|---|---|
prompt |
Kötelező. A párbeszédpanelen üzenetként megjelenő karakterlánc-kifejezés. A maximális hossz prompt körülbelül 1024 karakter, a használt karakterek szélességétől függően. Ha prompt egynél több sora van, a sorokat kocsivissza (),Chr(13) soremelés (Chr(10)) karakterrel, illetve a sorok közötti kocsi-soremelés kombinációval (Chr(13) & Chr(10)) választhatja el egymástól. |
buttons |
Nem kötelező. Numerikus kifejezés, mely azoknak az értékeknek az összege, amelyek meghatározzák a megjelenítendő gombok számát és típusát, a használandó ikontípust, az alapértelmezett gombot és az üzenetpanel módját. Ha nincs megadva, a paraméter buttons alapértelmezett értéke a 0. |
title |
Nem kötelező. A párbeszédpanel címsorában megjelenő karakterlánc-kifejezés. Ha nem adja meg title, akkor az alkalmazás neve megjelenik a címsorban. |
helpfile |
Nem kötelező. Karakterlánc-kifejezés, amely a párbeszédpanel környezetfüggő súgóját biztosító súgófájlt azonosítja. Ha helpfile igen, azt context is meg kell adni. |
context |
Nem kötelező. Numerikus kifejezés, amely a súgó szerzője által a megfelelő súgótémakörhöz rendelt környezetfüggő szám. Ha context igen, azt helpfile is meg kell adni. |
Beállítások
Az buttons argumentumbeállítások a következők:
| Állandó | Érték | Leírás |
|---|---|---|
vbOKOnly |
0 |
Csak a megjelenítés OK. |
vbOKCancel |
1 |
Megjelenítés OK és Mégse gombra. |
vbAbortRetryIgnore |
2 |
Megjelenítés, Megszakítás, Újrapróbálás és Mellőzés |
vbYesNoCancel |
3 |
Az Igen, a Nem és a Mégse megjelenítése |
vbYesNo |
4 |
Az Igen és a Nem megjelenítése |
vbRetryCancel |
5 |
Az Újrapróbálkozás és a Mégse megjelenítése |
vbCritical |
16 |
Megjeleníti a Kritikus üzenet ikont. |
vbQuestion |
32 |
A figyelmeztető lekérdezés ikon megjelenítése. |
vbExclamation |
48 |
A figyelmeztető üzenet ikonjának megjelenítése. |
vbInformation |
64 |
A tájékoztató üzenet ikonjának megjelenítése. |
vbDefaultButton1 |
0 |
Az első gomb beállítása alapértelmezettként |
vbDefaultButton2 |
256 |
A második gomb beállítása alapértelmezettként |
vbDefaultButton3 |
512 |
A harmadik gomb beállítása alapértelmezettként |
vbDefaultButton4 |
768 |
A negyedik gomb bejelölése alapértelmezettnek |
vbApplicationModal |
0 |
Alkalmazás módú. A felhasználónak válaszolnia kell az üzenetpanelre, mielőtt folytatja a munkát az aktuális alkalmazásban. |
vbSystemModal |
4096 |
Rendszer modális. Az összes alkalmazás fel lesz függesztve addig, amíg a felhasználó nem válaszol az üzenetpanelre. |
vbMsgBoxHelpButton |
16384 |
Súgó gomb elhelyezése az üzenetpanelen. |
VbMsgBoxSetForeground |
65536 |
Adja meg az üzenetpanel ablakát előtérablakként. |
vbMsgBoxRight |
524288 |
A szöveg jobbra igazítása |
vbMsgBoxRtlReading |
1048576 |
A szöveg megjelenítése jobbról balra olvasással héber és arab rendszeren. |
Az értékek első csoportja (05–) a párbeszédpanelen megjelenítendő gombok számát és típusát határozza meg. A második csoport (16, 32, 48, ) 64az ikonstílust írja le. A harmadik csoport (0, 256) 512határozza meg, hogy melyik gomb az alapértelmezett. A negyedik csoport (0, 4096) határozza meg az üzenetpanel módját. Amikor a számok összeadásával határozza meg az buttons argumentum értékét, egy csoportból csak egy számot használjon.
Megjegyzés
Az állandókat a Visual Basic for Applications adja meg. Ennek következtében a nevek bárhol használhatók a kódban a tényleges értékek helyett.
Visszatérési értékek
| Állandó | Érték | Leírás |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Mégse |
vbAbort |
3 |
Megszakítás |
vbRetry |
4 |
Újra |
vbIgnore |
5 |
Mellőzés |
vbYes |
6 |
Igen |
vbNo |
7 |
Nem |
Megjegyzések
Ha mindkettő helpfilecontext meg van adva, a megfelelő súgótémakör contextmegtekintéséhez nyomja le az F1 billentyűt a Windowsban vagy a Súgót macOS rendszerben. Egyes gazdaalkalmazások, például a Microsoft Excel, automatikusan elhelyeznek egy Súgó gombot a párbeszédpanelen.
Ha a párbeszédpanel tartalmaz egy Mégse gombot, az Esc billentyű hatása ugyanaz, mintha a Mégse gombot választaná. Ha a párbeszédpanel tartalmaz egy Súgó gombot, akkor a párbeszédpanelhez tartozik környezetérzékeny súgó. Azonban mindaddig nem ad vissza értéket, amíg a felhasználó ki nem választ egy másik gombot.
Megjegyzés
Ha az elsőként elnevezett argumentumnál többet szeretne megadni, azt egy kifejezésben kell használnia MsgBox . Ha ki szeretne hagyni egyes pozíciófüggő argumentumokat, az argumentumhoz tartozó elválasztó karaktert szerepeltetnie kell.
Példa
Megjegyzés
A következő példa bemutatja, hogyan használható a függvény egy Visual Basic for Applications (VBA) modulban.
Az alábbi példa a MsgBox függvény használatával megjelenít egy párbeszédpanelt, amely egy kritikus hibáról szóló üzenetet jelenít meg, Igenés Nem gombot tartalmazó párbeszédpanelen. Az alapértelmezett válasz a Nem gomb. A függvény által MsgBox eredményül adott érték a felhasználó által kiválasztott gombtól függ. A példa feltételezi, hogy ez DEMO.HLP egy olyan súgófájl, amely egy olyan témakört tartalmaz, amelynek környezetazonosítója .1000
Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If