(0) exportieren Drucken
Alle erweitern
Erweitern Minimieren

MessageBox.Show-Methode (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Aktualisiert: November 2007

Zeigt mithilfe der angegebenen Hilfedatei, HelpNavigator und des angegebenen Hilfethemas ein Meldungsfeld 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.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public static DialogResult Show(
	IWin32Window owner,
	string text,
	string caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options,
	string helpFilePath,
	HelpNavigator navigator,
	Object param
)
public static DialogResult Show(
	IWin32Window owner,
	String text,
	String caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options,
	String helpFilePath,
	HelpNavigator navigator,
	Object param
)
public static function Show(
	owner : IWin32Window, 
	text : String, 
	caption : String, 
	buttons : MessageBoxButtons, 
	icon : MessageBoxIcon, 
	defaultButton : MessageBoxDefaultButton, 
	options : MessageBoxOptions, 
	helpFilePath : String, 
	navigator : HelpNavigator, 
	param : Object
) : DialogResult

Parameter

owner
Typ: System.Windows.Forms.IWin32Window
Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.
text
Typ: System.String
Der im Meldungsfeld anzuzeigende Text.
caption
Typ: System.String
Der in der Titelleiste des Meldungsfelds anzuzeigende Text.
buttons
Typ: System.Windows.Forms.MessageBoxButtons
Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.
icon
Typ: System.Windows.Forms.MessageBoxIcon
Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.
defaultButton
Typ: System.Windows.Forms.MessageBoxDefaultButton
Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.
options
Typ: System.Windows.Forms.MessageBoxOptions
Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.
helpFilePath
Typ: System.String
Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.
navigator
Typ: System.Windows.Forms.HelpNavigator
Einer der HelpNavigator-Werte.
param
Typ: System.Object
Die numerische ID des Hilfethemas, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.

Rückgabewert

Typ: System.Windows.Forms.DialogResult
Einer der DialogResult-Werte.

AusnahmeBedingung
InvalidEnumArgumentException

buttons ist kein Member von MessageBoxButtons.

- oder -

Das icon ist kein Member des MessageBoxIcon.

- oder -

Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.

InvalidOperationException

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

ArgumentException

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.

- oder -

buttons gab eine ungültige Kombination von MessageBoxButtons an.

Bei einem Meldungsfeld handelt es sich um ein modales Dialogfeld, d. h. nur die Objekte des modalen Formulars akzeptieren eine Eingabe (Tastatur oder Mausklick). Das Programm muss ein modales Formular ausblenden oder schließen (üblicherweise als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular vorgenommen werden kann. Sie können den owner-Parameter zum Angeben eines bestimmten Objekts verwenden, das die IWin32Window-Schnittstelle implementiert und als Besitzer und Fenster der obersten Ebene 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 angegebene Hilfeinhalt wird angezeigt. Das Formular, das das Meldungsfeld (oder das aktive Formular) besitzt, empfängt auch das HelpRequested-Ereignis.

Kompilierte Hilfedateien stellen ein Inhaltsverzeichnis, einen Index, eine Suchfunktion sowie Verknüpfungen mit Schlüsselwörtern auf den Seiten bereit. Sie können für navigator folgende Werte verwenden: TableOfContents, Find, Index oder Topic.

Mithilfe von param können Sie den Topic-Befehl genauer anpassen. Wenn der im navigator-Parameter angegebene Wert TableOfContents, Index oder Find ist, muss dieser Wert null sein. Wenn der navigator-Parameter auf Topic verweist, muss dieser Wert auf ein Objekt verweisen, das den numerischen Wert des anzuzeigenden Themas enthält.

Der helpFilePath-Parameter kann die Form C:\Pfad\Beispiel.chm oder /Ordner/Datei.htm haben.

Im folgenden Codebeispiel wird veranschaulicht, wie ein dem Hauptfenster übergeordnetes Meldungsfeld angezeigt wird. Das Meldungsfeld zeigt die Schaltfläche Hilfe an. Wenn der Benutzer auf die Schaltfläche Hilfe klickt, wird die Hilfedatei Mspaint.chm geöffnet und die Registerkarte Hilfeindex und das vom ovals-Schlüsselwort identifizierte Thema werden angezeigt. Für das Beispiel muss die Hilfedatei Mspaint.chm installiert sein.

using System;
using System.Drawing;
using System.ComponentModel;
using 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.
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");



package WindowsApplication1;

import System.*;
import System.Drawing.*;
import System.ComponentModel.*;
import 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.
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");


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft