Release 10.1A: OpenEdge Development:
Progress 4GL Handbook

> ## Navigating the hierarchy of menu handles

> For both menus and submenus, your procedure code can traverse all the menu items and nested submenus. The `FIRST-CHILD` attribute of a menu or submenu returns the handle of its first menu item or child submenu. The `NEXT-SIBLING` attribute of each menu item or submenu returns the handle of the next object at that level. Object handles are returned in left-to-right order for sibling submenus, and top-to-bottom order for menu items. You can navigate in reverse by starting with the `LAST-CHILD` attribute and following the `PREV-SIBLING` chain. These attributes are readable only. Their values are established when you assign parents to each submenu and menu item.

> You can also add dynamic submenus and menu items to an existing static menu. To do this, navigate the menu using these `CHILD` and `SIBLING` attributes to locate the handle of the object in the menu where you want to attach another submenu or menu item. Create the new objects and parent them to the existing object. You can parent a new submenu to the menu bar or to another submenu. You can parent a new menu item to an existing submenu. New objects are added to the end of the list of current objects at that level (that is, to the right of existing submenus in a parent menu or submenu) or to the bottom of the list of menu items for a submenu.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095