Egy Access asztali adatbázisban az MsgBox függvény megjelenít egy üzenetet egy párbeszédpanelen, megvárja, amíg a felhasználó rákattint egy gombra, és egy egész számot ad vissza, amely jelzi, hogy a felhasználó melyik gombra kattintott.
Szintaxis
MsgBox ( üzenet [, gombok ] [, cím ] [, súgófájl ] [, környezet ] )
Az MsgBox függvény argumentumai a következők:
|
Argumentum |
Leírás |
|---|---|
|
üzenet |
Kötelező. A párbeszédpanelen üzenetként megjelenő karakterlánc-kifejezés. Az üzenet argumentum maximális hossza körülbelül 1024 karakter, a használt karakterek szélességétől függően. Ha az üzenet egynél több sorból áll, a sorokat kocsivissza (Chr(13)) vagy soremelés (Chr(10)) karakterrel, illetve a kettő kombinációjával (Chr(13) & Chr(10)) választhatja el egymástól. |
|
gombok |
Nem kötelező. Egy numerikus kifejezés, amely azoknak az értékeknek az összege, amelyek megadjá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 gombok argumentum alapértelmezett értéke 0. |
|
cím |
Nem kötelező. A párbeszédpanel címsorában megjelenő karakterlánc-kifejezés. Ha kihagyja a cím argumentumot, a címsorba az alkalmazás neve kerül. |
|
súgófájl |
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 megadja a súgófájl argumentumot, a környezet argumentumot is meg kell adnia. |
|
környezet |
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 megadja a környezet argumentumot, akkor a súgófájl argumentumot is meg kell adnia. |
Beállítások
A gombok argumentum beállításai a következők:
|
Állandó |
Érték |
Leírás |
|---|---|---|
|
vbOKOnly |
0 |
Csak az OK gombot jeleníti meg. |
|
vbOKCancel |
1 |
Megjeleníti az OK és a Mégse gombot. |
|
vbAbortRetryIgnore |
2 |
Megjeleníti a Megszakítás, az Újra és a Mellőzés gombot. |
|
vbYesNoCancel |
3 |
Megjeleníti az Igen, a Nem és a Mégse gombot. |
|
vbYesNo |
4 |
Megjeleníti az Igen és a Nem gombot. |
|
vbRetryCancel |
5 |
Megjeleníti az Újra és a Mégse gombot. |
|
vbCritical |
16 |
Megjeleníti a Kritikus üzenet ikont. |
|
vbQuestion |
32 |
Megjeleníti a Figyelmeztető kérdés ikont. |
|
vbExclamation |
48 |
Megjeleníti a Figyelmeztető üzenet ikont. |
|
vbInformation |
64 |
Megjeleníti a Tájékoztató üzenet ikont. |
|
vbDefaultButton1 |
0 |
Az első gomb az alapértelmezett. |
|
vbDefaultButton2 |
256 |
A második gomb az alapértelmezett. |
|
vbDefaultButton3 |
512 |
A harmadik gomb az alapértelmezett. |
|
vbDefaultButton4 |
768 |
A negyedik gomb az alapértelmezett. |
|
vbApplicationModal |
0 |
Alkalmazási 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 módú; minden alkalmazás fel van függesztve addig, amíg a felhasználó nem válaszol az üzenetpanelre. |
|
vbMsgBoxHelpButton |
16384 |
Súgó gombot ad az üzenetpanelhez. |
|
VbMsgBoxSetForeground |
65536 |
Megadja, hogy az üzenetpanel ablaka legyen az előtérben. |
|
vbMsgBoxRight |
524288 |
Megadja, hogy a szöveg jobbra legyen igazítva. |
|
vbMsgBoxRtlReading |
1048576 |
Megadja, hogy a szöveg jobbról balra olvasandó szövegként jelenjen meg héber és arab rendszeren. |
Az értékek első csoportja (0–5) megadja a párbeszédpanelen megjelenítendő gombok számát és típusát; a második csoport (16, 32, 48, 64) megadja az ikonstílust; a harmadik csoport (0, 256, 512) meghatározza, hogy melyik gomb legyen az alapértelmezett; és végül a negyedik csoport (0, 4096) határozza meg az üzenetpanel módját. Amikor a számok összeadásával meghatározza a gombok argumentum értékét, egy csoportból csak egy számot használjon.
Megjegyzés: Ezeket az állandókat a Visual Basic for Applications határozza meg. Ennek eredményeképpen a nevek bárhol felhaszná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 a súgófájl és a környezet is meg van adva, a felhasználó az F1 (Windows) vagy a HELP (macOS) billentyű lenyomásával megtekintheti a környezetnek megfelelő súgótémakört. Egyes gazdaalkalmazások, például a Microsoft Excel is automatikusan hozzáadnak egy Súgó gombot a párbeszédpanelhez.
Ha a párbeszédpanel tartalmaz egy Mégse gombot, akkor az ESC billentyű hatása ugyanaz, mint a Mégse gombra való kattintás. Ha a párbeszédpanel tartalmaz egy Súgó gombot, akkor a párbeszédpanelhez tartozik környezetérzékeny súgó. A párbeszédpanel azonban csak akkor ad vissza értéket, ha a felhasználó az egyéb gombok egyikére kattint.
Megjegyzés: Ha az első elnevezett argumentumnál többet szeretne megadni, akkor az MsgBox függvényt egy kifejezésben kell használnia. 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éldák egy Visual Basic for Applications (VBA) modulban mutatják be a függvény használatát.
Ebben a példában az MsgBox függvény megjelenít egy párbeszédpanelt, amely egy kritikus hibáról szóló üzenetet, továbbá egy Igen és egy Nem gombot tartalmaz. Az alapértelmezett válasz a Nem gomb. A MsgBox függvény által eredményül adott érték attól függ, hogy a felhasználó melyik gombot választja. A példa feltételezi, hogy a DEMO.HLP egy 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
