MessageBox.Show Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wyświetla okno komunikatu.

Przeciążenia

Show(String)	Wyświetla pole komunikatu z określonym tekstem.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy i słowa kluczowego Pomoc.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy i `HelpNavigator`tematu Pomocy.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy i `HelpNavigator`.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy i słowa kluczowego Pomoc.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Wyświetla okno komunikatu przed określonym obiektem oraz z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym i opcjami.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy i `HelpNavigator`.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Wyświetla okno komunikatu przed określonym obiektem oraz z określonym tekstem, podpis, przyciskami, ikoną i przyciskiem domyślnym.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Wyświetla okno komunikatu przed określonym obiektem oraz z określonym tekstem, podpis, przyciskami i ikoną.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną i przyciskiem domyślnym.
Show(IWin32Window, String, String, MessageBoxButtons)	Wyświetla okno komunikatu przed określonym obiektem oraz z określonym tekstem, podpis i przyciskami.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Wyświetla pole komunikatu z określonym tekstem, podpis, przyciskami i ikoną.
Show(IWin32Window, String, String)	Wyświetla okno komunikatu przed określonym obiektem oraz z określonym tekstem i podpis.
Show(String, String, MessageBoxButtons)	Wyświetla okno komunikatu z określonym tekstem, podpis i przyciskami.
Show(IWin32Window, String)	Wyświetla okno komunikatu przed określonym obiektem i z określonym tekstem.
Show(String, String)	Wyświetla pole komunikatu z określonym tekstem i podpis.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym i opcjami.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy i `HelpNavigator`tematu Pomocy.

Show(String)

Wyświetla pole komunikatu z określonym tekstem.

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

Tekst do wyświetlenia w oknie komunikatu.

Zwraca

DialogResult

DialogResult Jedna z wartości.

Przykłady

Poniższy przykład kodu wyświetla proste pole komunikatu.

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

Private Sub DisplayMessageBoxText()

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

Uwagi

Domyślnie w oknie komunikatu jest wyświetlany przycisk OK . Pole komunikatu nie zawiera podpis w tytule.

Dotyczy

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

Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy i słowa kluczowego Pomoc.

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

Implementacja tego IWin32Window będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w oknie komunikatu.

caption: String

Tekst do wyświetlenia na pasku tytułu okna komunikatu.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających, które przyciski mają być wyświetlane w oknie komunikatu.

icon: MessageBoxIcon

MessageBoxIcon Jedna z wartości określających, która ikona ma być wyświetlana w oknie komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedna z wartości określających domyślny przycisk dla okna komunikatu.

options: MessageBoxOptions

MessageBoxOptions Jedna z wartości określających, które opcje wyświetlania i skojarzenia będą używane dla okna komunikatu. Jeśli chcesz użyć wartości domyślnych, możesz przekazać wartość 0.

helpFilePath: String

Ścieżka i nazwa pliku Pomocy do wyświetlenia, gdy użytkownik kliknie przycisk Pomoc.

keyword: String

Słowo kluczowe Pomoc do wyświetlenia po kliknięciu przycisku Pomoc przez użytkownika.

Zwraca

DialogResult

DialogResult Jedna z wartości.

Wyjątki

InvalidEnumArgumentException

buttons nie jest członkiem programu MessageBoxButtons.

-lub-

icon nie jest członkiem programu MessageBoxIcon.

-lub-

Określony defaultButton element nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określone przez UserInteractive właściwość .

ArgumentException

options określono zarówno elementy , jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttonsokreślono nieprawidłową kombinację .MessageBoxButtons

Przykłady

Poniższy przykład kodu pokazuje, jak pokazać okno komunikatu nadrzędne do głównego okna. W oknie komunikatu zostanie wyświetlony przycisk Pomoc. Gdy użytkownik kliknie przycisk Pomoc, Mspaint.chm zostanie otwarty plik Pomocy i zostanie wyświetlony temat zidentyfikowany przez mspaint.chm::/paint_brush.htm słowo kluczowe. Przykład wymaga zainstalowania Mspaint.chm pliku Pomocy.

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

Uwagi

