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.Displays a message in a dialog box, waits for the user to click a button, and then returns an integer indicating which button the user clicked.

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

Parameter

Prompt
Object

Erforderlich.Required. Als Meldung im Dialogfeld angezeigter String-Ausdruck.String expression displayed as the message in the dialog box. Die maximale Länge von Prompt beträgt ungefähr 1024 Zeichen, abhängig von der Breite der verwendeten Zeichen.The maximum length of Prompt is approximately 1024 characters, depending on the width of the characters used. Wenn Prompt aus mehr als einer Zeile besteht, können Sie die Zeilen mit einem Wagenrücklaufzeichen (Chr(13)), mit einem Zeilenvorschubzeichen (Chr(10)) oder mit einer Kombination aus beiden (Chr(13) & Chr(10)) voneinander trennen.If Prompt consists of more than one line, you can separate the lines using a carriage return character (Chr(13)), a line feed character (Chr(10)), or a carriage return/linefeed character combination (Chr(13) & Chr(10)) between each line.

Buttons
MsgBoxStyle

Dies ist optional.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.Numeric expression that is the sum of values specifying the number and type of buttons to display, the icon style to use, the identity of the default button, and the modality of the message box. Wenn Sie Buttons nicht angeben, ist der Standardwert 0 (null).If you omit Buttons, the default value is zero.

Title
Object

Optional.Optional. Auf der Titelleiste des Dialogfelds angezeigter String-Ausdruck.String expression displayed in the title bar of the dialog box. Wenn Sie Title nicht angeben, wird der Anwendungsname auf der Titelleiste platziert.If you omit Title, the application name is placed in the title bar.

Gibt zurück

KonstanteConstant WertValue
OK 11
Cancel 22
Abort 33
Retry 44
Ignore 55
Yes 66
No 77
sein..

Ausnahmen

Prompt ist kein String-Ausdruck, oder Title ist ungültig.Prompt is not a String expression, or Title is invalid.

Der Prozess wird nicht im interaktiven Modus ausgeführt.Process is not running in User Interactive mode.

Ein oder mehrere Parameter ist bzw. sind kein/e Member der MsgBoxResult-Enumeration oder der MsgBoxStyle-Enumeration.One or more parameters not a member of MsgBoxResult or MsgBoxStyle enumeration.

Beispiele

In diesem Beispiel wird die MsgBox-Funktion verwendet, um in einem Dialogfeld mit den Schaltflächen Ja und Nein eine kritische Fehlermeldung anzuzeigen.This example uses the MsgBox function to display a critical-error message in a dialog box with Yes and No buttons. Die Schaltfläche Nein wird als Standardantwort angegeben.The No button is specified as the default response. Dies geschieht, indem die Konstanten Werte MsgBox in einem numerischen Ausdruck kombiniert werden.This is done by combining the MsgBox constant values into one numeric expression. Wenn Sie in diesem Fall 4 (die Schaltflächen Kombination Ja/Nein) und 16 (das Fenster Critical Message ) und 256 (die zweite Schaltfläche als Standard Schaltfläche) hinzufügen, ergibt dies insgesamt 276.In this case, adding 4 (the Yes/No button combination) and 16 (the Critical Message window) and 256 (the second button as default button) gives a total of 276. Der von der Funktion "MsgBox" zurückgegebene Wert hängt von der Schaltfläche ab, die vom Benutzer ausgewählt wurde: Yes gibt den Wert 6 zurück. No gibt den Wert 7 zurück.The value returned by the MsgBox function depends on the button chosen by the user: Yes returns a value of 6; No returns a value of 7.

' 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 positionellen Argumente weglassen, müssen Sie das entsprechende Komma Trennzeichen beibehalten.If you omit any positional arguments, you must retain the corresponding comma delimiter.

Wenn im Dialogfeld die Schaltfläche Abbrechen angezeigt wird, hat das Drücken der ESC-Taste denselben Effekt wie das Klicken auf Abbrechen .If the dialog box displays a Cancel button, pressing the ESC key has the same effect as clicking Cancel

Wenn das Dialogfeld eine Hilfe Schaltfläche enthält, wird die kontextbezogene Hilfe für das Dialogfeld bereitgestellt.If the dialog box contains a Help button, context-sensitive Help is provided for the dialog box. Es wird jedoch kein Wert zurückgegeben, bis eine der anderen Schaltflächen ausgewählt ist.However, no value is returned until one of the other buttons is chosen. Wenn Sie in Windows Form-Anwendungen auf die Schaltfläche Hilfe klicken, wird das Ereignis HelpRequested für das Formular ausgeführt.In Windows Form applications, choosing the Help button executes the HelpRequested event for the form.

