Befehlsreferenz - Interaktion: MsgBox-Funktion
VB-Versionen: VB4 | VB5 | VB6
Beschreibung:
Die MsgBox-Funktion zeigt die Standard-Windows Meldebox mit einem vorgegebenen Text, Symbol und einer bestimmten Schaltflächen-Kombination an. Der Rückgabewert gibt an, über welche Schaltfläche die MsgBox geschlossen wurde und ist eine Zahl vom Typ Integer.
Syntax:
MsgBox (prompt, [buttons, [title, [helpfile, [context]]]] )
Parameter:
prompt | (String) Legt den Text fest, der im Melde-Dialog angezeigt werden soll. Die maximale Länge beträgt in etwa 1024 Zeichen. Der Text kann auch Umbruchzeichen enthalten (vbCrLf). |
buttons | Optional. (Long) Ein Wert, der sich aus der zu verwendenden Anzahl und Typen von Schaltflächen und dem anzuzeigenden Icon (Symbol) errechnet. Wird buttons nicht angegeben, wird 0 als Wert angenommen (nur OK-Schaltfläche - kein Symbol). |
title | Optional. (String) Legt fest, welcher Text in der Titelzeile der Dialogbox erscheinen soll. Wird nichts angegeben, wird der Anwendungsname angezeigt. |
helpfile | Optional. (String) Legt die Hilfedatei fest, welche aktiviert werden soll, wenn der Anwender die Taste F1 drückt. |
context | Optional. (Long) Legt die Hilfeseite (Context-ID) der Hilfedatei fest, welche beim Drücken von F1 angezeigt werden soll. |
Der Parameter buttons kann einen der nachfolgenden Werte annehmen (oder eine Kombination daraus):
Anzahl und Typen der Schaltflächen:
Konstante | Wert | Beschreibung |
vbOkOnly | 0 | Nur die Schaltfläche OK anzeigen |
vbOkCancel | 1 | Schaltflächen OK und Abbrechen anzeigen |
vbAbortRetryIgnore | 2 | Abbruch, Wiederholen und Ignorieren |
vbYesNoCancel | 3 | Ja, Nein und Abbrechen |
vbYesNo | 4 | Schaltflächen Ja und Nein |
vbRetryCancel | 5 | Schaltflächen Wiederholen und Abbrechen |
Bildsymbol (Icon):
Konstante | Wert | Beschreibung |
vbCritical | 16 | Stop-Symbol |
vbQuestion | 32 | Fragezeichen-Symbol |
vbExclamation | 48 | Ausrufezeichen-Symbol |
vbInformation | 64 | Information-Symbol |
Standard-Schaltfläche (markiert):
Konstante | Wert | Beschreibung |
vbDefaultButton1 | 0 | Schaltfläche 1 |
vbDefaultButton2 | 256 | Schaltfläche 2 |
vbDefaultButton3 | 512 | Schaltfläche 3 |
vbDefaultButton4 | 768 | Schaltfläche 4 |
Zusätzliche Konstanten:
Konstante | Wert | Beschreibung |
vbApplicationModal | 0 | An die Anwendung gebunden. Der Benutzer muß auf das Meldungsfeld reagieren, bevor er seine Arbeit mit der aktuellen Anwendung fortsetzen kann. |
vbSystemModal | 4096 | An das System gebunden. Alle Anwendungen werden unterbrochen, bis der Benutzer auf das Meldungsfeld reagiert. |
vbMsgBoxHelpButton | 16384 | Hilfe-Schaltfläche zusätzlich anzeigen |
vbMsgBoxSetForeground | 65536 | Dialogbox in den Vordergrund setzen (kann nicht verdeckt werden) |
vbMsgBoxRight | 524288 | Der Meldungstext wird rechtsbündig ausgerichtet. |
Die erste Gruppe von Werten beschreibt die Anzahl und den Typ der im Dialogfeld angezeigten Schaltflächen. Die zweite Gruppe beschreibt die Symbolart. Die dritte Gruppe legt die Standardschaltfläche fest. Die vierte Gruppe legt fest, in welcher Form das Dialogfeld gebunden ist. Verwenden Sie beim Addieren der Zahlen zu einem Gesamtwert für das Argument buttons nur eine Zahl aus jeder Gruppe.
Rückgabewert:
Konstante | Wert | Beschreibung |
vbOk | 1 | OK |
vbCancel | 2 | Abbrechen |
vbAbort | 3 | Abbruch |
vbRetry | 4 | Wiederholen |
vbIgnore | 5 | Ignorieren |
vbYes | 6 | Ja |
vbNo | 7 | Nein |
Beispiel:
' OK und Abbrechen, Stop-Symbol, Titelzeile "Test" antwort = MsgBox("Vorsicht!", vbOKCancel + vbCritical, "Test") If antwort = vbOk Then ' OK wurde geklickt ... Else ' Abbrechen wurde geklickt ... End If
Siehe auch: | Inputbox-Funktion |