MsgBox-funksjonen viser en melding i en dialogboks i en Access-skrivebordsdatabase, venter til brukeren klikker en knapp og returnerer et heltall som angir hvilken knapp brukeren klikket på.
Syntaks
MsgBox ( prompt [ ,buttons ] [ ,title ] [, helpfile ] [ ,context ] )
Syntaksen for funksjonen MsgBox har disse argumentene:
|
Argument |
Beskrivelse |
|
spør |
Obligatorisk. Strenguttrykket vises som meldingen i dialogboksen. Maksimumslengden på ledeteksten er omtrent 1024 tegn, avhengig av bredden på tegnene som brukes. Hvis ledetekst består av mer enn én linje, kan du skille linjene ved hjelp av et linjereturtegn (Chr(13),et linjeelementtegn(Chr(10)), eller linje-retur – linjeavstandtegnkombinasjon (Chr(13) & Chr(10)) mellom hver linje. |
|
knapper |
Valgfritt. numerisk uttrykk som er summen av verdier som angir antallet og typen knapper som skal vises, ikonstilen som skal brukes, identiteten til standardknappen og modaliteten til meldingsboksen. Hvis den utelates, er standardverdien for knapper 0. |
|
tittel |
Valgfritt. Strenguttrykket vises på tittellinjen i dialogboksen. Hvis du utelater tittel,plasseres programnavnet på tittellinjen. |
|
helpfile |
Valgfritt. Strenguttrykk som identifiserer hjelpefilen som skal brukes til å gi kontekstsensitiv hjelp for dialogboksen. Hvis hjelpefilen er angitt, må også konteksten angis. |
|
kontekst |
Valgfritt. Numerisk uttrykk som er kontekstnummeret i Hjelp som er tilordnet det aktuelle hjelpeemnet av Hjelp-forfatteren. Hvis det er angitt en kontekst, må hjelpefil også angis. |
Innstillinger
Knappene argument innstillingene er:
|
Konstant |
Verdi |
Beskrivelse |
|
vbOKOnly |
0 |
Vis bare OK-knappen. |
|
vbOKCancel |
1 |
Vis OK- og Avbryt-knappene. |
|
vbAbortRetryIgnore |
2 |
Knappene Vis avbryting, Forsøkpå nytt og Ignorer. |
|
vbYesNoCancel |
3 |
Vis Ja-,Nei-og Avbryt-knappene. |
|
vbYesNo |
4 |
Vis Ja- og Nei-knapper. |
|
vbRetryCancel |
5 |
Vis knappene Nye forsøk og Avbryt. |
|
vbKritisk |
16 |
Vis kritisk melding-ikonet. |
|
vbQuestion |
32 |
Vis advarselsspørring-ikonet. |
|
vbEksklamasjon |
48 |
Vis advarsel-ikonet. |
|
vbInformation |
64 |
Vis informasjonsmelding-ikonet. |
|
vbDefaultButton1 |
0 |
Første knapp er standard. |
|
vbDefaultButton2 |
256 |
Andre knapp er standard. |
|
vbDefaultButton3 |
512 |
Tredje knapp er standard. |
|
vbDefaultButton4 |
768 |
Fjerde knapp er standard. |
|
vbApplicationModal |
0 |
Sperrende program; brukeren må svare på meldingsboksen før han eller hun fortsetter arbeidet i det gjeldende programmet. |
|
vbSystemModal |
4096 |
System med modus; alle programmer suspenderes til brukeren svarer på meldingsboksen. |
|
vbMsgBoxHelpButton |
16384 |
Legger til Hjelp-knappen i meldingsboksen |
|
VbMsgBoxSetForeground |
65536 |
Angir meldingsboksvinduet som forgrunnsvinduet |
|
vbMsgBoxRight |
524288 |
Teksten er høyrejustert |
|
vbMsgBoxRtlReading |
1048576 |
Angir at tekst skal vises som høyre-mot-venstre-lesing på hebraiske og arabiske systemer |
Tips!: I Access 2010 har uttrykksverktøyet IntelliSense, slik at du kan se hvilke argumenter uttrykket krever.
Den første gruppen med verdier (0–5) beskriver antall og type knapper som vises i dialogboksen. Den andre gruppen (16, 32, 48, 64) beskriver ikonstilen; den tredje gruppen (0, 256, 512) bestemmer hvilken knapp som er standard; og den fjerde gruppen (0, 4096) bestemmer modaliteten til meldingsboksen. Når du legger til tall for å opprette en endelig verdi for knapper-argumentet, bruker du bare ett tall fra hver gruppe.
Obs!: Disse konstantene angis av Visual Basic for Applications. Navnene kan derfor brukes hvor som helst i koden i stedet for de faktiske verdiene.
Returverdier
|
Konstant |
Verdi |
Beskrivelse |
|
vbOK |
1 |
OK |
|
vbCancel |
2 |
Avbryte |
|
vbAbort |
3 |
Avbrytes |
|
vbRetry |
4 |
Ta et nytt forsøk |
|
vbIgnore |
5 |
Ignorer |
|
vbYes |
6 |
Ja |
|
vbNo |
7 |
Nei |
Kommentarer
Når både hjelpefilog kontekst er angitt, kan brukeren trykke F1 (Windows) eller HJELP (Macintosh) for å vise Hjelpeemnet som samsvarer med konteksten. Enkelte vertsprogrammer, for eksempel Microsoft Excel, legger også automatisk til en Hjelp-knapp i dialogboksen.
Hvis dialogboksen viser en Avbryt-knapp, har det samme effekt som å klikke Avbrytnår du trykker ESC. Hvis dialogboksen inneholder en Hjelp-knapp, gis kontekstsensitiv hjelp for dialogboksen. Det returneres imidlertid ingen verdi før du klikker på en av de andre knappene.
Obs!: Hvis du vil angi mer enn det første navngitte argumentet, må du bruke MsgBox i en uttrykk. Hvis du vil utelate noen plasseringsargumenter, må du ta med det tilsvarende kommaskilletegnet.
Eksempel
Obs!: I eksemplene nedenfor vises bruken av denne funksjonen i en VBA-modul (Visual Basic for Applications).
Dette eksemplet bruker Meldingsboks-funksjonen til å vise en melding om kritisk feil i en dialogboks med Ja- og Nei-knapper. Nei-knappen er angitt som standardsvar. Verdien som returneres av MsgBox-funksjonen, avhenger av hvilken knapp brukeren har valgt. Dette eksemplet forutsetter at DEMO.HLP en hjelpefil som inneholder et emne med et kontekstnummer i Hjelp som er lik 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
