GetSaveFileNameΒΆ
GetSaveFileName opens a dialog box to select a file name.
-
ssFilename = GetSaveFileName()
-
ssFilename = GetSaveFileName(ssDir)
-
ssFilename = GetSaveFileName(ssDir, ssFilter)
-
ssFilename = GetSaveFileName(ssDir, ssFilter, nFilterIndex)
-
ssFilename = GetSaveFileName(ssDir, ssFilter, nFilterIndex, ssTitle)
-
<ssFilename, nFilter> = GetSaveFileName()
-
<ssFilename, nFilter> = GetSaveFileName(ssDir)
-
<ssFilename, nFilter> = GetSaveFileName(ssDir, ssFilter)
-
<ssFilename, nFilter> = GetSaveFileName(ssDir, ssFilter, nFilterIndex)
-
<ssFilename, nFilter> = GetSaveFileName(ssDir, ssFilter, nFilterIndex, ssTitle)
Return Value
The function returns a scalar string containing the complete file name
(ssFileName). If the user chose the Cancel button, the function returns
an empty string (""
).
Parameters
-
ssDir
The parameter ssDir contains a path name. Example
c:/Program/UniPlot/Samples
. If ssDir is a complete file name the file name is used to initialize the File Name edit control.
-
ssFilter
ssFilter The filter string ssFilter contains one or more strings for the file format combo box. The filter string has the following structure:
"All files (*.*)|*.*|"
More than one filter can be specified. Example:"Text File (*.txt)|*.txt|All Files (*.*)|*.*|"
-
nFilterIndex
This parameter specifies which filter is selected when the dialog box is displayed on the monitor. Filter enumeration starts with 1.
-
ssTitle
Title of the dialog box.
Example
* GetSaveFileName();
d:/data/test.dat
* GetSaveFileName("c:", ..
"UniScript Files (*.ic)|*.ic|" + ..
"All Files (*.*)|*.*|").
See also
id-1115219