interface data_table write
Allows you to write the contents of a data table field to a file.
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 contents of a data table can be directly stored in a file, for example, excel sheet or a tab delimited text file.
Format:
interface data_table write |
|---|
data_table_name = | An Existing GI_data_table |
file_name = | String |
row_labels = | Boolean |
column_labels = | Boolean |
Example:
interface data_table write & |
|---|
data_table_name = | .gui.atv.dtable1 & |
file_name = | "C:/data_2.xls" |
Description:
Parameter | Value Type | Description |
|---|
data_table _name | An Existing GI_data_table | Specifies the name of an existing data table to be displayed |
file_name | String | Specifies the remote file name to be accessed |
row_labels | String | Specifies whether existing row labels to be exported |
column_labels | String | Specifies whether existing column labels to be exported |
Extended Definition:
1. ‘File_name’ specifies the name of the file that is to be read, written, or executed. The proper extension is the default but can be overridden by simply supplying a different extension. You do not need to enclose the file name in quotes if it only contains alpha-numeric characters and starts with a letter. If you want to include other characters, such as a '.' for an extension or '/' or '[]' for directory paths, you must enclose the name in quotes.
2. If the BOOLEAN value for ‘row labels’ and ‘column labels’ is ‘yes’ then existing labels of the rows and columns are exported along with the data_table contents.