Die MsgBox-Funktion zeigt eine Meldung in einem Dialogfeld an und wartet darauf, dass der Benutzer auf eine Schaltfläche klickt. Der Rückgabewert gibt an, auf welche Schaltfläche der Benutzer geklickt hat.
Syntax | ||||
Result := MsgBox(Text [, Buttons [, Title [, ParentWinHandle]]]) | ||||
Rückgabewert | ||||
Typ |
Beschreibung | |||
MsgBoxReturn |
Der Code des gewählten Buttons | |||
Parameter | ||||
Verwendung |
Name |
Typ |
Übergabe |
Beschreibung |
Erforderlich |
Text |
String |
ByVal |
Ausgabetext |
Optional |
Buttons |
MsgBoxStyle |
ByVal |
Attribute der Meldung. Die unten angegebenen Werte können oderverknüpft in diesem Parameter angegeben werden |
Optional |
Title |
String |
ByVal |
Text in der Titelzeile der Meldung |
Optional |
ParentWinHandle |
Long |
ByVal |
Window-Handle des übergeordneten Fensters |
MsgBoxReturn |
Beschreibung |
3 – Abort |
Es wurde der Abbruch-Button gedrückt |
2 – Cancel |
Es wurde der Cancel-Button gedrückt |
5 – Ignore |
Es wurde der Ignorieren-Button gedrückt |
7 – No |
Es wurde der Nein-Button gedrückt |
1 – OK |
Es wurde der OK-Button gedrückt |
4 – Retry |
Es wurde der Wiederholen-Button gedrückt |
6 – Yes |
Es wurde der Ja-Button gedrückt |
MsgBoxStyle |
Beschreibung |
2 – AbortRetryIgnore |
Abbrechen-, Wiederholen- und Ignorieren-Button werden angezeigt |
0 – ApplicationModal |
Die Message-Box ist an die Anwendung gebunden |
16 – Critical |
der Meldung wird das Stopp-Symbol eingeblendet |
0 – DefaultButton1 |
Die erste Schaltfläche des Dialogs ist die Standardschaltfläche |
256 – DefaultButton2 |
Die zweite Schaltfläche des Dialogs ist die Standardschaltfläche |
512 – DefaultButton3 |
Die dritte Schaltfläche des Dialogs ist die Standardschaltfläche |
768 – DefaultButton4 |
Die vierte Schaltfläche des Dialogs ist die Standardschaltfläche |
48 – Exclamation |
In der Meldung wird das Ausrufezeichen-Symbol eingeblendet |
16384 – HelpButton |
Blendet einen Hilfe-Button ein |
64 – Information |
In der Meldung wird das Info-Symbol eingeblendet |
524288 – MsgBoxRight |
Die Buttons werden linksbündig angeordnet. |
1 – OKCancel |
OK- und Abbrechen-Button werden angezeigt. |
0 – OKOnly |
Nur der OK-Button wird angezeigt. Dieser Button ist die Standardschaltfläche. Der Dialog ist an die Anwendung gebunden, d.h. der Benutzer muss die Meldung durch Anklicken des OK-Buttons bestätigen bevor er seine Arbeit mit der aktuellen Anwendung fortsetzen kann. |
32 – Question |
In der Meldung wird das Fragezeichen-Symbol eingeblendet |
5 – RetryCancel |
Wiederholen- und Abbrechen-Button werden angezeigt |
1048576 – RtlReading |
Der Text wird optimiert für Right-to-Left Schreibweise angeordnet |
65536 – SetForeground |
Setzt die Meldung in den Vordergrund |
4096 – SystemModal |
Der Dialog ist an das System gebunden, d.h. alle Anwendungen werden solange unterbrochen, bis der Benutzer auf das Meldungsfeld reagiert |
8192 – TaskModal |
Der Dialog ist an die Anwendung gebunden, d.h. nur die aktuelle Anwendung wird solange unterbrochen, bis der Benutzer auf das Meldungsfeld reagiert |
4 – YesNo |
Ja- und Nein-Button werden angezeigt |
3 – YesNoCancel |
Ja-, Nein- und Abbrechen-Button werden angezeigt |
Bemerkung:
ParentWinHandle wird bei taskmodaler Anzeige verwendet, um die Message-Box an das übergeordnete Fenster zu binden. Wird ParentWinHandle nicht angegeben, wird die Message-Box auf dem primären Monitor angezeigt, ansonsten auf dem Monitor, in dem die linke obere Ecke das übergeordnete Fenster liegt.