MessageBox.Show Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zobrazí okno se zprávou.

Přetížení

Show(String)	Zobrazí okno se zprávou se zadaným textem.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy a klíčového slova nápovědy.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru `HelpNavigator`nápovědy a tématu nápovědy.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy a `HelpNavigator`.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy a klíčového slova nápovědy.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Zobrazí okno se zprávou před zadaným objektem a se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem a možnostmi.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy a `HelpNavigator`.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Zobrazí okno se zprávou před zadaným objektem a se zadaným textem, popis, tlačítky, ikonou a výchozím tlačítkem.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Zobrazí okno se zprávou před zadaným objektem a se zadaným textem, popis, tlačítky a ikonou.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou a výchozím tlačítkem.
Show(IWin32Window, String, String, MessageBoxButtons)	Zobrazí okno se zprávou před zadaným objektem a se zadaným textem, popis a tlačítky.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky a ikonou.
Show(IWin32Window, String, String)	Zobrazí okno se zprávou před zadaným objektem a se zadaným textem a popis.
Show(String, String, MessageBoxButtons)	Zobrazí okno se zprávou se zadaným textem, popis a tlačítky.
Show(IWin32Window, String)	Zobrazí okno se zprávou před zadaným objektem a se zadaným textem.
Show(String, String)	Zobrazí okno se zprávou se zadaným textem a popis.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem a možnostmi.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru `HelpNavigator`nápovědy a tématu nápovědy.

Show(String)

Zobrazí okno se zprávou se zadaným textem.

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

Parametry

text: String

Text, který se má zobrazit v okně se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Příklady

Následující příklad kódu zobrazí jednoduché okno se zprávou.

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

Private Sub DisplayMessageBoxText()

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

Poznámky

Ve výchozím nastavení se v okně se zprávou zobrazí tlačítko OK . Okno se zprávou neobsahuje v názvu popis.

Platí pro

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

Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy a klíčového slova nápovědy.

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

helpFilePath: String

Cesta a název souboru nápovědy, který se zobrazí, když uživatel klikne na tlačítko Nápověda.

keyword: String

Klíčové slovo nápovědy, které se zobrazí, když uživatel klikne na tlačítko Nápověda.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

ArgumentException

options zadaných i DefaultDesktopOnly ServiceNotification.

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit okno se zprávou nadřazené hlavnímu oknu. V okně se zprávou se zobrazí tlačítko Nápověda. Když uživatel klikne na tlačítko Nápověda, Mspaint.chm otevře se soubor nápovědy a zobrazí se téma označené klíčovým slovem mspaint.chm::/paint_brush.htm . Příklad vyžaduje, aby byl Mspaint.chm nainstalován soubor nápovědy.

#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")

Poznámky

Okno se zprávou je modální dialogové okno, což znamená, že nemůže dojít k žádnému vstupu (kliknutí pomocí klávesnice nebo myši) s výjimkou objektů v modálním formuláři. Před vstupem do jiného formuláře musí program modální formulář skrýt nebo zavřít (obvykle v reakci na nějakou akci uživatele). Parametr můžete použít owner k určení konkrétního objektu, který implementuje IWin32Window rozhraní, které bude sloužit jako vlastník nejvyšší úrovně dialogového okna.

Když uživatel klikne na tlačítko Nápověda, otevře se soubor nápovědy zadaný v parametru helpFilePath a zobrazí se téma klíčového slova nápovědy určené parametrem keyword . Formulář, který je vlastníkem pole zprávy (nebo aktivní formulář), obdrží HelpRequested také událost.

Viz také

Platí pro

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

Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru HelpNavigatornápovědy a tématu nápovědy.

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

Parametry

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

helpFilePath: String

Cesta a název souboru nápovědy, který se zobrazí, když uživatel klikne na tlačítko Nápověda.

navigator: HelpNavigator

Jedna z HelpNavigator hodnot.

param: Object

Číselné ID tématu nápovědy, které se zobrazí, když uživatel klikne na tlačítko Nápověda.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

ArgumentException

options zadaných i DefaultDesktopOnly ServiceNotification.

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit okno se zprávou s tlačítkem Nápověda. Když uživatel klikne na tlačítko Nápověda, Mspaint.chm otevře se soubor nápovědy a zobrazí se karta Rejstřík nápovědy a téma označené klíčovým slovem ovals . Příklad vyžaduje, aby byl Mspaint.chm nainstalován soubor nápovědy.

