TCustomForm.MDIChildren property

Declaration

property MDIChildren[I: Integer]: TCustomForm read GetMDIChildren;

Description

MDIChildren is a read-only indexed TCustomForm property which provides access to the child forms in a Multi-Document Interface (MDI) application. In an MDI application, one of the forms acts as the main form for the application, and is the container for its MDI child forms. In addition, a MDI child form can be nested in another MDI child form.

The form role is determined by the value in the FormStyle property. fsMDIForm is used for the main form, and fsMDIChild for the child forms. MDIChildren is relevant when the current form instance uses one of these MDI form style values.

Index is an Integer value is used to access a MDI child form by its ordinal position in MDIChildren. The return value contains the TCustomForm instance at the specified position, as determined using the GetMDIChildren method in the widgetset class. The return value can be Nil when the current form does not use a FormStyle with the value fsMDIForm or fsMDIChild, or when a handle has not yet been allocated for the form instance. The return value is always Nil at design-time.

Use MDIChildCount to get the number MDI child forms for the form instance.

Use ActiveMDIChild to get the active MDI child form in the application.

Set the value in the FormStyle property to indicate that the class is used as a MDI form.

See also

• FormStyle
• MDIChildCount
• ActiveMDIChild