145
Grid Properties
The Apostrophe Operator can be used with the unique logical identifier (ctl_id) to
dynamically read and alter a wide variety of control attributes (properties) directly
from the programming language. Most cell attributes are only accessible through the
implementation of properties. For example, drag and drop functionality requires the
'DraggedColumn, 'DraggedRow, 'DroppedOnColumn, and 'DroppedOnRow.
Note: In order to access many grid properties, cell(s) must be identified first using the
The complete list of properties available for manipulating a grid are described in
Cell Types
The following cell types can be assigned using the FMT= option in the GRID directive or
via the 'Celltype$ grid object property:
Cell works like a button if clicked. Cell can be changed if not
"Button"
locked (on double click). Set 'Lock property to 1 to achieve
standard button behaviour for cell.
Check box with no 3D effect ('Value=0 or 1,'Text=label).
"CheckBox"
"CheckBoxRaised" 3D check box that looks raised.
"CheckBoxRecessed" 3D check box that looks recessed.
Check box that uses a check mark.
"CheckMark"
"CheckMarkRaised" Raised check box that uses a check mark.
"CheckMarkRecessed" Recessed check box that uses a check mark.
Text cell that, when editing, allows user to make selection
"DropBox"
from a drop down list. The drop list is loaded from the
'Text$ property.
"DropBoxHideBtn" Same as "DropBox", but the drop down button is shown
only when focus is on the cell.
Normal text cell that will show "..." if text exceeds
"Ellipsis"
displayable area. Ctrl - Enter can be used to force a new line
in the cell (inserts $0D0A$ into cell value).
Same as "Ellipsis", but forces the cell to drop vertically
"EllipsisDrop"
only during an edit. Ctrl - Enter can be used to force a new
line in the cell (inserts $0D0A$ into cell value).
Small button at the right side of cell used to invoke lookup -
"Lookup"
button image is defined via the cell's 'Bitmap property. If no
image is given, button shows three dots.
Same as "Lookup", but indicates that the button is hidden
"LookupHideBtn"
when the cell is not selected.
Normal text cell that can contain multiple lines of text.
"Multi_line"
Ctrl - Enter can be used to force new line (value $0D0A$).
Normal text cell containing one line of data.
"Normal"
Same as "Lookup", but user is unable to edit the cell.
"Query"