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 restituisce un Integer pulsante che indica il pulsante 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 è di circa 1024 caratteri, a seconda della larghezza dei caratteri usati. Se sono presenti più righe, è possibile separare le righe usando un carattere di ritorno a capo (), un carattere di ritorno a capo () o una combinazione di ritorno a capo-linea () tra ogni riga.If prompt has more than one line, you can separate the lines by using a carriage return character (Chr(13)), a linefeed character ()Chr(10) or a carriage return-linefeed combination (Chr(13) & Chr(10)) between each line. |
buttons |
Facoltativo. Espressione numerica che rappresenta la 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 omesso, il valore predefinito per buttons è 0. |
title |
Facoltativo. Espressione stringa visualizzata sulla barra del titolo della finestra di dialogo. Se si omette title, il nome dell'applicazione viene visualizzato 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 fornito, context deve essere fornito anche. |
context |
Facoltativo. Espressione numerica che rappresenta il numero di contesto della Guida assegnato all'argomento della Guida appropriato dall'autore della Guida. Se context fornito, helpfile deve essere fornito anche. |
Impostazioni
Le impostazioni degli buttons argomenti sono:
| Costante | Valore | Descrizione |
|---|---|---|
vbOKOnly |
0 |
Visualizza solo OK . |
vbOKCancel |
1 |
Visualizzare OK e Annulla. |
vbAbortRetryIgnore |
2 |
Visualizzare Interrompi, Riprova e Ignora. |
vbYesNoCancel |
3 |
Visualizzare Sì, No e Annulla. |
vbYesNo |
4 |
Visualizzare Sì e No. |
vbRetryCancel |
5 |
Visualizzare Riprova e Annulla. |
vbCritical |
16 |
Visualizzare l'icona Messaggio critico . |
vbQuestion |
32 |
Visualizzare l'icona Query di avviso . |
vbExclamation |
48 |
Visualizzare l'icona Messaggio di avviso . |
vbInformation |
64 |
Visualizzare l'icona Messaggio informazioni . |
vbDefaultButton1 |
0 |
Imposta il primo pulsante come predefinito. |
vbDefaultButton2 |
256 |
Imposta il secondo pulsante come predefinito. |
vbDefaultButton3 |
512 |
Imposta il terzo pulsante come predefinito. |
vbDefaultButton4 |
768 |
Imposta il quarto pulsante come predefinito. |
vbApplicationModal |
0 |
Modale applicazione. L'utente deve rispondere alla finestra di messaggio prima di continuare a lavorare nell'applicazione corrente. |
vbSystemModal |
4096 |
Modale di sistema. Tutte le applicazioni vengono sospese finché l'utente non risponde alla finestra di messaggio. |
vbMsgBoxHelpButton |
16384 |
Aggiungere un pulsante ? alla finestra di messaggio. |
VbMsgBoxSetForeground |
65536 |
Specificare la finestra del messaggio come finestra in primo piano. |
vbMsgBoxRight |
524288 |
Allineare a destra il testo. |
vbMsgBoxRtlReading |
1048576 |
Fare in modo che il testo venga visualizzato con la lettura da destra a sinistra nei sistemi ebraico e arabo. |
Il primo gruppo di valori (0 fino 5a ) 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. Quando si aggiungono numeri per creare un valore finale per l'argomento buttons , usare un solo numero per ogni gruppo.
Nota
Queste costanti vengono specificate da Visual Basic, Applications Edition. Di conseguenza, è possibile usare i nomi in un punto qualsiasi 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 |
Ignorare |
vbYes |
6 |
Sì |
vbNo |
7 |
No |
Osservazioni
Quando vengono forniti entrambi helpfile e context , l'utente può premere F1 in Windows o la Guida in macOS per visualizzare l'argomento della Guida corrispondente context. Alcune applicazioni host, ad esempio Microsoft Excel, aggiungono automaticamente un pulsante ? alla finestra di dialogo.
Se nella finestra di dialogo viene visualizzato un pulsante Annulla , premere ESC equivale a selezionare 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ù argomenti denominati oltre al primo, è 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 di Visual Basic, Applications Edition (VBA).
Questo esempio usa la MsgBox funzione per visualizzare un messaggio di errore critico in una finestra di dialogo con i pulsanti Sì e No . Il pulsante No viene specificato come risposta predefinita. Il valore restituito dalla funzione dipende dal pulsante selezionato dall'utente MsgBox . Questo esempio 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