TApplication.MessageBox Methode
Zeigt dem Benutzer eine bestimmte Meldung an.
Klasse
TApplication
Syntax
[Delphi] function MessageBox(const Text: PAnsiChar; const Caption: PAnsiChar; Flags: Integer): Integer;
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 Standardeinstellung.
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 Nummerischer 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.