Adams Basic Package > Adams View > View Command Language > interface > interface data_table create

interface data_table create

Allows you to create a new data table.
The data table is similar to a excel workbook where a categorized data can be stored as array, locating each item by its row and column index. The data table can be created on a dialog box and the data is displayed using this command .

Format:

 
interface data_table create
data_table_name =
A New GI_data_table
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
cell_select_commands =
String
commands =
String
editable =
Boolean
auto_add_rows =
Boolean

Example:

 
interface data_table create &
data_table_name =
.gui.param.dtable &
enabled =
yes &
help_text =
"text2help" &
documentation_text =
"text4doc" &
units =
pixel &
horiz_resizing =
attach_left &
vert_resizing =
attach_top &
location =
0.0, 0.0 &
height =
280 &
width =
360 &
commands =
"interface dialog display dialog=.gui.about_Adams" &
cell_select_commands =
“int dialog dis dialog=.gui.moag”&
editable =
yes &
auto_add_rows =
yes

Description:

 
Parameter
Value Type
Description
data_table _name
A New GI_data_table
Specifies the name for a new data table to be created
enabled
Boolean
Activates the data table
help_text
String
Specifies the help text
documentation_text
String
Specifies the documentation text
units
Int_units
Specifies the data table size as pixel or relative to Adams window
horiz_resizing
Int_h_resize
Specifies the attachment and scaling option for the data table
vert_resizing
Int_v_resize
Specifies the attachment and scaling option for the data table
location
Real
Specifies the location of the data table on the dialog box
height
Real
Specifies the height of the data table in terms of relative units or pixel
width
Real
Specifies the width of the data table field in terms of relative units or pixel
cell select commands
String
Specifies the command to be executed whenever any cell is selected
commands
String
Specifies the command to be executed
editable
Boolean
Allows editing the data table contents
auto_add_rows
Boolean
When paste area differs in size from copied selection, then it will auto generate the rows to match copied selection.

Extended Definition:

1. The preliminary parameters of the data table like size, associated commands and editing capability are set using this command. The data table is then by filled by entering the appropriate fields for row and column. The data table with specified name is created on the dialog box If parameter ‘Enabled’ is set to ON, the data table is be preactivated.
2. The pop-up help and documentation help can be specified in appropriate columns.
3. The size of the data table 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 data table menu on existing dialog box. For example, attach_left; attach_top options for Horiz_resizing and Vert_resizing will place the data table 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 data table 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 data table field window to be one half as high as the Adams View window.
6. ‘Cell select command’ gets executed whenever any cell is selected for editing.
7. The parameter ‘command’ specifies the name of the command to be executed.
8. The data table can be edited after initializing it if the BOOLEAN option is ‘yes’ for the parameter ‘editable’