Freigeben über


MessageBox.Show Methode

Definition

Zeigt ein Meldungsfenster an.

Überlädt

Show(String)

Zeigt ein Meldungsfenster mit angegebenem Text an.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Zeigt mithilfe der angegebenen Hilfedatei und des angegebenen Hilfestichworts ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Zeigt mithilfe der angegebenen Hilfedatei, HelpNavigator und dem angegebenen Hilfethema ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Zeigt unter Verwendung der angegebenen Hilfedatei ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Zeigt mithilfe der angegebenen Hilfedatei und HelpNavigator ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Zeigt mithilfe der angegebenen Hilfedatei und des angegebenen Hilfestichworts ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der Standardschaltfläche und Optionen an.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Zeigt unter Verwendung der angegebenen Hilfedatei ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Zeigt mithilfe der angegebenen Hilfedatei und HelpNavigator ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol und der Standardschaltfläche an.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen und dem angegebenen Symbol an.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, dem angegebenen Symbol und der Standardschaltfläche an.

Show(IWin32Window, String, String, MessageBoxButtons)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung und den angegebenen Schaltflächen an.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen und dem angegebenen Symbol an.

Show(IWin32Window, String, String)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text und der angegebenen Beschriftung an.

Show(String, String, MessageBoxButtons)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung und den angegebenen Schaltflächen an.

Show(IWin32Window, String)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text an.

Show(String, String)

Zeigt ein Meldungsfenster mit dem angegebenen Text und der angegebenen Beschriftung an.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der Standardschaltfläche und Optionen an.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Zeigt mithilfe der angegebenen Hilfedatei, HelpNavigator und dem angegebenen Hilfethema ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

Show(String)

Zeigt ein Meldungsfenster mit angegebenem Text an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);
public static System.Windows.Forms.DialogResult Show (string text);
public static System.Windows.Forms.DialogResult Show (string? text);
static member Show : string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

Gibt zurück

Einer der DialogResult-Werte.

Beispiele

Im folgenden Codebeispiel wird ein einfaches Meldungsfeld angezeigt.

private void DisplayMessageBoxText()
{
         MessageBox.Show("Hello, world.");
}
Private Sub DisplayMessageBoxText()

    MessageBox.Show("Hello, world.")
End Sub

Hinweise

Standardmäßig wird im Meldungsfeld eine Schaltfläche OK angezeigt. Das Meldungsfeld enthält keine Untertitel im Titel.

Gilt für:

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Zeigt mithilfe der angegebenen Hilfedatei und des angegebenen Hilfestichworts ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

keyword
String

Das Hilfestichwort, das angezeigt wird, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungsfeld angezeigt wird, das dem fenster Standard zugeordnet ist. Im Meldungsfeld wird eine Hilfeschaltfläche angezeigt. Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die Mspaint.chm Hilfedatei geöffnet, und das durch die mspaint.chm::/paint_brush.htm Schlüsselwort (keyword) identifizierte Thema wird angezeigt. Für das Beispiel muss die Mspaint.chm Hilfedatei installiert sein.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r8 = MessageBox::Show( this, "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r8 As DialogResult = MessageBox.Show(Me, "Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Hinweise

Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) erfolgen können, außer für Objekte im modale Formular. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor die Eingabe in ein anderes Formular erfolgen kann. Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window -Schnittstelle implementiert, das als Besitzer der obersten Ebene des Dialogfelds fungiert.

Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die im helpFilePath Parameter angegebene Hilfedatei geöffnet, und das durch den keyword Parameter identifizierte Thema "Hilfe Schlüsselwort (keyword)" wird angezeigt. Das -Ereignis wird ebenfalls von dem Formular empfangen, das das Meldungsfeld (oder das aktive Formular) besitzt HelpRequested .

Weitere Informationen

Gilt für:

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Zeigt mithilfe der angegebenen Hilfedatei, HelpNavigator und dem angegebenen Hilfethema ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

navigator
HelpNavigator

Einer der HelpNavigator-Werte.

param
Object

