Interaction.MsgBox(Object, MsgBoxStyle, Object) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Visar ett meddelande i en dialogruta, väntar tills användaren klickar på en knapp och returnerar sedan ett heltal som anger vilken knapp användaren klickade på.
public static Microsoft.VisualBasic.MsgBoxResult MsgBox(object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, object? Title = default);
public static Microsoft.VisualBasic.MsgBoxResult MsgBox(object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = default);
static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.OkOnly, Optional Title As Object = Nothing) As MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, Optional Title As Object = Nothing) As MsgBoxResult
Parametrar
- Prompt
- Object
Required.
String uttryck som visas som meddelandet i dialogrutan. Den maximala längden Prompt på är cirka 1 024 tecken, beroende på bredden på de tecken som används. Om Prompt består av mer än en rad kan du avgränsa raderna med ett vagnreturtecken (Chr(13)), ett radmatningstecken (Chr(10)) eller en kombination av vagnretur/linjematningstecken (Chr(13) & Chr(10)) mellan varje rad.
- Buttons
- MsgBoxStyle
Optional. Numeriskt uttryck som är summan av värden som anger antalet och typen av knappar som ska visas, ikonformatet som ska användas, standardknappens identitet och meddelanderutans modalitet. Om du utelämnar Buttonsär standardvärdet noll.
- Title
- Object
Optional.
String uttryck som visas i namnlisten i dialogrutan. Om du utelämnar Titleplaceras programnamnet i namnlisten.
Returer
Något av följande värden:
| Konstant | Value |
|---|---|
OK | 1 |
Cancel | 2 |
Abort | 3 |
Retry | 4 |
Ignore | 5 |
Yes | 6 |
No | 7 |
Undantag
Prompt är inte ett String uttryck eller Title är ogiltigt.
Processen körs inte i interaktivt användarläge.
En eller flera parametrar är inte medlemmar i MsgBoxResult eller MsgBoxStyle uppräkning.
Exempel
I det MsgBox här exemplet används funktionen för att visa ett kritiskt felmeddelande i en dialogruta med knapparna Ja och Nej. Knappen Nej anges som standardsvar. Detta görs genom att kombinera konstantvärdena MsgBox till ett numeriskt uttryck. I det här fallet ger tillägg av 4 (ja/nej-knappkombinationen) och 16 (fönstret Kritiskt meddelande ) och 256 (den andra knappen som standardknapp) totalt 276. Värdet som returneras av MsgBox funktionen beror på den knapp som användaren har valt: Ja returnerar värdet 6; Nej returnerar värdet 7.
' The following example requires that Option Infer be set to On.
' Define the message you want to see inside the message box.
Dim msg = "Do you want to continue?"
' Display a simple message box.
MsgBox(msg)
' Define a title for the message box.
Dim title = "MsgBox Demonstration"
' Add the title to the display.
MsgBox(msg, , title)
' Now define a style for the message box. In this example, the
' message box will have Yes and No buttons, the default will be
' the No button, and a Critical Message icon will be present.
Dim style = MsgBoxStyle.YesNo Or MsgBoxStyle.DefaultButton2 Or
MsgBoxStyle.Critical
' Display the message box and save the response, Yes or No.
Dim response = MsgBox(msg, style, title)
' Take some action based on the response.
If response = MsgBoxResult.Yes Then
MsgBox("YES, continue!!", , title)
Else
MsgBox("NO, stop!!", , title)
End If
Kommentarer
Om du utelämnar några positionsargument måste du behålla motsvarande kommaavgränsare.
Om dialogrutan visar knappen Avbryt har det samma effekt att trycka på ESC-tangenten som att klicka på Avbryt
Om dialogrutan innehåller en Hjälp-knapp finns sammanhangsberoende hjälp för dialogrutan. Inget värde returneras dock förrän någon av de andra knapparna har valts. Om du väljer knappen Help i Windows formulärprogram körs händelsen HelpRequested för formuläret.
Note
Funktionen MsgBox kräver UIPermission på nivån SafeTopLevelWindows , vilket kan påverka dess körning i situationer med partiellt förtroende. Mer information finns i UIPermission.
Uppräkningsvärdena MsgBoxStyle visas i följande tabell.
| Medlem | Value | Description |
|---|---|---|
| Medlem | Value | Description |
OKOnly |
0 | Visar endast OK-knappen. |
OKCancel |
1 | Visar knapparna OK och Avbryt. |
AbortRetryIgnore |
2 | Visar knapparna Avbryt, Försök igen och Ignorera. |
YesNoCancel |
3 | Visar knapparna Ja, Nej och Avbryt. |
YesNo |
4 | Visar knapparna Ja och Nej. |
RetryCancel |
5 | Visar knapparna Försök igen och Avbryt. |
Critical |
16 | Visar ikonen Kritiskt meddelande. |
Question |
32 | Visar ikonen Varningsfråga. |
Exclamation |
48 | Visar ikonen Varningsmeddelande. |
Information |
64 | Visar ikonen Informationsmeddelande. |
DefaultButton1 |
0 | Den första knappen är standard. |
DefaultButton2 |
256 | Den andra knappen är standard. |
DefaultButton3 |
512 | Den tredje knappen är standard. |
ApplicationModal |
0 | Programmet är modalt. Användaren måste svara på meddelanderutan innan den fortsätter att fungera i det aktuella programmet. |
SystemModal |
4096 | Systemet är modalt. Alla program pausas tills användaren svarar på meddelanderutan. |
MsgBoxSetForeground |
65536 | Anger meddelanderutans fönster som förgrundsfönster. |
MsgBoxRight |
524288 | Texten är högerjusterad. |
MsgBoxRtlReading |
1048576 | Anger att text ska visas som höger-till-vänster-läsning i hebreiska och arabiska system. |
Den första gruppen med värden (0–5) beskriver antalet och typen av knappar som visas i dialogrutan. Den andra gruppen (16, 32, 48, 64) beskriver ikonformatet. Den tredje gruppen (0, 256, 512) avgör vilken knapp som är standard. Den fjärde gruppen (0, 4096) bestämmer meddelanderutans modalitet och den femte gruppen anger om meddelanderutans fönster är förgrundsfönstret, tillsammans med textens justering och riktning. När du lägger till tal för att skapa ett slutligt värde för Buttons argumentet använder du bara ett tal från varje grupp.