Interaction.MsgBox(Object, MsgBoxStyle, Object) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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:
| Costante | Valore |
|---|---|
OK | 1 |
Cancel | 2 |
Abort | 3 |
Retry | 4 |
Ignore | 5 |
Yes | 6 |
No | 7 |
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.