Vcl.Dialogs.TOpenDialog.OnCanClose

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnCanClose: TCloseQueryEvent read FOnCanClose write FOnCanClose;

C++

__property Vcl::Forms::TCloseQueryEvent OnCanClose = {read=FOnCanClose, write=FOnCanClose};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
event published
Vcl.Dialogs.pas
Vcl.Dialogs.hpp
Vcl.Dialogs TOpenDialog

Beschreibung

Tritt ein, wenn der Benutzer versucht, das Dialogfeld ohne abzubrechen zu schließen.

Mit einer OnCanClose-Ereignisbehandlungsroutine können Sie den Wert von FileName einer individuellen Gültigkeitsprüfung unterziehen. Dateiauswahl-Dialogfelder stellen eine Reihe integrierter Gültigkeitsprüfungen bereit, wie z.B. die Prüfung auf ungültige Zeichen, die Aufforderung zur Bestätigung vor dem Überschreiben von Dateien, die Prüfung, ob eine Datei oder ein Pfad vorhanden ist usw. Diese Gültigkeitsprüfungen können mit Hilfe der Eigenschaft Options festgelegt werden. In Anwendungen lassen sich in einer OnCanClose-Ereignisbehandlungsroutine zusätzliche Gültigkeitsprüfungen von Dateienamen vornehmen.

Setzen Sie den Parameter CanClose auf false, um zu verhindern, dass das Dialogfeld geschlossen wird. Teilen Sie über die Ereignisbehandlungsroutine OnCanClose dem Benutzer mit, warum das Dialogfeld nicht geschlossen wird.

Anmerkung:  OnCanClose triit unter Windows NT 3.51 nur ein, wenn die neue Shell installiert ist.

Siehe auch