Vcl.Forms.TCustomForm.GetChildren

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure GetChildren(Proc: TGetChildProc; Root: TComponent); override;

C++

DYNAMIC void __fastcall GetChildren(System::Classes::TGetChildProc Proc, System::Classes::TComponent* Root);

Properties

Type Visibility Source Unit Parent
procedure
function
public
Vcl.Forms.pas
Vcl.Forms.hpp
Vcl.Forms TCustomForm

Description

Returns the "child" components of the form; that is, those components that return the form from their GetParentComponent method.

The component streaming system calls GetChildren to request that the form execute a callback for every child component in the form. The callback must execute in creation order (the order the child components appear in the form file). A child component is defined as any component that returns this form from its GetParentComponent method.

Proc is the callback to execute for every child component.

Root specifies the top-level component (such as a form or data module) that is currently being loaded or saved.

In TCustomForm, GetChildren first calls the inherited method, which executes Proc for every control that lists the form as its Parent. Then, if the Root parameter identifies this form, GetChildren executes Proc for every child component that does not have a Parent.

See Also