Interaction.MsgBox(Object, MsgBoxStyle, Object) Metoda

Definice

Obor názvů:
Microsoft.VisualBasic
Sestavení:
Microsoft.VisualBasic.Core.dll
Sestavení:
Microsoft.VisualBasic.dll
Zdroj:
Interaction.vb
Zdroj:
Interaction.vb
Zdroj:
Interaction.vb
Zdroj:
Interaction.vb
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);
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

Required. 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ávratového řádku nebo řádku (Chr(13) & Chr(10)) mezi jednotlivými řádky.

Buttons
MsgBoxStyle

Optional. Číselný výraz, který představuje součet hodnot určující počet a typ tlačítek, která se mají zobrazit, styl ikony, identitu výchozího tlačítka a způsob zobrazení pole zprávy. Pokud vynecháte Buttons, výchozí hodnota je nula.

Title
Object

Optional. 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:

KonstantaHodnota
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Výjimky

ArgumentException

Prompt String není 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 MsgBoxResult výčtyMsgBoxStyle.

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. To se provádí kombinací konstantních hodnot do jednoho číselného MsgBox výrazu. V tomto případě se při přidání 4 (kombinace tlačítka Ano/Ne) a 16 (okno Kritická zpráva ) a 256 (druhé tlačítko jako výchozí tlačítko) zobrazí celkem 276. Hodnota vrácená MsgBox funkcí závisí na tlačítku zvoleném uživatelem: Ano vrátí hodnotu 6; Nevrá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, je nutné zachovat odpovídající oddělovač čárky.

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

Pokud dialogové okno obsahuje tlačítko Nápověda , je pro toto dialogové okno k dispozici kontextová nápověda. Dokud ale nevybídnete jedno z dalších tlačítek, nebude vrácena žádná hodnota. V Windows formulářových aplikacích se při výběru tlačítka Help spustí událost HelpRequested formuláře.

Note

Funkce MsgBox vyžaduje UIPermission na SafeTopLevelWindows úrovni, která může ovlivnit její spuštění v situacích s částečnou důvěryhodností. Další informace najdete na webu UIPermission.

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

Člen Hodnota Description
Člen Hodnota Description
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ávy.
Question 32 Zobrazí ikonu upozornění dotazu.
Exclamation 48 Zobrazí ikonu Upozornění zprávy.
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 pole se zprávou.
SystemModal 4096 Systém je modální. Všechny aplikace jsou pozastavené, dokud uživatel neodpovědí na okno se zprávou.
MsgBoxSetForeground 65536 Určuje okno okna zprávy jako okno popředí.
MsgBoxRight 524288 Text je zarovnaný doprava.
MsgBoxRtlReading 1048576 Určuje, že text by se měl zobrazovat jako čtení zprava doleva v systémech hebrejštiny a arabštiny.

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 způsob pole zprávy a pátá skupina určuje, zda je okno pole zprávy oknem popředí spolu se zarovnáním a směrem textu. Při přidávání čísel pro vytvoření konečné hodnoty argumentu Buttons použijte pouze jedno číslo z každé skupiny.

Platí pro

Viz také