Okno komunikatu jest modalnym oknem dialogowym, co oznacza, że nie mogą wystąpić żadne dane wejściowe (kliknięcie za pomocą klawiatury lub myszy) z wyjątkiem obiektów w formie modalnej. Program musi ukryć lub zamknąć formularz modalny (zazwyczaj w odpowiedzi na akcję użytkownika) przed wprowadzeniem danych wejściowych do innego formularza. Możesz użyć parametru owner , aby określić określony obiekt, który implementuje IWin32Window interfejs, który będzie służyć jako właściciel najwyższego poziomu okna dialogowego.

Gdy użytkownik kliknie przycisk Pomoc, zostanie otwarty plik Pomocy określony w parametrze helpFilePath i zostanie wyświetlony temat słowa kluczowego Pomoc zidentyfikowany przez keyword parametr . Formularz, który jest właścicielem pola wiadomości (lub aktywnego formularza) również odbiera HelpRequested zdarzenie.

Zobacz też

Dotyczy

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

Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy i HelpNavigatortematu Pomocy.

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

Tekst do wyświetlenia w oknie komunikatu.

caption: String

Tekst do wyświetlenia na pasku tytułu okna komunikatu.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających, które przyciski mają być wyświetlane w oknie komunikatu.

icon: MessageBoxIcon

MessageBoxIcon Jedna z wartości określających, która ikona ma być wyświetlana w oknie komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedna z wartości określających domyślny przycisk dla okna komunikatu.

options: MessageBoxOptions

helpFilePath: String

Ścieżka i nazwa pliku Pomocy do wyświetlenia, gdy użytkownik kliknie przycisk Pomoc.

navigator: HelpNavigator

HelpNavigator Jedna z wartości.

param: Object

Numeryczny identyfikator tematu Pomocy do wyświetlenia, gdy użytkownik kliknie przycisk Pomoc.

Zwraca

DialogResult

DialogResult Jedna z wartości.

Wyjątki

InvalidEnumArgumentException

buttons nie jest członkiem programu MessageBoxButtons.

-lub-

icon nie jest członkiem programu MessageBoxIcon.

-lub-

Określony defaultButton element nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określone przez UserInteractive właściwość .

ArgumentException

options określono zarówno elementy , jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttonsokreślono nieprawidłową kombinację .MessageBoxButtons

Przykłady

W poniższym przykładzie kodu pokazano, jak wyświetlić okno komunikatu za pomocą przycisku Pomoc. Gdy użytkownik kliknie przycisk Pomoc, zostanie otwarty plik Pomocy, Mspaint.chm a zostanie wyświetlona karta Indeks Pomocy oraz temat zidentyfikowany przez ovals słowo kluczowe. Przykład wymaga zainstalowania Mspaint.chm pliku Pomocy.

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

Uwagi

Gdy użytkownik kliknie przycisk Pomoc, zostanie otwarty plik Pomocy określony w parametrze helpFilePath i zostanie wyświetlona zawartość Pomocy zidentyfikowana przez navigator parametr . Formularz, który jest właścicielem pola wiadomości (lub aktywnego formularza) również odbiera HelpRequested zdarzenie.

Skompilowane pliki pomocy udostępniają spis treści, indeks, wyszukiwanie i linki słów kluczowych na stronach. Możesz użyć następujących wartości dla navigator: TableOfContents, Find, Indexlub Topic.

Możesz użyć param polecenia , aby zapewnić dalsze uściślenie Topic polecenia. Jeśli wartość określona w parametrze navigator to TableOfContents, Indexlub Find, ta wartość powinna mieć wartość null. navigator Jeśli parametr odwołuje Topicsię do parametru , ta wartość powinna odwoływać się do obiektu zawierającego wartość liczbową tematu do wyświetlenia.

Parametr helpFilePath może mieć postać C:\path\sample.chm lub /folder/file.htm.

Zobacz też

Dotyczy

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

Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy.

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

Implementacja tego IWin32Window będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w oknie komunikatu.

caption: String

Tekst do wyświetlenia na pasku tytułu okna komunikatu.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających, które przyciski mają być wyświetlane w oknie komunikatu.

icon: MessageBoxIcon

MessageBoxIcon Jedna z wartości określających, która ikona ma być wyświetlana w oknie komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedna z wartości określających domyślny przycisk dla okna komunikatu.

options: MessageBoxOptions

helpFilePath: String

Ścieżka i nazwa pliku Pomocy do wyświetlenia, gdy użytkownik kliknie przycisk Pomoc.

Zwraca

DialogResult

DialogResult Jedna z wartości.

Wyjątki

InvalidEnumArgumentException

buttons nie jest członkiem programu MessageBoxButtons.

