Interaction.MsgBox(Object, MsgBoxStyle, Object) Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Zdroj:

Interaction.vb

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);

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

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

MsgBoxResult

Jedna z následujících hodnot:

Konstanta	Hodnota
OK	1
Cancel	2
Abort	3
Retry	4
Ignore	5
Yes	6
No	7

Výjimky

ArgumentException

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

InvalidOperationException

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

InvalidEnumArgumentException

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.

Viz také

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