#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")

Poznámky

Když uživatel klikne na tlačítko Nápověda, otevře se soubor nápovědy zadaný v parametru helpFilePath a zobrazí se obsah nápovědy identifikovaný parametrem navigator . Formulář, který je vlastníkem pole zprávy (nebo aktivní formulář), obdrží HelpRequested také událost.

Kompilované soubory nápovědy poskytují na stránkách odkazy na obsah, index, hledání a klíčová slova. Pro : , , Index, nebo Topicmůžete použít následující hodnotynavigator. Find TableOfContents

Příkaz můžete použít param k dalšímu upřesnění Topic příkazu. Pokud je hodnota zadaná v parametru navigator , Indexnebo Find, tato hodnota by měla být null.TableOfContents navigator Pokud parametr odkazuje , Topictato hodnota by měla odkazovat na objekt, který obsahuje číselnou hodnotu tématu k zobrazení.

Parametr helpFilePath může být ve formátu C:\path\sample.chm nebo /folder/file.htm.

Viz také

Platí pro

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

Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy.

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

helpFilePath: String

Cesta a název souboru nápovědy, který se zobrazí, když uživatel klikne na tlačítko Nápověda.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

ArgumentException

options zadaných i DefaultDesktopOnly ServiceNotification.

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit okno se zprávou nadřazené hlavnímu formuláři. V okně se zprávou se zobrazí tlačítko Nápověda. Když uživatel klikne na tlačítko Nápověda, Mspaint.chm otevře se soubor nápovědy. Příklad vyžaduje, aby byl Mspaint.chm nainstalován soubor nápovědy.

#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")

Poznámky

Když uživatel klikne na tlačítko Nápověda, otevře se soubor nápovědy zadaný v parametru helpFilePath . Formulář, který je vlastníkem pole zprávy (nebo aktivní formulář), obdrží HelpRequested také událost.

Parametr helpFilePath může být ve formátu C:\path\sample.chm nebo /folder/file.htm.

Viz také

Platí pro

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

Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy a HelpNavigator.

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

Parametry

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

helpFilePath: String

Cesta a název souboru nápovědy, který se zobrazí, když uživatel klikne na tlačítko Nápověda.

navigator: HelpNavigator

Jedna z HelpNavigator hodnot.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

ArgumentException

options zadaných i DefaultDesktopOnly ServiceNotification.

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit okno se zprávou s tlačítkem Nápověda. Když uživatel klikne na tlačítko Nápověda, Mspaint.chm otevře se soubor nápovědy a zobrazí se karta Rejstřík nápovědy. Příklad vyžaduje, aby byl Mspaint.chm nainstalován soubor nápovědy.

#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)

Poznámky

Kompilované soubory nápovědy poskytují na stránkách odkazy na obsah, rejstřík, hledání a klíčová slova. Pro : , , Index, nebo Topicmůžete použít následující hodnotynavigator. Find TableOfContents

Parametr helpFilePath může být ve formátu C:\path\sample.chm nebo /folder/file.htm.

Viz také

Platí pro

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

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

Parametry

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

helpFilePath: String

Cesta a název souboru nápovědy, který se zobrazí, když uživatel klikne na tlačítko Nápověda.

keyword: String

Klíčové slovo nápovědy, které se zobrazí, když uživatel klikne na tlačítko Nápověda.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

ArgumentException

options zadaných i DefaultDesktopOnly ServiceNotification.

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit okno se zprávou s tlačítkem Nápověda. Když uživatel klikne na tlačítko Nápověda, Mspaint.chm otevře se soubor nápovědy a zobrazí se téma označené klíčovým slovem mspaint.chm::/paint_brush.htm . Příklad vyžaduje, aby byl Mspaint.chm nainstalován soubor nápovědy.

#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")

Poznámky

Okno se zprávou je modální dialogové okno, což znamená, že nemůže dojít k žádnému vstupu (kliknutí pomocí klávesnice nebo myši) s výjimkou objektů v modálním formuláři. Program musí skrýt nebo zavřít modální formulář (obvykle v reakci na nějakou akci uživatele) před vstupem do jiného formuláře.

