Macro commands may be used either in macros or by sending the commands to DPlot via dynamic data exchange (DDE). Some commands are valid only in macros (noted by Macros Only). Commands sent to DPlot via DDE must be enclosed by square brackets [ ]. Macro commands should not include the brackets.
Command parameters shown in the descriptions below are placeholders for the actual values. Command parameters are either numeric values, equations that evaluate to numbers, or character strings. Character string parameters are always bound by double quotation marks. Equations must be preceded by an equals sign (=).
The pipe symbol (|) in the command syntax indicates that a parameter is optional, and should not be included in your macro unless otherwise noted.
All indices into arrays are 1-based, e.g. Curve1=1 refers to the first curve in a plot.
A 0x prefix for numbers in the descriptions below indicates hexadecimal notation; e.g. 0x0010 = 16.
JR/Viewer indicates that the command is supported by DPlot Jr or DPlot Viewer.
JR/Viewer indicates that the command is NOT supported by DPlot Jr or DPlot Viewer.
Replaces the data points in an XY plot for curve with 1-based index destination with the data from curve with index source and deletes curve source. This command is particularly useful when you need to update an existing saved plot with updated data. Legend, point labels, symbol and line styles, and drawing order for the destination curve are preserved.
replaces the data points in curve 2 with the data from curve 5, and deletes curve 5.
replaces the data points in curve 3 with data from the first curve (if any) whose legend contains the character string "New Curve", then deletes that curve.
This command results in an error if either destination or source are less than 1 or greater than the number of curves in the active plot, or if destination=source.
Numeric curve indices may be replaced by substituting LegendHas("substring1"|,"substring2"|,"substring3"||). When this feature is used, DPlot will search for a curve whose legend entry contains substring1 and optionally substring2 and substring3. The index of the first curve whose legend matches that criteria will be substituted for LegendHas(...). If no match is found, no substitution is performed. Searches are case-specific.
For example, [SelectCurve(LegendHas("ABC","GHI"))] will search for a curve whose legend contains both ABC and GHI.
"ABCDEFGHI" is a positive match; "ABCDEFGH" is not. Neither is "abcdefghi".
LegendHas(...) may be used in any command in place of a curve or data set index.