Die numerische ID des Hilfethemas, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungsfeld mit einer Hilfeschaltfläche angezeigt wird. Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die Mspaint.chm Hilfedatei geöffnet, und die Registerkarte "Hilfeindex" und das durch die ovals Schlüsselwort (keyword) identifizierte Thema werden angezeigt. Für das Beispiel muss die Mspaint.chm Hilfedatei installiert sein.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r5 = MessageBox::Show( "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show ("Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r5 As DialogResult = MessageBox.Show("Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Hinweise

Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann.

Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die im helpFilePath Parameter angegebene Hilfedatei geöffnet, und der durch den navigator Parameter identifizierte Hilfeinhalt wird angezeigt. Das Formular, das das Meldungsfeld (oder das aktive Formular) besitzt, empfängt das HelpRequested Ereignis ebenfalls.

Kompilierte Hilfedateien bieten Inhaltsverzeichnis, Index, Suche und Schlüsselwort (keyword) Links auf Seiten. Sie können die folgenden Werte für navigatorverwenden: TableOfContents, Find, Indexoder Topic.

Sie können verwenden param , um den Topic Befehl weiter zu verfeinern. Wenn der im navigator -Parameter angegebene Wert , Indexoder FindistTableOfContents, sollte dieser Wert seinnull. Wenn der navigator Parameter auf verweist Topic, sollte dieser Wert auf ein Objekt verweisen, das den numerischen Wert des anzuzeigenden Themas enthält.

Der helpFilePath Parameter kann das Format C:\path\sample.chm oder /folder/file.htm haben.

Weitere Informationen

Gilt für:

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Zeigt unter Verwendung der angegebenen Hilfedatei ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungsfeld angezeigt wird, das dem formular Standard zugeordnet ist. Im Meldungsfeld wird eine Hilfeschaltfläche angezeigt. Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die Mspaint.chm Hilfedatei geöffnet. Das Beispiel erfordert, dass die Mspaint.chm Hilfedatei installiert ist.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r2 = MessageBox::Show( this, "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Hinweise

Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann. Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window Schnittstelle implementiert, das als Fenster der obersten Ebene und besitzer des Dialogfelds dient.

Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die im helpFilePath Parameter angegebene Hilfedatei geöffnet. Das Formular, das das Meldungsfeld (oder das aktive Formular) besitzt, empfängt das HelpRequested Ereignis ebenfalls.

Der helpFilePath Parameter kann das Format C:\path\sample.chm oder /folder/file.htm haben.

Weitere Informationen

Gilt für:

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Zeigt mithilfe der angegebenen Hilfedatei und HelpNavigator ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

navigator
HelpNavigator

Einer der HelpNavigator-Werte.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungsfeld mit einer Hilfeschaltfläche angezeigt wird. Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die Mspaint.chm Hilfedatei geöffnet, und die Registerkarte Hilfeindex wird angezeigt. Das Beispiel erfordert, dass die Mspaint.chm Hilfedatei installiert ist.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
System::Windows::Forms::DialogResult r3 = MessageBox::Show( "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
DialogResult r3 = MessageBox.Show ("Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display a message box. The Help button opens 
' the Mspaint.chm Help file and shows the Help contents 
' on the Index tab.
Dim r3 As DialogResult = MessageBox.Show("Message with Help file and Help navigator.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.Index)

Hinweise

Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann.

Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die im helpFilePath Parameter angegebene Hilfedatei geöffnet, und der durch den navigator Parameter identifizierte Hilfeinhalt wird angezeigt. Das Formular, das das Meldungsfeld (oder das aktive Formular) besitzt, empfängt das HelpRequested Ereignis ebenfalls.

Kompilierte Hilfedateien stellen Inhaltsverzeichnisse, Index-, Such- und Schlüsselwort (keyword) Links auf Seiten bereit. Sie können die folgenden Werte für navigatorverwenden: TableOfContents, Find, Indexoder Topic.

Der helpFilePath Parameter kann das Format C:\path\sample.chm oder /folder/file.htm haben.

Weitere Informationen

Gilt für:

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Zeigt mithilfe der angegebenen Hilfedatei und des angegebenen Hilfestichworts ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

keyword
String

Das Hilfestichwort, das angezeigt wird, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungsfeld mit einer Hilfeschaltfläche angezeigt wird. Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die Mspaint.chm Hilfedatei geöffnet, und das durch den mspaint.chm::/paint_brush.htm Schlüsselwort (keyword) identifizierte Thema wird angezeigt. Das Beispiel erfordert, dass die Mspaint.chm Hilfedatei installiert ist.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r7 = MessageBox::Show( "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r7 As DialogResult = MessageBox.Show("Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Hinweise

Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann.

Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die im helpFilePath Parameter angegebene Hilfedatei geöffnet, und das durch den keyword Parameter identifizierte Thema Hilfe Schlüsselwort (keyword) wird angezeigt. Das Formular, das das Meldungsfeld (oder das aktive Formular) besitzt, empfängt das HelpRequested Ereignis ebenfalls.

Weitere Informationen

Gilt für:

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der Standardschaltfläche und Optionen an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

In options wurde DefaultDesktopOnly oder ServiceNotification angegeben, und es war ein Wert im owner-Parameter angegeben. Diese beiden Optionen sollten nur verwendet werden, wenn Sie die Version dieser Methode aufrufen, die ohne den owner-Parameter auskommt.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von dieser Überladung von Showunterstützt werden. Nachdem überprüft wurde, ob eine Zeichenfolgenvariable leer ist, ServerNamewird im Beispiel eine MessageBoxangezeigt, die dem Benutzer die Option zum Abbrechen des Vorgangs bietet. Wenn der Rückgabewert der Show Methode nach Yesausgewertet wird, wird das angezeigte MessageBox Formular geschlossen.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window Schnittstelle implementiert, das als Fenster der obersten Ebene und besitzer des Dialogfelds dient. Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann.

Im Meldungsfeld können maximal drei Schaltflächen vorhanden sein.

Weitere Informationen

Gilt für:

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Zeigt unter Verwendung der angegebenen Hilfedatei ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungsfeld mit einer Hilfeschaltfläche angezeigt wird. Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die Mspaint.chm Hilfedatei geöffnet. Das Beispiel erfordert, dass die Mspaint.chm Hilfedatei installiert ist.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r1 = MessageBox::Show( "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Hinweise

Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann.

Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die im helpFilePath Parameter angegebene Hilfedatei geöffnet. Das Formular, das das Meldungsfeld (oder das aktive Formular) besitzt, empfängt das HelpRequested Ereignis ebenfalls.

Der helpFilePath Parameter kann das Format C:\path\sample.chm oder /folder/file.htm haben.

Weitere Informationen

Gilt für:

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

displayHelpButton
Boolean

true, um die Schaltfläche Hilfe anzuzeigen, andernfalls false. Der Standardwert ist false.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungsfeld mit einer Hilfeschaltfläche angezeigt, das Control.HelpRequested Ereignis behandelt und ein benutzerdefiniertes Hilfefenster als Reaktion auf das Ereignis angezeigt wird.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
System::Windows::Forms::DialogResult AlertMessageWithCustomHelpWindow()
{
   
   // Handle the HelpRequested event for the following message.
   this->HelpRequested += gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   this->Tag = "Message with Help button.";
   
   // Show a message box with OK and Help buttons.
   System::Windows::Forms::DialogResult r = MessageBox::Show( "Message with Help button.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, true );
   
   // Remove the HelpRequested event handler to keep the event
   // from being handled for other message boxes.
   this->HelpRequested -= gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   
   // Return the dialog box result.
   return r;
}

void Form1_HelpRequested( System::Object^ sender, System::Windows::Forms::HelpEventArgs^ hlpevent )
{
   
   // Create a custom Help window in response to the HelpRequested event.
   Form^ helpForm = gcnew Form;
   
   // Set up the form position, size, and title caption.
   helpForm->StartPosition = FormStartPosition::Manual;
   helpForm->Size = System::Drawing::Size( 200, 400 );
   helpForm->DesktopLocation = Point(this->DesktopBounds.X + this->Size.Width,this->DesktopBounds.Top);
   helpForm->Text = "Help Form";
   
   // Create a label to contain the Help text.
   Label^ helpLabel = gcnew Label;
   
   // Add the label to the form and set its text.
   helpForm->Controls->Add( helpLabel );
   helpLabel->Dock = DockStyle::Fill;
   
   // Use the sender parameter to identify the context of the Help request.
   // The parameter must be cast to the Control type to get the Tag property.
   Control^ senderControl = dynamic_cast<Control^>(sender);
   helpLabel->Text = String::Format( "Help information shown in response to user action on the '{0}' message.", dynamic_cast<String^>(senderControl->Tag) );
   
   // Set the Help form to be owned by the main form. This helps
   // to ensure that the Help form is disposed of.
   this->AddOwnedForm( helpForm );
   
   // Show the custom Help window.
   helpForm->Show();
   
   // Indicate that the HelpRequested event is handled.
   hlpevent->Handled = true;
}
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    this.Tag = "Message with Help button.";

    // Show a message box with OK and Help buttons.
    DialogResult r = MessageBox.Show ("Message with Help button.", 
                                      "Help Caption", MessageBoxButtons.OK, 
                                      MessageBoxIcon.Question, 
                                      MessageBoxDefaultButton.Button1, 
                                      0, true);

    // Remove the HelpRequested event handler to keep the event
    // from being handled for other message boxes.
    this.HelpRequested -= new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    // Return the dialog box result.
    return r;
}

private void Form1_HelpRequested (System.Object sender, System.Windows.Forms.HelpEventArgs hlpevent)
{
    // Create a custom Help window in response to the HelpRequested event.
    Form helpForm = new Form ();

    // Set up the form position, size, and title caption.
    helpForm.StartPosition = FormStartPosition.Manual;
    helpForm.Size = new Size (200, 400);
    helpForm.DesktopLocation = new Point (this.DesktopBounds.X + 
                                          this.Size.Width, 
                                          this.DesktopBounds.Top);
    helpForm.Text = "Help Form";

    // Create a label to contain the Help text.
    Label helpLabel = new Label ();

    // Add the label to the form and set its text.
    helpForm.Controls.Add (helpLabel);
    helpLabel.Dock = DockStyle.Fill;

    // Use the sender parameter to identify the context of the Help request.
    // The parameter must be cast to the Control type to get the Tag property.
    Control senderControl = sender as Control;

    helpLabel.Text = "Help information shown in response to user action on the '" + 
                      (string)senderControl.Tag + "' message.";

    // Set the Help form to be owned by the main form. This helps
    // to ensure that the Help form is disposed of.
    this.AddOwnedForm (helpForm);

    // Show the custom Help window.
    helpForm.Show ();

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}
' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

    ' Handle the HelpRequested event for the following message.
    AddHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    Me.Tag = "Message with Help button."

    ' Show a message box with OK and Help buttons.
    Dim r As DialogResult = MessageBox.Show("Message with Help button.", _
                                          "Help Caption", MessageBoxButtons.OK, _
                                          MessageBoxIcon.Question, _
                                          MessageBoxDefaultButton.Button1, _
                                          0, True)

    ' Remove the HelpRequested event handler to keep the event
    ' from being handled for other message boxes.
    RemoveHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    ' Return the dialog box result.
    Return r
End Function

Private Sub Form1_HelpRequested(ByVal sender As System.Object, ByVal hlpevent As System.Windows.Forms.HelpEventArgs)

    ' Create a custom Help window in response to the HelpRequested event.
    Dim helpForm As Form = New Form

    ' Set up the form position, size, and title caption.
    With helpForm
        .StartPosition = FormStartPosition.Manual
        .Size = New Size(200, 400)
        .DesktopLocation = New Point(Me.DesktopBounds.X + _
                                     Me.Size.Width, Me.DesktopBounds.Top)
        .Text = "Help Form"
    End With

    ' Create a label to contain the Help text.
    Dim helpLabel As Label = New Label

    ' Add the label to the form and set its text.
    helpForm.Controls.Add(helpLabel)
    helpLabel.Dock = DockStyle.Fill

    ' Use the sender parameter to identify the context of the Help request.
    ' The parameter must be cast to the Control type to get the Tag property.
    Dim senderControl As Control = CType(sender, Control)

    helpLabel.Text = "Help information shown in response to user action on the '" & _
                      CStr(senderControl.Tag) & "' message."

    ' Set the Help form to be owned by the main form. This helps
    ' to ensure that the Help form is disposed of.
    Me.AddOwnedForm(helpForm)

    ' Show the custom Help window.
    helpForm.Show()

    ' Indicate that the HelpRequested event is handled.
    hlpevent.Handled = True
End Sub

Hinweise

Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann.

Wenn der Benutzer auf die Schaltfläche Hilfe klickt, empfängt das Formular, das das Meldungsfeld (oder das aktive Formular) besitzt, das HelpRequested Ereignis. Behandeln Sie das HelpRequested Ereignis, um benutzerdefinierte Hilfeaktionen auszuführen.

Weitere Informationen

Gilt für:

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Zeigt mithilfe der angegebenen Hilfedatei und HelpNavigator ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

navigator
HelpNavigator

Einer der HelpNavigator-Werte.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungsfeld angezeigt wird, das dem Standard Fenster zugeordnet ist. Im Meldungsfeld wird eine Hilfeschaltfläche angezeigt. Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die Mspaint.chm Hilfedatei geöffnet, und die Registerkarte Hilfeindex wird angezeigt. Das Beispiel erfordert, dass die Mspaint.chm Hilfedatei installiert ist.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
System::Windows::Forms::DialogResult r4 = MessageBox::Show( this, "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
DialogResult r4 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file
' and shows the Help contents on the Index tab.
Dim r4 As DialogResult = MessageBox.Show(Me, _
                                      "Message with Help file and Help navigator.", _
                                      "Help Caption", MessageBoxButtons.OK, _
                                      MessageBoxIcon.Question, _
                                      MessageBoxDefaultButton.Button1, _
                                      0, "mspaint.chm", _
                                      HelpNavigator.Index)

Hinweise

Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann. Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window Schnittstelle implementiert, das als Fenster der obersten Ebene und besitzer des Dialogfelds dient.

Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die im helpFilePath Parameter angegebene Hilfedatei geöffnet, und der durch den navigator Parameter identifizierte Hilfeinhalt wird angezeigt. Das Formular, das das Meldungsfeld (oder das aktive Formular) besitzt, empfängt das HelpRequested Ereignis ebenfalls.

Kompilierte Hilfedateien stellen Inhaltsverzeichnisse, Index-, Such- und Schlüsselwort (keyword) Links auf Seiten bereit. Sie können die folgenden Werte für navigatorverwenden: TableOfContents, Find, Indexoder Topic.

Der helpFilePath Parameter kann das Format C:\path\sample.chm oder /folder/file.htm haben.

Weitere Informationen

Gilt für:

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol und der Standardschaltfläche an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von dieser Überladung von Showunterstützt werden. Nachdem überprüft wurde, ob eine Zeichenfolgenvariable leer ist, ServerNamewird im Beispiel eine MessageBoxangezeigt, die dem Benutzer die Option zum Abbrechen des Vorgangs bietet. Wenn der Rückgabewert der Show Methode nach Yesausgewertet wird, wird das angezeigte MessageBox Formular geschlossen.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window Schnittstelle implementiert, das als Fenster der obersten Ebene und besitzer des Dialogfelds dient. Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann.

Im Meldungsfeld können maximal drei Schaltflächen vorhanden sein.

Weitere Informationen

Gilt für:

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen und dem angegebenen Symbol an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von dieser Überladung von Showunterstützt werden. Nachdem überprüft wurde, ob eine Zeichenfolgenvariable leer ist, ServerNamewird im Beispiel eine MessageBoxangezeigt, die dem Benutzer die Option zum Abbrechen des Vorgangs bietet. Wenn der Rückgabewert der Show Methode nach Yesausgewertet wird, wird das angezeigte MessageBox Formular geschlossen.

private:
   void validateUserEntry4()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry4()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window Schnittstelle implementiert, das als Fenster der obersten Ebene und besitzer des Dialogfelds dient. Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann.

Im Meldungsfeld können maximal drei Schaltflächen vorhanden sein.

Weitere Informationen

Gilt für:

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, dem angegebenen Symbol und der Standardschaltfläche an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von dieser Überladung von Showunterstützt werden. Nachdem überprüft wurde, ob eine Zeichenfolgenvariable leer ist, ServerNamewird im Beispiel ein MessageBox mit einem Fragefeldsymbol angezeigt, das dem Benutzer die Option zum Abbrechen des Vorgangs bietet. Wenn der Rückgabewert der Show Methode nach Yesausgewertet wird, wird das angezeigte MessageBox Formular geschlossen.

private:
   void validateUserEntry3()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1 );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry3()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
        MessageBoxIcon.Question, MessageBoxDefaultButton.Button1);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry3()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question, _
            MessageBoxDefaultButton.Button1)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If
End Sub

Hinweise

Im Meldungsfeld können maximal drei Schaltflächen vorhanden sein.

Weitere Informationen

Gilt für:

Show(IWin32Window, String, String, MessageBoxButtons)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung und den angegebenen Schaltflächen an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von dieser Überladung von Showunterstützt werden. Nachdem überprüft wurde, ob eine Zeichenfolgenvariable leer ist, ServerNamewird im Beispiel eine MessageBoxangezeigt, die dem Benutzer die Option zum Abbrechen des Vorgangs bietet. Wenn der Rückgabewert der Show Methode nach Yesausgewertet wird, wird das angezeigte MessageBox Formular geschlossen.

private:
   void validateUserEntry5()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry5()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window Schnittstelle implementiert, das als Fenster der obersten Ebene und besitzer des Dialogfelds dient. Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) mit Ausnahme von Objekten im modalen Formular erfolgen können. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular erfolgen kann.

Im Meldungsfeld können maximal drei Schaltflächen vorhanden sein.

Weitere Informationen

Gilt für:

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen und dem angegebenen Symbol an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

Der angegebene buttons-Parameter ist kein Member von MessageBoxButtons.

- oder -

Der angegebene icon-Parameter ist kein Member von MessageBoxIcon.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

Beispiele

Im folgenden Codebeispiel wird eine der Methoden bei der Show Behandlung des Ereignisses ComboBox.DropDown veranschaulicht. Fügen Sie zum Ausführen des Beispiels den folgenden Code in ein Formular ein, und rufen Sie die InitializeComboBox -Methode aus dem Konstruktor oder Load der Methode des Formulars auf.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

Hinweise

Im Meldungsfeld können maximal drei Schaltflächen vorhanden sein.

Weitere Informationen

Gilt für:

Show(IWin32Window, String, String)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text und der angegebenen Beschriftung an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption);
static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

Gibt zurück

Einer der DialogResult-Werte.

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window -Schnittstelle implementiert, das als Fenster der obersten Ebene und besitzer des Dialogfelds dient. Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) erfolgen können, außer für Objekte im modale Formular. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor die Eingabe in ein anderes Formular erfolgen kann.

Standardmäßig wird im Meldungsfeld eine Schaltfläche OK angezeigt.

Gilt für:

Show(String, String, MessageBoxButtons)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung und den angegebenen Schaltflächen an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

Der angegebene buttons-Parameter ist kein Member von MessageBoxButtons.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie mit MessageBox den Optionen angezeigt wird, die von dieser Überladung von Showunterstützt werden. Nachdem überprüft wurde, ob eine Zeichenfolgenvariable leer ServerNameist, wird im Beispiel ein MessageBoxangezeigt, das dem Benutzer die Option zum Abbrechen des Vorgangs bietet. Wenn der Rückgabewert der Show Methode zu Yesausgewertet wird, wird das Formular, das angezeigt wird, MessageBox geschlossen.

private:
   void validateUserEntry()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry()
{
    // Checks the value of the text.
    if(serverName.Text.Length == 0)
    {
        // Initializes the variables to pass to the MessageBox.Show method.
        string message = "You did not enter a server name. Cancel this operation?";
     string caption = "Error Detected in Input";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.
        result = MessageBox.Show(message, caption, buttons);
        if (result == System.Windows.Forms.DialogResult.Yes)
        {
            // Closes the parent form.
            this.Close();
        }
    }
}
Private Sub ValidateUserEntry()
    ' Checks the value of the text.
    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.
        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox
        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.
        If Result = System.Windows.Forms.DialogResult.Yes Then
            ' Closes the parent form.
            Me.Close()
        End If
    End If
End Sub

Hinweise

Im Meldungsfeld können maximal drei Schaltflächen vorhanden sein.

Weitere Informationen

Gilt für:

Show(IWin32Window, String)

Zeigt vor dem angegebenen Objekt ein Meldungsfenster mit dem angegebenen Text an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text);
static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

Gibt zurück

Einer der DialogResult-Werte.

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window -Schnittstelle implementiert, das als Fenster der obersten Ebene und besitzer des Dialogfelds dient. Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) erfolgen können, außer für Objekte im modale Formular. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor die Eingabe in ein anderes Formular erfolgen kann.

Standardmäßig wird im Meldungsfeld eine Schaltfläche OK angezeigt. Das Meldungsfeld enthält keine Untertitel im Titel.

Gilt für:

Show(String, String)

Zeigt ein Meldungsfenster mit dem angegebenen Text und der angegebenen Beschriftung an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (string text, string caption);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption);
static member Show : string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

