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 (*.*)|*.*|").

id-1115219