Programming with Reflection

image\rwnprg32.gif GetSaveAsFileName method


Syntax FileName = object.GetSaveAsFileName(InitialFilename, FileFileter, FilterIndex, Title, ButtonText)



Opens the standard Save As dialog box and gets a file name from the user without actually saving any files.


InitialFilename Argument type: String
Specifies a suggested file name. If this argument is omitted, no default file name is suggested.

FileFilter Argument type: String
Specifies one or more file filtering criteria. These are used to fill a List files of type list box in the dialog box, and allow the user to select from different types of files to save.

 A file filtering criterion has two parts, separated by a comma: A description, such as "Text Files (.txt)" or "Settings Files (*.rsf)", and an MS-DOS wildcard file filter specification corresponding to that type of file, such as "*.txt" or "*.rsf". You can specify a single file filtering criterion:

 "Text Files (*.txt),*.txt"

 Or multiple file filtering criteria, separated by commas:

 "Text Files (*.txt),*.txt, Bitmaps (*.bmp),*.bmp"

 If this argument is omitted, *.rbs and *.txt files are listed.

FilterIndex Argument type: Integer
Identifies the default FileFilter—that is, what type of file is listed in the file type list box when the dialog box first opens. Use 1 to specify the first FileFilter, 2 to specify the second FileFilter, and so on.

Title Argument type: String
Specifies a title for the dialog box. If this argument is omitted, the title is "Save As".

ButtonText Argument type: String
Specifies the text for the default button in the dialog box. If this argument is omitted, the text is "Save."


FileName Return type: String
The file name (including drive and path information) the user selects, or an empty string if the user selects Cancel.


image\jump.gif Example

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this command