Sdílet prostřednictvím


Interaction.MsgBox(Object, MsgBoxStyle, Object) Metoda

Definice

Zobrazí zprávu v dialogovém okně, počká, až uživatel klikne na tlačítko, a vrátí celé číslo označující, na které tlačítko uživatel klikl.

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

Povinná hodnota. String výraz zobrazený jako zpráva v dialogovém okně. Maximální délka Prompt je přibližně 1024 znaků v závislosti na šířce použitých znaků. Pokud Prompt se skládá z více než jednoho řádku, můžete řádky oddělit pomocí znaku návratu na začátek řádku (Chr(13)), znaku odřádkování (Chr(10)) nebo kombinace znaků návratu na začátek řádku a znaku řádku (Chr(13) & Chr(10)) mezi jednotlivými řádky.

Buttons
MsgBoxStyle

Nepovinný parametr. Číselný výraz, který je součtem hodnot určujících počet a typ zobrazených tlačítek, styl ikony, který se má použít, identitu výchozího tlačítka a způsob zobrazení okna se zprávou. Pokud vynecháte Buttonsparametr , výchozí hodnota je nula.

Title
Object

Nepovinný parametr. String výraz zobrazený v záhlaví dialogového okna. Pokud vynecháte Title, název aplikace se umístí do záhlaví.

Návraty

Jedna z následujících hodnot:

KonstantaHodnota
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Výjimky

Prompt není String výraz nebo Title je neplatný.

Proces není spuštěn v interaktivním režimu uživatele.

Jeden nebo více parametrů, které nejsou členy nebo MsgBoxStyle výčtuMsgBoxResult.

Příklady

Tento příklad používá MsgBox funkci k zobrazení kritické chybové zprávy v dialogovém okně s tlačítky Ano a Ne. Jako výchozí odpověď je zadáno tlačítko Ne. K tomu slouží kombinace konstantních hodnot do jednoho číselného MsgBox výrazu. V tomto případě při přidání 4 (kombinace tlačítek Ano/Ne) a 16 (okno kritické zprávy ) a 256 (druhé tlačítko jako výchozí tlačítko) získáte celkem 276. Hodnota vrácená MsgBox funkcí závisí na tlačítku zvoleném uživatelem: Ano vrátí hodnotu 6; Funkce No vrátí hodnotu 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

Poznámky

Pokud vynecháte všechny poziční argumenty, musíte zachovat odpovídající oddělovač čárky.

Pokud se v dialogovém okně zobrazí tlačítko Zrušit, má stisknutí klávesy ESC stejný účinek jako kliknutí na Zrušit.

Pokud dialogové okno obsahuje tlačítko Nápověda , zobrazí se pro toto dialogové okno kontextová nápověda. Nevrátí se však žádná hodnota, dokud není vybráno jedno z ostatních tlačítek. V aplikacích Windows Form se výběrem tlačítka Nápověda spustí HelpRequested událost formuláře.

Poznámka

Funkce MsgBox vyžaduje UIPermission na SafeTopLevelWindows úrovni , což může mít vliv na její provádění v situacích s částečnou důvěryhodností. Další informace naleznete v tématu UIPermission.

Hodnoty MsgBoxStyle výčtu jsou uvedeny v následující tabulce.

Člen Hodnota Popis
Člen Hodnota Popis
OKOnly 0 Zobrazí pouze tlačítko OK.
OKCancel 1 Zobrazí tlačítka OK a Zrušit.
AbortRetryIgnore 2 Zobrazí tlačítka Přerušit, Opakovat a Ignorovat.
YesNoCancel 3 Zobrazí tlačítka Ano, Ne a Zrušit.
YesNo 4 Zobrazí tlačítka Ano a Ne.
RetryCancel 5 Zobrazí tlačítka Opakovat a Zrušit.
Critical 16 Zobrazí ikonu Kritická zpráva.
Question 32 Zobrazí upozornění Ikona dotazu.
Exclamation 48 Zobrazí ikonu Zpráva s upozorněním.
Information 64 Zobrazí ikonu Informační zpráva.
DefaultButton1 0 První tlačítko je výchozí.
DefaultButton2 256 Druhé tlačítko je výchozí.
DefaultButton3 512 Třetí tlačítko je výchozí.
ApplicationModal 0 Aplikace je modální. Uživatel musí před pokračováním v práci v aktuální aplikaci odpovědět na okno se zprávou.
SystemModal 4 096 Systém je modální. Všechny aplikace jsou pozastaveny, dokud uživatel neodpovědí na okno se zprávou.
MsgBoxSetForeground 65536 Určuje okno se zprávou jako okno na popředí.
MsgBoxRight 524288 Text je zarovnaný doprava.
MsgBoxRtlReading 1048576 Určuje, že text by se měl v hebrejštině a arabštině zobrazovat jako čtení zprava doleva.

První skupina hodnot (0–5) popisuje počet a typ tlačítek zobrazených v dialogovém okně. Druhá skupina (16, 32, 48, 64) popisuje styl ikony. Třetí skupina (0, 256, 512) určuje, které tlačítko je výchozí. Čtvrtá skupina (0, 4096) určuje modus okna se zprávou a pátá skupina určuje, zda je okno se zprávou okno na popředí, spolu s zarovnáním a směrem textu. Při sčítání čísel pro vytvoření konečné hodnoty argumentu Buttons používejte z každé skupiny pouze jedno číslo.

Platí pro

Viz také