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

Wymagane. 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 przesuwu wiersza (Chr(10)) lub kombinacjąChr( znaków powrotu karetki/linii (13) & Chr(10)) między każdym wierszem.

Buttons

MsgBoxStyle

Opcjonalny. 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ść okna komunikatu. W przypadku pominięcia Buttonswartością domyślną jest zero.

Title

Object

Opcjonalny. 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 uruchamiany w trybie interaktywnym użytkownika.

InvalidEnumArgumentException

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

Przykłady

W tym przykładzie użyto MsgBox funkcji , aby wyświetlić komunikat o błędzie krytycznym w oknie dialogowym z przyciskami Tak i Nie. Przycisk Nie jest określony jako domyślna odpowiedź. Odbywa się to przez połączenie MsgBox wartości stałych w jedno wyrażenie liczbowe. W tym 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 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 okna dialogowego zostanie udostępniona pomoc kontekstowa. Jednak żadna wartość nie jest zwracana do momentu wybrania jednego z innych przycisków. W aplikacjach Formularz systemu Windows wybranie przycisku Pomoc umożliwia wykonanie HelpRequested zdarzenia dla formularza.

Uwaga

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ę Ostrzeżenie kwerendy.
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 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ść okna komunikatu, a piąta grupa określa, czy okno okna komunikatu jest oknem pierwszego planu, wraz z wyrównaniem i kierunkiem tekstu. Podczas dodawania liczb w celu utworzenia ostatecznej wartości argumentu Buttons należy użyć tylko jednej liczby z każdej grupy.

Zobacz też

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