Interaction.MsgBox(Object, MsgBoxStyle, Object) Metodo

Definizione

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);
public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, 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
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, 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

Uno dei valori seguenti:

CostanteValore
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Eccezioni

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

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

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.

Si applica a

Vedi anche