Programming Guide - Actian

Table Field OperationsFor example, the following code first checks whether the cursor is on a formfield. If it is, the code checks whether the current field is a table field. If thecurrent field is not a table field, the code sends an appropriate message to theuser.table_field = null;if CurFrame.InputFocusField is not null thentable_field =CurFrame.InputFocusField.WhichTableField();endif;if table_field is null thenmessage 'You must be in a table field tosort it.';resume;endif;If the input focus is not on any field when the WhichTableField method isinvoked, an error message is written to the trace window and the log file.This code checks that the field is not null before proceeding, thus preventingthe trace window message.If the field is a table field, the WhichTableField method returns the table fieldto the user-defined variable table_field. You can obtain information about thistable field using attributes and methods provided by the OpenROAD systemclasses. For example, you can:• Access array valuesTo manipulate values in the underlying array, you need a referencevariable that points to it. To load values from the underlying array into thearray reference variable, use the GetFieldValue method of the FieldObjectsystem class, for example:...tf_array = ArrayObject default null;...table_field.GetFieldValue(value = byref(tf_array));250 Programming Guide