interface data_table clear

Allows you to erase the contents of a 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.
This command helps to clear any cell contents of the data table.

Format:

 
interface data_table clear
data_table_name =
an existing GI_data_table
clear_target =
clear_opts

Example:

 
interface data_table clear &
data_table_name =
.gui.param.dtable &
clear_target =
changed_cell_highlights

Description:

 
Parameter
Value Type
Description
data_table _name
An Existing GI_data_table
Specifies the name of an existing data table
clear_target
Clear_opt
Specifies the action to be taken on the cell contents

Extended Definition:

1. The contents of a data table can be erased by clear command, when the ‘clear_target’ option is set to ‘cell_contents’
2. The contents of a cell in the data table get highlighted when the data table is edited. The highlighting can be cleared by choosing ‘changed_cell_highlights’ for clear command. This will preserve the contents of a cell, but the highlighting will be removed.

Tips:

The parameters ‘cell contents’ and ‘changed_cell_highlights’ are mutually exclusive.