TMenuItem.CheckChildrenHandles procedure

Declaration

procedure CheckChildrenHandles

Description

CheckChildrenHandles recursively checks menu items to ensure that handles for merged / child menu items are freed when they are hidden, or not owned by a menu item on the menu. No actions are performed in the method when Items has not been assigned.

At run-time, InitiateActions is called to ensure that the visibility of child Items with an action are up-to-date. If AutoLineReduction is in effect, RethinkLines is called to remove redundant menu separators. These actions are not performed at design-time.

The handle for hidden menu items in MergedItems are freed. The handle for visible menu items in MergedItems are freed and re-created.

CheckChildrenHandles is called from CreateHandle when the handle for a menu item is allocated. It is also called when a menu item is merged into another menu or item. Finally, it is called when update notifications are handled for the class instances in the Items property.

See also

• CreateHandle
• Handle
• Menu
• Parent
• Items
• MergedItems
• MergedWith
• InitiateActions
• InitiateAction
• AutoLineReduction
• RethinkLines
• Action
• Visible
• Notify