# DirSelect

显示可以让用户选择文件夹的标准对话框.

    SelectedFolder := DirSelect(StartingFolder, Options, Prompt)

## 参数

StartingFolder

  类型: 字符串

  如果为空或省略, 则对话框的初始选择为用户的我的文档文件夹(或可能是我的电脑). 可以指定 CLSID 文件夹, 如 `"::{20d04fe0-3aea-1069-a2d8-08002b30309d}"`(即我的电脑) 来从特定的专用文件夹开始导航.

  否则, 此参数最常见的用法是星号后面紧跟着初始选择的驱动器或文件夹的绝对路径. 例如, `"*C:\"` 会初始选择 C 驱动器. 同样地, `"*C:\My Folder"` 会初始选择这个特殊的文件夹.

  星号表示允许用户从起始文件夹向上导航(接近根目录). 如果没有星号, 则强制用户在 StartingFolder(或 StartingFolder 自身) 中选择文件夹. 省略星号的一个好处是最初 StartingFolder 会显示为树形展开状态, 这样可以节省用户点击前面加号的时间.

  如果有星号, 向上导航也可以选择限制在桌面以外的文件夹中. 这是通过在星号前面加上最顶层文件夹的绝对路径, 后面正好是一个空格或制表符来实现的. 例如, `"C:\My Folder *C:\My Folder\Projects"` 将不允许用户导航到比 C:\My Folder 更上级的文件夹(不过初始选择可以是 C:\My Folder\Projects):

Options

  类型: 整数

  下列数字的其中一个:

  0: 禁用下面所有选项.

  1(默认): 提供允许用户新建文件夹的按钮.

  加 2 到上面的数字来提供允许用户输入文件夹名称的编辑区域. 例如, 此参数值为 3 表示同时提供编辑区域和 "新建文件夹" 按钮.

  加 4 到上面的数字来忽略 BIF_NEWDIALOGSTYLE 属性. 加 4 确保了 DirSelect 即使在像 WinPE 或 BartPE 这样的预安装环境中也能正常工作. 然而, 这样阻止了 "新建文件夹" 按钮的出现.

  如果用户在编辑区域中输入了无效的文件夹名称, 则 SelectedFolder 会被设置为在导航树中选择的文件夹而不是用户输入的内容.

Prompt

  类型: 字符串

  显示在窗口中用来提示用户操作的文本. 如果省略或为空, 则它默认为 `"Select Folder - " A_ScriptName`(即当前脚本的名称).

## 返回值

类型: 字符串

此函数返回用户选择的文件夹的完整路径和名称. 如果用户取消对话框(即不希望选择文件夹), 则返回空字符串. 如果用户选择根目录(如 C:\), 则返回值将包含末尾的反斜杠. 如果不希望这样, 则使用如下方法移除它:

    Folder := RegExReplace(DirSelect(), "\\$")  ; 移除末尾的反斜杠, 如果存在.

如果系统拒绝显示对话框, 也会返回一个空字符串, 但这是非常罕见的.

## 备注

文件夹选择对话框通常看起来像这样:

GUI 窗口可以使用 +OwnDialogs 选项的方法来显示模式文件夹选择对话框. 模式对话框在其消失之前会阻止用户与 GUI 窗口进行交互.

## 相关

FileSelect, MsgBox, InputBox, ToolTip, GUI, CLSID List, DirCopy, DirMove, SplitPath

此外, 操作系统提供了标准的对话框让用户选取字体, 颜色或图标. 使用 DllCall 可以显示这些对话框, 如 GitHub 所示.

## 示例

允许用户选择一个文件夹, 并提供一个编辑字段和 "新建文件夹" 按钮.

    SelectedFolder := DirSelect(, 3)
    if SelectedFolder = ""
        MsgBox "You didn't select a folder."
    else
        MsgBox "You selected folder '" SelectedFolder "'."

CLSID 例子. 允许用户选择 "我的电脑" 目录下的文件夹.

    SelectedFolder := DirSelect("::{20d04fe0-3aea-1069-a2d8-08002b30309d}")  ; 我的电脑.

dftg