Vcl.Dialogs.TColorDialog.Execute
Delphi
function Execute(ParentWnd: HWND): Boolean; override;
C++
virtual bool __fastcall Execute(HWND ParentWnd)/* overload */;
inline bool __fastcall Execute(){ return TCommonDialog::Execute(); }
Inhaltsverzeichnis
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
- Color
- Vcl.Dialogs.TCommonDialog.Execute
- Vcl.Forms.TApplication.ActiveFormHandle
- Vcl.Forms.Application
- HWND (MSDN)
Codebeispiele