MessageBox.Show Metodo

Definizione

Visualizza una finestra di messaggio.

Overload

Show(String)

Visualizza una finestra di messaggio con il testo specificato.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida e la parola chiave della Guida desiderati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida, HelpNavigator e l'argomento della Guida desiderati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato e HelpNavigator.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida e la parola chiave della Guida desiderati.

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

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti l'icona, il pulsante predefinito e le opzioni specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato e HelpNavigator.

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

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti, l'icona e il pulsante predefinito specificati.

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

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti e l'icona specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona e il pulsante predefinito specificati.

Show(IWin32Window, String, String, MessageBoxButtons)

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia e i pulsanti specificati.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti e l'icona specificati.

Show(IWin32Window, String, String)

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo e la didascalia specificati.

Show(String, String, MessageBoxButtons)

Visualizza una finestra di messaggio con il testo, la didascalia e i pulsanti specificati.

Show(IWin32Window, String)

Visualizza una finestra di messaggio davanti all'oggetto indicato e con il testo specificato.

Show(String, String)

Visualizza una finestra di messaggio con il testo e le didascalie specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito e le opzioni specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida, HelpNavigator e l'argomento della Guida desiderati.

Show(String)

Visualizza una finestra di messaggio con il testo specificato.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Esempio

Nell'esempio di codice seguente viene visualizzata una semplice finestra di messaggio.

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

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

Commenti

Per impostazione predefinita, nella finestra di messaggio viene visualizzato un pulsante OK . La finestra di messaggio non contiene un didascalia nel titolo.

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida e la parola chiave della Guida desiderati.

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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

helpFilePath
String

Percorso e nome del file della Guida da visualizzare quando l'utente sceglie il pulsante ?.

keyword
String

Parola chiave della Guida visualizzata quando l'utente fa clic sul pulsante ?.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio padre nella finestra principale. Nella finestra di messaggio viene visualizzato un pulsante ? Quando l'utente fa clic sul pulsante ? viene aperto il Mspaint.chm file della Guida e viene visualizzato l'argomento identificato dalla mspaint.chm::/paint_brush.htm parola chiave . L'esempio richiede l'installazione del file della Mspaint.chm Guida.

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

Commenti

Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione degli oggetti nel modulo modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che possa verificarsi l'input in un altro modulo. È possibile usare il owner parametro per specificare un oggetto specifico, che implementa l'interfaccia IWin32Window , che fungerà da proprietario principale della finestra di dialogo.

Quando l'utente fa clic sul pulsante ? viene aperto il file della helpFilePath Guida specificato nel parametro e viene visualizzato l'argomento keyword della parola chiave della Guida identificato dal parametro . Il modulo proprietario della finestra di messaggio (o del modulo attivo) riceve anche l'evento HelpRequested .

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida, HelpNavigator e l'argomento della Guida desiderati.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

helpFilePath
String

Percorso e nome del file della Guida da visualizzare quando l'utente sceglie il pulsante ?.

navigator
HelpNavigator

Uno dei valori di HelpNavigator.

param
Object

ID numerico dell'argomento della Guida da visualizzare quando l'utente fa clic sul pulsante ?.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio con un pulsante ? Quando l'utente fa clic sul pulsante ? viene aperto il Mspaint.chm file della Guida e viene visualizzata la scheda Indice della Guida e l'argomento identificato dalla ovals parola chiave . L'esempio richiede l'installazione del file della Mspaint.chm Guida.

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

Commenti

Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione degli oggetti nel modulo modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che possa verificarsi l'input in un altro modulo.

Quando l'utente fa clic sul pulsante ? viene aperto il file della helpFilePath Guida specificato nel parametro e viene visualizzato il contenuto della navigator Guida identificato dal parametro . Il modulo proprietario della finestra di messaggio (o del modulo attivo) riceve anche l'evento HelpRequested .

I file della Guida compilati forniscono sommario, indice, ricerca e collegamenti di parole chiave nelle pagine. È possibile usare i valori seguenti per navigator: TableOfContents, Find, Indexo Topic.

