ProvideX V8.20 > Language Reference > 2. Directives
147
Format 1: Define/Create
GRID ctl_id,@(col,ln,wth,ht)[,ctrlopt]
Use this format to create your grid. The value in ctl_id is a unique identifier for your grid.
This value is used to generate a CTL value whenever the grid is selected and changed.
Format 2: Remove Grid
GRID REMOVE ctl_id[,ERR=stmtref]
Use this format to delete an entire grid.
Format 3: Disable/Enable
GRID {DISABLE | ENABLE} ctl_id[,ERR=stmtref]
Use the GRID DISABLE format to disable a grid so that it will be visible but
inaccessible to users. To reactivate it, use GRID ENABLE.
Format 4: Lock/Unlock
GRID {LOCK | UNLOCK} ctl_id,col,row[,width,height][,ERR=stmtref]
Use the GRID LOCK format to allow/deny access to a range of cells in the grid. The user
cannot change the cell's value, but if the cell is a button control the user can still click on
it. Use the GRID UNLOCK format to release the locked range of cells for other processes.
Reminder: If you use zero (0) as your value for both column and row, ProvideX
interprets that as all columns and rows, respectively and will lock/unlock the entire grid.
You can also use a grid control object's properties to lock or unlock cells (by setting
the 'Row, 'Column and 'Lock properties). Set your 'Lock value to 1 (lock) or 0
(zero to unlock). The default background colour for locked cells is LIGHT GRAY
(standard button face colour). Use the 'BackColour property to override this. See
Note: The current functionality for the 'Sort and 'Sort$ properties will override
locked rows.
Format 5: Hide/Show
GRID {HIDE | SHOW} ctl_id[,ERR=stmtref]
With the GRID HIDE format, the grid remains active, but is not displayed. It is still
accessible programmatically. Use the SHOW format to restore the display and user access.