FileSelect

ファイルを開く、または保存するための標準的なダイアログを表示します。

SelectedFile := FileSelect(Options, RootDir\Filename, Title, Filter)

パラメータ

Options

型：文字列または整数

省略したときは、初期設定は0となります。次のオプションが何も設定されないのと同じです。そうでなければ、数字または次の文字を指定します。文字の後に数字が組み合わされることもあります。例えば、"M"、"1、"M1"はすべて有効です（ただし、同等ではありません）。

D：フォルダー（ディレクトリ）を選択します。Dを指定すると、ファイルではなくフォルダーを選択できるようになります。このダイアログは、ファイルを選択するときとほぼ同じ機能を持ちますが、フィルターには対応していません（Filterは省略されるか空白になります）。

M：マルチセレクトです。Mを指定すると、シフトクリックコントロールクリックなどで複数のファイルを選択できるようになります。この場合、戻り値は文字列ではなく、配列になります。個々のファイルを取り出すには、このページ下部の例を参照してください。

S：保存ダイアログです。Sを指定すると、ダイアログに常に「開く」ボタンの代わりに「保存」ボタンが表示されるようになります。

以下の数字を使用することができます。複数を有効にするには。、それらを足し算します。例えば、1と2を使う場合は、数字の3を指定します。

1：ファイルが存在する必要がある
2：パスは存在しなければならない
8：新しいファイルを作成するかどうかを確認します
16：ファイルを上書きするかどうか確認します
32：ショートカット（.lnkファイル）は、ターゲットに解決されるのではなく、そのまま選択されます。また、このオプションは、フォルダーショートカットによるフォルダーへのナビゲーションを防止します。

上書き保存を促す」オプションは保存ダイアログでのみサポートされているため、「作成を促す」オプションを指定せずにこのオプションを指定すると、Sオプションも有効になります。同様に、Sオプションがある場合、"Prompt to Create"オプションは効果を発揮しません。24を指定すると、ダイアログでサポートされているどのタイプのプロンプトも有効になります。

RootDir\Filename

型：文字列

If blank or omitted, the starting directory will be a default that might depend on the OS version (it will likely be the directory most recently selected by the user during a prior use of FileSelect). Otherwise, specify one or both of the following:

RootDir：ルート（開始）ディレクトリ。絶対パスが指定されていない場合は、A_WorkingDirのサブフォルダとみなされます。

Filename：ダイアログの編集フィールドに最初に表示されるデフォルトのファイル名です。裸のファイル名（パスなし）のみが表示されます。ダイアログが正しく表示されるように、不正な文字（/<|:"など）が存在しないことを確認してください。

例：

"C:\My Pictures\Default Image Name.gif"  ; RootDirとFilenameの両方が存在します。
"C:\My Pictures"  ; RootDirのみ存在します。
"My Pictures"  ; RootDirのみが存在し、現在の作業ディレクトリからの相対パスです。
"My File"  ; Filenameのみ存在します（ただし、"My File"がフォルダとして存在する場合は、RootDirとします）。

Title

型：文字列

If blank or omitted, it defaults to "Select File - " A_ScriptName (i.e. the name of the current script), unless the "D" option is present, in which case the word "File" is replaced with "Folder". Otherwise, specify the title of the file-selection window.

Filter

型：文字列

If blank or omitted, the dialog will show all type of files and provide the "All Files (*.*)" option in the "Files of type" drop-down list.

Otherwise, specify a string to indicate which types of files are shown by the dialog, e.g. "Documents (*.txt)". To include more than one file extension in the filter, separate them with semicolons, e.g. "Audio (*.wav; *.mp2; *.mp3)". In this case, the "Files of type" drop-down list has the specified string and "All Files (*.*)" as options.

"D"オプションがある場合、このパラメータは空白または省略する必要があります。

戻り値

型：文字列または配列

マルチセレクトが有効でない場合、この関数は、ユーザーが選択した単一のファイルまたはフォルダのフルパスと名前を返し、ユーザーがダイアログをキャンセルした場合は空の文字列を返します。

Mオプション（複数選択）が有効な場合、この関数は項目の配列を返し、各項目は1つのファイルのフルパスと名前になります。本ページ下部の例では、ファイルを1つずつ抽出する方法を示しています。ユーザーがダイアログをキャンセルした場合、配列は空（アイテムがゼロ）になります。

備考

ファイル選択ダイアログは、通常このように表示されます：

GUIウィンドウは、+OwnDialogsオプションにより、モーダルファイル選択ダイアログを表示することができる。モーダルダイアログは、ダイアログが解除されるまで、ユーザーがGUIウィンドウと対話するのを防ぎます。

DirSelect、MsgBox、InputBox、ToolTip、GUI、CLSIDリスト、解析ループ、SplitPath

また、OSには、フォント、色、アイコンの選択を促すダイアログボックスが標準装備されています。These dialogs can be displayed via DllCall in combination with comdlg32\ChooseFont, comdlg32\ChooseColor, or shell32\PickIconDlg. Search the forums for examples.

例

既存の.txtまたは.docファイルを選択できるようにします。

SelectedFile := FileSelect(3, , "Open a file", "Text Documents (*.txt; *.doc)")
if SelectedFile = ""
    MsgBox "The dialog was canceled."
else
    MsgBox "The following file was selected:`n" SelectedFile

既存のファイルを複数選択できるようにします。

SelectedFiles := FileSelect("M3")  ; M3 = 既存ファイルをマルチセレクトします。
if SelectedFiles.Length = 0
{
    MsgBox "The dialog was canceled."
    return
}
for FileName in SelectedFiles
{
    Result := MsgBox("File #" A_Index " of " SelectedFiles.Length ":`n" FileName "`n`nContinue?",, "YN")
    if Result = "No"
        break
}

フォルダーを選択できるようにします。

SelectedFolder := FileSelect("D", , "Select a folder")
if SelectedFolder = ""
    MsgBox "The dialog was canceled."
else
    MsgBox "The following folder was selected:`n" SelectedFolder

FileSelect

パラメータ

戻り値

備考

関連

例