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

此控件允许用户选择一个目录。

通用实现是一个按钮,单击时会弹出 wxDirDialog。原生实现可能有所不同,但通常是一个(小型)小部件,用于访问目录选择对话框。仅当 wxUSE_DIRPICKERCTRL 设置为 1(默认值)时才可用。

样式

此类支持以下样式

  • wxDIRP_DEFAULT_STYLE:默认样式:包括 wxDIRP_DIR_MUST_EXIST,并且仅在 wxMSW 下包括 wxDIRP_USE_TEXTCTRL。

  • wxDIRP_USE_TEXTCTRL:在选择器按钮的左侧创建一个文本控件,该控件完全由 wxDirPickerCtrl 管理,用户可以使用该控件指定路径(请参阅 SetPath)。文本控件会自动与按钮的值同步。使用 wxPickerBase 中定义的函数来修改文本控件。

  • wxDIRP_DIR_MUST_EXIST:创建一个选择器,该选择器仅允许在弹出的 wxDirDialog 中选择现有目录。请注意,与 wxFLP_FILE_MUST_EXIST 一样,即使指定了此文件,如果也使用了 wxDIRP_USE_TEXTCTRL 样式,仍然可以输入不存在的目录。另请注意,如果不使用 wxDIRP_USE_TEXTCTRL,则原生 wxGTK 实现始终使用此样式,因为它不支持选择不存在的目录。

  • wxDIRP_CHANGE_DIR:在每次用户目录选择更改时更改当前工作目录。

  • wxDIRP_SMALL:使用控件的较小版本,带有小的“...”按钮而不是普通的“浏览”按钮。此标志自 wxWidgets 2.9.3 起新增。

参见

此类派生自,并且可以使用以下类中的函数:

wxWidgets 文档:wxDirPickerCtrl

事件

此类发出的事件类型

概要

函数

使用给定的参数创建小部件。

销毁对象

返回当前所选目录的绝对路径。

初始化对象并使用所有参数调用 create/4

设置当前所选目录的绝对路径。

类型

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

函数

此函数的链接

create(This, Parent, Id)

查看源代码
-spec create(This, Parent, Id) -> boolean()
                when This :: wxDirPickerCtrl(), Parent :: wxWindow:wxWindow(), Id :: integer().

等效于 create(This, Parent, Id, [])

-spec create(This, Parent, Id, [Option]) -> boolean()
                when
                    This :: wxDirPickerCtrl(),
                    Parent :: wxWindow:wxWindow(),
                    Id :: integer(),
                    Option ::
                        {path, unicode:chardata()} |
                        {message, unicode:chardata()} |
                        {pos, {X :: integer(), Y :: integer()}} |
                        {size, {W :: integer(), H :: integer()}} |
                        {style, integer()} |
                        {validator, wx:wx_object()}.

使用给定的参数创建小部件。

返回:如果控件成功创建,则返回 true,如果创建失败,则返回 false。

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

销毁对象

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

返回当前所选目录的绝对路径。

-spec new() -> wxDirPickerCtrl().
-spec new(Parent, Id) -> wxDirPickerCtrl() when Parent :: wxWindow:wxWindow(), Id :: integer().

等效于 new(Parent, Id, [])

-spec new(Parent, Id, [Option]) -> wxDirPickerCtrl()
             when
                 Parent :: wxWindow:wxWindow(),
                 Id :: integer(),
                 Option ::
                     {path, unicode:chardata()} |
                     {message, unicode:chardata()} |
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()} |
                     {validator, wx:wx_object()}.

初始化对象并使用所有参数调用 create/4

此函数的链接

setPath(This, Dirname)

查看源代码
-spec setPath(This, Dirname) -> ok when This :: wxDirPickerCtrl(), Dirname :: unicode:chardata().

设置当前所选目录的绝对路径。

如果控件使用 wxDIRP_DIR_MUST_EXIST 并且不使用 wxDIRP_USE_TEXTCTRL 样式,则 dirname 必须是现有目录的名称,如果情况并非如此,则会被原生 wxGTK 实现简单地忽略。