Finestra di messaggio

Visualizza un messaggio in una finestra di dialogo, attende che l'utente faccia clic su un pulsante e restituisce un valore che indica quale pulsante è stato selezionato.

Struttura

MsgBox(messaggio[, pulsanti][, titolo][, file_aiuto, contesto])

Parametri

prompt - Espressione stringa visualizzata come messaggio nella finestra di dialogo. La lunghezza massima del prompt è di circa 1024 caratteri, a seconda della larghezza dei caratteri utilizzati. Se il prompt è composto da più righe, è possibile separarle inserendo un carattere di ritorno a capo (Chr(13)), un carattere di avanzamento riga (Chr(10)) o una combinazione dei due caratteri (Chr(13) & Chr(10)) tra una riga e l'altra.

pulsanti - Espressione numerica che rappresenta la somma dei valori che specificano il numero e il tipo di pulsanti da visualizzare, lo stile delle icone da utilizzare, l'identificatore del pulsante predefinito e la modalità della finestra di messaggio. Per i valori, consultare la sezione Impostazioni. Se omesso, il valore predefinito per i pulsanti è 0.

titolo - Espressione stringa visualizzata nella barra del titolo della finestra di dialogo. Se non si specifica il titolo, nella barra del titolo verrà visualizzato il nome dell'applicazione.

helpfile - Espressione stringa che identifica il file della Guida da utilizzare per fornire la Guida contestuale relativa alla finestra di dialogo. Se viene specificato il file di aiuto, è necessario specificare anche il contesto. Non disponibile sulle piattaforme a 16 bit.

contesto - Espressione numerica che identifica il numero di contesto della Guida assegnato dall'autore della Guida all'argomento corrispondente. Se viene fornito il contesto, è necessario fornire anche il file di aiuto. Non disponibile sulle piattaforme a 16 bit.

Valori dei parametri

Le impostazioni dell'argomento «buttons» sono:

Valore costante Descrizione

vbOKOnly 0 Visualizza solo il pulsante OK.

vbOKCancel 1 Visualizza i pulsanti OK e Annulla.

vbAbortRetryIgnore 2 Visualizza i pulsanti "Interrompi", "Riprova" e "Ignora".

vbYesNoCancel 3 Visualizza i pulsanti Sì, No e Annulla.

vbYesNo 4 Visualizza i pulsanti Sì e No.

vbRetryCancel 5 Visualizza i pulsanti "Riprova" e "Annulla".

vbCritical 16 Visualizza l'icona del messaggio critico.

vbDomanda 32 Visualizza l'icona di avviso della query.

vbExclamation 48 Icona "Visualizza messaggio di avviso".

vbInformation 64 Icona del messaggio informativo.

vbDefaultButton1 0 Il primo pulsante è quello predefinito.

vbDefaultButton2 256 Il secondo pulsante è quello predefinito.

vbDefaultButton3 512 Il terzo pulsante è quello predefinito.

vbDefaultButton4 768 Il quarto pulsante è quello predefinito.

vbApplicationModal 0 Finestra modale dell'applicazione; l'utente deve rispondere alla finestra di messaggio prima di poter continuare a lavorare nell'applicazione corrente.

vbSystemModal 4096 Finestra modale di sistema; tutte le applicazioni vengono sospese finché l'utente non risponde alla finestra di messaggio.

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 delle icone; il terzo gruppo (0, 256, 512, 768) determina quale pulsante è quello predefinito; e il quarto gruppo (0, 4096) determina la modalità della finestra di messaggio. Quando si sommano i numeri per ottenere il valore finale dei pulsanti degli argomenti, utilizzare un solo numero per ciascun gruppo.

Valore restituito

La funzione MsgBox restituisce i seguenti valori:

Pulsante "Valore costante"

, vbOK 1 OK

vbCancel 2 Annulla

vbAbort 3 Annulla

vbRetry 4 Riprova

vbIgnora 5 Ignora

vbSì 6 Sì

vbNo 7 No

Descrizione

Quando sono specificati sia il file della guida che il contesto, l'utente può premere F1 per visualizzare l'argomento della guida corrispondente al contesto.

Se nella finestra di dialogo è presente un pulsante Annulla, premere il tasto ESC ha lo stesso effetto che cliccare su Annulla. Se la finestra di dialogo contiene un pulsante "Aiuto", viene fornita una guida contestuale relativa alla finestra stessa. Tuttavia, non viene restituito alcun valore finché non si fa clic su uno degli altri pulsanti.

Quando si utilizza la funzione MsgBox con Microsoft Internet Explorer, il titolo di qualsiasi finestra di dialogo visualizzata contiene sempre "VBScript:" per distinguerla dalle finestre di dialogo standard del sistema.

Esempio

L'esempio seguente utilizza la funzione MsgBox per visualizzare una finestra di messaggio e restituire un valore che indica quale pulsante è stato cliccato:

Dim MyVar

; MyVar = MsgBox("Hello World!", 65, "Esempio di MsgBox"); ' MyVar contiene 1 o 2, a seconda del pulsante su cui si fa clic. |