Interaction.MsgBox(Object, MsgBoxStyle, Object) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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:
| Constante | Value |
|---|---|
OK | 1 |
Cancel | 2 |
Abort | 3 |
Retry | 4 |
Ignore | 5 |
Yes | 6 |
No | 7 |
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.