Interaction.MsgBox(Object, MsgBoxStyle, Object) Metodo

Definizione

Visualizza un messaggio in una finestra di dialogo, attende che l'utente faccia clic su un pulsante e quindi restituisce un numero intero che indica il pulsante su cui l'utente ha fatto clic.

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.ApplicationModal, Optional Title As Object = Nothing) As MsgBoxResult

Parametri

Prompt
Object

Required. String espressione 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 usando un carattere di ritorno a capo (Chr(13)), un carattere di avanzamento riga (Chr(10)) o una combinazione di caratteri ritorno a capo/avanzamento riga (Chr(13) e Chr(10)) tra ogni riga.

Buttons
MsgBoxStyle

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

Title
Object

Optional. String espressione visualizzata nella barra del titolo della finestra di dialogo. Se si omette Title, il nome dell'applicazione viene inserito nella barra del titolo.

Valori restituiti

Uno dei valori seguenti:

CostanteValore
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Eccezioni

Prompt non è un'espressione String o Title non è valida.

Il processo non è in esecuzione in modalità Utente interattivo.

Uno o più parametri non un membro 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 i pulsanti Sì e No. Il pulsante No è specificato come risposta predefinita. Questa operazione viene eseguita combinando i MsgBox valori costanti in un'unica 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 conservare il delimitatore virgola corrispondente.

Se nella finestra di dialogo viene visualizzato un pulsante Annulla, premere ESC ha lo stesso effetto di fare clic su Annulla.

Se la finestra di dialogo contiene un pulsante ?, per la finestra di dialogo viene fornita la Guida sensibile al contesto. Tuttavia, non viene restituito alcun valore finché non viene scelto uno degli altri pulsanti. Nelle applicazioni modulo Windows scegliere il pulsante Help esegue l'evento HelpRequested per il modulo.

Note

La MsgBox funzione richiede UIPermission a SafeTopLevelWindows livello, 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 è il predefinito.
DefaultButton2 256 Il secondo pulsante è il predefinito.
DefaultButton3 512 Il terzo pulsante è il 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 della 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 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