Vcl.Dialogs.TOpenDialog.Execute

• Up to Parent: TOpenDialog

Delphi

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

C++

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

Properties

Type	Visibility	Source	Unit	Parent
function	public	Vcl.Dialogs.pas Vcl.Dialogs.hpp	Vcl.Dialogs	TOpenDialog

Description

Displays the file-selection dialog.

Execute opens the file-selection dialog, returning true when the user selects a file and clicks Open. If the user clicks Cancel, Execute returns false.

The code signatures of Execute that appear above are actually overrides of the Execute overloads in the base class Vcl.Dialogs.TCommonDialog.Execute. There is one more overload of Execute for Delphi that appears in the inherited members from TCommonDialog, and this overload takes no input parameters.

The ParentWnd parameter is a window handle of type HWND MSDN. If none is provided, the current form handle is used, accessed from Vcl.Forms.TApplication.ActiveFormHandle in the global variable Vcl.Forms.Application.

 // 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();

See Also

• Files
• FileName
• Vcl.Dialogs.TCommonDialog.Execute
• Vcl.Forms.TApplication.ActiveFormHandle
• Vcl.Forms.Application
• HWND MSDN

Code Examples

• TApplicationIcon (Delphi)
• TOpenDialogFileName (Delphi)
• UsingDialogs (Delphi)
• TApplicationIcon (C++)
• UsingDialogs (C++)