-lub-

icon nie jest członkiem programu MessageBoxIcon.

-lub-

Określony defaultButton element nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określone przez UserInteractive właściwość .

ArgumentException

options określono zarówno elementy , jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttonsokreślono nieprawidłową kombinację .MessageBoxButtons

Przykłady

W poniższym przykładzie kodu pokazano, jak pokazać okno komunikatu nadrzędne do formularza głównego. W oknie komunikatu zostanie wyświetlony przycisk Pomoc. Gdy użytkownik kliknie przycisk Pomoc, Mspaint.chm zostanie otwarty plik Pomocy. Przykład wymaga zainstalowania Mspaint.chm pliku Pomocy.

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

Uwagi

Okno komunikatu jest modalnym oknem dialogowym, co oznacza, że nie mogą wystąpić żadne dane wejściowe (kliknięcie za pomocą klawiatury lub myszy) z wyjątkiem obiektów w formie modalnej. Program musi ukryć lub zamknąć formularz modalny (zazwyczaj w odpowiedzi na akcję użytkownika) przed wprowadzeniem danych wejściowych do innego formularza. Możesz użyć parametru owner , aby określić konkretny obiekt, który implementuje IWin32Window interfejs, który będzie służyć jako okno najwyższego poziomu okna dialogowego i właściciel.

Gdy użytkownik kliknie przycisk Pomoc, zostanie otwarty plik Pomocy określony w parametrze helpFilePath . Formularz, który jest właścicielem pola wiadomości (lub aktywnego formularza) również odbiera HelpRequested zdarzenie.

Parametr helpFilePath może mieć postać C:\path\sample.chm lub /folder/file.htm.

Zobacz też

Dotyczy

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

Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy i 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

Tekst do wyświetlenia w oknie komunikatu.

caption: String

Tekst do wyświetlenia na pasku tytułu okna komunikatu.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających, które przyciski mają być wyświetlane w oknie komunikatu.

icon: MessageBoxIcon

MessageBoxIcon Jedna z wartości określających, która ikona ma być wyświetlana w oknie komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedna z wartości określających domyślny przycisk dla okna komunikatu.

options: MessageBoxOptions

helpFilePath: String

Ścieżka i nazwa pliku Pomocy do wyświetlenia, gdy użytkownik kliknie przycisk Pomoc.

navigator: HelpNavigator

HelpNavigator Jedna z wartości.

Zwraca

DialogResult

DialogResult Jedna z wartości.

Wyjątki

InvalidEnumArgumentException

buttons nie jest członkiem programu MessageBoxButtons.

-lub-

icon nie jest członkiem programu MessageBoxIcon.

-lub-

Określony defaultButton element nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określone przez UserInteractive właściwość .

ArgumentException

options określono zarówno elementy , jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttonsokreślono nieprawidłową kombinację .MessageBoxButtons

Przykłady

W poniższym przykładzie kodu pokazano, jak wyświetlić okno komunikatu za pomocą przycisku Pomoc. Gdy użytkownik kliknie przycisk Pomoc, Mspaint.chm zostanie otwarty plik Pomocy i zostanie wyświetlona karta Indeks Pomocy. Przykład wymaga zainstalowania Mspaint.chm pliku Pomocy.

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

Uwagi

Gdy użytkownik kliknie przycisk Pomoc, zostanie otwarty plik pomocy określony w parametrze helpFilePath i zostanie wyświetlona zawartość Pomocy zidentyfikowana przez navigator parametr . Formularz, który jest właścicielem pola wiadomości (lub aktywnego formularza) również odbiera HelpRequested zdarzenie.

Skompilowane pliki Pomocy udostępniają spis treści, indeks, wyszukiwanie i linki słów kluczowych na stronach. Możesz użyć następujących wartości dla navigator: TableOfContents, Find, Indexlub Topic.

Parametr helpFilePath może mieć postać C:\path\sample.chm lub /folder/file.htm.

Zobacz też

Dotyczy

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

Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy i słowa kluczowego Pomoc.

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

Tekst do wyświetlenia w oknie komunikatu.

caption: String

Tekst do wyświetlenia na pasku tytułu okna komunikatu.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających, które przyciski mają być wyświetlane w oknie komunikatu.

icon: MessageBoxIcon

MessageBoxIcon Jedna z wartości określających, która ikona ma być wyświetlana w oknie komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedna z wartości określających domyślny przycisk dla okna komunikatu.

