檢視原始碼 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 起可用。請注意,在 Windows 下,
wxRESIZE_BORDER
具有特殊的副作用,其中可以使用兩個不同的目錄選擇對話框,並且此樣式也隱含地選擇了新版本,因為舊版本始終具有固定大小。由於新版本幾乎總是更可取的,因此建議始終使用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().
設定預設路徑。