Set the update state of a graph object.
Syntax
graph_name.setupdate(options) [sample]
Follow the name of the graph with a period, the keyword setupdate, and the update setting.
Optionally, include a sample with the “manual” or “automatic” options to restrict updates to data changes made within the sample period. If you do not include a sample, updates will occur according to changes in the workfile sample.
Options
“off” or “o” | Turn updating off. |
“manual” or “m” | Update when requested (with the
Graph::update command), or when the graph type is changed. |
“auto” or “a” | Update whenever the update condition is met. If a sample is specified, an update will occur when data changes within the sample. If no sample is specified, updates will occur when data or the workfile sample changes. |
Examples
gr1.setupdate(o)
This command turns off updating for graph GR1.
gr1.setupdate(a)
turns on automatic updating for graph GR1, according to the workfile sample. Whenever the underlying data or the workfile sample changes, GR1 will be updated with the changes.
gr2.setupdate(m) 1992 1993
turns on manual updating for graph GR2, for the sample period 1992 to 1993. When the graph is manually updated, using the
update command, changes in data between 1992 and 1993 will be updated.
Cross-references
See
“Graph Objects” for a discussion of graph updating options.