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

TextNote macro command

Print this Topic Previous pageReturn to chapter overviewNext page

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.


 

[TextNote("Note",X,Y,Frame,Opaque,Button,TabStops)]

JR   Viewer

Obsolete (though still supported). Use TextNoteEx.

Adds a notation to the plot. Note is the text of the notation. X,Y are the coordinates of the upper left corner of the note, expressed as a percentage of the plot size (0.0 to 1.0). Frame = 1 to draw a rectangle around the note. Opaque = 1 to hide any objects intersecting the note. Button = 1 if the note is "activated" with a button. TabStops is the number of character cells used for tab positioning. See the Add/Edit Note command for more information.

To break a note into multiple lines, you may either embed carriage return-line feed sequences into the note text, or include the literal sequence "\n". The latter method is the only way to include line breaks in a note produced by a macro. Examples:

In VB/VBA:

Control.LinkExecute "[TextNote(""Line 1" & chr$(13) & chr$(10) & "Line 2"",0.1,0.1,1,1,0,8)]"

In C/C++, using DPLOTLIB:

DPlot_Command(DocNum,
"[TextNote(\"Line 1\r\nLine 2\",0.1,0.1,1,1,0,8)]");

In Fortran, using DPLOTLIB:

ret=DPlot_Command(DocNum,
'[TextNote("Line 1\nLine 2",0.1,0.1,1,1,0,8)]'//char(0))

In a macro:

[TextNote("Line 1\nLine 2",0.1,0.1,1,1,0,8)]

 


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