Vcl.Forms.TApplication.MessageBox
Delphi
function MessageBox(const Text, Caption: PChar; Flags: Longint = MB_OK): Integer;
C++
int __fastcall MessageBox(const System::WideChar * Text, const System::WideChar * Caption, int Flags = 0x0);
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Vcl.Forms.pas Vcl.Forms.hpp |
Vcl.Forms | TApplication |
Beschreibung
Zeigt dem Benutzer eine bestimmte Meldung an.
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 unter http://msdn.microsoft.com/en-us/library/windows/desktop/ms645505(v=vs.85).aspx beschrieben wird.
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. |