Interaction.MsgBox(Object, MsgBoxStyle, Object) Metodo

Definizione

Visualizza un messaggio in una finestra di dialogo, attende che l'utente faccia clic su un pulsante, quindi restituisce un intero che indica il pulsante scelto dall'utente.Displays a message in a dialog box, waits for the user to click a button, and then returns an integer indicating which button the user clicked.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = null);
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 = null) As MsgBoxResult

Parametri

Prompt
Object

Obbligatorio.Required. Espressione String visualizzata come messaggio nella finestra di dialogo.String expression displayed as the message in the dialog box. La lunghezza massima di Prompt è di circa 1024 caratteri, a seconda della larghezza dei caratteri utilizzati.The maximum length of Prompt is approximately 1024 characters, depending on the width of the characters used. Se Prompt è costituito da più di una riga, è possibile separare le righe usando un carattere di ritorno a capo (Chr(13)), un carattere di avanzamento riga (Chr(10)) o una combinazione dei caratteri di ritorno a capo e avanzamento riga (Chr(13) & Chr(10)) tra ogni riga.If Prompt consists of more than one line, you can separate the lines using a carriage return character (Chr(13)), a line feed character (Chr(10)), or a carriage return/linefeed character combination (Chr(13) & Chr(10)) between each line.

Buttons
MsgBoxStyle

facoltativo.Optional. Espressione numerica che rappresenta la somma dei valori che specificano il numero e il tipo dei pulsanti da visualizzare, lo stile di icona da utilizzare, l'identità del pulsante predefinito e la modalità della finestra di messaggio.Numeric expression that is the sum of values specifying the number and type of buttons to display, the icon style to use, the identity of the default button, and the modality of the message box. Se si omette Buttons, il valore predefinito è zero.If you omit Buttons, the default value is zero.

Title
Object

Facoltativo.Optional. Espressione String visualizzata nella barra del titolo della finestra di dialogo.String expression displayed in the title bar of the dialog box. Se si omette Title, nella barra del titolo viene visualizzato il nome dell'applicazione.If you omit Title, the application name is placed in the title bar.

Restituisce

CostanteConstant ValueValue
OK 11
Cancel 22
Abort 33
Retry 44
Ignore 55
Yes 66
No 77
..

Eccezioni

Prompt non è un'espressione String oppure Title non è valido.Prompt is not a String expression, or Title is invalid.

Il processo non viene eseguito in modo interattivo con l'utente.Process is not running in User Interactive mode.

Uno o più parametri non sono membri dell'enumerazione MsgBoxResult o MsgBoxStyle.One or more parameters not a member of MsgBoxResult or MsgBoxStyle enumeration.

Esempi

In questo esempio viene utilizzata la funzione MsgBox per visualizzare un messaggio critico-errore in una finestra di dialogo con i pulsanti Sì e no.This example uses the MsgBox function to display a critical-error message in a dialog box with Yes and No buttons. Il pulsante No viene specificato come risposta predefinita.The No button is specified as the default response. Questa operazione viene eseguita combinando i valori costanti MsgBox in un'unica espressione numerica.This is done by combining the MsgBox constant values into one numeric expression. In questo caso, l'aggiunta di 4 (la combinazione di pulsante Sì/No) e 16 (la finestra di messaggio critica ) e 256 (il secondo pulsante come pulsante predefinito) fornisce un totale di 276.In this case, adding 4 (the Yes/No button combination) and 16 (the Critical Message window) and 256 (the second button as default button) gives a total of 276. Il valore restituito dalla funzione MsgBox dipende dal pulsante scelto dall'utente: Sì restituisce un valore pari a 6. No restituisce un valore pari a 7.The value returned by the MsgBox function depends on the button chosen by the user: Yes returns a value of 6; No returns a value of 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 omette qualsiasi argomento posizionale, è necessario mantenere il delimitatore di virgola corrispondente.If you omit any positional arguments, you must retain the corresponding comma delimiter.

Se nella finestra di dialogo viene visualizzato un pulsante Annulla , la pressione del tasto ESC ha lo stesso effetto di quando si fa clic su Annulla .If the dialog box displays a Cancel button, pressing the ESC key has the same effect as clicking Cancel

