Access-työpöytätietokannassa MsgBox-funktio näyttää sanoman valintaikkunassa, odottaa, että käyttäjä napsauttaa painiketta, ja palauttaa kokonaisluvun , joka ilmaisee, mitä painiketta käyttäjä napsautti.
Syntaksi
MsgBox(kehote [, painikkeet ] [, otsikko ] [, ohjetiedosto ] [, konteksti ] )
MsgBox-funktion syntaksin argumentit ovat seuraavat:
| Argumentti | Kuvaus |
|---|---|
| kehote | Pakollinen. Valintaikkunan viestinä näytetty merkkijonolauseke. Kehotteen enimmäispituus on noin 1 024 merkkiä käytettyjen merkkien leveyden mukaan. Jos kehote koostuu useammasta kuin yhdestä rivistä, voit erottaa rivit rivinvaihdon merkillä (Chr(13)), rivinsyötteen merkillä (Chr(10)) tai rivinvaihdolla – rivinvaihtomerkkiyhdistelmällä (Chr(13) & Chr(10)) kunkin rivin välissä. |
| painikkeet | Valinnainen. numeerinen lauseke, joka on näytettävien painikkeiden lukumäärän ja tyypin määrittävien arvojen summa, käytettävä kuvaketyyli, oletuspainikkeen käyttäjätiedot ja viestiruudun modaalisuus. Jos se jätetään pois, painikkeiden oletusarvo on 0. |
| otsikko | Valinnainen. Valintaikkunan otsikkorivillä näytetty merkkijonolauseke. Jos jätät otsikon pois, sovelluksen nimi sijoitetaan otsikkoriville. |
| ohjetiedosto | Valinnainen. Ohjetiedoston määrittävä merkkijonolauseke, joka antaa kontekstisidonnaisia ohjeita valintaikkunalle. Jos ohjetiedostoa tarjotaan, myös konteksti on annettava. |
| konteksti | Valinnainen. Numeerinen lauseke on ohjeen tekijän asianmukaiselle ohjeaiheelle määrittämä kontekstiluku. Jos kontekstia annetaan, on myös annettava ohjetiedosto . |
Asetukset
Painikkeiden argumenttiasetuksetovat seuraavat:
| Vakio | Arvo | Kuvaus |
|---|---|---|
| vbOKOnly | 0 | Näytä vain OK-painike. |
| vbOKCancel | 1 | Näytä OK- ja Peruuta-painikkeet. |
| vbAbortRetryIgnore | 2 | Näytä Keskeytä-, Yritä uudelleen- ja Ohita-painikkeet. |
| vbYesNoCancel | 3 | Näytä Kyllä-, Ei- ja Peruuta-painikkeet. |
| vbYesNo | 4 | Näytä Kyllä- ja Ei-painikkeet. |
| vbRetryCancel | 5 | Näytä Yritä uudelleen- ja Peruuta-painikkeet. |
| vbCritical | 16 | Näytä Kriittinen viesti -kuvake. |
| vbQuestion | 32 | Näytä Varoituskysely-kuvake . |
| vbExclamation | 48 | Näytä Varoitusviesti-kuvake . |
| vbInformation | 64 | Näytä Tietoviesti-kuvake. |
| vbDefaultButton1 | 0 | Ensimmäinen painike on oletusarvo. |
| vbDefaultButton2 | 256 | Toinen painike on oletusarvo. |
| vbDefaultButton3 | 512 | Kolmas painike on oletusarvo. |
| vbDefaultButton4 | 768 | Neljäs painike on oletusarvo. |
| vbApplicationModal | 0 | Sovellusmodaali; käyttäjän on vastattava viestiruutuun, ennen työskentelyn jatkamista nykyisessä sovelluksessa. |
| vbSystemModal | 4096 | Järjestelmämodaali; kaikki sovellukset keskeytetään, kunnes käyttäjä vastaa viestiruutuun. |
| vbMsgBoxHelpButton | 16384 | Lisää Ohje-painikkeen viestiruutuun |
| VbMsgBoxSetForeground | 65536 | Määrittää viestiruutuikkunan taustaikkunaksi |
| vbMsgBoxRight | 524288 | Teksti tasattu oikealle |
| vbMsgBoxRtlReading | 1048576 | Määrittää, että tekstin pitäisi näkyä oikealta vasemmalle -lukuna heprean- ja arabiankielisissä järjestelmissä |
Ensimmäisessä arvoryhmässä (0–5) kuvataan valintaikkunassa näytettävien painikkeiden määrä ja tyyppi. toinen ryhmä (16, 32, 48, 64) kuvaa kuvaketyyliä; kolmas ryhmä (0, 256, 512) määrittää, mikä painike on oletuspainike. ja neljäs ryhmä (0, 4096) määrittää viestiruudun modaalisuuden. Kun lisäät numeroita ja luot lopullisen arvon painikeargumentille , käytä vain yhtä lukua kustakin ryhmästä.
Huomautus
Nämä vakiot on määrittänyt Visual Basic for Applications. Sen tuloksena nimiä voidaan käyttää 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 ohjetiedostoa ja kontekstia annetaan, käyttäjä voi tarkastella kontekstia vastaavaa ohjeaihetta painamalla F1-näppäintä (Windows) tai HELP (macOS). Jotkin isäntäsovellukset, kuten Microsoft Excel, lisäävät myös automaattisesti Ohje-painikkeen valintaikkunaan.
Jos valintaikkunassa näytetään Peruuta-painike, ESC-näppäimen painalluksella on sama vaikutus kuin Peruuta-painikkeen napsautuksella. Jos valintaikkunassa on Ohje-painike, kontekstikohtainen Ohje annetaan valintaikkunassa. Mitään arvoa ei kuitenkaan palauteta, kunnes napsautat yhtä toisista painikkeista.
Huomautus
Jos haluat määrittää enemmän kuin ensimmäisen nimetyn argumentin, sinun on käytettävä MsgBoxia lausekkeessa. Jos haluat jättää pois joitakin paikka-argumentteja, sinun on sisällytettävä vastaava pilkkuerotin.
Esimerkki
Huomautus
Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa.
Tässä esimerkissä MsgBox-funktiota käytetään näyttämään kriittinen virheviesti valintaikkunassa Kyllä- ja Ei-painikkeilla. Ei-painike on määritetty oletusvastaukseksi.
MsgBox-funktion palauttama arvo riippuu käyttäjän valitsemasta painikkeesta. Tässä esimerkissä oletetaan, että ohjetiedosto DEMO.HLP sisältää ohjetiedoston, jonka ohjekontekstin numero 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