interface menubar modify
Allows you to modify an existing menubar.
The menubar can be created on main_window, popup_window, ppt_main_window, or a user defined custom window. The menubar can further be built up by adding menus, which are associated with Adams commands.
This command is used to modify a menubar which may be further used to add menus for execution of various commands. For adding the menus and activating the menubar refer to ‘menubar_build’.
Format:
interface menubar modify |
|---|
menubar_name = | an existing GI_menubar |
new_menubar_name = | a new GI_menubar |
enabled = | boolean |
help_text = | string |
documentation_text = | string |
units = | int_units |
horiz_resizing = | int_h_resize |
vert_resizing = | int_v_resize |
Example:
interface menubar modify & |
|---|
menubar_name = | .gui.win.mnbr & |
new_menubar_name = | mnbr1 & |
enabled = | yes & |
help_text = | "text2help" & |
documentation_text = | "text2doc" & |
units = | relative & |
horiz_resizing = | attach_left & |
vert_resizing = | attach_top |
Description:
Parameter | Value Type | Description |
|---|
menubar_name | An Existing GI_menubar | Specifies the name of an existing menubar |
new_menubar_name | A New GI_menubar | Specifies a new name for an existing menubar |
enabled | Boolean | Activates the menubar |
help_text | String | Specifies the help text |
documentation_text | String | Specifies the documentation text |
units | Int_units | Specifies the menubar size as pixel or relative to Adams window |
horiz_resizing | Int_h_resize | Specifies the attachment and scaling option for the menubar |
vert_resizing | Int_v_resize | Specifies the attachment and scaling option for the menubar |
Extended Definition:
1. The ‘new_menubar_name’ will replace the existing menubar with the new name.
2. A menubar contains various menus. Each of these menus may be associated with different commands. Such a menubar can be created by this command. adding menus and commands to the menus is done by ‘interface menubar build’ command. The menubar can be displayed on the main_window, popup_window, ppt_main_window, or a user defined custom window.
3. The menubar is enabled by the parameter ‘enabled’. The popup_help_text and documentation is specified. The size of the menubar can be specified either in terms of number of pixels. Alternatively, the size can also be stated as relative to the Adams window. The vertical and horizontal resizing options are used to adjust the placement of the menubar on existing window. For example, attach_left; attach_top options for Horiz_resizing and Vert_resizing will place the menu on the top left corner of the window box. The location can also be specified from the top left corner by adjusting the parameter ‘location’