Interaction.MsgBox(Object, MsgBoxStyle, Object) Methode

Definitie

Geeft een bericht weer in een dialoogvenster, wacht tot de gebruiker op een knop klikt en retourneert vervolgens een geheel getal dat aangeeft op welke knop de gebruiker heeft geklikt.

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.ApplicationModal, Optional Title As Object = Nothing) As MsgBoxResult

Parameters

Prompt
Object

Required. String expressie weergegeven als het bericht in het dialoogvenster. De maximale lengte is Prompt ongeveer 1024 tekens, afhankelijk van de breedte van de gebruikte tekens. Als Prompt u uit meer dan één regel bestaat, kunt u de lijnen scheiden met behulp van een regelterugloopteken (Chr(13)), een regelinvoerteken (Chr(10)) of een combinatie van regelteruglooptekens (Chr(13) & Chr(10)) tussen elke regel.

Buttons
MsgBoxStyle

Optional. Numerieke expressie die de som is van waarden die het aantal en het type knoppen opgeven dat moet worden weergegeven, de pictogramstijl die moet worden gebruikt, de identiteit van de standaardknop en de modaliteit van het berichtvak. Als u weglaat Buttons, is de standaardwaarde nul.

Title
Object

Optional. String expressie weergegeven in de titelbalk van het dialoogvenster. Als u weglaat Title, wordt de naam van de toepassing in de titelbalk geplaatst.

Retouren

Een van de volgende waarden:

ConstanteValue
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Uitzonderingen

Prompt is geen String expressie of Title is ongeldig.

Het proces wordt niet uitgevoerd in de interactieve modus van de gebruiker.

Een of meer parameters die geen lid zijn van MsgBoxResult of MsgBoxStyle opsomming.

Voorbeelden

In dit voorbeeld wordt de MsgBox functie gebruikt om een kritiek foutbericht weer te geven in een dialoogvenster met de knoppen Ja en Nee. De knop Nee wordt ingesteld als het standaardantwoord. Dit wordt gedaan door de MsgBox constante waarden te combineren in één numerieke expressie. In dit geval is het toevoegen van 4 (de combinatie van de knop Ja/Nee) en 16 (het venster Kritiek bericht ) en 256 (de tweede knop als standaardknop) in totaal 276. De waarde die door de MsgBox functie wordt geretourneerd, is afhankelijk van de knop die door de gebruiker is gekozen: Ja retourneert een waarde van 6; Nee retourneert een waarde van 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

Opmerkingen

Als u positionele argumenten weglaat, moet u het bijbehorende scheidingsteken voor komma's behouden.

Als in het dialoogvenster een knop Annuleren wordt weergegeven, heeft het drukken op esc hetzelfde effect als op Annuleren klikken

Als het dialoogvenster een Help-knop bevat, is er contextafhankelijke Help-informatie beschikbaar voor het dialoogvenster. Er wordt echter geen waarde geretourneerd totdat een van de andere knoppen is gekozen. Als u in Windows Formuliertoepassingen de knop Help kiest, wordt de gebeurtenis HelpRequested voor het formulier uitgevoerd.

Note

De MsgBox functie vereist UIPermission op het SafeTopLevelWindows niveau, wat van invloed kan zijn op de uitvoering ervan in gedeeltelijke vertrouwenssituaties. Zie UIPermission voor meer informatie.

De MsgBoxStyle opsommingswaarden worden vermeld in de volgende tabel.

Lid Value Description
Lid Value Description
OKOnly 0 Hiermee wordt alleen de knop OK weergegeven.
OKCancel 1 Hiermee worden de knoppen OK en Annuleren weergegeven.
AbortRetryIgnore 2 Hiermee worden de knoppen Afbreken, Opnieuw proberen en Negeren weergegeven.
YesNoCancel 3 Hiermee worden de knoppen Ja, Nee en Annuleren weergegeven.
YesNo 4 Hiermee worden de knoppen Ja en Nee weergegeven.
RetryCancel 5 Hiermee worden de knoppen Opnieuw proberen en Annuleren weergegeven.
Critical 16 Hiermee wordt het pictogram Kritiek bericht weergegeven.
Question 32 Hiermee wordt het pictogram Waarschuwingsquery weergegeven.
Exclamation 48 Hiermee wordt het pictogram Waarschuwingsbericht weergegeven.
Information 64 Hiermee wordt het pictogram Informatiebericht weergegeven.
DefaultButton1 0 De eerste knop is de standaardknop.
DefaultButton2 256 De tweede knop is de standaardknop.
DefaultButton3 512 De derde knop is de standaardknop.
ApplicationModal 0 De toepassing is modaal. De gebruiker moet reageren op het berichtvak voordat deze verdergaat in de huidige toepassing.
SystemModal 4096 Het systeem is modaal. Alle toepassingen worden onderbroken totdat de gebruiker reageert op het berichtvak.
MsgBoxSetForeground 65536 Hiermee geeft u het berichtvakvenster op als het voorgrondvenster.
MsgBoxRight 524288 Tekst is rechts uitgelijnd.
MsgBoxRtlReading 1048576 Hiermee geeft u tekst moet worden weergegeven als van rechts naar links lezen op Hebreeuwse en Arabische systemen.

De eerste groep waarden (0-5) beschrijft het aantal en het type knoppen dat in het dialoogvenster wordt weergegeven. In de tweede groep (16, 32, 48, 64) wordt de pictogramstijl beschreven. De derde groep (0, 256, 512) bepaalt welke knop de standaardknop is. De vierde groep (0, 4096) bepaalt de modaliteit van het berichtvak en de vijfde groep geeft aan of het venster van het berichtvak het voorgrondvenster is, samen met de uitlijning en richting van de tekst. Wanneer u getallen optelt om een uiteindelijke waarde voor het Buttons argument te maken, gebruikt u slechts één getal uit elke groep.

Van toepassing op

Zie ook