Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

 

Data di pubblicazione: ottobre 2016

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.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public static DialogResult Show(
	IWin32Window owner,
	string text,
	string caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options,
	string helpFilePath,
	string keyword
)

Parametri

owner
Type: System.Windows.Forms.IWin32Window

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

text
Type: System.String

Testo da visualizzare nella finestra di messaggio.

caption
Type: System.String

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

buttons
Type: System.Windows.Forms.MessageBoxButtons

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

icon
Type: System.Windows.Forms.MessageBoxIcon

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

defaultButton
Type: System.Windows.Forms.MessageBoxDefaultButton

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

options
Type: System.Windows.Forms.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
Type: System.String

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

keyword
Type: System.String

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

Valore restituito

Type: System.Windows.Forms.DialogResult

Uno dei valori di DialogResult.

Exception Condition
InvalidEnumArgumentException

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

Il defaultButton specificato non è un membro di MessageBoxDefaultButton.

InvalidOperationException

Si è verificato un tentativo di visualizzare il MessageBox in un processo che non è in esecuzione in modalità interattiva utente. Questa impostazione è specificata la SystemInformation.UserInteractive proprietà.

ArgumentException

options specificato sia DefaultDesktopOnly e ServiceNotification.

-oppure-

buttons specificare una combinazione valida di MessageBoxButtons.

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

Quando l'utente fa clic sul pulsante della Guida in linea, il file della Guida specificato nel helpFilePath parametro viene aperto e l'argomento della parola chiave identificate le keyword parametro viene visualizzato. Il form che possiede la finestra di messaggio (o il form attivo) riceve anche il HelpRequested evento.

Esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio associata alla finestra principale. La finestra di messaggio viene visualizzato un pulsante?. Quando l'utente fa clic sul pulsante della Guida in linea, il Mspaint.chm viene aperto il file della Guida in linea e l'argomento identificato dal mspaint.chm::/paint_brush.htm parola chiave viene visualizzata. Nell'esempio si presuppone che il Mspaint.chm file della Guida è installato.

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// 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");

UIPermission

for safe subwindows to call this method. Associated enumeration: F:System.Security.Permissions.UIPermissionWindow.SafeSubWindows

WebPermission

to access a HTML help file through a HTTP request. Associated enumeration: F:System.Net.NetworkAccess.Connect

SecurityPermission

to access a HTML help file not served from a HTTP server. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: