ProvideX V8.20 > Language Reference > 2. Directives
43
CHART Directive
       Control Chart
Formats
1.Define/Create: CHART ctl_id,@(col,ln,wth,ht),[,ctrlopt]
2.Remove: CHART REMOVE ctl_id[,ERR=stmtref]
3.Disable/Enable: CHART {DISABLE | ENABLE} ctl_id[,ERR=stmtref]
4.Hide/Show: CHART {HIDE | SHOW} ctl_id[,ERR=stmtref]
5.Load: CHART LOAD ctl_id,strvar$[,ERR=stmtref]
6.Clear Data: CHART CLEAR ctl_id[,ERR=stmtref]
7.Clear Data & Titles: CHART DELETE ctl_id[,ERR=stmtref]
8.Retrieve Value: CHART FIND ctl_id,dataset, point,{numvar|label$}[,ERR=stmtref]
9.Read Selected Set: CHART READ ctl_id, dataset,eom$[,ERR=stmtref]
10. Update Existing Values: CHART WRITE ctl_id,dataset,point,{numvar|label$}[,ERR=stmtref]
Where
@(col,ln, Position and size of the check box region. Numeric expressions.
wth,ht)
Column and line coordinates for top left corner, width in number of
columns and height in number of lines.
ctl_id
Unique logical identifier for the chart (any integer -32000 to +32000). Avoid
integers that conflict with keyboard definitions (e.g., 4 cancels CTL=4 for the
F4 key) or Negative CTL Definitions, p.822. Use this value with the
apostrophe operator to access various Chart Properties.
Control options. Supported options for CHART include:
ctrlopt
ERR=stmtref Error transfer
FMT=def$ See Chart Formats listed below.)
FNT="font" Font name (size controlled by window coordinates).
OPT=char$ (See Attribute/Behaviour Settings below).
SEP=char$ Delimiter character. Hex or ASCII string value.
TIP=text$ Mouse pointer message. To change the colour, refer to the
'TC'= System Parameter, p.686.
Chart Formats (for FMT=def$): 2DLINE (default), 2DAREA, 3DAREA,
2DBAR, 3DBAR, 2DCOLUMN, 3DCOLUMN, 3DLINE, 2DPIE, 3DPIE, 2DRIBBON,
3DRIBBON, 2DSCATTER, 3DSCATTER, 2DSTACK, 3DSTACK.
Attribute/Behaviour Settings (for OPT=char$):
"B" - Chart has no border or frame.
"D" - Initially disabled
"d" - Permanently disabled
"H" - Chart is initially hidden
"h" - Permanently hidden.
"G" - Keep active on focus change to a new/non-concurrent window.
Some OPT= characters may be combined. Invalid settings are ignored.
dataset
Dataset from which values will be drawn.
numvar
Name of variable that will contain returned numeric data value.
eom$
EOM character sequence used to select the set. Hex string expression.