Interaction.MsgBox(Object, MsgBoxStyle, Object) Methode

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

Interaction.vb

Zeigt eine Meldung in einem Dialogfeld an und wartet darauf, dass der Benutzer auf eine Schaltfläche klickt. Anschließend wird eine ganze Zahl zurückgegeben, die angibt, auf welche Schaltfläche geklickt wurde.

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

Parameter

Prompt

Object

Erforderlich. Als Meldung im Dialogfeld angezeigter String-Ausdruck. Die maximale Länge von Prompt beträgt ungefähr 1024 Zeichen, abhängig von der Breite der verwendeten Zeichen. Wenn Prompt sie aus mehr als einer Zeile besteht, können Sie die Linien mit einem Wagenrücklaufzeichen (Chr(13)), einem Zeilenvorschubzeichen (Chr(10)) oder einer Wagenrücklauf-/Zeilenvorschubzeichenkombination (Chr(13) & Chr(10)) zwischen jeder Zeile trennen.

Buttons

MsgBoxStyle

Dies ist optional. Numerischer Ausdruck, der die Summe der Werte für folgende Angaben darstellt: Anzahl und Art der anzuzeigenden Schaltflächen, Art des zu verwendenden Symbols, Angabe der Standardschaltfläche und Verhalten des Meldungsfelds. Wenn Sie Buttons nicht angeben, ist der Standardwert 0 (null).

Title

Object

Dies ist optional. Auf der Titelleiste des Dialogfelds angezeigter String-Ausdruck. Wenn Sie Title nicht angeben, wird der Anwendungsname auf der Titelleiste platziert.

Gibt zurück

MsgBoxResult

Einer der folgenden Werte:

Konstante	Wert
OK	1
Cancel	2
Abort	3
Retry	4
Ignore	5
Yes	6
No	7

Ausnahmen

ArgumentException

Prompt ist kein String-Ausdruck, oder Title ist ungültig.

InvalidOperationException

Der Prozess wird nicht im interaktiven Modus ausgeführt.

InvalidEnumArgumentException

Ein oder mehrere Parameter ist bzw. sind kein/e Member der MsgBoxResult-Enumeration oder der MsgBoxStyle-Enumeration.

Beispiele

In diesem Beispiel wird die MsgBox Funktion verwendet, um eine kritische Fehlermeldung in einem Dialogfeld mit den Schaltflächen Ja und Nein anzuzeigen. Die Schaltfläche Nein wird als Standardantwort angegeben. Dies geschieht, indem die MsgBox Konstantenwerte in einem numerischen Ausdruck kombiniert werden. In diesem Fall ergibt das Hinzufügen von 4 (die Schaltflächenkombination Ja/Nein) und 16 (das Fenster Kritische Nachricht ) und 256 (die zweite Schaltfläche als Standardschaltfläche) insgesamt 276. Der von der MsgBox Funktion zurückgegebene Wert hängt von der vom Benutzer ausgewählten Schaltfläche ab: Ja gibt den Wert 6 zurück; No gibt den Wert 7 zurück.

' 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

Hinweise

Wenn Sie Positionsargumente weglassen, müssen Sie das entsprechende Kommastrennzeichen beibehalten.

Wenn im Dialogfeld die Schaltfläche Abbrechen angezeigt wird, hat das Drücken der ESC-Taste die gleiche Auswirkung wie das Klicken auf Abbrechen.

Wenn das Dialogfeld eine Hilfeschaltfläche enthält, wird kontextabhängige Hilfe für das Dialogfeld bereitgestellt. Es wird jedoch kein Wert zurückgegeben, bis eine der anderen Schaltflächen ausgewählt ist. Wenn Sie in Windows Form-Anwendungen die Schaltfläche Hilfe auswählen, wird das HelpRequested Ereignis für das Formular ausgeführt.

Hinweis

Die MsgBox Funktion benötigt UIPermission auf der SafeTopLevelWindows Ebene, was sich auf ihre Ausführung in Teilweise vertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter UIPermission.

Die MsgBoxStyle Enumerationswerte sind in der folgenden Tabelle aufgeführt.

Mitglied	Wert	BESCHREIBUNG
Mitglied	Wert	BESCHREIBUNG
OKOnly	0	Zeigt nur die Schaltfläche OK an.
OKCancel	1	Zeigt die Schaltflächen OK und Abbrechen an.
AbortRetryIgnore	2	Zeigt die Schaltflächen Abbrechen, Wiederholen und Ignorieren an.
YesNoCancel	3	Zeigt die Schaltflächen Ja, Nein und Abbrechen an.
YesNo	4	Zeigt die Schaltflächen Ja und Nein an.
RetryCancel	5	Zeigt die Schaltflächen Wiederholen und Abbrechen an.
Critical	16	Zeigt das Symbol "Kritische Nachricht" an.
Question	32	Zeigt das Warnungsabfragesymbol an.
Exclamation	48	Zeigt das Symbol "Warnungsmeldung" an.
Information	64	Zeigt das Symbol "Informationsnachricht" an.
DefaultButton1	0	Erste Schaltfläche ist Standard.
DefaultButton2	256	Zweite Schaltfläche ist Standard.
DefaultButton3	512	Dritte Schaltfläche ist Standard.
ApplicationModal	0	Die Anwendung ist modal. Der Benutzer muss auf das Meldungsfeld reagieren, bevor die Arbeit in der aktuellen Anwendung fortgesetzt wird.
SystemModal	4096	Das System ist modal. Alle Anwendungen werden angehalten, bis der Benutzer auf das Meldungsfeld antwortet.
MsgBoxSetForeground	65536	Gibt das Meldungsfeldfenster als Vordergrundfenster an.
MsgBoxRight	524288	Text ist rechtsbündig.
MsgBoxRtlReading	1048576	Gibt an, dass Text in hebräischen und arabischen Systemen als Lesevorgang von rechts nach links angezeigt werden soll.

Die erste Gruppe von Werten (0-5) beschreibt die Anzahl und den Typ der im Dialogfeld angezeigten Schaltflächen. Die zweite Gruppe (16, 32, 48, 64) beschreibt den Symbolstil. Die dritte Gruppe (0, 256, 512) bestimmt, welche Schaltfläche die Standardeinstellung ist. Die vierte Gruppe (0, 4096) bestimmt die Modalität des Nachrichtenfelds, und die fünfte Gruppe gibt an, ob das Fenster des Nachrichtenfelds das Vordergrundfenster ist, zusammen mit der Ausrichtung und Richtung des Texts. Wenn Sie Zahlen hinzufügen, um einen endgültigen Wert für das Buttons Argument zu erstellen, verwenden Sie nur eine Zahl aus jeder Gruppe.

Weitere Informationen

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