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

BkPlotColor 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, 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.



JR   Viewer

Sets the background color for a 2D plot. By default DPlot uses the Windows' window background color for the background of plots. The window background color may be set by right-clicking on your desktop and selecting Properties, then the Appearance tab, then the Advanced button. If color is -1, the document window background color will be used (set with BkColor). If that color value is also set to -1, then the window background color set with Control Panel is used. color is in the form (blue*65536)+(green*256)+red, where blue, green, and red range from 0 to 255. The color value may be expressed as a decimal or hexadecimal value; hexadecimal notation should include a "0x" prefix. For example 0x00FF00FF and 16711935 both represent magenta (blue=red=255, green=0).

Please note: Use caution with this setting. If used and color is not equal to -1, then the specified color will be used on all output, including printed plots. (By default the background is not painted on printed output.) A colored background will of course consume much more ink than a transparent background.

To set the background color for the entire plot, including areas outside the coordinate axes, see BkColor. BkColor and BkPlotColor are not mutually exclusive: you can use BkColor to set the color of areas outside the coordinate axes and BkPlotColor for the area bound by the axes.


See also

Colors menu command


Page url: