geUpdateWindowMenus

geUpdateWindowMenus(
w_windowId
)

Description

Updates the enabled status of all the menu items in the window’s banner menu hierarchy and all of the window’s fixed menu items.

Whether a menu item is enabled or disabled is determined by comparing that menu item’s enable predicates with the corresponding application status in the window. The enable predicates are matched to the status value according to the appName specified with geSetEnablePredicate and geSetWindowStatus. The comparison used is:

(enablePredicate & status) == enablePredicate

• If all of the comparisons are TRUE, the menu item is enabled. Otherwise, the menu item is disabled.
• If a menu item does not have an enable predicate, the menu item’s enabled state is not changed. The menu is neither enabled or disabled. However, the menu item’s submenus, if any, are updated.
• If a menu item is disabled, the menu item’s submenus are not updated. Otherwise, if the menu item is enabled, that menu’s submenus are updated.
• If an application’s current status is undefined and ~0 is used for the application’s status, all status bits are TRUE.

Layout window menus are automatically updated after every HI event. So you do not need to explicitly call geUpdateWindowMenus to update the menus.

Arguments

w_windowId

The ID of the window whose menus you want to update.

Value Returned

Returns a list of all the menu update system applications that changed since the last call to geUpdateWindowMenus.

Related Topics

Automatic Menu Enabling Functions

Return to top