Adams Basic Package > Adams View > View Command Language > interface > interface toolbar modify

interface toolbar modify

Allows you to modify an existing toolbar.
The toolbar can be created on a existing pop_window or a window, where various toolbar buttons can be placed.

Format:

 
interface toolbar modify
toolbar_name =
an existing GI_toolbar
new_toolbar_name =
a new GI_toolbar
enabled =
boolean
help_text =
string
documentation_text =
string
units =
nt_units
horiz_resizing =
int_h_resize
vert_resizing =
int_v_resize
location =
real
height =
real
width =
real
rank =
integer
top =
boolean

Example:

 
interface toolbar modify &
toolbar_name =
.gui.ppwndw.tlbr &
new_toolbar_name =
.gui.ppwndw.tlbr1 &
location =
0.2, 0.2 &
height =
0.2 &
width =
0.9 &
enabled =
yes &
help_text =
"text2help" &
documentation_text =
"text2doc" &
units =
relative &
horiz_resizing =
attach_left &
vert_resizing =
attach_top &
rank =
2 &
top =
yes

Description:

 
Parameter
Value Type
Description
toolbar _name
An Existing GI_toolbar
Specifies the name of an existing toolbar
new_toolbar_name
A New GI_toolbar
Specifies a new name for an existing toolbar
enabled
Boolean
Activates the toolbar
help_text
String
Specifies the help text
documentation_text
String
Specifies the documentation text
units
Int_units
Specifies the toolbar size as pixel or relative to pop_up window
horiz_resizing
Int_h_resize
Specifies the attachment and scaling option for the toolbar
vert_resizing
Int_v_resize
Specifies the attachment and scaling option for the toolbar
location
Real
Specifies the location of the toolbar on the pop_up window
height
Real
Specifies the height of the toolbar in terms of relative units or pixel
width
Real
Specifies the width of the toolbar field in terms of relative units or pixel
rank
Integer
Specifies the rank of the toolbar in case of multiple toolbars
top
Boolean
Keeps the toolbar on the top of other windows

Extended Definition:

1. The preliminary parameters of the toolbar like size, rank and label are set using this command.
2. The pop-up help and documentation help can be specified in appropriate columns.
3. The size of the toolbar can be specified either in terms of number of pixels. Alternatively, the size can also be stated as relative to the pop_up window
4. The vertical and horizontal resizing options are used to adjust the placement of the toolbar menu on existing pop_window. For example, attach_left; attach_top options for Horiz_resizing and Vert_resizing will place the toolbar on the top left corner of the pop_up. The location can also be specified from the top left corner by adjusting the parameter ‘location’
5. The size of the toolbar window can be specified with respect to the pop_up window size. The value for parameter height and width should be a real number between 0.0 and 2.0, where 2.0 represents the height of the window. Therefore, a value of 1.0 will set the toolbar to be one half as high as the pop_up window.
6. The toolbar remains on the ‘top’ of other windows if specified ‘yes’ for the parameter ‘top’