Funktionen MsgBox

I en Access-skrivebordsdatabase viser funktionen MsgBox en meddelelse i en dialogboks, venter på, at brugeren klikker på en knap og returnerer et Heltal , der angiver, hvilken knap brugeren har klikket på.

Syntaks

MsgBox(prompt [, knapper ] [, titel ] [, helpfile ] [, kontekst ] )

Syntaks for funktionen MsgBox har disse argumenter:

Argument	Beskrivelse
prompt	Obligatorisk. Strengudtryk, der vises som meddelelsen i dialogboksen. Promptens maksimale længde er ca . 1024 tegn, afhængigt af bredden af de tegn, der bruges. Hvis prompt består af mere end én linje, kan du adskille linjerne ved hjælp af et vognreturtegn (Chr(13)), et linjeskifttegn (Chr(10)) eller vognretur – tegnkombination for linjeskift (Chr(13) & Chr(10)) mellem hver linje.
knapper	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 knapper 0.
titel	Valgfrit. Strengudtryk, der vises i dialogboksens titellinje. Hvis du udelader titel, placeres programmets navn i titellinjen.
hjælpfil	Valgfrit. Strengudtryk, der identificerer Hjælp-filen, der bruges til kontekstafhængig hjælp til dialogboksen. Hvis hjælpfil er angivet, skal konteksten også angives.
kontekst	Valgfrit. Numerisk udtryk, som er det Hjælp-kontekstnummer, der tildeles til det relevante emne i Hjælp af forfatteren til Hjælp. Hvis konteksten angives, skal hjælpfil også angives.

Indstillinger

Indstillingerne forknappers argument er:

Konstant	Værdi	Beskrivelse
vbOKOnly	0	Vis kun knappen OK.
vbOKCancel	1	Vis knapperne OK og Annuller.
vbAbortRetryIgnore	2	Vis knapperne Afbryd, Prøv igen og Ignorer.
vbYesNoCancel	3	Vis knapperne Ja, Nej og Annuller.
vbYesNo	4	Vis knapperne Ja og Nej.
vbRetryCancel	5	Vis knapperne Prøv igen og Annuller.
vbCritical	16	Vis ikonet Kritisk meddelelse.
vbQuestion	32	Vis ikonet Advarselsforespørgsel .
vbExclamation	48	Vis ikon for advarselsmeddelelse .
vbInformation	64	Vis ikonet Meddelelse.
vbDefaultButton1	0	Den første knap er standard.
vbDefaultButton2	256	Den anden knap er standard.
vbDefaultButton3	512	Den tredje knap er standard.
vbDefaultButton4	768	Den fjerde knap er standard.
vbApplicationModal	0	Programmodal; brugeren skal reagere på meddelelsesboksen, før arbejdet fortsættes i det aktuelle program.
vbSystemModal	4096	Systemmodal; alle programmer suspenderes, indtil brugeren reagerer på meddelelsesboksen.
vbMsgBoxHelpButton	16384	Tilføjer knappen Hjælp i meddelelsesboksen.
VbMsgBoxSetForeground	65536	Angiver vinduet med meddelelsesboksen som vinduet i forgrunden
vbMsgBoxRight	524288	Teksten højrejusteres
vbMsgBoxRtlReading	1048576	Angiver, at tekst skal vises med læseretning fra højre mod venstre på hebraiske og arabiske systemer

Den første gruppe af værdier (0-5) beskriver antallet og typen af knapper, der vises i dialogboksen. den anden gruppe (16, 32, 48, 64) beskriver ikontypografien den tredje gruppe (0, 256, 512) bestemmer, hvilken knap der er standardknappen. og den fjerde gruppe (0, 4096) bestemmer meddelelsesfeltets modalitet. Når du tilføjer tal for at oprette en endelig værdi for argumentet knapper , 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	Ignorer
vbYes	6	Ja
vbNo	7	Nej

Bemærkninger

Når både hjælpfil og kontekst er angivet, kan brugeren trykke på F1 (Windows) eller HJÆLP (macOS) for at få vist det Hjælp-emne, der svarer til konteksten. Nogle værtsprogrammer, f.eks. Microsoft Excel, føjer også automatisk en Hjælp-knap til dialogboksen.

Hvis dialogboksen viser en Annuller-knap, har et tryk på Esc-knappen samme virkning som et klik på Annuller. Hvis dialogboksen indeholder en Hjælp-knap, findes der kontekstafhængig hjælp til dialogboksen. Der returneres dog ingen værdi, før der klikkes på 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 standardsvaret. 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