Sign in Join
FPDoc Onlineexperiment

TApplication.RemoveStayOnTop procedure

Member of TApplicationpublicIn unit Forms

Removes the StayOnTop attribute from all visible forms in the application.

Declaration

pascal
procedure RemoveStayOnTop(const ASystemTopAlso: Boolean=False)

Arguments

ASystemTopAlso

Indicates whether system dialogs/forms with stay on top set are also updated. Default value is False.

Description

RemoveStayOnTop is a method used to remove the stay on top attribute from visible forms in the application.

RemoveStayOnTop calls the AppRemoveStayOnTopFlags method in the widgetset class instance. ASystemTopAlso indicates whether system dialogs/forms with the stay on top attribute are included in the list of forms affected in the method. The default value for ASystemTopAlso is False, and omits these forms from the list.

RemoveStayOnTop builds the internal list of forms used in the RestoreStayOnTop method. It adds each visible form instance in Screen.CustomForms to the internal list, and sets its FormStyle property to fsNormal. Any form without a Parent, not Visible, or without FormStyle set to fsStayOnTop is not added to the list or affected in the method.

RemoveStayOnTop is called from methods like ModalStarted and HandleException.

See RestoreStayOnTop for the actions performed to restore the stay on top attribute to the list of forms.

See also

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.