Programming Guide - Actian

Table FieldsTable Fields and Associated ArraysThere are three ways to create a table field in OpenROAD Workbench:• You can create an activefield for each column, select them all, and thengroup them into a Tablefield.• You can Create Fields from Database Table, and select the table fieldoption.• You can Create Fields from User Class, and select the table field option.If you do not create the table field from a UserClass, OpenROAD provides adefault unnamed user class for the underlying array. If you created the tablefield using a Group, the attribute names correspond to the names of theactivefields that were grouped and have data types corresponding to theactivefield's data types. If you created the table field from a database table,the names and values of the attributes correspond to the column names anddata types of the table.The data type of the array variable associated with the table field is theUserClass associated with it, either a named one, or the default unnamed one.The correspondence between array attributes and table field columnsfacilitates selection of multiple rows from a database table into the fielddisplay.TableField, ColumnField, and ProtoField ObjectsWhen you create a table field, OpenROAD initializes a TableField object for thetable field and one ColumnField object for each column in the table field. TheTableField object provides access to the following table field components:• Visual, such as the width of the outline around the table field• Operational, such as setting the input focus to a specific cell• Textual, such as the text of its titleThe ColumnField objects give access to the following column field components:• Visual, such as the background color of its prototype field, ProtoField• Textual, such as the text of its title228 Programming Guide