Interaction.MsgBox(Object, MsgBoxStyle, Object) Metódus

Definíció

Névtér:

Microsoft.VisualBasic

Szerelvény:

Microsoft.VisualBasic.Core.dll

Forrás:

Interaction.vb

Megjelenít egy üzenetet egy párbeszédpanelen, megvárja, amíg a felhasználó rákattint egy gombra, majd visszaad egy egész számot, amely jelzi, hogy a felhasználó melyik gombra kattintott.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox(object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, object? Title = default);

static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult

Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, Optional Title As Object = Nothing) As MsgBoxResult

Paraméterek

Prompt

Object

Kötelező. String kifejezés jelenik meg üzenetként a párbeszédpanelen. A maximális hossz Prompt a használt karakterek szélességétől függően körülbelül 1024 karakter lehet. Ha Prompt egynél több sorból áll, a vonalakat egy kocsivissza karakterrel (13Chr(), egy vonalbetöltési karakterrel ()Chr(10)) vagy egy kocsivissza/sortörés karakterkombinációval (Chr(13) és Chr(10)) elválaszthatja egymástól.

Buttons

MsgBoxStyle

Optional. Numerikus kifejezés, amely a megjelenítendő gombok számát és típusát, a használni kívánt ikonstílust, az alapértelmezett gomb identitását és az üzenetmező modalitását adja meg. Ha kihagyja Buttons, az alapértelmezett érték nulla.

Title

Object

Optional. String kifejezés jelenik meg a párbeszédpanel címsorában. Ha kihagyja Title, az alkalmazás neve a címsorba kerül.

Válaszok

MsgBoxResult

Az alábbi értékek egyike:

Állandó	Érték
OK	1
Cancel	2
Abort	3
Retry	4
Ignore	5
Yes	6
No	7

Kivételek

ArgumentException

Prompt nem kifejezés String , vagy Title érvénytelen.

InvalidOperationException

A folyamat nem felhasználói interaktív módban fut.

InvalidEnumArgumentException

Egy vagy több paraméter nem tagja vagy MsgBoxResultMsgBoxStyle enumerálása.

Példák

Ez a példa a függvény használatával MsgBox jelenít meg egy kritikus hibaüzenetet az Igen és a Nem gombokkal rendelkező párbeszédpanelen. Az alapértelmezett válasz a Nem gomb. Ez úgy történik, hogy az MsgBox állandó értékeket egyetlen numerikus kifejezésbe egyesíti. Ebben az esetben a 4 (az Igen/Nem gombkombináció) és a 16 ( a Kritikus üzenet ablak) és a 256 (a második gomb alapértelmezett gombként) hozzáadása összesen 276-ot ad. A függvény által visszaadott érték a MsgBox felhasználó által választott gombtól függ: Igen, 6 értéket ad vissza; Nem ad vissza 7-et.

' The following example requires that Option Infer be set to On.

' Define the message you want to see inside the message box.
Dim msg = "Do you want to continue?"

' Display a simple message box.
MsgBox(msg)

' Define a title for the message box.
Dim title = "MsgBox Demonstration"

' Add the title to the display.
MsgBox(msg, , title)

' Now define a style for the message box. In this example, the
' message box will have Yes and No buttons, the default will be
' the No button, and a Critical Message icon will be present.
Dim style = MsgBoxStyle.YesNo Or MsgBoxStyle.DefaultButton2 Or
            MsgBoxStyle.Critical

' Display the message box and save the response, Yes or No.
Dim response = MsgBox(msg, style, title)

' Take some action based on the response.
If response = MsgBoxResult.Yes Then
    MsgBox("YES, continue!!", , title)
Else
    MsgBox("NO, stop!!", , title)
End If

Megjegyzések

Ha kihagy bármilyen pozícióargumentumot, meg kell őriznie a megfelelő vesszőelválasztót.

Ha a párbeszédpanelen megjelenik a Mégse gomb, az ESC billentyű lenyomása ugyanolyan hatással van, mint a Mégse gombra

Ha a párbeszédpanel tartalmaz egy Súgó gombot, akkor a párbeszédpanelhez tartozik környezetérzékeny súgó. A többi gomb egyikének kiválasztásáig azonban nem ad vissza értéket. Az Windows űrlapalkalmazásokban a Help gombbal végrehajtja az űrlap HelpRequested eseményét.

Note

A MsgBox függvény megköveteli UIPermission a SafeTopLevelWindows szintet, ami befolyásolhatja a részleges megbízhatósági helyzetekben történő végrehajtását. További információért lásd UIPermission.

Az MsgBoxStyle enumerálási értékek az alábbi táblázatban találhatók.

Tag	Érték	Leírás
Tag	Érték	Leírás
OKOnly	0	Csak az OK gombot jeleníti meg.
OKCancel	1	Megjeleníti az OK és a Mégse gombot.
AbortRetryIgnore	2	Az Megszakítás, az Újrapróbálkozás és a Mellőzés gomb megjelenítése.
YesNoCancel	3	Megjeleníti az Igen, a Nem és a Mégse gombot.
YesNo	4	Megjeleníti az Igen és a Nem gombot.
RetryCancel	5	Megjeleníti az Újrapróbálkozás és a Mégse gombot.
Critical	16	Kritikus üzenet ikon megjelenítése.
Question	32	Megjeleníti a Figyelmeztető lekérdezés ikont.
Exclamation	48	Figyelmeztető üzenet ikon megjelenítése.
Information	64	Az Információs üzenet ikon megjelenítése.
DefaultButton1	0	Az első gomb az alapértelmezett.
DefaultButton2	256	A második gomb az alapértelmezett.
DefaultButton3	512	A harmadik gomb az alapértelmezett.
ApplicationModal	0	Az alkalmazás modális. A felhasználónak válaszolnia kell az üzenetmezőre, mielőtt folytatná a munkát az aktuális alkalmazásban.
SystemModal	4096	A rendszer modális. A rendszer mindaddig felfüggeszti az alkalmazásokat, amíg a felhasználó nem válaszol az üzenetmezőre.
MsgBoxSetForeground	65536	Az üzenetmező ablakát adja meg előtérablakként.
MsgBoxRight	524288	A szöveg jobbra van igazítva.
MsgBoxRtlReading	1048576	A szövegnek jobbról balra író olvasásként kell megjelennie héber és arab rendszereken.

Az első értékcsoport (0-5) a párbeszédpanelen megjelenő gombok számát és típusát ismerteti. A második csoport (16, 32, 48, 64) az ikonstílust írja le. A harmadik csoport (0, 256, 512) határozza meg, hogy melyik gomb az alapértelmezett. A negyedik csoport (0, 4096) határozza meg az üzenetmező modalitását, az ötödik csoport pedig azt határozza meg, hogy az üzenetmező ablaka-e az előtérablak, valamint a szöveg igazítása és iránya. Ha számokat ad hozzá az Buttons argumentum végső értékének létrehozásához, minden csoportból csak egy számot használjon.

Lásd még

• InputBox(String, String, String, Int32, Int32)
• Show(String)