Interaction.MsgBox(Object, MsgBoxStyle, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

Interaction.vb

Wyświetla komunikat w oknie dialogowym, czeka, aż użytkownik kliknie przycisk, a następnie zwróci liczbę całkowitą wskazującą, który przycisk kliknął użytkownik.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox(object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, 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.OkOnly, Optional Title As Object = Nothing) As MsgBoxResult

Parametry

Prompt

Object

Required. String wyrażenie wyświetlane jako komunikat w oknie dialogowym. Maksymalna długość Prompt to około 1024 znaków, w zależności od szerokości używanych znaków. Jeśli Prompt składa się z więcej niż jednego wiersza, można oddzielić wiersze znakiem powrotu karetki (Chr(13)), znakiem kanału informacyjnego (Chr(10)) lub kombinacją znaków powrotu karetki/linii (Chr(13) i Chr(10)) między poszczególnymi wierszami.

Buttons

MsgBoxStyle

Optional. Wyrażenie liczbowe, które jest sumą wartości określających liczbę i typ przycisków do wyświetlenia, styl ikony do użycia, tożsamość przycisku domyślnego i modalność pola komunikatu. W przypadku pominięcia Buttonswartością domyślną jest zero.

Title

Object

Optional. String wyrażenie wyświetlane na pasku tytułu okna dialogowego. Jeśli pominięto Title, nazwa aplikacji zostanie umieszczona na pasku tytułu.

Zwraca

MsgBoxResult

Jedna z następujących wartości:

Stała	Wartość
OK	1
Cancel	2
Abort	3
Retry	4
Ignore	5
Yes	6
No	7

Wyjątki

ArgumentException

Prompt nie jest wyrażeniem String lub Title jest nieprawidłowe.

InvalidOperationException

Proces nie jest uruchomiony w trybie interaktywnym użytkownika.

InvalidEnumArgumentException

Co najmniej jeden parametr nie jest elementem członkowskim MsgBoxResult lub MsgBoxStyle wyliczeniem.

Przykłady

W tym przykładzie użyto MsgBox funkcji do wyświetlania komunikatu o błędzie krytycznym w oknie dialogowym z przyciskami Tak i Nie. Domyślną odpowiedzią jest przycisk Nie. Odbywa się to przez połączenie MsgBox wartości stałych w jedno wyrażenie liczbowe. W takim przypadku dodanie 4 (kombinacji przycisku Tak/Nie) i 16 (okno Komunikat krytyczny ) i 256 (drugi przycisk jako przycisk domyślny) daje łącznie 276. Wartość zwracana przez MsgBox funkcję zależy od przycisku wybranego przez użytkownika: Wartość Tak zwraca wartość 6; Nie zwraca wartości 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

Uwagi

Jeśli pominięto jakiekolwiek argumenty pozycyjne, należy zachować odpowiedni ogranicznik przecinka.

Jeśli w oknie dialogowym zostanie wyświetlony przycisk Anuluj , naciśnięcie klawisza ESC ma taki sam efekt, jak kliknięcie przycisku Anuluj

Jeśli okno dialogowe zawiera przycisk Pomoc , dla tego okna dialogowego jest dostępna pomoc kontekstowa. Jednak żadna wartość nie jest zwracana do momentu wybrania jednego z pozostałych przycisków. W aplikacjach Windows Formularz wybierz Help przycisk wykonuje zdarzenie HelpRequested formularza.

Note

Funkcja MsgBox wymaga UIPermission na SafeTopLevelWindows poziomie, co może mieć wpływ na jego wykonywanie w sytuacjach częściowego zaufania. Aby uzyskać więcej informacji, zobacz UIPermission.

Wartości MsgBoxStyle wyliczenia są wymienione w poniższej tabeli.

Członek	Wartość	Opis
Członek	Wartość	Opis
OKOnly	0	Wyświetla tylko przycisk OK.
OKCancel	1	Wyświetla przyciski OK i Anuluj.
AbortRetryIgnore	2	Wyświetla przyciski Przerwij, Ponów próbę i Ignoruj.
YesNoCancel	3	Wyświetla przyciski Tak, Nie i Anuluj.
YesNo	4	Wyświetla przyciski Tak i Nie.
RetryCancel	5	Wyświetla przyciski Ponów próbę i Anuluj.
Critical	16	Wyświetla ikonę Komunikat krytyczny.
Question	32	Wyświetla ikonę Zapytanie ostrzegawcze.
Exclamation	48	Wyświetla ikonę Komunikat ostrzegawczy.
Information	64	Wyświetla ikonę Komunikat informacyjny.
DefaultButton1	0	Pierwszy przycisk jest domyślny.
DefaultButton2	256	Drugi przycisk jest domyślny.
DefaultButton3	512	Trzeci przycisk jest domyślny.
ApplicationModal	0	Aplikacja jest modalna. Użytkownik musi odpowiedzieć na okno komunikatu przed kontynuowaniem pracy w bieżącej aplikacji.
SystemModal	4096	System jest modalny. Wszystkie aplikacje są zawieszone, dopóki użytkownik nie odpowie na okno komunikatu.
MsgBoxSetForeground	65536	Określa okno okna komunikatu jako okno pierwszego planu.
MsgBoxRight	524288	Tekst jest wyrównany do prawej.
MsgBoxRtlReading	1048576	Określa tekst powinien być wyświetlany jako odczyt od prawej do lewej w systemach hebrajskich i arabskich.

Pierwsza grupa wartości (0–5) opisuje liczbę i typ przycisków wyświetlanych w oknie dialogowym. Druga grupa (16, 32, 48, 64) opisuje styl ikony. Trzecia grupa (0, 256, 512) określa, który przycisk jest domyślny. Czwarta grupa (0, 4096) określa modalność pola komunikatu, a piąta grupa określa, czy okno pola komunikatu jest oknem pierwszego planu, wraz z wyrównaniem i kierunkiem tekstu. Podczas dodawania liczb w celu utworzenia ostatecznej wartości argumentu Buttons użyj tylko jednej liczby z każdej grupy.

Zobacz też

• InputBox(String, String, String, Int32, Int32)
• Show(String)