Vcl.Dialogs.TSaveDialog.Execute

• Übergeordnet: TSaveDialog

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	TSaveDialog

Beschreibung

Zeigt das Dialogfeld "Speichern unter" auf dem Bildschirm an.

Execute öffnet das Dialogfeld "Speichern unter" und gibt true zurück, sobald der Benutzer eine Datei ausgewählt und auf "Speichern" geklickt hat. Wenn der Benutzer den Speichern-Vorgang abbricht, gibt Execute einen falschen Wert 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 SaveDialog1.Execute then
   Memo1.Lines.SaveToFile(SaveDialog1.FileName);

 // C++:
 if (SaveDialog1->Execute())
   Memo1->Lines->SaveToFile(SaveDialog1->FileName);

Siehe auch

• Vcl.Dialogs.TCommonDialog.Execute
• Vcl.Forms.TApplication.ActiveFormHandle
• Vcl.Forms.Application
• HWND (MSDN)

Codebeispiele

• UsingDialogs (Delphi)
• UsingDialogs (C++)