options: MessageBoxOptions

helpFilePath: String

Ścieżka i nazwa pliku Pomocy do wyświetlenia, gdy użytkownik kliknie przycisk Pomoc.

keyword: String

Słowo kluczowe Pomoc do wyświetlenia po kliknięciu przycisku Pomoc przez użytkownika.

Zwraca

DialogResult

DialogResult Jedna z wartości.

Wyjątki

InvalidEnumArgumentException

buttons nie jest członkiem programu MessageBoxButtons.

-lub-

icon nie jest członkiem programu MessageBoxIcon.

-lub-

Określony defaultButton element nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określone przez UserInteractive właściwość .

ArgumentException

options określono zarówno elementy , jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttonsokreślono nieprawidłową kombinację .MessageBoxButtons

Przykłady

W poniższym przykładzie kodu pokazano, jak wyświetlić okno komunikatu za pomocą przycisku Pomoc. Gdy użytkownik kliknie przycisk Pomoc, Mspaint.chm zostanie otwarty plik Pomocy i zostanie wyświetlony temat zidentyfikowany przez mspaint.chm::/paint_brush.htm słowo kluczowe. Przykład wymaga zainstalowania Mspaint.chm pliku Pomocy.

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

Uwagi

Zobacz też

Dotyczy

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

Wyświetla okno komunikatu przed określonym obiektem oraz z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym i opcjami.

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

Implementacja tego IWin32Window będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w oknie komunikatu.

caption: String

Tekst do wyświetlenia na pasku tytułu okna komunikatu.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających, które przyciski mają być wyświetlane w oknie komunikatu.

icon: MessageBoxIcon

MessageBoxIcon Jedna z wartości określających, która ikona ma być wyświetlana w oknie komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedna z wartości określa domyślny przycisk dla okna komunikatu.

options: MessageBoxOptions

Zwraca

DialogResult

DialogResult Jedna z wartości.

Wyjątki

InvalidEnumArgumentException

buttons nie jest członkiem programu MessageBoxButtons.

-lub-

icon nie jest członkiem programu MessageBoxIcon.

-lub-

defaultButton nie jest członkiem programu MessageBoxDefaultButton.

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określone przez UserInteractive właściwość .

ArgumentException

options określono zarówno elementy , jak DefaultDesktopOnly i ServiceNotification.

-lub-

options określony DefaultDesktopOnly lub ServiceNotification i określony wartość w parametrze owner . Te dwie opcje powinny być używane tylko wtedy, gdy wywołasz wersję tej metody, która nie bierze parametru owner .

-lub-

buttonsokreślono nieprawidłową kombinację .MessageBoxButtons

Przykłady

W poniższym przykładzie kodu pokazano, jak wyświetlić element MessageBox z opcjami obsługiwanymi przez to przeciążenie elementu Show. Po sprawdzeniu, czy zmienna ciągu , ServerNamejest pusta, w przykładzie jest wyświetlana MessageBoxwartość , oferując użytkownikowi opcję anulowania operacji. Show Jeśli zwracana wartość metody zwróci wartość Yes, formularz, który wyświetla MessageBox wartość , jest zamknięty.

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

Uwagi

Możesz użyć parametru owner , aby określić konkretny obiekt, który implementuje IWin32Window interfejs, który będzie służyć jako okno najwyższego poziomu okna dialogowego i właściciel. Okno komunikatu jest modalnym oknem dialogowym, co oznacza, że nie mogą wystąpić żadne dane wejściowe (kliknięcie za pomocą klawiatury lub myszy) z wyjątkiem obiektów w formie modalnej. Program musi ukryć lub zamknąć formularz modalny (zazwyczaj w odpowiedzi na akcję użytkownika) przed wprowadzeniem danych wejściowych do innego formularza.

W oknie komunikatu można mieć maksymalnie trzy przyciski.

Zobacz też

Dotyczy

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

Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy.

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

Tekst do wyświetlenia w oknie komunikatu.

caption: String

Tekst do wyświetlenia na pasku tytułu okna komunikatu.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających, które przyciski mają być wyświetlane w oknie komunikatu.

icon: MessageBoxIcon

MessageBoxIcon Jedna z wartości określających, która ikona ma być wyświetlana w oknie komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedna z wartości określających domyślny przycisk dla okna komunikatu.

