_Application.GetSaveAsFilename(Object, Object, Object, Object, Object) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Displays the standard Save As dialog box and gets a file name from the user without actually saving any files.
public object GetSaveAsFilename (object InitialFilename, object FileFilter, object FilterIndex, object Title, object ButtonText);Public Function GetSaveAsFilename (Optional InitialFilename As Object, Optional FileFilter As Object, Optional FilterIndex As Object, Optional Title As Object, Optional ButtonText As Object) As ObjectParameters
- InitialFilename
- Object
Optional Object. Specifies the suggested file name. If this argument is omitted, Microsoft Excel uses the active workbook's name.
- FileFilter
- Object
Optional Object. A string specifying file filtering criteria.This string consists of pairs of file filter strings followed by the MS-DOS wildcard file filter specification, with each part and each pair separated by commas. Each separate pair is listed in the Files of type drop-down list box. For example, the following string specifies two file filters, text and addin: "Text Files (.txt), .txt, Add-In Files (.xla), .xla".To use multiple MS-DOS wildcard expressions for a single file filter type, separate the wildcard expressions with semicolons, for example, "Visual Basic Files (.bas; .txt),.bas;.txt".If omitted, this argument defaults to "All Files (.),.".
- FilterIndex
- Object
Optional Object. Specifies the index number of the default file filtering criteria, from 1 to the number of filters specified in FileFilter. If this argument is omitted or greater than the number of filters present, the first file filter is used.
- Title
- Object
Optional Object. Specifies the title of the dialog box. If this argument is omitted, the default title is used.
- ButtonText
- Object
Optional Object. Macintosh only.
Returns
Remarks
This method returns the selected file name or the name entered by the user. The returned name may include a path specification. Returns False if the user cancels the dialog box.
This method may change the current drive or folder.