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

interface btn_stack modify

Allows you to modify an existing button stack.
The button stack is a stack of buttons which has multiple buttons attached to one button tab. The button stack can be created by using this command.

Format:

 
interface btn_stack modify
btn_stack_name =
an existing GI_btn_stack
new_btn_stack_name =
a new btn_stack
enabled =
boolean
help_text =
string
documentation_text =
string
units =
int_units
horiz_resizing =
int_h_resize
vert_resizing =
int_v_resize
location =
real
height =
real
width =
real

Example:

 
interface btn_stack modify &
btn_stack_name =
.gui.cntrl.btn &
new_btn_stack_name =
.gui.cntrl.btn1 &
location =
0.0, 0.0 &
height =
0.5 &
width =
0.5 &
enabled =
yes &
help_text =
"help2text" &
documentation_text =
"doc2text” &
units =
relative &
horiz_resizing =
attach_left &
vert_resizing =
attach_top

Description:

 
Parameter
Value Type
Description
btn_stack _name
An Existing GI_btn_stack
Specifies the name of an existing button stack
new_btn_stack_name
A New GI_btn_stack
Specifies a new name for an existing btn_stack
enabled
Boolean
Activates the btn stack
help_text
String
Specifies the help text
documentation_text
String
Specifies the documentation text
units
Int_units
Specifies the btn_stack size as pixel or relative to dialog box window
horiz_resizing
Int_h_resize
Specifies the attachment and scaling option for the btn_stack
vert_resizing
Int_v_resize
Specifies the attachment and scaling option for the btn_stack
location
Real
Specifies the location of the btn_stack on the dialog box
height
Real
Specifies the height of the btn_stack in terms of relative units or pixel
width
Real
Specifies the width of the btn_stack field in terms of relative units or pixel

Extended Definition:

1. The preliminary parameters of the btn_stack like size, placement, and name can be modified by using this command.
2. The pop-up help and documentation help can be specified in appropriate columns.
3. The size of the btn_stack can be specified either in terms of number of pixels. Alternatively, the size can also be stated as relative to the dialog box window
4. The vertical and horizontal resizing options are used to adjust the placement of the btn_stack on existing dialog box. For example, attach_left; attach_top options for Horiz_resizing and Vert_resizing will place the btn_stack on the top left corner of the dialog box. The location can also be specified from the top left corner by adjusting the parameter ‘location’
5. The size of the btn_stack can be specified with respect to the dialog box 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 dialog window. Therefore, a value of 1.0 will set the btn_stack field window to be one half as high as the dialog box window.