Mit der Methode MessageBox können Sie dem Benutzer eine bestimmte Meldung anzeigen.
Delphi-Syntax:
function MessageBox(const Text, Caption: PChar; Flags: Longint = MB_OK): Integer;
C++ Syntax:
int __fastcall MessageBox(const char * Text, const char * Caption, int Flags = MB_OK);
Beschreibung
Mit MessageBox können Sie ein generisches Dialogfeld mit einer Meldung und einer oder mehreren Schaltflächen anzeigen. Der Parameter Caption ist der Titel des Dialogfeldes und ist optional.
MessageBox ist eine Kapselung der in der Windows-
API enthaltenen Funktion MessageBox. Die Kapselung von MessageBox in TApplication liefert automatisch den fehlenden Parameter für das Fenster-
Handle, den die Windows-
API-Funktion benötigt.
Der Wert des Parameters Text enthält die Meldung, die bei Bedarf auch länger als 255 Zeichen sein kann. Lange Meldungen werden im Meldungsfenster automatisch umbrochen.
Der Parameter Caption liefert als Wert den Titel, der in der Titelleiste des Dialogfeldes angezeigt wird. Dieser kann zwar länger als 255 Zeichen sein, wird aber nicht umbrochen, sondern das Meldungsfenster wird entsprechend verbreitert.
Der Parameter Flags gibt an, welche Schaltflächen das Meldungsfenster aufweist und wie sich dieser verhalten (mögliche Rückgabewerte). Die folgende Tabelle enthält die möglichen Werte. Diese Werte können zum Erzielen des gewünschten Effekts auch kombiniert werden.
Wert Bedeutung
MB_ABORTRETRYIGNORE Das Meldungsfenster enthält drei Schaltflächen: Abbruch, Wiederholen und Ignorieren.
MB_OK Das Meldungsfenster enthält eine Schaltfläche: OK. Dies ist die Voreinstellung.
MB_OKCANCEL Das Meldungsfenster enthält zwei Schaltflächen: OK und Abbrechen.
MB_RETRYCANCEL Das Meldungsfenster enthält zwei Schaltflächen: Wiederholen und Abbrechen.
MB_YESNO Das Meldungsfenster enthält zwei Schaltflächen: Ja und Nein.
MB_YESNOCANCEL Das Meldungsfenster enthält drei Schaltflächen: Ja, Nein und Abbrechen.
Der Rückgabewert der Methode MessageBox ist 0, wenn nicht genügend Speicher zur Erstellung des Meldungsfensters vorhanden war. Andernfalls wird einer der folgenden Werte zurückgegeben:
Wert Numerischer Wert Bedeutung
IDOK 1 Der Benutzer hat auf OK geklickt.
IDCANCEL 2 Der Benutzer hat auf Abbrechen geklickt.
IDABORT 3 Der Benutzer hat auf Abbruch geklickt.
IDRETRY 4 Der Benutzer hat auf Wiederholen geklickt.
IDIGNORE 5 Der Benutzer hat auf Ignorieren geklickt.
IDYES 6 Der Benutzer hat auf Ja geklickt.
IDNO 7 Der Benutzer hat auf Nein geklickt.