檢視原始碼 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 實作將會簡單地忽略它。