È possibile usare param per fornire ulteriore perfezionamento del Topic comando. Se il valore specificato nel navigator parametro è TableOfContents, Indexo Find, questo valore deve essere null. Se il navigator parametro fa Topicriferimento a , questo valore deve fare riferimento a un oggetto contenente il valore numerico dell'argomento da visualizzare.

Il helpFilePath parametro può essere del form C:\path\sample.chm o /cartella/file.htm.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato.

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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

helpFilePath
String

Percorso e nome del file della Guida da visualizzare quando l'utente sceglie il pulsante ?.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio padre nella maschera principale. Nella finestra di messaggio viene visualizzato un pulsante ? Quando l'utente fa clic sul pulsante ? viene aperto il file della Mspaint.chm Guida. L'esempio richiede l'installazione del file della Mspaint.chm Guida.

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

Commenti

Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione degli oggetti nel modulo modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che possa verificarsi l'input in un altro modulo. È possibile usare il owner parametro per specificare un particolare oggetto, che implementa l'interfaccia IWin32Window , che fungerà da finestra e proprietario della finestra di dialogo di primo livello.

Quando l'utente fa clic sul pulsante ? viene aperto il file della Guida specificato nel helpFilePath parametro . Il modulo proprietario della finestra di messaggio (o del modulo attivo) riceve anche l'evento HelpRequested .

Il helpFilePath parametro può essere del form C:\path\sample.chm o /cartella/file.htm.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato e 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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

helpFilePath
String

Percorso e nome del file della Guida da visualizzare quando l'utente sceglie il pulsante ?.

navigator
HelpNavigator

Uno dei valori di HelpNavigator.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio con un pulsante ? Quando l'utente fa clic sul pulsante ? viene aperto il Mspaint.chm file della Guida e viene visualizzata la scheda Indice della Guida. L'esempio richiede l'installazione del file della Mspaint.chm Guida.

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

Commenti

Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione degli oggetti nel modulo modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che possa verificarsi l'input in un altro modulo.

Quando l'utente fa clic sul pulsante ? viene aperto il file della helpFilePath Guida specificato nel parametro e viene visualizzato il contenuto della navigator Guida identificato dal parametro . Il modulo proprietario della finestra di messaggio (o del modulo attivo) riceve anche l'evento HelpRequested .

I file della Guida compilati forniscono i collegamenti sommari, indice, ricerca e parola chiave nelle pagine. È possibile usare i valori seguenti per navigator: TableOfContents, Find, Indexo Topic.

Il helpFilePath parametro può essere del form C:\path\sample.chm o /cartella/file.htm.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida e la parola chiave della Guida desiderati.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

helpFilePath
String

Percorso e nome del file della Guida da visualizzare quando l'utente sceglie il pulsante ?.

keyword
String

Parola chiave della Guida visualizzata quando l'utente fa clic sul pulsante ?.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio con un pulsante ? Quando l'utente fa clic sul pulsante ? viene aperto il Mspaint.chm file della Guida e viene visualizzato l'argomento identificato dalla mspaint.chm::/paint_brush.htm parola chiave . L'esempio richiede l'installazione del file della Mspaint.chm Guida.

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

Commenti

Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione di oggetti nel formato modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che l'input a un altro modulo possa verificarsi.

Quando l'utente fa clic sul pulsante Guida, il file della Guida specificato nel helpFilePath parametro viene aperto e viene visualizzato l'argomento della parola chiave della Guida identificato dal keyword parametro. Il modulo proprietario della finestra di messaggio (o del modulo attivo) riceve anche l'evento HelpRequested .

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti l'icona, il pulsante predefinito e le opzioni specificati.

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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

defaultButton non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

options ha specificato DefaultDesktopOnly o ServiceNotification e un valore nel parametro owner. Queste due opzioni vanno usate solo se si richiama la versione di questo metodo che non accetta un parametro owner.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare un MessageBox oggetto con le opzioni supportate da questo overload di Show. Dopo aver verificato che una variabile stringa, ServerName, è vuota, nell'esempio viene visualizzato un MessageBoxoggetto , che offre all'utente l'opzione per annullare l'operazione. Se il Show valore restituito del metodo restituisce Yes, il modulo visualizzato MessageBox viene chiuso.

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