options: MessageBoxOptions

helpFilePath: String

Ścieżka i nazwa pliku Pomocy do wyświetlenia, gdy użytkownik kliknie przycisk Pomoc.

Zwraca

DialogResult

DialogResult Jedna z wartości.

Wyjątki

InvalidEnumArgumentException

buttons nie jest członkiem programu MessageBoxButtons.

-lub-

icon nie jest członkiem programu MessageBoxIcon.

-lub-

Określony defaultButton element nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określone przez UserInteractive właściwość .

ArgumentException

options określono zarówno elementy , jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttonsokreślono nieprawidłową kombinację .MessageBoxButtons

Przykłady

W poniższym przykładzie kodu pokazano, jak wyświetlić okno komunikatu za pomocą przycisku Pomoc. Gdy użytkownik kliknie przycisk Pomoc, Mspaint.chm zostanie otwarty plik Pomocy. Przykład wymaga zainstalowania Mspaint.chm pliku Pomocy.

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

Uwagi

Parametr helpFilePath może mieć postać C:\path\sample.chm lub /folder/file.htm.

Zobacz też

Dotyczy

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

Wyświetla okno komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc.

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

Tekst do wyświetlenia w oknie komunikatu.

caption: String

Tekst do wyświetlenia na pasku tytułu okna komunikatu.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających, które przyciski mają być wyświetlane w oknie komunikatu.

icon: MessageBoxIcon

MessageBoxIcon Jedna z wartości określających, która ikona ma być wyświetlana w oknie komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedna z wartości określających domyślny przycisk dla okna komunikatu.

options: MessageBoxOptions

displayHelpButton: Boolean

true aby wyświetlić przycisk Pomoc; w przeciwnym razie , false. Wartość domyślna to false.

Zwraca

DialogResult

DialogResult Jedna z wartości.

Wyjątki

InvalidEnumArgumentException

buttons nie jest członkiem programu MessageBoxButtons.

-lub-

icon nie jest członkiem programu MessageBoxIcon.

-lub-

Określony defaultButton element nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określone przez UserInteractive właściwość .

ArgumentException

options określono zarówno elementy , jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttonsokreślono nieprawidłową kombinację .MessageBoxButtons

Przykłady

W poniższym przykładzie kodu pokazano, jak wyświetlić okno komunikatu z przyciskiem Pomoc, obsłużyć Control.HelpRequested zdarzenie i wyświetlić niestandardowe okno pomocy w odpowiedzi na zdarzenie.

#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

Uwagi

Gdy użytkownik kliknie przycisk Pomoc, formularz, który jest właścicielem okna komunikatu (lub aktywnego formularza) odbiera HelpRequested zdarzenie. Obsługa zdarzenia w HelpRequested celu wykonywania niestandardowych akcji Pomocy.

Zobacz też

Dotyczy

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

Wyświetla pole komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy i 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

Implementacja tego IWin32Window elementu będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających przyciski do wyświetlenia w polu komunikatu.

icon: MessageBoxIcon

Jedna z MessageBoxIcon wartości określających, która ikona ma być wyświetlana w polu komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedną z wartości określających domyślny przycisk dla pola komunikatu.

options: MessageBoxOptions

MessageBoxOptions Jedna z wartości określających, które opcje wyświetlania i skojarzenia będą używane dla pola komunikatu. Jeśli chcesz użyć wartości domyślnych, możesz przekazać wartość 0.

helpFilePath: String

Ścieżka i nazwa pliku Pomocy do wyświetlenia, gdy użytkownik kliknie przycisk Pomoc.

navigator: HelpNavigator

Jedna z HelpNavigator wartości.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Wyjątki

InvalidEnumArgumentException

buttons nie jest członkiem programu MessageBoxButtons.

-lub-

icon nie jest członkiem programu MessageBoxIcon.

-lub-

Określony defaultButton element nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określane przez UserInteractive właściwość .

ArgumentException

options określone zarówno, jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttons określono nieprawidłową kombinację elementu MessageBoxButtons.

Przykłady

Poniższy przykład kodu pokazuje, jak pokazać okno komunikatu nadrzędne do głównego okna. W oknie komunikatu zostanie wyświetlony przycisk Pomoc. Gdy użytkownik kliknie przycisk Pomoc, Mspaint.chm zostanie otwarty plik Pomocy i zostanie wyświetlona karta Indeks Pomocy. Przykład wymaga zainstalowania Mspaint.chm pliku Pomocy.

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

