MsgBox

betrifft

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.