Funktsioon MsgBox

NB! :  See artikkel on masintõlgitud, vaadake lahtiütlust. Selle artikli ingliskeelse versiooni leiate aadressilt (viiteks).

Accessi töölauaandmebaasi, funktsioon MsgBox dialoogiboksi kuvab teate, ootab kasutaja klõpsab nuppu ja tagastab täisarvuni , mis näitab, milliseid kasutaja klõpsata nuppu.

Süntaks

MsgBox ( viip [, nupud ] [, tiitel ] [, spikrifail ] [, kontekst ] )

Funktsiooni MsgBox süntaksil on järgmised argumendid.

Argument

Kirjeldus

viip

Nõutav. Dialoogiboksis teatena kuvatav stringavaldis. Argumendi viip suurim lubatud pikkus on umbes 1024 märki, olenevalt kasutatavate märkide laiusest. Kui viip koosneb rohkem kui ühest reast, saate ridu eraldada, kasutades iga rea vahel tagasijooksu märki (Chr(13)), reavahetuse märki (Chr(10)) või nende mõlema märgi kombinatsiooni (Chr(13) & Chr(10)).

nupud

Valikuline. Kuvatavate nuppude tüübi ja arvu, kasutatavate ikoonide, vaikenupu ID ning teateboksi modaalsuse määravate väärtuste summaks olev arvuline avaldis. Kui nupud ära jäetakse, on selle vaikeväärtus 0.

tiitel

Valikuline. Dialoogiboksi tiitliribal kuvatav stringavaldis. Kui jätate tiitel ära, paigutatakse tiitliribale rakenduse nimi.

spikrifail

Valikuline. Stringavaldis, mis määrab dialoogiboksile kontekstitundlikku teavet pakkuva spikrifaili. Kui spikrifail on sisestatud, peab sisestatud olema ka kontekst.

kontekst

Valikuline. Arvavaldis, mis on asjakohasele spikriteemale spikri autori poolt määratud spikri kontekstinumber. Kui kontekst on sisestatud, peab sisestatud olema ka spikrifail.


Sätted

Argumendi nupud sätted on järgmised.

Konstant

Väärtus

Kirjeldus

vbOKOnly

0

Kuvatakse ainult nupp OK.

vbOKCancel

1

Kuvatakse nupud OK ja Loobu.

vbAbortRetryIgnore

2

Kuvatakse nupud Katkesta, Proovi uuesti ja Ignoreeri.

vbYesNoCancel

3

Kuvatakse nupud Jah, Ei ja Loobu.

vbYesNo

4

Kuvatakse nupud Jah ja Ei.

vbRetryCancel

5

Kuvatakse nupud Proovi uuesti ja Loobu.

vbCritical

16

Kuvatakse ikoon Kriitiline teade.

vbQuestion

32

Kuvatakse ikoon Hoiatuspäring   .

vbExclamation

48

Kuvatakse ikoon Hoiatusteade   .

vbInformation

64

Kuvatakse ikoon Teade.

vbDefaultButton1

0

Esimene nupp on vaikenupp.

vbDefaultButton2

256

Teine nupp on vaikenupp.

vbDefaultButton3

512

Kolmas nupp on vaikenupp.

vbDefaultButton4

768

Neljas nupp on vaikenupp.

vbApplicationModal

0

Rakendusepõhine modaalsus: rakenduse edasikasutamiseks peab kasutaja teateboksile reageerima.

vbSystemModal

4096

Süsteemipõhine modaalsus: kõik rakendused on peatatud, kuni kasutaja teateboksile reageerib.

vbMsgBoxHelpButton

16384

Teateboksi lisatakse nupp „Spikker“.

VbMsgBoxSetForeground

65536

Teateboksiaken määratakse esiplaaniaknaks

vbMsgBoxRight

524288

Tekst joondatakse paremale.

vbMsgBoxRtlReading

1048576

Heebrea- ja araabiakeelsetes süsteemides määratakse teksti kuvamise suunaks paremalt vasakule


Näpunäide. :  Rakenduses Access 2010 on avaldisekoosturil IntelliSense, mis näitab, milliseid argumente avaldises kasutada tuleb. 

Esimeses rühmas olevad väärtused (0–5) tähistavad seda, millist tüüpi nuppe dialoogiboksis kuvatakse. Teise rühma väärtused (16; 32; 48; 64) tähistavad ikoonilaadi. Kolmanda rühma väärtused (0; 256; 512) määravad vaikenupu ning neljanda rühma väärtused (0; 4096) teateboksi modaalsuse. Argumendi nupud jaoks lõppväärtuse koostamiseks nuppude lisamisel kasutage igast rühmast ainult ühte numbrit.

Märkus. : Need konstandid määrab Visual Basic for Applications. Seetõttu saab neid nimetusi koodis kasutada tegelike väärtuste asemel.

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 nii spikrifail ja konteksti , kasutaja vajutage klahvi F1 (Windows) või abi (Macintosh) kontekstvastava spikriteema kuvamiseks. Mõned host rakendused, näiteks Microsoft Excel automaatselt lisada Spikker nuppu dialoogiboksi.

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. Enne muude nuppude klõpsamist aga väärtusi ei tagastata.

Märkus. : Kui soovite määrata rohkem kui ainult esimese nimelise argumendi, peate funktsiooni MsgBox kasutama avaldises. Positsiooniargumentide väljajätmiseks peate kaasama neile vastava komaeraldaja.

Näide

Märkus. : Järgige näited demonstreerivad seda seda funktsiooni Visual Basic for Applications (VBA) mooduli kasutamise.

Selles näites kuvatakse funktsiooni MsgBox abil kriitilise tõrke dialoogiboks, mis sisaldab nuppe „Jah“ ja „Ei“. Vaikevastuseks on määratud nupp „Ei“. Funktsiooni MsgBox tagastatav väärtus oleneb kasutaja valitud nupust. Selles näites eeldatakse, et DEMO.HLP on spikrifail, mis sisaldab spikriteemat, mille kontekstinumber on 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

Märkus. : Masintõlke lahtiütlus. Selle artikli tõlkis arvutisüsteem ilma inimese sekkumiseta. Microsoft pakub selliseid masintõlkeid, et inglise keelt mittekõnelevad kasutajad saaksid vaadata sisu Microsofti toodete, teenuste ja tehnoloogiate kohta. Kuna artikkel on masintõlgitud, võib see sisaldada sõnavara-, süntaksi- või grammatikavigu.

Täiendage oma oskusi
Tutvuge koolitusmaterjalidega
Kasutage uusi funktsioone enne teisi
Liituge Office Insideri programmiga

Kas sellest teabest oli abi?

Täname tagasiside eest!

Täname tagasiside eest! Tundub, et võiksime teid kokku viia ühega meie Office'i tugiagentidest, kes aitab teil probleemi lahendada.

×