Syntax

SaveFilename$[([title$ [,extensions$]])]

Description

Displays a dialog box that prompts the user to select from a list of files and returns a String containing the full path of the selected file.

Comments

The SaveFilename$ function accepts the following parameters:

Parameter

Description

title$

String containing the title that appears on the dialog box's caption. If this string is omitted, then "Save As" is used.

extensions$

String containing the available file types. Its format depends on the platform on which the Basic Control Engine is running. If this string is omitted, then all files are used.

The SaveFilename$ function returns a full pathname of the file that the user selects. A zero-length string is returned if the user selects Cancel. If the file already exists, then the user is prompted to overwrite it.

e$ = "All Files:*.BMP,*.WMF;Bitmaps:*.BMP;Metafiles:*.WMF"
f$ = SaveFilename$("Save Picture",e$)

Example

This example creates a save dialog box, giving the user the ability to save to several different file types.

Sub Main()
  e$ = "All Files:*.BMP,*.WMF;Bitmaps:*.BMP;Metafiles:*.WMF"
  f$ = SaveFilename$("Save Picture",e$)
  If Not f$ = "" Then
    Msgbox "User choose to save file as: " + f$
  Else
    Msgbox "User canceled."
  End IF
End Sub

See Also

MsgBox (statement); AskBox (function); AskPassword$ (function); InputBox, InputBox$ (functions); OpenFilename$ (function); SelectBox (function); AnswerBox (function).

Note

The extensions$ parameter must be in the following format:

 description:ext[,ext][;description:ext[,ext]]...

Placeholder

Description

description

Specifies the grouping of files for the user, such as All Files.

ext

Specifies a valid file extension, such as *.BAT or *.?F?.

For example, the following are valid extensions$ specifications:

  "All Files:*"
  "Documents:*.TXT,*.DOC"
  "All Files:*;Documents:*.TXT,*.DOC"

S