Funktionen MsgBox

I en Access-skrivebordsdatabase MsgBox viser funktionen en meddelelse i en dialogboks, venter på, at brugeren vælger en knap og returnerer en Integer , der angiver, hvilken knap brugeren har valgt.

Syntaks

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

MsgBox Syntaksen for funktionen har disse argumenter:

Argument	Beskrivelse
prompt	Obligatorisk. Strengudtryk, der vises som meddelelsen i dialogboksen. Den maksimale længde på prompt er ca. 1024 tegn, afhængigt af bredden af de anvendte tegn. Hvis prompt der er mere end én linje, kan du adskille linjerne ved hjælp af et vognreturtegn (Chr(13)), et linjeskifttegn (Chr(10)) eller en kombination af vognretur og linjeskift (Chr(13) & Chr(10)) mellem hver linje.
buttons	Valgfrit. Numerisk udtryk, der er summen af værdier, der angiver antallet og typen af knapper, der skal vises, den ikontypografi, der skal bruges, standardknappens identitet og meddelelsesfeltets modalitet. Hvis det udelades, er standardværdien for buttons .0
title	Valgfrit. Strengudtryk, der vises i dialogboksens titellinje. Hvis du udelader title, vises programmets navn på titellinjen.
helpfile	Valgfrit. Strengudtryk, der identificerer Hjælp-filen, der bruges til kontekstafhængig hjælp til dialogboksen. Hvis helpfile det er angivet, context skal også angives.
context	Valgfrit. Numerisk udtryk, som er det Hjælp-kontekstnummer, der tildeles til det relevante emne i Hjælp af forfatteren til Hjælp. Hvis context det er angivet, helpfile skal også angives.

Indstillinger

Argumentindstillingerne buttons er:

Konstant	Værdi	Beskrivelse
vbOKOnly	0	Vis kun OK .
vbOKCancel	1	Vis OK og Annuller.
vbAbortRetryIgnore	2	Vis Afbryd, Prøv igen og Ignorer.
vbYesNoCancel	3	Vis Ja, Nej og Annuller.
vbYesNo	4	Vis Ja og Nej.
vbRetryCancel	5	Vis Prøv igen og Annuller.
vbCritical	16	Vis ikonet Kritisk meddelelse .
vbQuestion	32	Vis ikonet Advarselsforespørgsel .
vbExclamation	48	Vis ikonet Advarselsmeddelelse .
vbInformation	64	Vis ikonet Meddelelse om oplysninger .
vbDefaultButton1	0	Gør den første knap til standardknappen.
vbDefaultButton2	256	Gør den anden knap til standardknappen.
vbDefaultButton3	512	Gør den tredje knap til standardknappen.
vbDefaultButton4	768	Gør den fjerde knap til standardknappen.
vbApplicationModal	0	Ansøgning modal. Brugeren skal svare på meddelelsesfeltet, før arbejdet i det aktuelle program fortsættes.
vbSystemModal	4096	Systemmodal. Alle programmer suspenderes, indtil brugeren svarer på meddelelsesfeltet.
vbMsgBoxHelpButton	16384	Føj en Hjælp-knap til meddelelsesfeltet.
VbMsgBoxSetForeground	65536	Angiv meddelelsesboksvinduet som forgrundsvinduet.
vbMsgBoxRight	524288	Højrejustere teksten.
vbMsgBoxRtlReading	1048576	Få teksten vist med læsning fra højre mod venstre på hebraiske og arabiske systemer.

Den første gruppe af værdier (0 til 5) beskriver antallet og typen af knapper, der vises i dialogboksen. Den anden gruppe (16, 32, 48) 64beskriver ikontypografien. Den tredje gruppe (0, 256, 512) bestemmer, hvilken knap der er standardknappen. Den fjerde gruppe (0, 4096) bestemmer meddelelsesfeltets modalitet. Når du tilføjer tal for at oprette en endelig værdi for buttons argumentet, skal du kun bruge ét tal fra hver gruppe.

Returværdier

Konstant	Værdi	Beskrivelse
vbOK	1	OK
vbCancel	2	Annuller
vbAbort	3	Afbryd
vbRetry	4	Prøv igen
vbIgnore	5	Ignorere
vbYes	6	Ja
vbNo	7	Nej

Bemærkninger

Når både helpfile og context er angivet, kan brugeren trykke på F1 i Windows eller Hjælp i macOS for at få vist det Hjælp-emne, der svarer contexttil . Nogle værtsprogrammer, f.eks. Microsoft Excel, føjer også automatisk en Hjælp-knap til dialogboksen.

Hvis der vises en Annuller-knap i dialogboksen, har et tryk på Esc samme effekt som at vælge Annuller. Hvis dialogboksen indeholder en Hjælp-knap, findes der kontekstafhængig hjælp til dialogboksen. Der returneres dog ingen værdi, før brugeren vælger en af de andre knapper.

Eksempel

I dette eksempel bruges funktionen MsgBox til at vise en kritisk fejlmeddelelse i en dialogboks med knapperne Ja og Nej . Knappen Nej er angivet som standardsvar. Den værdi, der returneres af funktionen MsgBox , afhænger af den knap, brugeren vælger. I dette eksempel antages det, at er DEMO.HLP en Hjælp-fil, der indeholder et emne med et Hjælp-kontekstnummer lig med 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