Funktsioon MsgBox

Rakenduskoht
Microsoft 365 rakendus Access Access 2024 Access 2021 Access 2019 Access 2016

Accessi töölauaandmebaasis MsgBox kuvab funktsioon dialoogiboksis teate, ootab, kuni kasutaja valib nupu, ja tagastab selle Integer , mis näitab, millise nupu kasutaja valis.

Süntaks

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

Funktsiooni MsgBox süntaksil on järgmised argumendid.

Argument Kirjeldus
prompt Nõutav. Dialoogiboksis teatena kuvatav stringavaldis. Olenevalt kasutatavate märkide laiusest on maksimaalne pikkus prompt umbes 1024 märki. Kui prompt teil on mitu rida, saate jooned eraldada, kasutades iga rea vahel tagasijooksu märki (Chr(13)), reakanali märki (Chr(10)) või tagasijooksurea kombinatsiooni (Chr(13) & Chr(10)).
buttons Valikuline. Arvuline avaldis, mis tähistab kuvatavate nuppude arvu ja tüüpi määravate väärtuste summat, kasutatavat ikoonilaadi, vaikenupu identiteeti ja teateboksi modaalsust. Kui see puudub, on 0vaikeväärtus buttons .
title Valikuline. Dialoogiboksi tiitliribal kuvatav stringavaldis. Kui see puudub title, kuvatakse tiitliribal rakenduse nimi.
helpfile Valikuline. Stringavaldis, mis määrab dialoogiboksile kontekstitundlikku teavet pakkuva spikrifaili. Kui helpfile see on olemas, context tuleb esitada ka.
context Valikuline. Arvavaldis, mis on asjakohasele spikriteemale spikri autori poolt määratud spikri kontekstinumber. Kui context see on olemas, helpfile tuleb esitada ka.

Sätted

Argumendi buttons sätted on järgmised.

Konstant Väärtus Kirjeldus
vbOKOnly 0 Kuva ainult OK .
vbOKCancel 1 Kuva OK ja Loobu.
vbAbortRetryIgnore 2 Kuvatakse katkestamine, uuesti proovimine ja ignoreerimine.
vbYesNoCancel 3 Kuvatakse Jah, Ei ja Loobu.
vbYesNo 4 Kuva jah ja ei.
vbRetryCancel 5 Kuva uuesti proovimine ja loobumine.
vbCritical 16 Saate kuvada kriitilise teate ikooni.
vbQuestion 32 Saate kuvada hoiatuspäringu ikooni.
vbExclamation 48 Kuvatakse ikoon Hoiatusteade .
vbInformation 64 Ikooni Teabeteade kuvamine.
vbDefaultButton1 0 Muutke esimene nupp vaikenupuks.
vbDefaultButton2 256 Määrake teine nupp vaikenupuks.
vbDefaultButton3 512 Muutke kolmas nupp vaikenupuks.
vbDefaultButton4 768 Muutke neljas nupp vaikenupuks.
vbApplicationModal 0 Rakenduse modaal. Enne praeguses rakenduses töötamise jätkamist peab kasutaja teateboksile vastama.
vbSystemModal 4096 Süsteemi modaal. Kõik rakendused peatatakse, kuni kasutaja vastab teateboksile.
vbMsgBoxHelpButton 16384 Teateboksile nupu Spikker lisamine.
VbMsgBoxSetForeground 65536 Määrake teateboksi aken esiplaaniaknaks.
vbMsgBoxRight 524288 Teksti paremjoondamine.
vbMsgBoxRtlReading 1048576 Teksti kuvamine paremalt vasakule lugemise abil heebrea ja araabia süsteemides.

Esimene väärtusterühm (0 kuni 5) kirjeldab dialoogiboksis kuvatavate nuppude arvu ja tüüpi. Teine rühm (16, 32, 48, 64) kirjeldab ikoonilaadi. Kolmas rühm (0, 256, 512) määratleb, milline nupp on vaikenupp. Neljas rühm (0, 4096) määratleb sõnumiboksi modaalsuse. Kui lisate argumendi lõppväärtuse buttons loomiseks arve, kasutage igast rühmast ainult ühte arvu.

Märkus.

Need konstandid määrab Visual Basic for Applications. Seetõttu saate tegelike väärtuste asemel kasutada koodis suvalisi nimesid.

Tagastusväärtused

Konstant Väärtus Kirjeldus
vbOK 1 OK
vbCancel 2 Loobu
vbAbort 3 Katkesta
vbRetry 4 Proovi uuesti
vbIgnore 5 Ignoreeri
vbYes 6 Jah
vbNo 7 Ei

Kommentaarid

Kui mõlemad helpfile on saadaval, context saab kasutaja Windowsis vajutada klahvi F1 või macOS-i spikrit , et vaadata vastavat spikriteemat context. Mõni hostrakendus (nt Microsoft Excel) lisab dialoogiboksi automaatselt ka nupu Spikker .

Kui dialoogiboksis kuvatakse nupp Loobu , on paoklahvi (Esc ) vajutamisel sama tulemus, mis nupu Loobu klõpsamisel. Kui dialoogiboks sisaldab nuppu Spikker, on dialoogiboksi jaoks saadaval ka kontekstitundlik spikker. Väärtust ei tagastata enne, kui kasutaja valib mõne muu nupu.

Märkus.

Kui soovite määrata rohkem kui esimese nimega argumendi, peate seda avaldises kasutama MsgBox . Positsiooniargumentide väljajätmiseks peate kaasama neile vastava komaeraldaja.

Näide

Märkus.

Järgmises näites kirjeldatakse, kuidas kasutada seda funktsiooni moodulis Visual Basic for Applications (VBA).

Selles näites MsgBox kasutatakse funktsiooni kriitilise tõrke teate kuvamiseks dialoogiboksis nuppudega Jah ja Ei . Vaikevastusena on määratud nupp Ei . Funktsiooni tagastatav MsgBox väärtus sõltub nupust, mille kasutaja valib. Selles näites eeldatakse, et see DEMO.HLP on spikrifail, mis sisaldab spikriteemat, mille kontekstinumber 1000on .

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