Programmer's Reference > Sending data to DPlot from another application

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.

[XY(x,y)]

JR Viewer

Adds a data point to the curve selected with the SelectCurve command. If this operation would cause the number of points in the curve to exceed the array sizes (set with FileArrays), DPlot returns DDE_FNOTPROCESSED to a DDE client, or causes an error in the DPlot macro facility. The x and y value must be separated by a comma. Both the x and y values can be represented as times (e.g. 09:24:45.01 PM), dates, or date and time groups (with a space between the date and time).

NOTE: Executing multiple [XY()] commands on a Windows 95 or 98 system is very slow, while on Windows 2000 and later systems is only slightly slower than sending binary data via an XTYP_POKE transaction (as in the DPLOTLIB demo programs). If you are developing an application for users who might be using Windows 95 or 98, and yours is not a real-time application that plots results as they occur, you should consider either:

Using the [XYXY()] command to send multiple data pairs rather than individual [XY()] commands.

Or:

Preface a series of [XY()] commands with a [PostponeRedraw()], and terminate the series of [XY()] commands with a [ViewRedraw()].

The former (using [XYXY()] will in all cases be faster but might not always be practical. The latter will delay redrawing the plot until the ViewRedraw command is sent.

____________________________