The Table Objects: 3 TableClass Instance Data

TableClass is a subclass of VisCompClass . This lets you group Tables together with other Tables and other Vis objects. Note, however, that you are not permitted to add children to a Table object. When TableClass creates a VisText object to let users enter data, it makes that VisText a child of the Table ; if you try to add children to the TableClass , you will interfere with that process, and cause many unpredictable problems.

This section describes the instance data fields defined for TableClass . It also describes how to set, examine, and change those fields which are of interest to the application.

The TableClass has the following instance data:

Code Display 5-1 TableClass Instance Data

/* TI_rows specifies the number of rows in the table object. This field can be set 
 * dynamically with MSG_TABLE_SET_ROW_COUNT. This height includes the row 
 * separators.
 */
    @instance		word		TI_rows;

/* TI_columns specifies the total number of columns in the table. All columns must 
 * be visible at once (the table does not scroll horizontally). You must set this 
 * field in your source file; it cannot currently be set at run-time.
 */
    @instance		word		TI_columns;

/* TI_visibleRows contains the number of rows currently displayed. You must set 
 * this field in your source file; it cannot currently be set at run-time.
 */
    @instance		word		TI_visibleRows;

/* TI_topRow contains the row number of the first visible row. This is maintained 
 * automatically by the Table object; applications should not set this field.
 */
    @instance		word		TI_topRow;

/* TI_tableFlags contains a record of TableFlags. This record is described below 
 * in  Table Attributes.  */
    @instance		TableFlags		TI_tableFlags;

/* TI_rowFlags contains a record of TableRowFlags. This record is described below 
 * in  Working with Rows. */
    @instance		TableRowFlags		TI_rowFlags;

/* TI_columnDefinitions contains the chunk handle of a list of column definitions.
 * Column definitions are discussed in  Defining Columns. */
    @instance		ChunkHandle		TI_columnDefinitions;

/* TI_rowHeight specifies the height of each row in "points" (72 points = 1 inch). 
 * You must set this in your source code; there is no way to change this 
 * dynamically.
 */
    @instance		word		TI_rowHeight;

/* This field specifies the Table object's TableBorderFlags, which specify the 
 * border and bounds for the Table object. TableBorderFlags are described 
 * below in  Table Attributes. */
    @instance		TableBorderFlags			TI_borderFlags;

/* The following instance data fields are for internal use by the Table object. 
 * You should not set, inspect, or change any of these fields, either in your
 * source code or at run-time.
 */

    @instance		TableCellLocation			TI_currentSelectionStart = 
	{ T_NONE_SELECTED, T_NONE_SELECTED };

    @instance		TableCellLocation			TI_currentSelectionEnd = 
	{ T_NONE_SELECTED, T_NONE_SELECTED };

    @instance		TableCellLocation			TI_lastSelectionStart = 
	{ T_NONE_SELECTED, T_NONE_SELECTED };

    @instance		TableCellLocation			TI_lastSelectionEnd = 
	{ T_NONE_SELECTED, T_NONE_SELECTED };

    @instance		Rectangle			TI_bounds = {0, 0, 0, 0};

    @instance		TableRangeInversionType			TI_tableRangeInversion;

    @instance		TableCellLocation			TI_lastCell = {
			T_NONE_SELECTED, 
			T_NONE_SELECTED};

    @instance		TableSelectionDrawStyleType 			TI_selectionDrawStyle;

    @instance		TablePrivateFlags			TI_privateFlags;

    @instance		ChunkHandle			TI_textObj;

2 TableClass Overview | Next:

4 Using a Table Object