Vcl.Forms.ValidParentForm
Delphi
function ValidParentForm(Control: TControl; TopForm: Boolean = True): TCustomForm;
C++
extern DELPHI_PACKAGE TCustomForm* __fastcall ValidParentForm(Vcl::Controls::TControl* Control, bool TopForm = true);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | Vcl.Forms.pas Vcl.Forms.hpp |
Vcl.Forms | Vcl.Forms |
Beschreibung
Gibt das Formular oder die Registerkarte mit einem bestimmten Steuerelement zurück.
Mit ValidParentForm können Sie den Nachkommen von TCustomForm ermitteln, der das im Parameter Control angegebene Steuerelement enthält. Wenn der Parameter TopForm true ist, sucht diese Funktion in der gesamten Kette der Control übergeordneten Elemente nach einem Formular, das kein übergeordnetes Element hat. Wenn TopForm false ist, sucht diese Funktion in der gesamten Kette der übergeordneten Elemente nach dem TCustomForm-Formular.
Befindet sich das Steuerelement nicht in einem Formular (beispielsweise ein ActiveX-Steuerelement, das in ein Fenster eines anderen Typs eingebettet wurde), löst ValidParentForm eine EInvalidOperation-Exception aus.