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