Action Statement
Add drawing statements to the contents of an object.
For Graphical Objects:
add to {G_OBJ_NAME|G_CLS_NAME} [at [position] X Y]
DRAWING_STATEMENT [...]
For Textual Regions:
add to {TR_NAME|TR_CLS_NAME} [at [position] ]
column COL_NO line line_NO
TEXT_DRAWING_STATEMENT [...]
For Image Regions:
add to {IR_NAME|IR_CLS_NAME}
INSERT_STATEMENT
For List Boxes:
add to {LB_NAME|LB_CLS_NAME}
INSERT_STATEMENT [...]
For Alphanumeric Spin Buttons:
add to {SB_NAME|SB_CLS_NAME}
INSERT_STATEMENT [...]
For Sliders:
add to {SL_NAME|SL_CLS_NAME}
INSERT_STATEMENT [...]
G_OBJ_NAME
The identifier for a graphical object.
G_CLS_NAME
The identifier for a class of graphical objects.
at X Y
The position in a graphical object at which these drawing statements begin. The graphics and text cursors move to the specified coordinates, and the drawing statements are added at that position.
DRAWING_STATEMENT
A drawing statement.
TR_NAME
The identifier for a textual region.
TR_CLS_NAME
The identifier for a class of textual regions.
IR_NAME
The identifier for an image region.
IR_CLS_NAME
The identifier for a class of image regions.
column COL_NO line line_NO
The column and line number (respectively) in the textual region at which the new drawing statements begin.
TEXT_DRAWING_STATEMENT
A textual drawing statement.
LB_NAME
The identifier for a list box.
LB_CLS_NAME
The identifier for a class of list boxes.
INSERT_STATEMENT
An insert string or insert file drawing statement.
SB_NAME
The identifier for an alphanumeric spin button.
SB_CLS_NAME
The identifier for a class of alphanumeric spin buttons.
SL_NAME
The identifier for a slider.
SL_CLS_NAME
The identifier for a class of sliders.
Description
The added contents are specified by the drawing statements or insert statements within this action statement. For image regions the inserted string must contain a hexadecimal represent of a recognized image format, e.g. JPEG or GIF.
When specifying an add to statement for a class of objects, the class must be made up of all the same types of objects: graphical objects, textual regions, tables, list boxes, sliders, or spin buttons.
See the add to TABLE_NAME action statement for information about tables.
Default Values
If you do not specify a position for graphical objects or textual regions, the drawing statements are added at the current position of the graphics cursor or text cursor, respectively.
Entries for list boxes are inserted according to the sorting order specified. If no sorting was specified, entries are inserted at the end of the list box.
If an insert file is performed for a list box, then each line from the file is inserted according to the sorting order specified. If no sorting was specified, the lines from the file are inserted at the end of the list box.
Entries for alphanumeric spin buttons are inserted at the end of the spin button.
If you do not specify a position when adding to a table, new rows or columns are added at the end of the table.
Example
response to Draw_PB
add to Plot_GR
draw to NewX NewY
response to UpDate_PB
add to Heading at position 300 100
" Today is: " date
response to StartReport_PB
add to Report_TR
at column 10 line 4
insert "memorandum"
...
response to OK_PB
add to Phone_List_LB
insert "555-1212"
See Also
add to TABLE_NAME Action Statement
change Action Statement
