查看源代码 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
显示对话框。
-spec setMessage(This, Message) -> ok when This :: wxDirDialog(), Message :: unicode:chardata().
设置将显示在对话框上的消息。
-spec setPath(This, Path) -> ok when This :: wxDirDialog(), Path :: unicode:chardata().
设置默认路径。