Commenti

È possibile usare il owner parametro per specificare un oggetto specifico, che implementa l'interfaccia IWin32Window , che fungerà da finestra e proprietario della finestra di dialogo. Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione di oggetti nel formato modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che l'input a un altro modulo possa verificarsi.

È possibile avere un massimo di tre pulsanti nella casella di messaggio.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

helpFilePath
String

Percorso e nome del file della Guida da visualizzare quando l'utente sceglie il pulsante ?.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio con un pulsante Della Guida. Quando l'utente fa clic sul pulsante Guida, viene aperto il Mspaint.chm file della Guida. L'esempio richiede che il Mspaint.chm file della Guida sia installato.

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

Commenti

Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione di oggetti nel formato modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che l'input a un altro modulo possa verificarsi.

Quando l'utente fa clic sul pulsante Guida, viene aperto il helpFilePath file della Guida specificato nel parametro. Il modulo proprietario della finestra di messaggio (o del modulo attivo) riceve anche l'evento HelpRequested .

Il helpFilePath parametro può essere del form C:\path\sample.chm o /cartella/file.htm.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

displayHelpButton
Boolean

true per visualizzare il pulsante ?; in caso contrario, false. Il valore predefinito è false.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio con un pulsante Della Guida, gestire l'evento e visualizzare una finestra della Guida personalizzata in risposta all'evento Control.HelpRequested .

#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

Commenti

Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione di oggetti nel formato modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che l'input a un altro modulo possa verificarsi.

Quando l'utente fa clic sul pulsante Guida, il modulo proprietario della casella di messaggio (o il modulo attivo) riceve l'evento HelpRequested . Gestire l'evento HelpRequested per eseguire azioni della Guida personalizzate.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato e 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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

helpFilePath
String

Percorso e nome del file della Guida da visualizzare quando l'utente sceglie il pulsante ?.

navigator
HelpNavigator

Uno dei valori di HelpNavigator.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio padre nella finestra principale. La finestra di messaggio visualizza un pulsante Della Guida. Quando l'utente fa clic sul pulsante Guida, il Mspaint.chm file della Guida viene aperto e viene visualizzata la scheda Indice della Guida. L'esempio richiede che il Mspaint.chm file della Guida sia installato.

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

Commenti

Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione degli oggetti nel modulo modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che possa verificarsi l'input in un altro modulo. È possibile usare il owner parametro per specificare un particolare oggetto, che implementa l'interfaccia IWin32Window , che fungerà da finestra e proprietario della finestra di dialogo di primo livello.

Quando l'utente fa clic sul pulsante ? viene aperto il file della helpFilePath Guida specificato nel parametro e viene visualizzato il contenuto della navigator Guida identificato dal parametro . Il modulo proprietario della finestra di messaggio (o del modulo attivo) riceve anche l'evento HelpRequested .

I file della Guida compilati forniscono i collegamenti sommari, indice, ricerca e parola chiave nelle pagine. È possibile usare i valori seguenti per navigator: TableOfContents, Find, Indexo Topic.

Il helpFilePath parametro può essere del form C:\path\sample.chm o /cartella/file.htm.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti, l'icona e il pulsante predefinito specificati.

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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

defaultButton non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare un MessageBox oggetto con le opzioni supportate da questo overload di Show. Dopo aver verificato che una variabile stringa, ServerName, è vuota, nell'esempio viene visualizzato un MessageBoxoggetto , che offre all'utente l'opzione per annullare l'operazione. Se il Show valore restituito del metodo restituisce Yes, il modulo che visualizza l'oggetto MessageBox viene chiuso.

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

Commenti

È possibile usare il owner parametro per specificare un particolare oggetto, che implementa l'interfaccia IWin32Window , che fungerà da finestra e proprietario della finestra di dialogo di primo livello. Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione degli oggetti nel modulo modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che possa verificarsi l'input in un altro modulo.

