Open the Save As dialog
X-Function not designed for Auto GetN Dialog. That is, the following cannot be used:
1. dlgSave; // save the file name to string fname$
2. dlgSave fname:=myfile; // save the file name to myfile$
3. dlgSave ext:=*.ogs title:="Saving GIF file location"; // Initialize the dialog with file extension ogs and title "Saving GIF file location".
Please refer to the page for additional option switches when accessing the x-function from script
The string that will receive path and name of the user's chosen file.
Optional string used to initialize the dialog with settings from a file extension group.
Optional string used to initialize the file path (for opening, saving, etc.) in the dialog.
Optional string used to set the dialog's title.
This X-Function opens a dialog asking user to "create" a file. When the file name and path is specified, the full path file name is saved to a variable. And the file is not saved.
This example finds and imports files satisfied certain condition, and then create a video based graphs of these data.
string fname$;//all the XF that deals with files default to fname$ string
//Find files and import them
findFiles path:=system.path.program$+"Samples\Curve Fitting" ext:="*.dat" addpath:=1;//result in fname$
//import from fname$, ImpMode=3 for new book
impasc option.sparklines:=0 option.ImpMode:=3 Options.Names.FNameToBk:=0;
//Create graphs with only the 1st 2 columns
doc -e W
plotxy iy:=(1,2) plot:=200; window -ia;
//Specify the path and name of the video file.
dlgSave ext:=*.avi title:="Saving Video file location";
int err = vw.Create(%(fname$));
doc -e P
type -a "File saved to %(fname$)";