Se la finestra di dialogo contiene un pulsante ?, viene fornita una guida sensibile al contesto per la finestra di dialogo.If the dialog box contains a Help button, context-sensitive Help is provided for the dialog box. Tuttavia, fino a quando non viene scelto uno degli altri pulsanti, non viene restituito alcun valore.However, no value is returned until one of the other buttons is chosen. Nelle applicazioni Windows Form, se si sceglie il pulsante? viene eseguito l'evento HelpRequested per il modulo.In Windows Form applications, choosing the Help button executes the HelpRequested event for the form.

Nota

La funzione MsgBox richiede UIPermission a livello di SafeTopLevelWindows, che può influire sulla sua esecuzione in situazioni di attendibilità parziale.The MsgBox function requires UIPermission at the SafeTopLevelWindows level, which may affect its execution in partial-trust situations. Per altre informazioni, vedere UIPermission.For more information, see UIPermission.

Nella tabella seguente sono elencati i valori di enumerazione MsgBoxStyle.The MsgBoxStyle enumeration values are listed in the following table.

MemberMember ValueValue DescriptionDescription
MemberMember ValueValue DescriptionDescription
OKOnly 00 Visualizza solo il pulsante OK.Displays OK button only.
OKCancel 11 Visualizza i pulsanti OK e Annulla.Displays OK and Cancel buttons.
AbortRetryIgnore 22 Visualizza i pulsanti Interrompi, Riprova e ignora.Displays Abort, Retry, and Ignore buttons.
YesNoCancel 33 Visualizza i pulsanti Sì, no e Annulla.Displays Yes, No, and Cancel buttons.
YesNo 44 Visualizza i pulsanti Sì e no.Displays Yes and No buttons.
RetryCancel 55 Visualizza i pulsanti Riprova e Annulla.Displays Retry and Cancel buttons.
Critical 1616 Visualizza l'icona del messaggio critico.Displays Critical Message icon.
Question 3232 Visualizza l'icona della query di avviso.Displays Warning Query icon.
Exclamation 4848 Visualizza l'icona del messaggio di avviso.Displays Warning Message icon.
Information 6464 Visualizza l'icona del messaggio informativo.Displays Information Message icon.
DefaultButton1 00 Il primo pulsante è quello predefinito.First button is default.
DefaultButton2 256256 Il secondo pulsante è quello predefinito.Second button is default.
DefaultButton3 512512 Il terzo pulsante è quello predefinito.Third button is default.
ApplicationModal 00 L'applicazione è modale.Application is modal. È necessario che l'utente risponda alla finestra di messaggio prima di continuare a lavorare nell'applicazione corrente.The user must respond to the message box before continuing work in the current application.
SystemModal 40964096 Il sistema è modale.System is modal. Tutte le applicazioni vengono sospese fino a quando l'utente non risponde alla finestra di messaggio.All applications are suspended until the user responds to the message box.
MsgBoxSetForeground 6553665536 Specifica la finestra MessageBox come finestra in primo piano.Specifies the message box window as the foreground window.
MsgBoxRight 524288524288 Il testo è allineato a destra.Text is right-aligned.
MsgBoxRtlReading 10485761048576 Specifica che il testo deve apparire come lettura da destra a sinistra nei sistemi ebraici e arabi.Specifies text should appear as right-to-left reading on Hebrew and Arabic systems.

Il primo gruppo di valori (0-5) descrive il numero e il tipo di pulsanti visualizzati nella finestra di dialogo.The first group of values (0-5) describes the number and type of buttons displayed in the dialog box. Il secondo gruppo (16, 32, 48, 64) descrive lo stile dell'icona.The second group (16, 32, 48, 64) describes the icon style. Il terzo gruppo (0, 256, 512) determina quale pulsante è l'impostazione predefinita.The third group (0, 256, 512) determines which button is the default. Il quarto gruppo (0, 4096) determina la modalità della finestra di messaggio e il quinto gruppo specifica se la finestra di messaggio è la finestra in primo piano, insieme all'allineamento e alla direzione del testo.The fourth group (0, 4096) determines the modality of the message box, and the fifth group specifies whether or not the message box window is the foreground window, along with the alignment and direction of the text. Quando si aggiungono numeri per creare un valore finale per l'argomento Buttons, utilizzare un solo numero di ogni gruppo.When adding numbers to create a final value for the Buttons argument, use only one number from each group.

Si applica a

Vedi anche