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

interface tab_container modify

Allows modifying the tab_container properties.
Tab_container is similar to a container but can be added to a dialog box or another container. When you add a tab_container, a tab appears in the parent container.

Format:

 
interface object tab_container modify
tab_container_name =
an exisitng gi_tab_container
new_ tab_container_name =
a new gi_tab_container
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
commands =
string
current choice =
string

Example:

 
interface tab_container create &
tab_container_name =
.gui.cntr.tabcnt &
enabled =
yes &
help_text =
"help2text" &
documentation_text =
"doc2text" &
units =
relative &
horiz_resizing =
attach_left &
vert_resizing =
attach_top &
location =
0.0, 0.0 &
height =
0.4 &
width =
0.4 &
commands =
"interface dialog display dialog=.gui.about_Adams" &
current_choice =
"yes"

Description:

 
Parameter
Value Type
Description
tab_container_name
An Existing GI_tab_container
Specifies the name of an existing tab_container to be modified
new_tab_container_name
A New GI_tab_container
Specifies a new name for the tab_container
enabled
Boolean
Activates the tab_container
help_text
String
Specifies the help text
documentation_text
String
Specifies the documentation text
units
Int_units
Specifies the tab_container size as pixel or relative to Adams window
horiz_resizing
Int_h_resize
Specifies the attachment and scaling option for the tab_container
vert_resizing
Int_v_resize
Specifies the attachment and scaling option for the tab_container
location
Real
Specifies the location of the tab_container on the dialog box
height
Real
Specifies the height of the tab_container in terms of relative units or pixel
width
Real
Specifies the width of the tab_container field in terms of relative units or pixel
commands
String
Specifies the command to be executed
current choice
String
Specifies the default option for the command to be executed

Extended Definition:

1. The preliminary parameters of the tab_container like size, associated commands and editing capability are set using this command. To rename the tab_container, fill the parameter ‘new_tab_container_name’.
2. The pop-up help and documentation help can be specified in appropriate columns.
3. The size of the tab_container can be specified either in terms of number of pixels. Alternatively, the size can also be stated as relative to the Adams window.
4. The vertical and horizontal resizing options are used to adjust the placement of the tab_container menu on existing dialog box. For example, attach_left; attach_top options for Horiz_resizing and Vert_resizing will place the tab_container 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 tab_container window can be specified with respect to the Adams 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 tab_container field window to be one half as high as the Adams View window.
6. The parameter ‘command’ specifies the name of the command to be executed, whereas the current choice determines the default choice for the execution of the command.