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)

 

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 desiderato.

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
)

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 ?.

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 verrà utilizzato come finestra di primo livello e il proprietario 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. Il form che possiede la finestra di messaggio (o il form attivo) riceve anche il HelpRequested evento.

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

Esempio di codice seguente viene illustrato come visualizzare una finestra di messaggio associato al form 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. 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 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");

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: