Vcl.Dialogs.TOpenDialog.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 TOpenDialog

Beschreibung

Zeigt das Dialogfeld zur Dateiauswahl an.

Execute öffnet das Dialogfeld zur Auswahl von Dateien und gibt true zurück, wenn der Benutzer eine Datei ausgewählt und auf "Öffnen" geklickt hat. Wenn der Anwender auf "Abbrechen" klickt, gibt Execute false zurück.

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 OpenDialog1.Execute then
   Memo1.Lines.LoadFromFile(OpenDialog1.FileName)
 else
   Memo1.Lines.Clear;
 // C++:
 if (OpenDialog1->Execute())
   Memo1->Lines->LoadFromFile(OpenDialog1->FileName);
 else
   Memo1->Lines->Clear();

Siehe auch

Codebeispiele