Vcl.Forms.TApplication.MessageBox

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function MessageBox(const Text, Caption: PChar; Flags: Longint = MB_OK): Integer;

C++

int __fastcall MessageBox(const System::WideChar * Text, const System::WideChar * Caption, System::LongInt Flags = 0x0);

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.


Siehe auch

Codebeispiele