Dialogs.TaskMessageDlgPos

Delphi-Informationen

von Dialogs.pas

	function TaskMessageDlgPos(const Title: string;
		const Msg: string;
		DlgType: TMsgDlgType;
		Buttons: TMsgDlgButtons;
		HelpCtx: Integer;
		X: Integer;
		Y: Integer): Integer; overload;
 
	function TaskMessageDlgPos(const Title: string;
		const Msg: string;
		DlgType: TMsgDlgType;
		Buttons: TMsgDlgButtons;
		HelpCtx: Integer;
		X: Integer;
		Y: Integer;
		DefaultButton: TMsgDlgBtn): Integer; overload;

Unit: Dialogs

Typ: Funktion

Sichtbarkeit: public

C++-Informationen

von Dialogs.hpp

	int __fastcall TaskMessageDlgPos(System::UnicodeString Title,
		System::UnicodeString Msg,
		Dialogs::TMsgDlgType DlgType,
		System::Set<Dialogs::TMsgDlgBtn,0,11> Buttons,
		int HelpCtx,
		int X,
		int Y);

Unit: Dialogs

Typ: Funktion

Beschreibung

Zeigt ein Meldungs-Task-Dialogfeld an einer bestimmten Position des Bildschirms an.

Mit TaskMessageDlgPos können Sie an einer bestimmten Position des Bildschirms ein Meldungsfenster anzeigen. Die Möglichkeit, einen Titel anzugeben, bietet diese Funktion nicht (wenn Sie ein Fenster mit einem bestimmten Titel benötigen, verwenden Sie MessageDlg).

Der Parameter Msg enthält die angezeigte Meldung.

Der Parameter DlgType bestimmt den Typ des Meldungsfensters:

DlgType-Wert	Bedeutung
mtWarning	Ein Meldungsfenster, das ein gelbes Ausrufezeichen enthält.
mtError	Ein Meldungsfenster, das ein rotes Stoppschild enthält
mtInformation	Ein Meldungsfenster, das ein blaues "i" enthält.
mtConfirmation	Ein Meldungsfenster, das ein grünes Fragezeichen enthält.
mtCustom	Ein Meldungsfenster, das kein Bitmap enthält. Der Titel des Meldungsfensters ist der Name der ausführbaren Datei der Anwendung.

Der Parameter Buttons legt fest, welche Schaltflächen das Meldungsfenster enthält.

Der Parameter HelpCtx ist die Kontext-ID des Hilfethemas, das angezeigt wird, wenn der Anwender auf die Schaltfläche Hilfe klickt oder F1 drückt.

Die Parameter X und Y sind die Bildschirmkoordinaten des Meldungsfensters. Der Wert -1 bedeutet, dass das Meldungsfenster an keiner bestimmten Position angezeigt wird.

Der Parameter DefaultBtn legt fest, welche der Schaltflächen in Buttons die Standardschaltfläche ist. Der Wert mbNone bedeutet, dass es keine Standardschaltfläche gibt.

Der Parameter Bitmap ist eine Grafik, die im Meldungsfenster angezeigt wird. Wenn Bitmap nil (Delphi) bzw. NULL (C++) ist, wird keine Grafik angezeigt (es sei denn, DlgType hat den Wert mtConfirmation).

Der Rückgabewert von MessageDlgPos gibt an, welche Schaltfläche der Benutzer ausgewählt hat. Die folgende Tabelle zeigt die möglichen Werte für TMsgDlgBtn und die entsprechenden Rückgabewerte:

TMsgDlgBtn-Wert	Rückgabewert
mbOk	mrOk
mbOK	mrOk
mbCancel	mrCancel
mbYes	mrYes
mbNo	mrNo
mbAbort	mrAbort
mbRetry	mrRetry
mbIgnore	mrIgnore
mbAll	mrAll
mbNoToAll	mrNoToAll
mbYesToAll	mrYesToAll
mbClose	mrClose

Anmerkung:  Der Text der Meldung kann zur Laufzeit mit der Tastenkombination Strg+C in die Zwischenablage kopiert werden.

Siehe auch

• Routinen zur Unterstützung von Dialogfeldern

Codebeispiele

• TaskDialogs (Delphi)
• TaskDialogs (C++)