檢視原始碼 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 來顯示對話框。

此函式的連結

setMessage(This, Message)

檢視原始碼
-spec setMessage(This, Message) -> ok when This :: wxDirDialog(), Message :: unicode:chardata().

設定將在對話框上顯示的訊息。

-spec setPath(This, Path) -> ok when This :: wxDirDialog(), Path :: unicode:chardata().

設定預設路徑。