In een Access-bureaubladdatabase geeft de MsgBox functie een bericht weer in een dialoogvenster, wacht totdat de gebruiker een knop selecteert en retourneert Integer een bericht dat aangeeft welke knop de gebruiker heeft geselecteerd.
Syntaxis
MsgBox(prompt[, buttons][, title][, helpfile][, context])
De syntaxis van de MsgBox functie heeft deze argumenten:
| Argument | Beschrijving |
|---|---|
prompt |
Vereist. Een tekenreeksexpressie die als het bericht wordt weergegeven in het dialoogvenster. De maximumlengte van prompt is ongeveer 1024 tekens, afhankelijk van de breedte van de tekens die worden gebruikt. Bij prompt een regel met meer dan één regel kunt u de regels scheiden met een regelterugloopteken (Chr(13)), een teken voor een nieuwe regel (Chr(10)), of een combinatieChr(13) & Chr(10) van deze regel en een nieuwe regel (). |
buttons |
Optioneel. Een numerieke expressie die de som is van de waarden die het aantal en het type knoppen aangeeft dat moet worden weergegeven, de te gebruiken pictogramstijl, de identiteit van de standaardknop en de modaliteit van het berichtvak. Als u dit argument weglaat, is 0de standaardwaarde voor buttons . |
title |
Optioneel. Een tekenreeksexpressie die wordt weergegeven op de titelbalk van het dialoogvenster. Als u dit weglaat title, wordt de naam van de toepassing op de titelbalk weergegeven. |
helpfile |
Optioneel. Een tekenreeksexpressie die verwijst naar het Help-bestand met contextafhankelijke Help-informatie voor het dialoogvenster. Indien helpfile verstrekt, context moet ook worden verstrekt. |
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 verstrekt, helpfile moet ook worden verstrekt. |
Instellingen
De buttons argumentinstellingen zijn:
| Constante | Waarde | Beschrijving |
|---|---|---|
vbOKOnly |
0 |
Alleen OK weergeven. |
vbOKCancel |
1 |
Weergeven OK en annuleren. |
vbAbortRetryIgnore |
2 |
Afbreken, opnieuw proberen en negeren weergeven. |
vbYesNoCancel |
3 |
Ja,Nee en Annuleren weergeven. |
vbYesNo |
4 |
Ja ennee weergeven. |
vbRetryCancel |
5 |
Opnieuw proberen en annuleren weergeven. |
vbCritical |
16 |
Het pictogram Kritiek bericht weergeven. |
vbQuestion |
32 |
Het waarschuwingsquerypictogram weergeven. |
vbExclamation |
48 |
Het waarschuwingspictogram weergeven. |
vbInformation |
64 |
Het pictogram Informatiebericht weergeven. |
vbDefaultButton1 |
0 |
De eerste knop instellen als standaardknop. |
vbDefaultButton2 |
256 |
De tweede knop instellen als standaardknop. |
vbDefaultButton3 |
512 |
Maak van de derde knop de standaardknop. |
vbDefaultButton4 |
768 |
Maak de vierde knop als standaardknop. |
vbApplicationModal |
0 |
Applicatie modaal. De gebruiker moet reageren op het bericht voordat hij of zij verder kan werken in de huidige toepassing. |
vbSystemModal |
4096 |
Systeem modaal. Alle toepassingen worden onderbroken totdat de gebruiker op het bericht reageert. |
vbMsgBoxHelpButton |
16384 |
Voeg een Help-knop toe aan het bericht. |
VbMsgBoxSetForeground |
65536 |
Het berichtvenster opgeven als het voorgrondvenster. |
vbMsgBoxRight |
524288 |
Lijn de tekst rechts uit. |
vbMsgBoxRtlReading |
1048576 |
Tekst weergeven met tekst van rechts naar links op Hebreeuwse en Arabische systemen. |
De eerste groep waarden (0 tot en met 5) beschrijft het aantal en het type van de knoppen die in het dialoogvenster worden 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 gaat optellen om de definitieve waarde voor het buttons argument te bepalen, gebruikt u slechts één getal uit elke groep.
Opmerking
Deze constanten worden opgegeven door Visual Basic for Applications. Hierdoor kunt u de namen overal in de code gebruiken in plaats van de werkelijke waarden.
Retourwaarden
| 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
Als beide helpfilecontext zijn opgegeven, kan de gebruiker op F1 in Windows of Help in macOS drukken om het bijbehorende Help-onderwerp contextweer te geven. 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 pas een waarde geretourneerd als de gebruiker een van de andere knoppen selecteert.
Opmerking
Als u meer argumenten dan het eerste benoemde argument wilt opgeven, moet u dit in een expressie gebruiken MsgBox . Als u op bepaalde plekken argumenten wilt weglaten, moet u daar wel een komma als scheidingsteken typen.
Voorbeeld
Opmerking
In het volgende voorbeeld ziet u hoe u deze functie kunt gebruiken in een VBA-module (Visual Basic for Applications).
In dit voorbeeld wordt de MsgBox functie gebruikt om een bericht over een kritieke fout weer te geven in een dialoogvenster met de knoppen Ja en Nee . De knop Nee wordt ingesteld 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 om een Help-bestand gaat met daarin een onderwerp met een waarde voor Help-context die 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