| Argumentum | Leírás |
|---|---|
| kérdés | Kötelező. Egy olyan karakterlánc-kifejezés, amely üzenetként megjelenik a párbeszédpanelen. A kérdés maximális hossza körülbelül 1024 karakter, a pontos érték a használt karakterek szélességétől függ. Ha a kérdés egynél több sorból áll, az egyes sorok elválaszthatók kocsivissza (Chr(13)) vagy soremelés karakterrel (Chr(10)), illetve a kettő kombinációjával (Chr(13) & Chr(10)). |
| 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 alapértelmezett értéke 0. |
| cím | Nem kötelező. Egy olyan karakterlánc-kifejezés, amely a párbeszédpanel címsorában jelenik meg. Ha nem ad meg címet, a címsorba az alkalmazás neve kerül. |
| súgófájl | Nem kötelező. Egy olyan karakterlánc-kifejezés, amely megadja azt a súgófájlt, amely a párbeszédpanelhez tartozó környezetfüggő súgót tartalmazza. Ha meg van adva a súgófájl, környezetet is meg kell adni. |
| környezet | Nem kötelező. Egy olyan numerikus kifejezés, amely megadja a súgófájl témakörének környezetazonosítóját, amelyet a súgó szerzője társított a témakörhöz. Ha meg van adva a környezet, súgófájlt is meg kell adni. |
Beállítások
A gombok argumentumnak az alábbi beállításai vannak:
| Á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 az 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é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 adja meg. Így a neveket bárhol használhatja a kódban a tényleges értékek helyett.
Eredményül kapott é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 | Átugorja |
| vbYes | 6 | Igen |
| vbNo | 7 | Nem |
Megjegyzés
Ha meg van adva súgófájl és környezet is, akkor a felhasználó használhatja az F1 (Windows) illetve a Help (Macintosh) gombot a környezethez tartozó súgótémakör megjelenítésére. Egyes gazdaalkalmazások, például a Microsoft Office Excel 2007 a párbeszédpanelhez is automatikusan hozzáadják a Súgó gombot.
Ha párbeszédpanel tartalmaz egy Mégse gombot, akkor az Escape billentyű hatása ugyanaz, mint a Mégse gombra való kattintás. Ha a párbeszédpanel tartalmaz Súgó gombot, akkor a párbeszédpanelhez van környezetérzékeny súgó. Értéket azonban csak akkor kap, ha a felhasználó valamely más gombra kattint rá.
Megjegyzés: Ha az első névvel ellátott argumentumnál többet szeretne megadni, a MsgBox függvényt kifejezésben kell használnia. Ha el szeretne hagyni egyes, pozicionális argumentumokat, a helyükre vesszőt kell illesztenie.
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. További információt a VBA használatáról a Keresés elem mellett található legördülő listából a fejlesztői forrásokat választva, majd egy vagy több keresőszót megadva kaphat.
Ebben a példában a MsgBox függvénnyel megjeleníthet 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