[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index]

Reference for unit 'Forms' (#lcl)

TApplication.UpdateMainForm

Makes the specified form the MainForm in the Application.

Declaration

Source position: forms.pp line 1608

public procedure TApplication.UpdateMainForm(

AForm: TForm

);

Arguments

AForm

The form to use as the MainForm in the Application.

Description

UpdateMainForm is a method used to make the form instance in AForm the main form for the application. It stores the value in AForm to the MainForm property. No actions are performed in the method for the following conditions:

MainForm is already assigned.
AForm is marked for release.
The Handle for AForm has not yet been allocated.
AForm is a MDI Child form (FormStyle contains fsMDIChild) or a splash screen form (FormStyle contains fsSplash).

UpdateMainForm is called from the CreateForm method, and occurs before the form calls its HandleNeeded method. It is also called when the Handle for a form is created (or re-created) in the CreateWnd method in TForm.

Version 3.2

Generated 2024-02-25

Home