Když uživatel klikne na tlačítko Nápověda, otevře se soubor nápovědy zadaný v parametru helpFilePath a zobrazí se téma klíčového slova nápovědy identifikované parametrem keyword . Událost obdrží HelpRequested také formulář, který vlastní pole zprávy (nebo aktivní formulář).

Viz také

Platí pro

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

Zobrazí okno se zprávou před zadaným objektem a se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem a možnostmi.

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně zprávy.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně zprávy.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně zprávy.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot určuje výchozí tlačítko pro okno se zprávou.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttonsnení členem .MessageBoxButtons

-nebo-

iconnení členem .MessageBoxIcon

-nebo-

defaultButtonnení členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností.

ArgumentException

optionsa .DefaultDesktopOnly ServiceNotification

-nebo-

options zadaný DefaultDesktopOnly nebo ServiceNotification a zadal hodnotu v parametru owner . Tyto dvě možnosti by měly být použity pouze v případě, že vyvoláte verzi této metody, která nepřebývá owner parametr.

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit a MessageBox s možnostmi podporovanými tímto přetížením .Show Po ověření, ServerNameže řetězcová proměnná , je prázdná, zobrazí MessageBoxpříklad a nabídne uživateli možnost operaci zrušit. Pokud se Show návratová hodnota metody vyhodnotí na Yes, formulář, který zobrazil MessageBox , se zavře.

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

Poznámky

Parametr můžete použít owner k určení konkrétního objektu, který implementuje IWin32Window rozhraní, které bude sloužit jako okno nejvyšší úrovně a vlastníka dialogového okna. Okno se zprávou je modální dialogové okno, což znamená, že nemůže dojít k žádnému vstupu (kliknutí pomocí klávesnice nebo myši) s výjimkou objektů v modálním formuláři. Program musí skrýt nebo zavřít modální formulář (obvykle v reakci na nějakou akci uživatele) před vstupem do jiného formuláře.

V okně se zprávou můžete mít maximálně tři tlačítka.

Viz také

Platí pro

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

Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy.

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

Parametry

text: String

Text, který se má zobrazit v okně zprávy.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně zprávy.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně zprávy.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro pole zprávy.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

helpFilePath: String

Cesta a název souboru nápovědy, který se zobrazí, když uživatel klikne na tlačítko Nápověda.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttonsnení členem .MessageBoxButtons

-nebo-

iconnení členem .MessageBoxIcon

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností.

ArgumentException

optionsa .DefaultDesktopOnly ServiceNotification

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit okno se zprávou s tlačítkem Nápověda. Když uživatel klikne na tlačítko Nápověda, Mspaint.chm otevře se soubor nápovědy. Příklad vyžaduje, aby byl nainstalován soubor nápovědy Mspaint.chm .

#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")

Poznámky

Když uživatel klikne na tlačítko Nápověda, otevře se soubor nápovědy zadaný v parametru helpFilePath . Událost obdrží HelpRequested také formulář, který vlastní pole zprávy (nebo aktivní formulář).

Parametr helpFilePath může být ve formátu C:\path\sample.chm nebo /folder/file.htm.

Viz také

Platí pro

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

Zobrazí pole se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda.

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

Parametry

text: String

Text, který se má zobrazit v okně zprávy.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně zprávy.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně zprávy.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro pole zprávy.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

displayHelpButton: Boolean

truezobrazit tlačítko Nápověda; v opačném případě . false Výchozí formát je false.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttonsnení členem .MessageBoxButtons

-nebo-

iconnení členem .MessageBoxIcon

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností.

ArgumentException

optionsa .DefaultDesktopOnly ServiceNotification

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit okno se zprávou s tlačítkem Nápověda, zpracovat Control.HelpRequested událost a zobrazit vlastní okno nápovědy v reakci na událost.

#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

Poznámky

Když uživatel klikne na tlačítko Nápověda, obdrží událost formulář, který je vlastníkem pole zprávy (nebo aktivní formulář HelpRequested ). HelpRequested Zpracování události pro provádění vlastních akcí nápovědy

Viz také

Platí pro

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

Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem, možnostmi a tlačítkem Nápověda pomocí zadaného souboru nápovědy a HelpNavigator.

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

helpFilePath: String

Cesta a název souboru nápovědy, který se zobrazí, když uživatel klikne na tlačítko Nápověda.

