Udostępnij za pośrednictwem


Interaction.MsgBox(Object, MsgBoxStyle, Object) Metoda

Definicja

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);
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.OkOnly, Optional Title As Object = Nothing) As MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, 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

Jedna z następujących wartości:

StałaWartość
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Wyjątki

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

Proces nie jest uruchamiany w trybie interaktywnym użytkownika.

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.

Dotyczy

Zobacz też