Vcl.Forms.GetParentForm

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function GetParentForm(Control: TControl; TopForm: Boolean = True): TCustomForm;

C++

extern DELPHI_PACKAGE TCustomForm* __fastcall GetParentForm(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 GetParentForm 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 (z.B. bei einem ActiveX-Steuerelement, das in einem anderen Fenstertyp eingebettet ist), gibt GetParentForm nil (Delphi) oder NULL (C++) zurück.

Siehe auch