interface menubar create
Allows you to create a new 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 create a menubar which is then used to add menus for execution of various commands. For adding the menus and activating the menubar refer to ‘menubar_build’.
Format:
interface menubar create |
|---|
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 create & |
|---|
menubar_name = | .gui.win.mbar & |
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 | A New GI_menubar | Specifies the name for a new 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. 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 buttons 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.
2. 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.
3. The vertical and horizontal resizing options are used to adjust the placement of the menu 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’