interface data_table set selected
Allows you to alter the selected cells in a data table field
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.
The selected cell of a data table can be edited using the ‘set selected’ command.
Format:
interface data_table set selected |
|---|
data_table_name = | an existing GI_data_table |
strings = | string |
reals = | real |
repeat_strings = | boolean |
action = | col_action |
Example:
interface data_table set selected & |
|---|
data_table_name = | .gui.atv.dtable & |
strings = | select_new & |
action = | replace & |
repeat_strings = | yes |
Description:
Parameter | Value Type | Description |
|---|
data_table _name | An Existing GI_data_table | Specifies the name of an existing data table |
strings | String | Specifies the new STRING contents for the selected cells |
reals | Real | Specifies the new REAL contents for the selected cells |
repeat_strings | Boolean | Specifies whether same STRING or REAL contents will be inserted to all marked cells |
action | Col_action | Specifies the mode of insertion of new contents in to the selected cells |
Extended Definition:
The contents of an existing cell of a data table can be altered using the ‘SET’ command. The cells which will be altered can be are selected first and then the command is entered.
If the cell contains the same strings or reals as the one to be entered after alteration, then whether the strings is to be repeated or not is decided by the parameter ‘repeat_strings’. If the ‘repeat strings’ is set to ‘yes’ then all the selected will be replaced by new contents. On the other hand, if the ‘repeat_strings’ is set to ‘no’, then only first selected of the group will be replaced by the new contents, hence the new contents will appear only once. If the values are repeated for all the selected cells then the parameter ‘repeat strings’ need to be set to ‘yes’.
The parameter ‘string’ or ‘real’ is used to specify the new contents of the cell which may replace, append or prefix the existing contents of the cell. To specify how the new contents would be inserted in the existing cell contents, the parameter ‘action’ which has multiple options like ‘replace’, ‘append’, or ‘prefix’ is used.
Tips:
Select the cell to be altered first and then execute the command.