Syntax of DISPLAY ARRAY instruction
The DISPLAY ARRAY
instruction controls
the display of a program array on the screen.
Syntax
DISPLAY ARRAY array TO screen-array.*
[ HELP help-number ]
[ ATTRIBUTES ( { display-attribute
| control-attribute }
[,...]) ]
[ dialog-control-block
[...]
END DISPLAY ]
where dialog-control-block is one of:
{ BEFORE DISPLAY
| AFTER DISPLAY
| BEFORE ROW
| AFTER ROW
| ON IDLE seconds
| ON TIMER seconds
| ON ACTION action-name
[ ATTRIBUTES ( action-attributes-display-array ) ]
| ON FILL BUFFER
| ON SELECTION CHANGE
| ON SORT
| ON APPEND [ ATTRIBUTES ( action-attributes-listmod-triggers ) ]
| ON INSERT [ ATTRIBUTES ( action-attributes-listmod-triggers ) ]
| ON UPDATE [ ATTRIBUTES ( action-attributes-listmod-triggers ) ]
| ON DELETE [ ATTRIBUTES ( action-attributes-listmod-triggers ) ]
| ON EXPAND ( row-index )
| ON COLLAPSE ( row-index )
| ON DRAG_START ( dnd-object )
| ON DRAG_FINISH ( dnd-object )
| ON DRAG_ENTER ( dnd-object )
| ON DRAG_OVER ( dnd-object )
| ON DROP ( dnd-object )
| ON KEY ( key-name [,...] )
}
dialog-statement
[...]
where action-attributes-display-array
is:
{ TEXT = string
| COMMENT = string
| IMAGE = string
| ACCELERATOR = string
| DEFAULTVIEW = { YES | NO | AUTO }
| CONTEXTMENU = { YES | NO | AUTO }
| ROWBOUND
[,...] }
where action-attributes-listmod-triggers
is:
{ TEXT = string
| COMMENT = string
| IMAGE = string
| ACCELERATOR = string
| DEFAULTVIEW = { YES | NO | AUTO }
| CONTEXTMENU = { YES | NO | AUTO }
[,...] }
where dialog-statement is one of:
{ statement
| EXIT DISPLAY
| CONTINUE DISPLAY
| ACCEPT DISPLAY
}
where
display-attribute
is:{ BLACK | BLUE | CYAN | GREEN
| MAGENTA | RED | WHITE | YELLOW
| BOLD | DIM | INVISIBLE | NORMAL
| REVERSE | BLINK | UNDERLINE
}
where
control-attribute
is:{ ACCEPT [ = boolean ]
| CANCEL [ = boolean ]
| KEEP CURRENT ROW [ = boolean ]
| HELP = help-number
| COUNT = row-count
| UNBUFFERED [ = boolean ]
| DETAILACTION = action-name
| DOUBLECLICK = action-name
| ACCESSORYTYPE = { DETAILBUTTON | DISCLOSUREINDICATOR | CHECKMARK }
| FOCUSONFIELD
}
- array is a static or dynamic array containing the records you want to display.
- screen-array is the name of the screen array used to display data.
- help-number is an integer that associates a help message number with the instruction.
- action-name identifies an action that can be executed by the user.
- seconds is an integer literal or variable that defines a number of seconds.
- row-index identifies the program variable which holds the row index corresponding to the tree view node that has been expanded or collapsed.
- dnd-object references a
ui.DragDrop
variable defined in the scope of the dialog. - key-name is an hot-key identifier (such as
F11
orControl-z
). - statement is any instruction supported by the language.
- row-count defines the total number of rows for a static array.
- boolean is a boolean expression that evaluates to
TRUE
orFALSE
. - action-attributes are dialog-specific action attributes.