Uwagi

Pole komunikatu to modalne okno dialogowe, co oznacza, że nie może wystąpić żadne wejście (klawiatura lub kliknięcie myszy) z wyjątkiem obiektów w formie modalnej. Program musi ukryć lub zamknąć formularz modalny (zazwyczaj w odpowiedzi na akcję użytkownika) przed wystąpieniem danych wejściowych do innego formularza. Można użyć parametru owner , aby określić określony obiekt, który implementuje IWin32Window interfejs, który będzie służył jako okno dialogowe najwyższego poziomu i właściciel.

Gdy użytkownik kliknie przycisk Pomoc, zostanie otwarty plik Pomocy określony w parametrze helpFilePath , a zawartość Pomocy zidentyfikowana przez navigator parametr zostanie wyświetlona. Formularz, który jest właścicielem pola wiadomości (lub aktywnego formularza) również odbiera HelpRequested zdarzenie.

Skompilowane pliki Pomocy zapewniają spis treści, indeks, wyszukiwanie i linki słów kluczowych na stronach. Możesz użyć następujących wartości dla navigator: TableOfContents, Find, Indexlub Topic.

Parametr helpFilePath może mieć postać C:\path\sample.chm lub /folder/file.htm.

Zobacz też

Dotyczy

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

Wyświetla pole komunikatu przed określonym obiektem i z określonym tekstem, podpis, przyciskami, ikoną i przyciskiem domyślnym.

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

Implementacja tego IWin32Window elementu będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających przyciski do wyświetlenia w polu komunikatu.

icon: MessageBoxIcon

Jedna z MessageBoxIcon wartości określających, która ikona ma być wyświetlana w polu komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedną z wartości określających domyślny przycisk dla pola komunikatu.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Wyjątki

InvalidEnumArgumentException

buttonsnie jest członkiem .MessageBoxButtons

-lub-

iconnie jest członkiem .MessageBoxIcon

-lub-

defaultButtonnie jest członkiem .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określane przez UserInteractive właściwość .

Przykłady

Poniższy przykład kodu pokazuje, jak wyświetlić MessageBox element z opcjami obsługiwanymi przez to przeciążenie elementu Show. Po sprawdzeniu, czy zmienna ciągu jest pusta, ServerNamew przykładzie jest wyświetlana MessageBoxwartość , oferując użytkownikowi opcję anulowania operacji. Show Jeśli wartość zwracana metody zostanie obliczona na Yeswartość , formularz, który wyświetlił wartość MessageBox , jest zamknięty.

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

Uwagi

Można użyć parametru owner , aby określić określony obiekt, który implementuje IWin32Window interfejs, który będzie służył jako okno dialogowe najwyższego poziomu i właściciel. Pole komunikatu to modalne okno dialogowe, co oznacza, że nie może wystąpić żadne wejście (klawiatura lub kliknięcie myszy) z wyjątkiem obiektów w formie modalnej. Program musi ukryć lub zamknąć formularz modalny (zazwyczaj w odpowiedzi na akcję użytkownika) przed wystąpieniem danych wejściowych do innego formularza.

Możesz mieć maksymalnie trzy przyciski w polu komunikatu.

Zobacz też

Dotyczy

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

Wyświetla pole komunikatu przed określonym obiektem i z określonym tekstem, podpis, przyciskami i ikoną.

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

Implementacja tego IWin32Window elementu będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających przyciski do wyświetlenia w polu komunikatu.

icon: MessageBoxIcon

Jedna z MessageBoxIcon wartości określających, która ikona ma być wyświetlana w polu komunikatu.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Wyjątki

InvalidEnumArgumentException

buttonsnie jest członkiem .MessageBoxButtons

-lub-

iconnie jest członkiem .MessageBoxIcon

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określane przez UserInteractive właściwość .

Przykłady

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

Uwagi

Możesz mieć maksymalnie trzy przyciski w polu komunikatu.

Zobacz też

Dotyczy

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

Wyświetla pole komunikatu z określonym tekstem, podpis, przyciskami, ikoną i przyciskiem domyślnym.

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

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających przyciski do wyświetlenia w polu komunikatu.

icon: MessageBoxIcon

Jedna z MessageBoxIcon wartości określających, która ikona ma być wyświetlana w polu komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedną z wartości określających domyślny przycisk dla pola komunikatu.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Wyjątki