È possibile avere un massimo di tre pulsanti nella finestra di messaggio.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti e l'icona specificati.

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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare un MessageBox oggetto con le opzioni supportate da questo overload di Show. Dopo aver verificato che una variabile stringa, ServerName, è vuota, nell'esempio viene visualizzato un MessageBoxoggetto , che offre all'utente l'opzione per annullare l'operazione. Se il Show valore restituito del metodo restituisce Yes, il modulo che visualizza l'oggetto MessageBox viene chiuso.

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

Commenti

È possibile usare il owner parametro per specificare un particolare oggetto, che implementa l'interfaccia IWin32Window , che fungerà da finestra e proprietario della finestra di dialogo di primo livello. Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione degli oggetti nel modulo modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che possa verificarsi l'input in un altro modulo.

È possibile avere un massimo di tre pulsanti nella finestra di messaggio.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona e il pulsante predefinito specificati.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

defaultButton non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare un MessageBox oggetto con le opzioni supportate da questo overload di Show. Dopo aver verificato che una variabile stringa, ServerName, è vuota, nell'esempio viene visualizzata un'icona MessageBox con una casella di domande, offrendo all'utente l'opzione di annullare l'operazione. Se il Show valore restituito del metodo restituisce Yes, il modulo che visualizza l'oggetto MessageBox viene chiuso.

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

Commenti

È possibile avere un massimo di tre pulsanti nella finestra di messaggio.

Vedi anche

Si applica a

Show(IWin32Window, String, String, MessageBoxButtons)

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia e i pulsanti specificati.

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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare un MessageBox oggetto con le opzioni supportate da questo overload di Show. Dopo aver verificato che una variabile stringa, ServerName, è vuota, nell'esempio viene visualizzato un MessageBoxoggetto , che offre all'utente l'opzione per annullare l'operazione. Se il Show valore restituito del metodo restituisce Yes, il modulo che visualizza l'oggetto MessageBox viene chiuso.

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

Commenti

È possibile usare il owner parametro per specificare un particolare oggetto, che implementa l'interfaccia IWin32Window , che fungerà da finestra e proprietario della finestra di dialogo di primo livello. Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione degli oggetti nel modulo modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che possa verificarsi l'input in un altro modulo.

È possibile avere un massimo di tre pulsanti nella finestra di messaggio.

Vedi anche

Si applica a

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti e l'icona specificati.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

Il parametro buttons specificato non è un membro di MessageBoxButtons.

-oppure-

Il parametro icon specificato non è un membro di MessageBoxIcon.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

Esempio

Nell'esempio di codice seguente viene illustrato uno dei Show metodi durante la gestione dell'evento ComboBox.DropDown . Per eseguire l'esempio, incollare il codice seguente in un modulo e chiamare il InitializeComboBox metodo dal costruttore o Load dal metodo del modulo.

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

Commenti

È possibile avere un massimo di tre pulsanti nella casella di messaggio.

Vedi anche

Si applica a

Show(IWin32Window, String, String)

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo e la didascalia specificati.

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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Commenti

È possibile usare il owner parametro per specificare un oggetto specifico, che implementa l'interfaccia IWin32Window , che fungerà da finestra e proprietario della finestra di dialogo. Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione di oggetti nel formato modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che l'input a un altro modulo possa verificarsi.

Per impostazione predefinita, la finestra di messaggio visualizza un pulsante OK .

Si applica a

Show(String, String, MessageBoxButtons)

Visualizza una finestra di messaggio con il testo, la didascalia e i pulsanti specificati.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

Il parametro buttons specificato non è un membro di MessageBoxButtons.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare un MessageBox oggetto con le opzioni supportate da questo overload di Show. Dopo aver verificato che una variabile stringa, ServerName, è vuota, nell'esempio viene visualizzato un MessageBoxoggetto , che offre all'utente l'opzione per annullare l'operazione. Se il Show valore restituito del metodo restituisce Yes, il modulo visualizzato MessageBox viene chiuso.

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

Commenti

È possibile avere un massimo di tre pulsanti nella casella di messaggio.

Vedi anche

Si applica a

Show(IWin32Window, String)

Visualizza una finestra di messaggio davanti all'oggetto indicato e con il testo specificato.

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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Commenti