Hinweis

Die Funktion "MsgBox" erfordert UIPermission auf der Ebene "SafeTopLevelWindows", die sich möglicherweise auf die Ausführung in teilweise vertrauenswürdigen Situationen auswirkt.The MsgBox function requires UIPermission at the SafeTopLevelWindows level, which may affect its execution in partial-trust situations. Weitere Informationen finden Sie unter UIPermission.For more information, see UIPermission.

Die MsgBoxStyle-Enumerationswerte sind in der folgenden Tabelle aufgeführt.The MsgBoxStyle enumeration values are listed in the following table.

MemberMember WertValue BeschreibungDescription
MemberMember WertValue BeschreibungDescription
OKOnly 00 Zeigt nur die Schaltfläche OK an.Displays OK button only.
OKCancel 11 Zeigt die Schaltflächen OK und Abbrechen an.Displays OK and Cancel buttons.
AbortRetryIgnore 22 Zeigt die Schaltflächen Abbrechen, wiederholen und ignorieren an.Displays Abort, Retry, and Ignore buttons.
YesNoCancel 33 Zeigt die Schaltflächen Ja, Nein und Abbrechen an.Displays Yes, No, and Cancel buttons.
YesNo 44 Zeigt die Schaltflächen Ja und Nein an.Displays Yes and No buttons.
RetryCancel 55 Zeigt die Schaltflächen wiederholen und Abbrechen an.Displays Retry and Cancel buttons.
Critical 1616 Zeigt das Symbol für kritische Meldungen an.Displays Critical Message icon.
Question 3232 Zeigt das Symbol für Warn Abfragen an.Displays Warning Query icon.
Exclamation 4848 Zeigt das Symbol für Warnmeldungen an.Displays Warning Message icon.
Information 6464 Zeigt das Symbol Informations Meldung an.Displays Information Message icon.
DefaultButton1 00 Erste Schaltfläche ist Standard.First button is default.
DefaultButton2 256256 Zweite Schaltfläche ist Standard.Second button is default.
DefaultButton3 512512 Dritte Schaltfläche ist Standard.Third button is default.
ApplicationModal 00 Die Anwendung ist modal.Application is modal. Der Benutzer muss auf das Meldungs Feld reagieren, bevor die Arbeit in der aktuellen Anwendung fortgesetzt wird.The user must respond to the message box before continuing work in the current application.
SystemModal 40964096 Das System ist modal.System is modal. Alle Anwendungen werden angehalten, bis der Benutzer auf das Meldungs Feld antwortet.All applications are suspended until the user responds to the message box.
MsgBoxSetForeground 6553665536 Gibt das Meldungs Feld Fenster als Vordergrund Fenster an.Specifies the message box window as the foreground window.
MsgBoxRight 524288524288 Der Text wird rechtsbündig ausgerichtet.Text is right-aligned.
MsgBoxRtlReading 10485761048576 Gibt an, dass Text in hebräischen und arabischen Systemen als Leseberechtigung von rechts nach links angezeigt werden soll.Specifies text should appear as right-to-left reading on Hebrew and Arabic systems.

Die erste Gruppe von Werten (0-5) beschreibt die Anzahl und den Typ der Schaltflächen, die im Dialogfeld angezeigt werden.The first group of values (0-5) describes the number and type of buttons displayed in the dialog box. Die zweite Gruppe (16, 32, 48, 64) beschreibt die Art des Symbols.The second group (16, 32, 48, 64) describes the icon style. Die dritte Gruppe (0, 256, 512) bestimmt, welche Schaltfläche die Standard Schaltfläche ist.The third group (0, 256, 512) determines which button is the default. Die vierte Gruppe (0, 4096) bestimmt die Modalität des Meldungs Felds, und die fünfte Gruppe gibt an, ob das Meldungs Feld Fenster das Vordergrund Fenster ist, zusammen mit der Ausrichtung und Richtung des Texts.The fourth group (0, 4096) determines the modality of the message box, and the fifth group specifies whether or not the message box window is the foreground window, along with the alignment and direction of the text. Wenn Sie Zahlen hinzufügen, um einen Endwert für das Buttons-Argument zu erstellen, verwenden Sie nur eine Zahl aus jeder Gruppe.When adding numbers to create a final value for the Buttons argument, use only one number from each group.

Gilt für:

Siehe auch