diff --git a/docs/xml/lcl/menus.xml b/docs/xml/lcl/menus.xml index 4fb6eace06..8a621cbc52 100644 --- a/docs/xml/lcl/menus.xml +++ b/docs/xml/lcl/menus.xml @@ -1398,16 +1398,49 @@ surface for the IDE. -Verifies the handles for child menu items on the menu. + +Verifies the handles for child menu items on the menu. +

-CheckChildrenHandles recursively checks menu items to ensure that handles for -merged 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. +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.

- + + + + + + + + + + + + + + + +