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.