Interaction.MsgBox(Object, MsgBoxStyle, Object) Methode

Definition

Zeigt eine Meldung in einem Dialogfeld an, wartet, bis der Benutzer auf eine Schaltfläche klickt, und gibt dann eine ganze Zahl zurück, die angibt, auf welche Schaltfläche der Benutzer geklickt hat.

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.ApplicationModal, Optional Title As Object = Nothing) As MsgBoxResult

Parameter

Prompt
Object

Required. String Ausdruck, der als Meldung im Dialogfeld angezeigt wird. Die maximale Länge beträgt Prompt ca. 1024 Zeichen, je nach Breite der verwendeten Zeichen. Wenn Prompt sie aus mehr als einer Zeile besteht, können Sie die Zeilen durch ein Wagenrücklaufzeichen (Chr(13)), ein Zeilenvorschubzeichen (Chr(10)) oder eine Wagenrücklauf-/Zeilenvorschubzeichenkombination (Chr(13) & Chr(10)) zwischen jeder Zeile trennen.

Buttons
MsgBoxStyle

Dies ist optional. Numerischer Ausdruck, der die Summe der Werte angibt, die die Anzahl und den Typ der anzuzeigenden Schaltflächen, die zu verwendende Symbolformatvorlage, die Identität der Standardschaltfläche und die Modalität des Meldungsfelds angeben. Wenn Sie weglassen Buttons, ist der Standardwert null.

Title
Object

Dies ist optional. String Ausdruck, der in der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie weglassen Title, wird der Anwendungsname in der Titelleiste platziert.

Gibt zurück

Mögliche Werte:

KonstanteValue
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Ausnahmen

Prompt ist kein String Ausdruck oder Title ungültig.

Der Prozess wird nicht im interaktiven Benutzermodus ausgeführt.

Mindestens ein Parameter, kein Element oder MsgBoxResultMsgBoxStyle eine Enumeration.

Beispiele

In diesem Beispiel wird die MsgBox Funktion verwendet, um eine Fehlermeldung in einem Dialogfeld mit den Schaltflächen "Ja" und "Nein" anzuzeigen. Die Schaltfläche "Nein" ist als Standardantwort angegeben. Dazu werden die MsgBox Konstantenwerte in einem numerischen Ausdruck kombiniert. In diesem Fall gibt das Hinzufügen von 4 (die Kombination aus Ja/Nein) und 16 (das Fenster " Kritische Nachricht ") und 256 (die zweite Schaltfläche als Standardschaltfläche) insgesamt 276. Der von der Funktion zurückgegebene Wert hängt von der MsgBox vom Benutzer gewählten Schaltfläche ab: Ja gibt den Wert 6 zurück; Nein gibt einen Wert von 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 keine Positionsargumente angeben, müssen Sie das entsprechende Kommatrennzeichen beibehalten.

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

Wenn das Dialogfeld die Schaltfläche Hilfe enthält, wird für das Dialogfeld eine kontextbezogene Hilfe zur Verfügung gestellt. Es wird jedoch kein Wert zurückgegeben, bis eine der anderen Schaltflächen ausgewählt wird. In Windows Formularanwendungen führt die Auswahl der Schaltfläche Help das ereignis HelpRequested für das Formular aus.

Note

Die MsgBox Funktion erfordert UIPermission auf der SafeTopLevelWindows Ebene, die sich auf die 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 Value Description
Mitglied Value Description
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 Symbol "Warnungsabfrage" an.
Exclamation 48 Zeigt das Symbol "Warnmeldung" an.
Information 64 Zeigt das Informationsmeldungssymbol an.
DefaultButton1 0 Erste Schaltfläche ist Standardschaltfläche.
DefaultButton2 256 Zweite Schaltfläche ist Standardschaltfläche.
DefaultButton3 512 Dritte Schaltfläche ist Standardschaltfläche.
ApplicationModal 0 Die Anwendung ist modal. Der Benutzer muss auf das Meldungsfeld reagieren, bevor er die Arbeit in der aktuellen Anwendung fortsetzt.
SystemModal 4096 Das System ist modal. Alle Anwendungen werden angehalten, bis der Benutzer auf das Meldungsfeld antwortet.
MsgBoxSetForeground 65536 Legt das Meldungsfeld als Vordergrundfenster fest.
MsgBoxRight 524288 Der Text ist rechts ausgerichtet.
MsgBoxRtlReading 1048576 Gibt an, dass der Text auf hebräischen und arabischen Systemen von rechts links angezeigt werden soll.

Die erste Gruppe von Werten (0-5) beschreibt die Anzahl und den Typ der Schaltflächen, die im Dialogfeld angezeigt werden. Die zweite Gruppe (16, 32, 48, 64) beschreibt die Symbolformatvorlage. Die dritte Gruppe (0, 256, 512) bestimmt, welche Schaltfläche die Standardeinstellung ist. Die vierte Gruppe (0, 4096) bestimmt die Modalität des Meldungsfelds, und die fünfte Gruppe gibt an, ob das Nachrichtenfeldfenster 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