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

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

 

[SavePreferences("filename")]

JR   Viewer

Reads a preferences file which may subsequently be read by the File>Get Preferences menu command or a GetPreferences macro command. If a path is not specified, the default preferences folder is assumed (%APPDATA%\DPlot\Preferences on Windows 2000, XP, and Vista). If a filename extension is not included, ".set" is appended.

|DOCNAME|

If filename contains the text |DOCNAME| (including the enclosing pipe symbol |, and must be uppercase), |DOCNAME| will be replaced by the name appearing in the title bar of the document, minus any filename extension if present. Generally the document title is the name of the first file opened for the document or the name of a DPlot file if you save the document to that format, or Plot1, Plot2, etc. if a file has not been opened or saved. The document title may be changed with a Caption command.

For example if the document caption is [mydata.csv], then:

"|DOCNAME|" will be replaced with "%APPDATA%\DPlot\Preferences\mydata.set"

"c:\folder\|DOCNAME|" will be replaced with "c:\folder\mydata.set"

"c:\folder\|DOCNAME|.pref" will be replaced with "c:\folder\mydata.pref"

 

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