Interaction.MsgBox(Object, MsgBoxStyle, Object) Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

Interaction.vb

Visualizza un messaggio in una finestra di dialogo, attende che l'utente faccia clic su un pulsante, quindi restituisce un intero che indica il pulsante scelto dall'utente.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, object? Title = default);

static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult

Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, Optional Title As Object = Nothing) As MsgBoxResult

Parametri

Prompt

Object

Obbligatorio. Espressione String visualizzata come messaggio nella finestra di dialogo. La lunghezza massima di Prompt è di circa 1024 caratteri, a seconda della larghezza dei caratteri utilizzati. Se Prompt è costituito da più righe, è possibile separare le righe utilizzando un carattere di ritorno a capo (Chr(13)), un carattere di avanzamento riga (Chr(10)) o una combinazione di caratteri di ritorno a capo/avanzamento riga (Chr(13) & Chr(10)) tra ogni riga.

Buttons

MsgBoxStyle

facoltativo. Espressione numerica che rappresenta la somma dei valori che specificano il numero e il tipo dei pulsanti da visualizzare, lo stile di icona da utilizzare, l'identità del pulsante predefinito e la modalità della finestra di messaggio. Se si omette Buttons, il valore predefinito è zero.

Title

Object

facoltativo. Espressione String visualizzata nella barra del titolo della finestra di dialogo. Se si omette Title, nella barra del titolo viene visualizzato il nome dell'applicazione.

Restituisce

MsgBoxResult

Uno dei valori seguenti:

Costante	Valore
OK	1
Cancel	2
Abort	3
Retry	4
Ignore	5
Yes	6
No	7

Eccezioni

ArgumentException

Prompt non è un'espressione String oppure Title non è valido.

InvalidOperationException

Il processo non viene eseguito in modo interattivo con l'utente.

InvalidEnumArgumentException

Uno o più parametri non sono membri dell'enumerazione MsgBoxResult o MsgBoxStyle.

Esempio

In questo esempio viene usata la MsgBox funzione per visualizzare un messaggio di errore critico in una finestra di dialogo con pulsanti Sì e No. Il pulsante No viene specificato come risposta predefinita. Questa operazione viene eseguita combinando i MsgBox valori costanti in un'espressione numerica. In questo caso, l'aggiunta di 4 (combinazione di pulsanti Sì/No) e 16 (finestra Messaggio critico ) e 256 (il secondo pulsante come pulsante predefinito) fornisce un totale di 276. Il valore restituito dalla MsgBox funzione dipende dal pulsante scelto dall'utente: Sì restituisce un valore pari a 6; No restituisce un valore pari a 7.

' The following example requires that Option Infer be set to On.

' Define the message you want to see inside the message box.
Dim msg = "Do you want to continue?"

' Display a simple message box.
MsgBox(msg)

' Define a title for the message box.
Dim title = "MsgBox Demonstration"

' Add the title to the display.
MsgBox(msg, , title)

' Now define a style for the message box. In this example, the
' message box will have Yes and No buttons, the default will be
' the No button, and a Critical Message icon will be present.
Dim style = MsgBoxStyle.YesNo Or MsgBoxStyle.DefaultButton2 Or
            MsgBoxStyle.Critical

' Display the message box and save the response, Yes or No.
Dim response = MsgBox(msg, style, title)

' Take some action based on the response.
If response = MsgBoxResult.Yes Then
    MsgBox("YES, continue!!", , title)
Else
    MsgBox("NO, stop!!", , title)
End If

Commenti

Se si omettono argomenti posizionali, è necessario mantenere il delimitatore virgola corrispondente.

Se nella finestra di dialogo viene visualizzato un pulsante Annulla , la pressione del tasto ESC ha lo stesso effetto di fare clic su Annulla

Se la finestra di dialogo contiene un pulsante ? , viene fornita la Guida sensibile al contesto per la finestra di dialogo. Tuttavia, fino a quando non viene scelto uno degli altri pulsanti, non viene restituito alcun valore. Nelle applicazioni Windows Form, la scelta del pulsante ? esegue l'evento HelpRequested per il modulo.

Nota

La MsgBox funzione richiede UIPermission a SafeTopLevelWindows livello di , che può influire sull'esecuzione in situazioni di attendibilità parziale. Per altre informazioni, vedere UIPermission.

I MsgBoxStyle valori di enumerazione sono elencati nella tabella seguente.

Membro	Valore	Descrizione
Membro	Valore	Descrizione
OKOnly	0	Visualizza solo il pulsante OK.
OKCancel	1	Visualizza i pulsanti OK e Annulla.
AbortRetryIgnore	2	Visualizza i pulsanti Interrompi, Riprova e Ignora.
YesNoCancel	3	Visualizza i pulsanti Sì, No e Annulla.
YesNo	4	Visualizza i pulsanti Sì e No.
RetryCancel	5	Visualizza i pulsanti Riprova e Annulla.
Critical	16	Visualizza l'icona Messaggio critico.
Question	32	Visualizza l'icona Query di avviso.
Exclamation	48	Visualizza l'icona messaggio di avviso.
Information	64	Visualizza l'icona Del messaggio informativo.
DefaultButton1	0	Il primo pulsante è quello predefinito.
DefaultButton2	256	Il secondo pulsante è quello predefinito.
DefaultButton3	512	Il terzo pulsante è quello predefinito.
ApplicationModal	0	L'applicazione è modale. L'utente deve rispondere alla finestra di messaggio prima di continuare a lavorare nell'applicazione corrente.
SystemModal	4096	Il sistema è modale. Tutte le applicazioni vengono sospese fino a quando l'utente non risponde alla finestra di messaggio.
MsgBoxSetForeground	65536	Specifica la finestra di messaggio come finestra in primo piano.
MsgBoxRight	524288	Il testo è allineato a destra.
MsgBoxRtlReading	1048576	Specifica che il testo deve essere visualizzato come lettura da destra a sinistra nei sistemi ebrei e arabi.

Il primo gruppo di valori (0-5) descrive il numero e il tipo di pulsanti visualizzati nella finestra di dialogo. Il secondo gruppo (16, 32, 48, 64) descrive lo stile dell'icona. Il terzo gruppo (0, 256, 512) determina il pulsante predefinito. Il quarto gruppo (0, 4096) determina la modalità della finestra di messaggio e il quinto gruppo specifica se la finestra della finestra di messaggio è la finestra in primo piano, insieme all'allineamento e alla direzione del testo. Quando si aggiungono numeri per creare un valore finale per l'argomento Buttons , usare un solo numero da ogni gruppo.

Vedi anche

• InputBox(String, String, String, Int32, Int32)
• Show(String)