Application.GetSaveAsFilename メソッド (Excel)Application.GetSaveAsFilename method (Excel)

ユーザーからファイル名を取得するために、[名前を付けて保存] ダイアログ ボックスを表示します。ダイアログ ボックスで指定したファイルは、実際には保存されません。Displays the standard Save As dialog box and gets a file name from the user without actually saving any files.

構文Syntax

expression.expression. GetSaveAsFilename( _InitialFilename_ , _FileFilter_ , _FilterIndex_ , _Title_ , _ButtonText_ )

expressionApplication オブジェクトを表す変数です。expression A variable that represents an Application object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
InitialFilenameInitialFilename 省略可能Optional バリアント型 (Variant)Variant 推奨されるファイル名を指定します。Specifies the suggested file name. この引数を省略すると、Microsoft Excel は、作業中のブックの名前を使用します。If this argument is omitted, Microsoft Excel uses the active workbook's name.
FileFilterFileFilter 省略可能Optional バリアント型 (Variant)Variant ファイルの候補を指定する文字列 (ファイル フィルター文字列) を指定します。A string specifying file filtering criteria.
FilterIndexFilterIndex 省略可能Optional バリアント型 (Variant)Variant _FileFilter_で指定されているフィルターの数を 1 から、既定ファイル フィルター文字列のインデックス番号を指定します。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.
TitleTitle 省略可能Optional バリアント型 (Variant)Variant ダイアログ ボックスのタイトルを指定します。Specifies the title of the dialog box. この引数を省略すると、既定のタイトルが使用されます。If this argument is omitted, the default title is used.
ButtonTextButtonText 省略可能Optional バリアント型 (Variant)Variant Macintosh でのみ指定できます。Macintosh only.

戻り値Return value

バリアント型Variant

解説Remarks

_FileFilter_引数で渡された文字列は、ファイル フィルター文字列は、MS-DOS ワイルドカード、各部品に続いてのペア、コンマで区切られたそれぞれのペアで構成されます。This string passed in the FileFilter argument 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. 次の文字列が 2 種類のフィルター、テキスト、およびアドインのファイルを指定するたとえば、:"テキスト ファイル (*.txt)、 .txt ファイル、アドインのファイル (.xla)、ペア」です。For example, the following string specifies two file filters, text and addin: "Text Files (*.txt), .txt, Add-In Files (.xla), *.xla".

1 つのファイル フィルター文字列に複数のワイルドカードを対応させるには、"Visual Basic ファイル (.bas;.txt),.bas;.txt" のように各ワイルドカードをセミコロン (;) で区切ります。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".

このメソッドは、選択したファイル名またはユーザーが入力した名前を返します。This method returns the selected file name or the name entered by the user. 返される名前は、パス指定を含む場合があります。The returned name may include a path specification. ユーザー ダイアログ ボックスをキャンセルする場合はFalseを返します。Returns False if the user cancels the dialog box.

このメソッドを実行することによって、カレント ドライブやカレント フォルダーが変更される可能性があります。This method may change the current drive or folder.

Example

この例をテキスト ファイルにファイル フィルターを使用して、[名前を付けて保存] ダイアログ ボックスを表示します。This example displays the Save As dialog box, with the file filter set to text files. ユーザーがファイル名を選択した場合の例は、メッセージ ボックスにそのファイル名を表示します。If the user chooses a file name, the example displays that file name in a message box.

fileSaveName = Application.GetSaveAsFilename( _ 
 fileFilter:="Text Files (*.txt), *.txt") 
If fileSaveName <> False Then 
 MsgBox "Save as " & fileSaveName 
End If

関連項目See also

Application オブジェクトApplication Object