Access-työpöytätietokannassa funktio näyttää viestin valintaikkunassa, odottaa, MsgBox että käyttäjä valitsee painikkeen, ja palauttaa käyttäjän Integer valitseman painikkeen.
Syntaksi
MsgBox(prompt[, buttons][, title][, helpfile][, context])
MsgBox Funktion syntaksilla on seuraavat argumentit:
| Argumentti | Kuvaus |
|---|---|
prompt |
Pakollinen. Valintaikkunan viestinä näytetty merkkijonolauseke. Enimmäispituus prompt on noin 1 024 merkkiä käytettyjen merkkien leveyden mukaan. Jos prompt siinä on useampi kuin yksi rivi, voit erottaa rivit rivinvaihtomerkillä (Chr(13)), rivinsiirtomerkillä (Chr(10)) tai rivinvaihdon ja rivinsiirron yhdistelmällä (Chr(13) & Chr(10)) rivien välissä. |
buttons |
Valinnainen. Numeerinen lauseke, joka on niiden arvojen summa, jotka määrittävät näytettävien painikkeiden määrän ja tyypin, käytettävän kuvaketyylin, oletuspainikkeen identiteetin ja sanomaruudun modaliteetin. Jos se jätetään pois, oletusarvo buttons on 0. |
title |
Valinnainen. Valintaikkunan otsikkorivillä näytetty merkkijonolauseke. Jos jätät tämän titlepois, sovelluksen nimi näkyy otsikkorivillä. |
helpfile |
Valinnainen. Ohjetiedoston määrittävä merkkijonolauseke, joka antaa kontekstisidonnaisia ohjeita valintaikkunalle. Jos helpfile se on annettu, myös context on annettava. |
context |
Valinnainen. Numeerinen lauseke on ohjeen tekijän asianmukaiselle ohjeaiheelle määrittämä kontekstiluku. Jos context se on annettu, myös helpfile on annettava. |
Asetukset
Argumentin buttons asetukset ovat seuraavat:
| Vakio | Arvo | Kuvaus |
|---|---|---|
vbOKOnly |
0 |
Näytä vain OK . |
vbOKCancel |
1 |
Näytä OK ja Peruuta. |
vbAbortRetryIgnore |
2 |
Näytä keskeytys, yritä uudelleen ja ohita. |
vbYesNoCancel |
3 |
Näyttää Kyllä-, Ei- ja Peruuta-painikkeet. |
vbYesNo |
4 |
Näytä Kyllä- ja Ei. |
vbRetryCancel |
5 |
Näytä Yritä uudelleen - ja Peruuta-toiminnot. |
vbCritical |
16 |
Näytä kriittisen viestin kuvake. |
vbQuestion |
32 |
Näytä varoituskyselyn kuvake. |
vbExclamation |
48 |
Näytä varoitussanomakuvake . |
vbInformation |
64 |
Näyttää tietosanoman kuvakkeen. |
vbDefaultButton1 |
0 |
Tee ensimmäisestä painikkeesta oletus. |
vbDefaultButton2 |
256 |
Tee toisesta painikkeesta oletuspainike. |
vbDefaultButton3 |
512 |
Tee kolmannesta painikkeesta oletuspainike. |
vbDefaultButton4 |
768 |
Tee neljännestä painikkeesta oletuspainike. |
vbApplicationModal |
0 |
Sovellusmodaali. Käyttäjän on vastattava viestiruutuun ennen työskentelyn jatkamista nykyisessä sovelluksessa. |
vbSystemModal |
4096 |
Järjestelmän modaali. Kaikkien sovellusten käyttö keskeytyy, kunnes käyttäjä vastaa viestiruutuun. |
vbMsgBoxHelpButton |
16384 |
Lisää Ohje-painike viestiruutuun. |
VbMsgBoxSetForeground |
65536 |
Määrittää viestiruutuikkunan taustaikkunaksi. |
vbMsgBoxRight |
524288 |
Tasaa teksti oikealle. |
vbMsgBoxRtlReading |
1048576 |
Voit määrittää, että teksti luetaan oikealta vasemmalle heprean- ja arabiankielisissä järjestelmissä. |
Ensimmäinen arvojoukko (0 through 5) kuvaa valintaikkunassa näkyvien painikkeiden määrää ja tyyppiä. Toinen ryhmä (16, 32, 48) 64kuvaa kuvaketyyliä. Kolmas ryhmä (0, 256, 512) määrittää, mikä painike on oletus. Neljäs ryhmä (0, 4096) määrittää sanomaruudun modaliteetin. Kun lisäät lukuja argumentin lopullisen arvon buttons luomiseksi, käytä vain yhtä lukua kustakin ryhmästä.
Huomautus
Nämä vakiot on määrittänyt Visual Basic for Applications. Tämän ansiosta voit käyttää nimiä koodissa missä tahansa todellisten arvojen sijasta.
Palautusarvot
| Vakio | Arvo | Kuvaus |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Peruuta |
vbAbort |
3 |
Keskeytä |
vbRetry |
4 |
Yritä uudelleen |
vbIgnore |
5 |
Ohita |
vbYes |
6 |
Kyllä |
vbNo |
7 |
Ei |
Huomautuksia
Kun molemmat helpfile ovat context annettuja, käyttäjä voi tarkastella vastaavaa contextohjeaihetta painamalla Windowsissa F1-näppäintä tai macOS:n ohjetta. Jotkin isäntäsovellukset, kuten Microsoft Excel, lisäävät myös automaattisesti Ohje-painikkeen valintaikkunaan.
Jos valintaikkunassa näkyy Peruuta-painike , Esc-näppäimen painalluksella on sama vaikutus kuin Peruuta-painikkeen valitsemisella. Jos valintaikkunassa on Ohje-painike, kontekstikohtainen Ohje annetaan valintaikkunassa. Mitään arvoa ei kuitenkaan palauteta, ennen kuin käyttäjä valitsee toisen painikkeen.
Huomautus
Jos haluat määrittää enemmän kuin ensimmäisen nimetyn argumentin, lausekkeessa on käytettävä MsgBox argumenttia. Jos haluat jättää pois joitakin paikka-argumentteja, sinun on sisällytettävä vastaava pilkkuerotin.
Esimerkki
Huomautus
Seuraavassa esimerkissä havainnollistetaan, miten tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa.
Tässä esimerkissä funktiota MsgBox käytetään näyttämään kriittinen virheviesti valintaikkunassa, jossa on Kyllä - ja Ei-painikkeet .
Ei-painike on määritetty oletusvastaukseksi. Funktion palauttama MsgBox arvo riippuu käyttäjän valitsemasta painikkeesta. Tässä esimerkissä oletetaan, että DEMO.HLP se on ohjetiedosto, joka sisältää aiheen, jonka ohjekontekstin luku on yhtä suuri kuin 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