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

XYLabel 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.


 

[XYLabel(XY,location,offset,"label")]

JR   Viewer

Draws the text label at or near the X, Y, or Z axis, depending on the location and offset settings.

XY        X or Y value, in plot space, where the label will be located.

location        Specifies the axis near which the label will be drawn.

0        Lower X axis

1        Upper X axis

2        Left Y axis

3        Right Y axis

4        Z axis

offset        Distance, in inches, between the axis and the label.

For 3D views of 3D or 4D data, the labels will always be drawn on the same side of the plot that the numbers along the coordinate axes are drawn.

This command is useful for replacing numeric values along an axis with non-numeric labels, particularly for bar charts. To hide the normal numbers appearing on an axis, set the number format to "None": [NumberFormat(0,12)] for the X axis, [NumberFormat(1,12)] for the Y axis.

 


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