navigator: HelpNavigator

Jedna z HelpNavigator hodnot.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttonsnení členem .MessageBoxButtons

-nebo-

iconnení členem .MessageBoxIcon

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

ArgumentException

options zadaných i DefaultDesktopOnly ServiceNotification.

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit okno se zprávou nadřazené hlavnímu oknu. V okně se zprávou se zobrazí tlačítko Nápověda. Když uživatel klikne na tlačítko Nápověda, Mspaint.chm soubor nápovědy se otevře a zobrazí se karta Index nápovědy. Příklad vyžaduje, aby byl nainstalován soubor nápovědy Mspaint.chm .

#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)

Poznámky

Parametr helpFilePath může být ve formátu C:\path\sample.chm nebo /folder/file.htm.

Viz také

Platí pro

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

Zobrazí okno se zprávou před zadaným objektem a se zadaným textem, popis, tlačítky, ikonou a výchozím tlačítkem.

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

-nebo-

defaultButton není členem skupiny MessageBoxDefaultButton.

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

Příklady

Následující příklad kódu ukazuje, jak zobrazit MessageBox s možnostmi podporovanými tímto přetížením Show. Po ověření, ServerNameže řetězcová proměnná je prázdná, zobrazí MessageBoxpříklad a nabídne uživateli možnost zrušit operaci. Pokud se vrácená Show hodnota metody vyhodnotí jako Yes, formulář, který zobrazil MessageBox , se zavře.

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

Poznámky

Parametr můžete použít owner k určení konkrétního objektu, který implementuje IWin32Window rozhraní, které bude sloužit jako okno nejvyšší úrovně a vlastník dialogového okna. Okno se zprávou je modální dialogové okno, což znamená, že nemůže dojít k žádnému vstupu (kliknutí pomocí klávesnice nebo myši) s výjimkou objektů v modálním formuláři. Před vstupem do jiného formuláře musí program modální formulář skrýt nebo zavřít (obvykle v reakci na nějakou akci uživatele).

V okně se zprávou můžete mít maximálně tři tlačítka.

Viz také

Platí pro

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

Zobrazí okno se zprávou před zadaným objektem a se zadaným textem, popis, tlačítky a ikonou.

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

Příklady

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

Poznámky

V okně se zprávou můžete mít maximálně tři tlačítka.

Viz také

Platí pro

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

Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou a výchozím tlačítkem.

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

Parametry

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

-nebo-

defaultButton není členem skupiny MessageBoxDefaultButton.

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

Příklady

Následující příklad kódu ukazuje, jak zobrazit MessageBox s možnostmi podporovanými tímto přetížením Show. Po ověření, ServerNameže je řetězcová proměnná prázdná, se v příkladu zobrazí MessageBox ikona pole s otazníkem, která uživateli nabídne možnost operaci zrušit. Pokud se vrácená Show hodnota metody vyhodnotí jako Yes, formulář, který zobrazil MessageBox , se zavře.

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

Poznámky

V okně se zprávou můžete mít maximálně tři tlačítka.

Viz také

Platí pro

Show(IWin32Window, String, String, MessageBoxButtons)

Zobrazí okno se zprávou před zadaným objektem a se zadaným textem, popis a tlačítky.

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

Příklady

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

Poznámky

V okně se zprávou můžete mít maximálně tři tlačítka.

Viz také

MessageBoxButtons

Platí pro

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Zobrazí okno se zprávou se zadaným textem, popis, tlačítky a ikonou.

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

Parametry

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

Zadaný buttons parametr není členem .MessageBoxButtons

-nebo-

Zadaný icon parametr není členem .MessageBoxIcon

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

Příklady

Následující příklad kódu ukazuje jednu z Show metod při zpracování ComboBox.DropDown události. Pokud chcete spustit příklad, vložte do formuláře následující kód a zavolejte metodu InitializeComboBox z konstruktoru nebo Load metody formuláře.

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

Poznámky

V okně se zprávou můžete mít maximálně tři tlačítka.

Viz také

Platí pro

Show(IWin32Window, String, String)

Zobrazí okno se zprávou před zadaným objektem a se zadaným textem a popis.

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Poznámky

Ve výchozím nastavení se v okně se zprávou zobrazí tlačítko OK .

Platí pro

Show(String, String, MessageBoxButtons)

Zobrazí okno se zprávou se zadaným textem, popis a tlačítky.

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

Parametry

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

Zadaný buttons parametr není členem .MessageBoxButtons

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

Příklady

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

Poznámky

V okně se zprávou můžete mít maximálně tři tlačítka.

Viz také

MessageBoxButtons

Platí pro

Show(IWin32Window, String)

Zobrazí okno se zprávou před zadaným objektem a se zadaným textem.

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Poznámky

Ve výchozím nastavení se v okně se zprávou zobrazí tlačítko OK . Okno se zprávou neobsahuje v názvu popis.

Platí pro

Show(String, String)

Zobrazí okno se zprávou se zadaným textem a popis.

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

Parametry

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Poznámky

Ve výchozím nastavení se v okně se zprávou zobrazí tlačítko OK .

Platí pro

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

Zobrazí okno se zprávou se zadaným textem, popis, tlačítky, ikonou, výchozím tlačítkem a možnostmi.

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

Parametry

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

ArgumentException

options zadaných i DefaultDesktopOnly ServiceNotification.

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit MessageBox s možnostmi podporovanými tímto přetížením Show. Po ověření, ServerNameže je řetězcová proměnná prázdná, se v příkladu zobrazí MessageBox ikona pole s otazníkem, která uživateli nabídne možnost operaci zrušit. Příklad používá RightAlign člen výčtu MessageBoxOptions k zarovnání textu k pravému okraji dialogového okna. Pokud se vrácená Show hodnota metody vyhodnotí jako Yes, formulář, který zobrazil MessageBox , se zavře.

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

Poznámky

V okně se zprávou můžete mít maximálně tři tlačítka.

Viz také

Platí pro

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

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

Parametry

owner: IWin32Window

Implementace IWin32Window , která bude vlastníkem modálního dialogového okna.

text: String

Text, který se má zobrazit v okně se zprávou.

caption: String

Text, který se má zobrazit v záhlaví okna se zprávou.

buttons: MessageBoxButtons

Jedna z MessageBoxButtons hodnot, která určují, která tlačítka se mají zobrazit v okně se zprávou.

icon: MessageBoxIcon

Jedna z MessageBoxIcon hodnot, která určuje, která ikona se má zobrazit v okně se zprávou.

defaultButton: MessageBoxDefaultButton

Jedna z MessageBoxDefaultButton hodnot, která určuje výchozí tlačítko pro okno se zprávou.

options: MessageBoxOptions

Jedna z MessageBoxOptions hodnot, která určuje, které možnosti zobrazení a přidružení budou použity pro okno se zprávou. Pokud chcete použít výchozí hodnoty, můžete předat hodnotu 0.

helpFilePath: String

Cesta a název souboru nápovědy, který se zobrazí, když uživatel klikne na tlačítko Nápověda.

navigator: HelpNavigator

Jedna z HelpNavigator hodnot.

param: Object

Číselné ID tématu nápovědy, které se zobrazí, když uživatel klikne na tlačítko Nápověda.

Návraty

DialogResult

Jedna z DialogResult hodnot.

Výjimky

InvalidEnumArgumentException

buttons není členem skupiny MessageBoxButtons.

-nebo-

icon není členem skupiny MessageBoxIcon.

-nebo-

Zadaný defaultButton parametr není členem .MessageBoxDefaultButton

InvalidOperationException

Došlo k pokusu o zobrazení objektu MessageBox v procesu, který není spuštěn v interaktivním režimu uživatele. To je určeno UserInteractive vlastností .

ArgumentException

options zadaných i DefaultDesktopOnly ServiceNotification.

-nebo-

buttonszadala neplatnou kombinaci .MessageBoxButtons

Příklady

Následující příklad kódu ukazuje, jak zobrazit okno se zprávou nadřazené hlavnímu oknu. V okně se zprávou se zobrazí tlačítko Nápověda. Když uživatel klikne na tlačítko Nápověda, Mspaint.chm otevře se soubor nápovědy a zobrazí se karta Rejstřík nápovědy a téma označené klíčovým slovem ovals . Příklad vyžaduje, aby byl Mspaint.chm nainstalován soubor nápovědy.

#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")

Poznámky

Parametr helpFilePath může být ve formátu C:\path\sample.chm nebo /folder/file.htm.

Viz také

Platí pro