Accessi töölauaandmebaasis kuvab funktsioon MsgBox dialoogiboksis teate, ootab, kuni kasutaja nuppu klõpsab, ja tagastab täisarvu , mis näitab, millist nuppu kasutaja klõpsas.
Süntaks
MsgBox(viip [, nupud ] [, pealkiri ] [, spikrifail ] [, kontekst ] )
Funktsiooni MsgBox süntaksil on järgmised argumendid.
| Argument | Kirjeldus |
|---|---|
| viip | Nõutav. Dialoogiboksis teatena kuvatav stringavaldis. Viiba maksimumpikkus on ligikaudu 1024 märki, olenevalt kasutatavate märkide laiusest. Kui viip koosneb rohkem kui ühest reast, saate jooned eraldada, kasutades iga rea vahel tagasijooksu märki (Chr(13)), reakandmismärki (Chr(10)) või tagasijooksu – reakanali märgikombinatsiooni (Chr(13) & Chr(10)). |
| nupud | 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 nuppude vaikeväärtus 0. |
| tiitel | Valikuline. Dialoogiboksi tiitliribal kuvatav stringavaldis. Kui tiitel puudub, paigutatakse tiitliribale rakenduse nimi. |
| spikrifail | Valikuline. Stringavaldis, mis määrab dialoogiboksile kontekstitundlikku teavet pakkuva spikrifaili. Kui spikrifail on sisestatud, peab olema esitatud 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
Argumentide nupudsä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 | Kuva hoiatuspäringu ikoon. |
| vbExclamation | 48 | Ikoon Kuva 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 |
Esimene väärtusterühm (0–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; ja neljas rühm (0, 4096) määratleb sõnumiboksi modaalsuse. Nuppude argumendi lõppväärtuse loomiseks arvude liitmisel kasutage igast rühmast ainult ühte arvu.
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 saadaval on nii spikrifail kui ka kontekst , saab kasutaja kontekstile vastava spikriteema kuvamiseks vajutada klahvi F1 (Windows) või HELP (macOS). Mõned hostrakendused (nt Microsoft Excel) lisavad dialoogiboksi automaatselt 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. Enne muude nuppude klõpsamist aga väärtusi ei tagastata.
Märkus.
Kui soovite määrata rohkem kui esimese nimega argumendi, peate avaldises kasutama funktsiooni MsgBox . Positsiooniargumentide väljajätmiseks peate kaasama neile vastava komaeraldaja.
Näide
Märkus.
Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis.
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 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