InvalidEnumArgumentException

buttonsnie jest członkiem .MessageBoxButtons

-lub-

iconnie jest członkiem .MessageBoxIcon

-lub-

defaultButtonnie jest członkiem .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określane przez UserInteractive właściwość .

Przykłady

Poniższy przykład kodu pokazuje, jak wyświetlić MessageBox element z opcjami obsługiwanymi przez to przeciążenie elementu Show. Po sprawdzeniu, ServerNameczy zmienna ciągu jest pusta, w przykładzie zostanie wyświetlona MessageBox ikona pola pytania, oferując użytkownikowi opcję anulowania operacji. Show Jeśli wartość zwracana metody zostanie obliczona na Yeswartość , formularz, który wyświetlił wartość MessageBox , jest zamknięty.

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

Uwagi

Możesz mieć maksymalnie trzy przyciski w polu komunikatu.

Zobacz też

Dotyczy

Show(IWin32Window, String, String, MessageBoxButtons)

Wyświetla pole komunikatu przed określonym obiektem i z określonym tekstem, podpis i przyciskami.

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

Implementacja tego IWin32Window elementu będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających przyciski do wyświetlenia w polu komunikatu.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Wyjątki

InvalidEnumArgumentException

buttonsnie jest członkiem .MessageBoxButtons

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określane przez UserInteractive właściwość .

Przykłady

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

Uwagi

Możesz mieć maksymalnie trzy przyciski w polu komunikatu.

Zobacz też

MessageBoxButtons

Dotyczy

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Wyświetla pole komunikatu z określonym tekstem, podpis, przyciskami i ikoną.

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

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających przyciski do wyświetlenia w polu komunikatu.

icon: MessageBoxIcon

Jedna z MessageBoxIcon wartości określających, która ikona ma być wyświetlana w polu komunikatu.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Wyjątki

InvalidEnumArgumentException

Określony buttons parametr nie jest elementem członkowskim MessageBoxButtons.

-lub-

Określony icon parametr nie jest elementem członkowskim MessageBoxIcon.

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określane przez UserInteractive właściwość .

Przykłady

Poniższy przykład kodu przedstawia jedną z Show metod obsługi ComboBox.DropDown zdarzenia. Aby uruchomić przykład, wklej następujący kod w formularzu i wywołaj InitializeComboBox metodę z konstruktora lub Load metody formularza.

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

Uwagi

Możesz mieć maksymalnie trzy przyciski w polu komunikatu.

Zobacz też

Dotyczy

Show(IWin32Window, String, String)

Wyświetla pole komunikatu przed określonym obiektem oraz z określonym tekstem i podpis.

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

Implementacja tego IWin32Window elementu będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Uwagi

Domyślnie w polu komunikatu jest wyświetlany przycisk OK .

Dotyczy

Show(String, String, MessageBoxButtons)

Wyświetla pole komunikatu z określonym tekstem, podpis i przyciskami.

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

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających przyciski do wyświetlenia w polu komunikatu.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Wyjątki

InvalidEnumArgumentException

Określony buttons parametr nie jest elementem członkowskim MessageBoxButtons.

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określane przez UserInteractive właściwość .

Przykłady

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

Uwagi

Możesz mieć maksymalnie trzy przyciski w polu komunikatu.

Zobacz też

MessageBoxButtons

Dotyczy

Show(IWin32Window, String)

Wyświetla pole komunikatu przed określonym obiektem i z określonym tekstem.

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

Implementacja tego IWin32Window elementu będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w polu wiadomości.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Uwagi

Domyślnie w polu komunikatu jest wyświetlany przycisk OK . Pole wiadomości nie zawiera podpis w tytule.

Dotyczy

Show(String, String)

Wyświetla pole komunikatu z określonym tekstem i podpis.

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

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

Zwraca

DialogResult

Jedna z DialogResult wartości.

Uwagi

Domyślnie w polu komunikatu jest wyświetlany przycisk OK .

Dotyczy

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

Wyświetla pole komunikatu z określonym tekstem, podpis, przyciskami, ikoną, przyciskiem domyślnym i opcjami.

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

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających przyciski do wyświetlenia w polu komunikatu.

icon: MessageBoxIcon

Jedna z MessageBoxIcon wartości określających, która ikona ma być wyświetlana w polu komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedną z wartości określających domyślny przycisk dla pola komunikatu.

