Vcl.Dialogs.TColorDialog.Execute

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Execute(ParentWnd: HWND): Boolean; override;

C++

virtual bool __fastcall Execute(HWND ParentWnd)/* overload */;
inline bool __fastcall  Execute(){ return TCommonDialog::Execute(); }

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Vcl.Dialogs.pas
Vcl.Dialogs.hpp
Vcl.Dialogs TColorDialog

Beschreibung

Zeigt das Dialogfeld zur Farbauswahl an.

Execute öffnet das Dialogfeld zur Farbauswahl und gibt true zurück, wenn der Benutzer eine Farbe auswählt und auf OK klickt. Bricht der Benutzer ab, wird false zurückgegeben.

Die Codesignaturen der Methode Execute sind eigentlich Überschreibungen der Execute-Überladungen in der Basisklasse Vcl.Dialogs.TCommonDialog.Execute. Für Delphi gibt es eine zusätzliche Überladung der Methode Execute, die in den geerbten Membern von TCommonDialog angezeigt wird und keine Eingabeparameter übernimmt.

Der Parameter ParentWnd ist ein Fenster-Handle des Typs HWND (MSDN). Wenn kein Fenster-Handle zur Verfügung steht, wird das aktuelle Formular-Handle verwendet, auf das von Vcl.Forms.TApplication.ActiveFormHandle in der globalen Variable Vcl.Forms.Application zugegriffen werden kann.


 // Delphi:
 if ColorDialog1.Execute then
   Shape1.Brush.Color := ColorDialog1.Color
 else
   Shape1.Brush.Color := clGray;
 // C++:
 if (ColorDialog1->Execute())
   Shape1->Brush->Color = ColorDialog1->Color;
 else
   Shape1->Brush->Color = clGray;

Siehe auch

Codebeispiele