Vcl.Forms.TApplication.Initialize

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure Initialize;

C++

void __fastcall Initialize();

Properties

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

Description

Provides an opportunity to initialize subsystems.

Initialize is the first method called by the project source file. It calls the InitProc procedure pointer. By default, the call to Initialize for the application does nothing because the default InitProc pointer is nil (Delphi) or NULL (C++) .

To use Initialize, the InitProc pointer must be predefined. This can be accomplished in one of two ways:

In Delphi, you can include a unit that assigns a procedure to InitProc in its initialization section, such as the ComObj unit. You can make this assignment in the initialization section of any of your units.

In both Delphi and C++, you can create a custom initialization procedure that assigns a value to the InitProc pointer, and add a call to this procedure to the project source prior to the call to Initialize. (In Delphi, you can add it to the initialization section of the unit in which it is declared. In C++, you can use the pragma startup directive in that unit.)

Warning: Only one instance of InitProc can be defined in an application. If more than one unit assigns a value to InitProc, only the last assignment will work. You can, however, call the previous value of InitProc from an initialization procedure, so that all initialization procedures are executed.

For projects that do not assign a value to InitProc, the call to Initialize can be safely deleted from the project source.

Note: Although Initialize is the first method called in the main project source code, it is not the first code that is executed in a GUI application. For example, in Delphi, the application first executes the initialization section of all the units used by the application.

See Also

Code Examples