Gibt zurück

Einer der DialogResult-Werte.

Hinweise

Standardmäßig wird im Meldungsfeld eine Schaltfläche OK angezeigt.

Gilt für:

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Zeigt ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der Standardschaltfläche und Optionen an.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parameter

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie mit MessageBox den Optionen angezeigt wird, die von dieser Überladung von Showunterstützt werden. Nachdem überprüft wurde, ServerNameob die Zeichenfolgenvariable leer ist, wird im Beispiel ein MessageBox mit einem Fragefeldsymbol angezeigt, das dem Benutzer die Option zum Abbrechen des Vorgangs bietet. Im Beispiel wird der RightAlign Member der MessageBoxOptions -Enumeration verwendet, um den Text am rechten Rand des Dialogfelds auszurichten. Wenn der Rückgabewert der Show Methode zu Yesausgewertet wird, wird das Formular, das angezeigt wird, MessageBox geschlossen.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Hinweise

Im Meldungsfeld können maximal drei Schaltflächen vorhanden sein.

Weitere Informationen

Gilt für:

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Zeigt mithilfe der angegebenen Hilfedatei, HelpNavigator und dem angegebenen Hilfethema ein Meldungsfenster mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche „Hilfe“ an.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.

text
String

Der im Meldungsfenster anzuzeigende Text.

