Interaction.MsgBox(Object, MsgBoxStyle, Object) Methode

Definition

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);
public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, 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
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, 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

Einer der folgenden Werte:

KonstanteWert
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Ausnahmen

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

Der Prozess wird nicht im interaktiven Modus ausgeführt.

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.

Gilt für:

Weitere Informationen