TScreen.FocusedForm property

Declaration

property FocusedForm: TCustomForm read FFocusedForm;

Description

FocusedForm is a read-only TCustomForm property which contains the form which has focus on the screen. The value for the property is maintained in the SetFocusedForm method, which ensures that the previously focused form is deactivated before setting the value in the property. It is also updated in the RemoveForm method when the freed form instance is the current value for the property.

FocusedForm is updated in the ShowModal method in TCustomForm when the focus is changed to a modal form. It is also updated in the ControlDestroyed method in TApplication when the freed control is also the current value for the property.

The value in the property is used to prevent hint windows from being displayed for other forms when a modal form is active.

See also

• ActiveForm
• ActiveCustomForm