MsgBox, functie

In een Access-bureaubladdatabase geeft de MsgBox functie een bericht weer in een dialoogvenster, wacht tot de gebruiker een knop heeft geselecteerd en retourneert een Integer die aangeeft welke knop de gebruiker heeft geselecteerd.

Syntaxis

MsgBox(prompt[, buttons][, title][, helpfile][, context])

De MsgBox syntaxis van de functie heeft deze argumenten:

Argument	Beschrijving
prompt	Vereist. Een tekenreeksexpressie die als het bericht wordt weergegeven in het dialoogvenster. De maximale lengte van prompt is ongeveer 1024 tekens, afhankelijk van de breedte van de gebruikte tekens. Als prompt u meer dan één regel heeft, kunt u de regels scheiden met behulp van een teken voor het terugsturen van de regel (Chr(13)), een regelinvoerteken (Chr(10)) of een combinatie van retour-regelinvoer (Chr(13) & Chr(10)) tussen elke regel.
buttons	Optioneel. 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 dit weglaat, is 0de standaardwaarde voor buttons .
title	Optioneel. Een tekenreeksexpressie die wordt weergegeven op de titelbalk van het dialoogvenster. Als u weglaat title, wordt de naam van de toepassing weergegeven in de titelbalk.
helpfile	Optioneel. Een tekenreeksexpressie die verwijst naar het Help-bestand met contextafhankelijke Help-informatie voor het dialoogvenster. Indien helpfile opgegeven, context moet ook worden opgegeven.
context	Optioneel. Een numerieke expressie die verwijst naar het nummer voor Help-context dat door de schrijver van de Help-informatie is toegewezen aan het betreffende Help-onderwerp. Indien context opgegeven, helpfile moet ook worden opgegeven.

Instellingen

De buttons argumentinstellingen zijn:

Constante	Waarde	Beschrijving
vbOKOnly	0	Alleen OK weergeven.
vbOKCancel	1	Ok weergeven en annuleren.
vbAbortRetryIgnore	2	Afgebroken, Opnieuw proberen en Negeren weergeven.
vbYesNoCancel	3	Geef Ja, Nee en Annuleren weer.
vbYesNo	4	Ja en Nee weergeven.
vbRetryCancel	5	Opnieuw proberen en Annuleren weergeven.
vbCritical	16	Het pictogram Kritiek bericht weergeven.
vbQuestion	32	Het pictogram Waarschuwingsquery weergeven.
vbExclamation	48	Het pictogram Waarschuwingsbericht weergeven.
vbInformation	64	Het pictogram Informatiebericht weergeven.
vbDefaultButton1	0	De eerste knop als standaard instellen.
vbDefaultButton2	256	Maak van de tweede knop de standaardknop.
vbDefaultButton3	512	Maak van de derde knop de standaardknop.
vbDefaultButton4	768	Maak van de vierde knop de standaardknop.
vbApplicationModal	0	Modale toepassing. De gebruiker moet reageren op het berichtvak voordat hij verder kan werken in de huidige toepassing.
vbSystemModal	4096	Systeemmodaal. Alle toepassingen worden onderbroken totdat de gebruiker op het berichtvak reageert.
vbMsgBoxHelpButton	16384	Voeg een Help-knop toe aan het berichtvak.
VbMsgBoxSetForeground	65536	Geef het berichtvenster op als het voorgrondvenster.
vbMsgBoxRight	524288	De tekst rechts uitlijnen.
vbMsgBoxRtlReading	1048576	Zorg ervoor dat de tekst van rechts naar links wordt weergegeven in Hebreeuwse en Arabische systemen.

De eerste groep waarden (0 tot en met 5) beschrijft het aantal en het type knoppen dat in het dialoogvenster wordt weergegeven. De tweede groep (16, 32, 48, 64) beschrijft de pictogramstijl. De derde groep (0, 256, 512) bepaalt welke knop de standaardknop is. De vierde groep (0, 4096) bepaalt de modaliteit van het berichtvak. Wanneer u getallen optellen om een uiteindelijke waarde voor het buttons argument te maken, gebruikt u slechts één getal uit elke groep.

Waarden retourneren

Constante	Waarde	Beschrijving
vbOK	1	OK
vbCancel	2	Annuleren
vbAbort	3	Afbreken
vbRetry	4	Opnieuw
vbIgnore	5	Negeren
vbYes	6	Ja
vbNo	7	Nee

Opmerkingen

Wanneer zowel als helpfilecontext zijn opgegeven, kan de gebruiker op F1 in Windows of op Help in macOS drukken om het Help-onderwerp te bekijken dat overeenkomt met context. Sommige hosttoepassingen, zoals Microsoft Excel, voegen ook automatisch een Help-knop toe aan het dialoogvenster.

Als in het dialoogvenster een knop Annuleren wordt weergegeven, heeft het drukken op Esc hetzelfde effect als het selecteren van Annuleren. Als het dialoogvenster een Help-knop bevat, is er contextafhankelijke Help-informatie beschikbaar voor het dialoogvenster. Er wordt echter geen waarde geretourneerd totdat de gebruiker een van de andere knoppen selecteert.

Voorbeeld

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 is opgegeven als het standaardantwoord. De waarde die door de MsgBox functie wordt geretourneerd, is afhankelijk van de knop die de gebruiker selecteert. In dit voorbeeld wordt ervan uitgegaan dat DEMO.HLP het een Help-bestand is dat een onderwerp bevat met een Help-contextnummer dat gelijk is aan 1000.

Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then    ' User chose Yes.
    MyString = "Yes"    ' Perform some action.
Else    ' User chose No.
    MyString = "No"    ' Perform some action.
End If