查看源代码 wxDirDialog (wx v2.4.3)

此类表示目录选择对话框。

样式

此类支持以下样式

  • wxDD_DEFAULT_STYLE:等同于 wxDEFAULT_DIALOG_STYLE 和 wxRESIZE_BORDER 的组合。

  • wxDD_DIR_MUST_EXIST:对话框将只允许用户选择一个已存在的文件夹。当不使用此样式时,对话框中会添加一个“创建新目录”按钮(在 Windows 上),或者以其他方式为用户提供输入新文件夹名称的方法。

  • wxDD_CHANGE_DIR:将当前工作目录更改为用户选择的目录。

注意:此标志不能与 wxDD_MULTIPLE 样式一起使用。

  • wxDD_MULTIPLE:允许用户选择多个目录。此标志仅自 wxWidgets 3.1.4 起可用

  • wxDD_SHOW_HIDDEN:显示隐藏和系统文件夹。此标志仅自 wxWidgets 3.1.4 起可用。请注意,wxRESIZE_BORDER 在 Windows 下有特殊的副作用,它会启用两个不同的目录选择对话框,并且此样式也会隐式地选择新版本,因为旧版本始终具有固定的大小。由于新版本几乎总是首选的,因此建议始终使用 wxRESIZE_BORDER 样式。如果对话框是使用默认样式值创建的,则情况如此,但如果您需要使用任何其他样式,您仍然应该指定 wxDD_DEFAULT_STYLE,除非您明确需要在 Windows 下使用旧版本的对话框。例如,不要单独使用 wxDD_DIR_MUST_EXIST 样式。

备注:MacOS 10.11+ 不在对话框上显示标题栏。使用 setMessage/2 在创建后更改对话框顶部向用户显示的字符串。wxTopLevelWindow:setTitle/2 方法是为了与仍然支持显示标题栏的 pre-10.11 MacOS 版本兼容而提供的。

参见

此类派生自以下类,可以使用其函数:

wxWidgets 文档:wxDirDialog

摘要

函数

销毁对象

返回将显示在对话框上的消息。

返回默认路径或用户选择的路径。

构造函数。

设置将显示在对话框上的消息。

设置默认路径。

类型

-type wxDirDialog() :: wx:wx_object().

函数

-spec destroy(This :: wxDirDialog()) -> ok.

销毁对象

-spec getMessage(This) -> unicode:charlist() when This :: wxDirDialog().

返回将显示在对话框上的消息。

-spec getPath(This) -> unicode:charlist() when This :: wxDirDialog().

返回默认路径或用户选择的路径。

注意:此函数不能用于具有 wxDD_MULTIPLE 样式的对话框,请改用 GetPaths() (在 wx 中未实现)。

-spec new(Parent) -> wxDirDialog() when Parent :: wxWindow:wxWindow().

等同于 new(Parent, [])

-spec new(Parent, [Option]) -> wxDirDialog()
             when
                 Parent :: wxWindow:wxWindow(),
                 Option ::
                     {title, unicode:chardata()} |
                     {defaultPath, unicode:chardata()} |
                     {style, integer()} |
                     {pos, {X :: integer(), Y :: integer()}} |
                     {sz, {W :: integer(), H :: integer()}}.

构造函数。

使用 wxDialog:showModal/1 显示对话框。

链接到此函数

setMessage(This, Message)

查看源代码
-spec setMessage(This, Message) -> ok when This :: wxDirDialog(), Message :: unicode:chardata().

设置将显示在对话框上的消息。

-spec setPath(This, Path) -> ok when This :: wxDirDialog(), Path :: unicode:chardata().

设置默认路径。