options: MessageBoxOptions

Zwraca

DialogResult

Jedna z DialogResult wartości.

Wyjątki

InvalidEnumArgumentException

buttonsnie jest członkiem .MessageBoxButtons

-lub-

iconnie jest członkiem .MessageBoxIcon

-lub-

Określona defaultButton wartość nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określane przez UserInteractive właściwość .

ArgumentException

options określone zarówno, jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttons określono nieprawidłową kombinację elementu MessageBoxButtons.

Przykłady

Poniższy przykład kodu pokazuje, jak wyświetlić MessageBox element z opcjami obsługiwanymi przez to przeciążenie elementu Show. Po sprawdzeniu, ServerNameczy zmienna ciągu jest pusta, w przykładzie zostanie wyświetlona MessageBox ikona pola pytania, oferując użytkownikowi opcję anulowania operacji. W przykładzie użyto RightAlign elementu członkowskiego MessageBoxOptions wyliczenia, aby wyrównać tekst do prawej krawędzi okna dialogowego. Show Jeśli wartość zwracana metody zostanie obliczona na Yeswartość , formularz, który wyświetlił wartość MessageBox , jest zamknięty.

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

Uwagi

Możesz mieć maksymalnie trzy przyciski w polu komunikatu.

Zobacz też

Dotyczy

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

Implementacja tego IWin32Window elementu będzie właścicielem modalnego okna dialogowego.

text: String

Tekst do wyświetlenia w polu wiadomości.

caption: String

Tekst wyświetlany na pasku tytułu pola wiadomości.

buttons: MessageBoxButtons

MessageBoxButtons Jedna z wartości określających przyciski do wyświetlenia w polu komunikatu.

icon: MessageBoxIcon

Jedna z MessageBoxIcon wartości określających, która ikona ma być wyświetlana w polu komunikatu.

defaultButton: MessageBoxDefaultButton

MessageBoxDefaultButton Jedną z wartości określających domyślny przycisk dla pola komunikatu.

options: MessageBoxOptions

helpFilePath: String

Ścieżka i nazwa pliku Pomocy do wyświetlenia, gdy użytkownik kliknie przycisk Pomoc.

navigator: HelpNavigator

Jedna z HelpNavigator wartości.

param: Object

Identyfikator liczbowy tematu Pomocy, który ma być wyświetlany, gdy użytkownik kliknie przycisk Pomoc.

Zwraca

DialogResult

DialogResult Jedna z wartości.

Wyjątki

InvalidEnumArgumentException

buttonsnie jest członkiem .MessageBoxButtons

-lub-

iconnie jest członkiem .MessageBoxIcon

-lub-

Określona defaultButton wartość nie jest elementem członkowskim .MessageBoxDefaultButton

InvalidOperationException

Podjęto próbę wyświetlenia MessageBox elementu w procesie, który nie jest uruchomiony w trybie interaktywnym użytkownika. Jest to określane przez UserInteractive właściwość .

ArgumentException

options określone zarówno, jak DefaultDesktopOnly i ServiceNotification.

-lub-

buttons określono nieprawidłową kombinację elementu MessageBoxButtons.

Przykłady

Poniższy przykład kodu pokazuje, jak pokazać pole komunikatu nadrzędne do głównego okna. W polu komunikatu zostanie wyświetlony przycisk Pomoc. Gdy użytkownik kliknie przycisk Pomoc, Mspaint.chm zostanie otwarty plik Pomocy, a karta Indeks Pomocy i temat zidentyfikowany przez ovals słowo kluczowe zostaną wyświetlone. Przykład wymaga zainstalowania Mspaint.chm pliku Pomocy.

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

Uwagi

Pole komunikatu to modalne okno dialogowe, co oznacza, że nie może wystąpić żadne wejście (klawiatura lub kliknięcie myszy) z wyjątkiem obiektów w formie modalnej. Program musi ukryć lub zamknąć formularz modalny (zazwyczaj w odpowiedzi na akcję użytkownika) przed wystąpieniem danych wejściowych do innego formularza. Możesz użyć parametru owner , aby określić konkretny obiekt, który implementuje IWin32Window interfejs, który będzie służyć jako okno najwyższego poziomu okna dialogowego i właściciel.

Parametr helpFilePath może mieć postać C:\path\sample.chm lub /folder/file.htm.

Zobacz też

Dotyczy