I en Access-skrivbordsdatabas visar funktionen ett meddelande i en dialogruta, MsgBox väntar på att användaren ska välja en knapp och returnerar en Integer som anger vilken knapp användaren har valt.
Syntax
MsgBox(prompt[, buttons][, title][, helpfile][, context])
Funktionens MsgBox syntax har följande argument:
| argument | Beskrivning |
|---|---|
prompt |
Obligatoriskt. Ett stränguttryck som visas som meddelande i dialogrutan. Den maximala längden prompt är cirka 1 024 tecken, beroende på vilken teckenbredd som används. Om prompt raderna består av fler än en rad kan du avgränsa raderna med hjälp av ett vagnreturtecken (Chr(13)), ett radmatningstecken (Chr(10)) eller en kombination av vagnretur och radmatning (Chr(13) & Chr(10)) mellan varje rad. |
buttons |
Valfritt. Numeriskt uttryck som är summan av de värden som anger hur många och vilken typ av knappar som ska visas, vilken ikonstil som ska användas, vilken knapp som är standardknappen och meddelanderutans modalitet. Om det utelämnas är standardvärdet för buttons .0 |
title |
Valfritt. Stränguttryck som visas i dialogrutans namnlista. Om du utelämnar titlevisas programnamnet i namnlisten. |
helpfile |
Valfritt. Ett stränguttryck som identifierar den hjälpfil som används för att erbjuda sammanhangsberoende hjälp för dialogrutan. Om helpfile det tillhandahålls, context måste det också tillhandahållas. |
context |
Valfritt. Ett numeriskt uttryck för det hjälpsammanhangsnummer som tilldelats hjälpavsnittet av hjälpavsnittets författare. Om context det tillhandahålls, helpfile måste det också tillhandahållas. |
Inställningar
Argumentinställningarna buttons är:
| Konstant | Värde | Beskrivning |
|---|---|---|
vbOKOnly |
0 |
Visa endast OK . |
vbOKCancel |
1 |
Visa OK och Avbryt. |
vbAbortRetryIgnore |
2 |
Visa Avbryt, Försök igen och Ignorera. |
vbYesNoCancel |
3 |
Visa Ja, Nej och Avbryt. |
vbYesNo |
4 |
Visa Ja och Nej. |
vbRetryCancel |
5 |
Visa Försök igen och Avbryt. |
vbCritical |
16 |
Visa ikonen Kritiskt meddelande . |
vbQuestion |
32 |
Visa ikonen Varningsfråga . |
vbExclamation |
48 |
Visa ikonen Varningsmeddelande . |
vbInformation |
64 |
Visa ikonen Informationsmeddelande . |
vbDefaultButton1 |
0 |
Gör den första knappen till standardinställning. |
vbDefaultButton2 |
256 |
Gör den andra knappen till standardknapp. |
vbDefaultButton3 |
512 |
Gör den tredje knappen till standard. |
vbDefaultButton4 |
768 |
Gör den fjärde knappen till standard. |
vbApplicationModal |
0 |
Ansökan modal. Användaren måste svara på meddelanderutan innan arbetet i det aktuella programmet kan fortsätta. |
vbSystemModal |
4096 |
Systemet modalt. Alla program pausas tills användaren svarar på meddelanderutan. |
vbMsgBoxHelpButton |
16384 |
Lägg till en hjälpknapp i meddelanderutan. |
VbMsgBoxSetForeground |
65536 |
Ange meddelandefönstret som förgrundsfönster. |
vbMsgBoxRight |
524288 |
Högerjustera texten. |
vbMsgBoxRtlReading |
1048576 |
Gör texten synlig med höger-till-vänster-läsning på hebreiska och arabiska system. |
Den första gruppen av värden (05till ) beskriver hur många och vilken typ av knappar som visas i dialogrutan. Den andra gruppen (16, 32, 48, 64) beskriver ikonformatet. Den tredje gruppen (0, 256, 512) bestämmer vilken knapp som är standard. Den fjärde gruppen (0,) 4096bestämmer meddelanderutans modalitet. När du adderar tal för att skapa ett slutvärde för buttons argumentet använder du bara ett tal från varje grupp.
Obs
Konstanterna definieras av Visual Basic for Applications. Därför kan du använda namnen var som helst i koden i stället för de faktiska värdena.
Returvärden
| Konstant | Värde | Beskrivning |
|---|---|---|
vbOK |
1 |
OK |
vbCancel |
2 |
Avbryt |
vbAbort |
3 |
Avbryta |
vbRetry |
4 |
Försök igen |
vbIgnore |
5 |
Ignorera |
vbYes |
6 |
Ja |
vbNo |
7 |
Nej |
Kommentarer
Om båda helpfile och context anges kan användaren trycka på F1 i Windows eller Hjälp i macOS för att visa det hjälpavsnitt som matchar context. Vissa värdprogram, till exempel Microsoft Excel, lägger också automatiskt till en hjälpknapp i dialogrutan.
Om dialogrutan visar en Avbryt-knapp har ett tryck på Esc samma effekt som att välja Avbryt. Om dialogrutan innehåller en Hjälp-knapp finns sammanhangsberoende hjälp för dialogrutan. Inget värde returneras dock förrän användaren väljer någon av de andra knapparna.
Obs
Om du vill ange fler än det första namngivna argumentet måste du använda MsgBox i ett uttryck. Om du vill utelämna vissa positionsargument måste du ta med motsvarande kommaavgränsade värden.
Exempel
Obs
I följande exempel visas hur du använder funktionen i en VBA-modul (Visual Basic for Applications).
I det MsgBox här exemplet används funktionen för att visa ett meddelande om ett kritiskt fel i en dialogruta med knapparna Ja och Nej . Knappen Nej anges som standardsvar. Vilket värde som returneras av funktionen MsgBox beror på vilken knapp användaren väljer. Det här exemplet förutsätter att det DEMO.HLP är en hjälpfil som innehåller ett avsnitt med ett hjälpsammanhangsnummer som är lika med 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