TCustomForm.SetZOrder procedure

Declaration

procedure SetZOrder(Topmost: Boolean); override

Arguments

Description

SetZOrder is an overridden method in TCustomForm. It ensures that a request to bring the current form to the top of the Z-Order is handled properly.

If a Parent control has not been assigned, the form instance is moved to the top of the Z-Order in the Screen singleton and the SetForegroundWindow routine is called using the Handle for the form instance. No actions are performed in the method if the Handle has not been allocated for the control, or when another form has been displayed modally on the Screen.

If Parent has been assigned, the inherited method is called to change the Z-Order using the SetChildZPosition method in the parent control.

SetZOrder is called from the BringToFront and SendToBack methods in the TControl ancestor.

See also

• GetCurrentModalForm
• MoveFormToZFront
• TControl.SetZOrder
• TControl.Parent
• TControl.BringToFront
• TControl.SendToBack
• SetForegroundWindow