GetOpenFilename メソッド
ユーザーからファイル名を取得するために、[ファイルを開く] ダイアログ ボックスを表示します。ダイアログ ボックスで指定したファイルは、実際には開かれません。
Syntax
式 .GetOpenFilename(FileFilter, FilterIndex, Title, ButtonText, MultiSelect)
式 Application オブジェクトを表す変数です。
パラメーター
名前 |
必須かどうか |
データ型 |
説明 |
---|---|---|---|
FileFilter |
オプション |
Variant (バリアント型) |
ファイル フィルター基準を指定する文字列。 |
FilterIndex |
オプション |
Variant (バリアント型) |
引数 FileFilter で指定したファイル フィルター文字列の中で、1 から何番目の値を既定値とするかを指定します。この引数を省略するか、ファイル フィルター文字列の数より大きい数値を指定すると、最初のファイル フィルター文字列が既定値となります。 |
Title |
オプション |
Variant (バリアント型) |
ダイアログ ボックスのタイトルを指定します。この引数を省略すると "ファイルを開く" になります。 |
ButtonText |
オプション |
Variant (バリアント型) |
Macintosh のみ |
MultiSelect |
オプション |
Variant (バリアント型) |
True を指定すると、複数のファイルを選択できます。False を指定すると、1 つのファイルしか選択できません。既定値は False です。 |
戻り値
バリアント
注
引数 FileFilter には、ファイル フィルター文字列とワイルドカードのペアを、必要な数だけ指定します。ファイル フィルター文字列とワイルドカードはコンマ (,) で区切り、各ペアもコンマで区切って指定します。各ペアは、[ファイルの種類] ボックスのリストに表示されます。たとえば、テキストとアドインの 2 つのファイル フィルターは、"テキスト ファイル (*.txt),*.txt,アドイン ファイル (*.xla),*.xla" のように指定します。
1 つのファイル フィルター文字列に複数のワイルドカードを対応させるには、"Visual Basic ファイル (*.bas;*.txt),*.bas;*.txt" のように各ワイルドカードをセミコロン (;) で区切ります。
引数 FileFilter を省略すると、"すべてのファイル (*.*),*.*" を指定したことになります。
このメソッドは、ユーザーによって選択、または入力されたファイルの名前とパス名を返します。引数 MultiSelect が True の場合は、選択されたファイルの名前の配列が返されます。選択されたファイルが 1 つでも、配列として返されます。入力が取り消された場合には False が返されます。
このメソッドを実行することによって、カレント ドライブやカレント フォルダーが変更される可能性があります。
使用例
次の使用例は、[ファイルを開く] ダイアログ ボックスを、ファイルの種類をテキスト ファイルに限定して表示します。ファイル名を選択すると、そのファイル名がメッセージ ボックスに表示されます。
fileToOpen = Application _
.GetOpenFilename("Text Files (*.txt), *.txt")
If fileToOpen <> False Then
MsgBox "Open " & fileToOpen
End If
注意
機械翻訳についての免責事項: この記事の翻訳はコンピューター システムによって行われており、人間の手は加えられていません。マイクロソフトでは、英語を話さないユーザーがマイクロソフトの製品、サービス、テクノロジに関するコンテンツを理解するのに役立てるため、こうした機械翻訳を提供しています。記事は機械翻訳されているため、用語、構文、文法などに誤りがある場合があります。