TControl.HandleObjectShouldBeVisible function

Declaration

function HandleObjectShouldBeVisible: Boolean; virtual

Function result

Description

HandleObjectShouldBeVisible is a Boolean function which indicates if the control requires a valid handle in its widgetset class instance and should be visible. The return value is set to True when the following conditions are satisfied:

• Neither the control nor its Handle is being destroyed.
• IsControlVisible returns True indicating the control is both Visible and not disabled on the form designer at design-time.
• Parent has been assigned and its HandleObjectShouldBeVisible method returns True.

HandleObjectShouldBeVisible is used frequently in widgetset class methods, and indicates that actions like allocating or freeing a handle should be performed. It determined the value for the Visible property in the widget. It also indicates whether the actions in the class method can be performed, or should be ignored.

See also

• IsVisible
• ControlState
• Parent
• TComponent.ComponentState