Navigation:  Programmer's Reference > Executing DPlot commands from another application > MoveCurves macro command

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 or character strings; character string parameters are always bound by double quotation marks.

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.

---

 

Moves (move=1) or copies (move=0) the index'th curve (or all curves for index=-1) from the reference document to the document with caption "destination" or, if the DocNum form is used, to the document with index DocNum. If destination is blank (or DocNum=0), the curve or curves are placed in a new document.

NOTE: For this command to work as expected with existing destination documents and the “destination” form, the destination document's caption must be known. DPlot will always generate a unique document caption, regardless of the use of the Caption command. For example, if your application uses the Caption command on two separate documents with the name set to "My New Plot" in both cases, DPlot will name the second document "My New Plot1". You can poll DPlot for a list of all document captions with this sequence of commands (Visual Basic):

 

Text1.LinkTopic = "DPlot|System"

Text1.LinkMode = 2

Text1.LinkItem = "Topics"

Text1.LinkRequest

Text1.LinkMode = 0

 

The Text1 text box will then be filled with a series of null-terminated strings. Two consecutive 0 bytes indicate the end of the string. The first and second strings will always be "XYPlot" and "System". The third and subsequent strings will be the captions of all open document windows. Given the list of all active documents, your application can then generate another caption for a new document that you know with certainty will be unique. You may then use the FileNewEx command to open a new document with that caption.

Alternatively, if the destination document was created via calls to DPLOTLIB functions, then the document index DocNum will have been returned by the function that created the document.

 

 

---

Page url: http://www.dplot.com/help/index.htm?movecurvescommand.htm