In un database desktop di Access la MsgBox funzione visualizza un messaggio in una finestra di dialogo, attende che l'utente selezioni un pulsante e ne restituisce Integer un che indica quale pulsante è stato selezionato dall'utente.
Sintassi
MsgBox(prompt[, buttons][, title][, helpfile][, context])
Gli MsgBox argomenti della sintassi della funzione sono i seguenti:
| Argomento | Descrizione |
|---|---|
prompt |
Obbligatorio. Espressione stringa visualizzata come messaggio nella finestra di dialogo. La lunghezza massima è di prompt circa 1024 caratteri, a seconda della larghezza dei caratteri utilizzati. Se prompt contiene più righe, è possibile separarle utilizzando un carattere di ritorno a capo (Chr(13)), un carattere di avanzamento riga (Chr(10)) o una combinazione di ritorno a capo-avanzamento riga (Chr(13) & Chr(10)) tra ogni riga. |
buttons |
Facoltativo. Espressione numerica, ossia la somma di 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 omesso, il valore predefinito è buttons0. |
title |
Facoltativo. Espressione stringa visualizzata sulla barra del titolo della finestra di dialogo. Se si omette title, il nome dell'applicazione appare nella barra del titolo. |
helpfile |
Facoltativo. Espressione stringa che identifica il file della Guida da usare per fornire la Guida sensibile al contesto per la finestra di dialogo. Se helpfile specificato, context deve essere fornito. |
context |
Facoltativo. Espressione numerica che rappresenta il numero di contesto della Guida assegnato all'argomento della Guida appropriato dall'autore della Guida. Se context specificato, helpfile deve essere fornito. |
Impostazioni
Le buttons impostazioni degli argomenti sono:
| Costante | Valore | Descrizione |
|---|---|---|
vbOKOnly |
0 |
Visualizza solo OK . |
vbOKCancel |
1 |
Visualizzare OK e Annulla. |
vbAbortRetryIgnore |
2 |
Visualizza Interrompi, Riprova e Ignora. |
vbYesNoCancel |
3 |
Visualizzare Sì, No e Annulla. |
vbYesNo |
4 |
Visualizza Sì e No. |
vbRetryCancel |
5 |
Visualizza nuovo tentativo e annulla. |
vbCritical |
16 |
Visualizzare l'icona del messaggio critico . |
vbQuestion |
32 |
Visualizzare l'icona della query di avviso . |
vbExclamation |
48 |
Visualizzare l'icona del messaggio di avviso . |
vbInformation |
64 |
Visualizzare l'icona del messaggio informativo . |
vbDefaultButton1 |
0 |
Impostare il primo pulsante come predefinito. |
vbDefaultButton2 |
256 |
Impostare il secondo pulsante come predefinito. |
vbDefaultButton3 |
512 |
Impostare il terzo pulsante come predefinito. |
vbDefaultButton4 |
768 |
Impostare il quarto pulsante come predefinito. |
vbApplicationModal |
0 |
Modalità di applicazione. L'utente deve rispondere alla finestra di messaggio prima di continuare a lavorare nell'applicazione corrente. |
vbSystemModal |
4096 |
Modalità di sistema. Tutte le applicazioni vengono sospese finché l'utente non risponde alla finestra di messaggio. |
vbMsgBoxHelpButton |
16384 |
Aggiungere un pulsante Guida alla finestra di messaggio. |
VbMsgBoxSetForeground |
65536 |
Specificare la finestra di messaggio come finestra in primo piano. |
vbMsgBoxRight |
524288 |
Allineare il testo a destra. |
vbMsgBoxRtlReading |
1048576 |
Far apparire il testo con la lettura da destra a sinistra nei sistemi ebraico e arabo. |
Il primo gruppo di valori (0 da a 5) descrive il numero e il tipo di pulsanti visualizzati nella finestra di dialogo. Il secondo gruppo (16, 32, , 6448) 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. Quando si sommano numeri per creare un valore finale per l'argomento buttons , usare un solo numero di ogni gruppo.
Nota
Queste costanti vengono specificate da Visual Basic, Applications Edition. Di conseguenza, è possibile usare i nomi in qualsiasi punto del codice invece dei valori effettivi.
Valori restituiti
| Costante | Valore | Descrizione |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Annulla |
vbAbort |
3 |
Interrompi |
vbRetry |
4 |
Riprova |
vbIgnore |
5 |
Ignora |
vbYes |
6 |
Sì |
vbNo |
7 |
No |
Osservazioni
Quando vengono fornite entrambe e helpfilecontext , l'utente può premere F1 in Windows o Guida in macOS per visualizzare l'argomento della Guida corrispondente context. Alcune applicazioni host, ad esempio Microsoft Excel, aggiungono automaticamente un pulsante della Guida alla finestra di dialogo.
Se nella finestra di dialogo viene visualizzato un pulsante Annulla , premere ESC ha lo stesso effetto della selezione di 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é l'utente non seleziona uno degli altri pulsanti.
Nota
Per specificare più del primo argomento citato, è necessario usare MsgBox in un'espressione. Per omettere alcuni argomenti posizionali, è necessario includere il delimitatore virgola corrispondente.
Esempio
Nota
Nell'esempio seguente viene illustrato come usare questa funzione in un modulo Visual Basic, Applications Edition (VBA).
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. Il valore restituito dalla funzione dipende dal pulsante selezionato dall'utente MsgBox . In questo esempio si presuppone che DEMO.HLP si tratti di un file della Guida che contiene un argomento con un numero di contesto della Guida uguale a 1000.
Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If