查看源代码 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
事件
此类发出的事件类型
概要
类型
-type wxDirPickerCtrl() :: wx:wx_object().
函数
-spec create(This, Parent, Id) -> boolean() when This :: wxDirPickerCtrl(), Parent :: wxWindow:wxWindow(), Id :: integer().
-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
。
-spec setPath(This, Dirname) -> ok when This :: wxDirPickerCtrl(), Dirname :: unicode:chardata().
设置当前所选目录的绝对路径。
如果控件使用 wxDIRP_DIR_MUST_EXIST
并且不使用 wxDIRP_USE_TEXTCTRL
样式,则 dirname
必须是现有目录的名称,如果情况并非如此,则会被原生 wxGTK 实现简单地忽略。