È possibile usare il owner parametro per specificare un oggetto specifico, che implementa l'interfaccia IWin32Window , che fungerà da finestra e proprietario della finestra di dialogo. Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione di oggetti nel formato modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che l'input a un altro modulo possa verificarsi.

Per impostazione predefinita, la finestra di messaggio visualizza un pulsante OK . La finestra di messaggio non contiene un didascalia nel titolo.

Si applica a

Show(String, String)

Visualizza una finestra di messaggio con il testo e le didascalie specificati.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

Restituisce

Uno dei valori di DialogResult.

Commenti

Per impostazione predefinita, la finestra di messaggio visualizza un pulsante OK .

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito e le opzioni specificati.

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

Parametri

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare un MessageBox oggetto con le opzioni supportate da questo overload di Show. Dopo aver verificato che una variabile stringa, ServerName, è vuota, nell'esempio viene visualizzata un'icona MessageBox con una casella interrogativa, offrendo all'utente l'opzione per annullare l'operazione. Nell'esempio viene usato il RightAlign membro dell'enumerazione MessageBoxOptions per allineare il testo al bordo destro della finestra di dialogo. Se il Show valore restituito del metodo restituisce Yes, il modulo visualizzato MessageBox viene chiuso.

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

Commenti

È possibile avere un massimo di tre pulsanti nella casella di messaggio.

Vedi anche

Si applica a

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida, HelpNavigator e l'argomento della Guida desiderati.

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

Parametri

owner
IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
String

Testo da visualizzare nella finestra di messaggio.

caption
String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

helpFilePath
String

Percorso e nome del file della Guida da visualizzare quando l'utente sceglie il pulsante ?.

navigator
HelpNavigator

Uno dei valori di HelpNavigator.

param
Object

ID numerico dell'argomento della Guida da visualizzare quando l'utente fa clic sul pulsante ?.

Restituisce

Uno dei valori di DialogResult.

Eccezioni

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il parametro defaultButton specificato non è un membro di MessageBoxDefaultButton.

Si è verificato un tentativo di visualizzare il controllo MessageBox in un processo non in esecuzione in modalità Interazione utente. Questa modalità è specificata dalla proprietà UserInteractive.

options ha specificato sia DefaultDesktopOnly sia ServiceNotification.

-oppure-

buttons ha specificato una combinazione non valida di MessageBoxButtons.

Esempio

Nell'esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio padre nella finestra principale. La finestra di messaggio visualizza un pulsante Della Guida. Quando l'utente fa clic sul pulsante Guida, viene aperto il Mspaint.chm file della Guida e viene visualizzata la scheda Indice della Guida e l'argomento identificato dalla ovals parola chiave. L'esempio richiede che il Mspaint.chm file della Guida sia installato.

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

Commenti

Una finestra di messaggio è una finestra di dialogo modale, ovvero nessun input (tastiera o clic del mouse) può verificarsi ad eccezione di oggetti nel formato modale. Il programma deve nascondere o chiudere un modulo modale (in genere in risposta a un'azione dell'utente) prima che l'input a un altro modulo possa verificarsi. È possibile usare il owner parametro per specificare un oggetto specifico, che implementa l'interfaccia IWin32Window , che fungerà da finestra e proprietario della finestra di dialogo.

Quando l'utente fa clic sul pulsante Guida, il file della Guida specificato nel helpFilePath parametro viene aperto e viene visualizzato il navigator contenuto della Guida identificato dal parametro. Il modulo proprietario della finestra di messaggio (o del modulo attivo) riceve anche l'evento HelpRequested .

I file della Guida compilati forniscono il sommario, l'indice, la ricerca e i collegamenti alle parole chiave nelle pagine. È possibile usare i valori seguenti per navigator: TableOfContents, Find, Indexo Topic.

È possibile usare param per fornire ulteriori miglioramenti del Topic comando. Se il valore specificato nel navigator parametro è TableOfContents, Indexo Find, questo valore deve essere null. Se il navigator parametro fa riferimento Topica , questo valore deve fare riferimento a un oggetto contenente il valore numerico dell'argomento da visualizzare.

Il helpFilePath parametro può essere del form C:\path\sample.chm o /cartella/file.htm.

Vedi anche

Si applica a