caption
String

Der in der Titelleiste des Meldungsfensters anzuzeigende Text.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfenster angezeigt werden sollen.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfenster angezeigt werden soll.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfenster angibt.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfenster angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

navigator
HelpNavigator

Einer der HelpNavigator-Werte.

param
Object

Die numerische ID des Hilfethemas, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche „Hilfe“ klickt.

Gibt zurück

Einer der DialogResult-Werte.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.

- oder -

icon ist kein Member von MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die UserInteractive-Eigenschaft angegeben.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungsfeld angezeigt wird, das dem fenster Standard zugeordnet ist. Im Meldungsfeld wird eine Hilfeschaltfläche angezeigt. Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die Mspaint.chm Hilfedatei geöffnet, und die Registerkarte "Hilfeindex" und das durch die ovals Schlüsselwort (keyword) identifizierte Thema werden angezeigt. Für das Beispiel muss die Mspaint.chm Hilfedatei installiert sein.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r6 = MessageBox::Show( this, "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r6 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r6 As DialogResult = MessageBox.Show(Me, _
                                   "Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Hinweise

Ein Meldungsfeld ist ein modales Dialogfeld, was bedeutet, dass keine Eingaben (Tastatur oder Mausklick) erfolgen können, außer für Objekte im modale Formular. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), bevor die Eingabe in ein anderes Formular erfolgen kann. Sie können den owner -Parameter verwenden, um ein bestimmtes Objekt anzugeben, das die IWin32Window Schnittstelle implementiert, das als Fenster der obersten Ebene und besitzer des Dialogfelds dient.

Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die im helpFilePath Parameter angegebene Hilfedatei geöffnet, und der durch den navigator Parameter identifizierte Hilfeinhalt wird angezeigt. Das Formular, das das Meldungsfeld (oder das aktive Formular) besitzt, empfängt das HelpRequested Ereignis ebenfalls.

Kompilierte Hilfedateien bieten Inhaltsverzeichnis, Index, Suche und Schlüsselwort (keyword) Links auf Seiten. Sie können die folgenden Werte für navigatorverwenden: TableOfContents, Find, Indexoder Topic.

Sie können verwenden param , um den Topic Befehl weiter zu verfeinern. Wenn der im navigator -Parameter angegebene Wert , Indexoder FindistTableOfContents, sollte dieser Wert seinnull. Wenn der navigator Parameter auf verweist Topic, sollte dieser Wert auf ein Objekt verweisen, das den numerischen Wert des anzuzeigenden Themas enthält.

Der helpFilePath Parameter kann das Format C:\path\sample.chm oder /folder/file.htm haben.

Weitere Informationen

Gilt für: