檢視原始碼 wxFilePickerCtrl (wx v2.4.3)
此控制項允許使用者選擇檔案。
一般實作是一個按鈕，點擊後會彈出 wxFileDialog。原生實作可能有所不同，但通常是一個（小的）小工具，可讓您存取檔案選擇器對話方塊。只有在 wxUSE_FILEPICKERCTRL 設定為 1（預設值）時才可用。
樣式
此類別支援以下樣式
wxFLP_DEFAULT_STYLE：預設樣式：包含 wxFLP_OPEN | wxFLP_FILE_MUST_EXIST，以及在 wxMSW 和 wxOSX 下包含 wxFLP_USE_TEXTCTRL。
wxFLP_USE_TEXTCTRL：在選擇器按鈕的左側建立一個文字控制項，該控制項完全由
wxFilePickerCtrl管理，使用者可以使用它來指定路徑（請參閱 SetPath）。文字控制項會自動與按鈕的值同步。使用wxPickerBase中定義的函式來修改文字控制項。wxFLP_OPEN：建立一個選擇器，允許使用者選擇要開啟的檔案。
wxFLP_SAVE：建立一個選擇器，允許使用者選擇要儲存的檔案。
wxFLP_OVERWRITE_PROMPT：只能與 wxFLP_SAVE 結合使用：在選擇檔案之前要求使用者確認。
wxFLP_FILE_MUST_EXIST：只能與 wxFLP_OPEN 結合使用：在彈出視窗
wxFileDialog中選擇的檔案必須是現有的檔案。請注意，如果同時使用wxFLP_USE_TEXTCTRL，使用者仍然可以在文字控制項中輸入不存在的檔案名稱，此標記是給使用者的提示，而不是保證所選檔案對程式確實存在。wxFLP_CHANGE_DIR：每次使用者選擇檔案變更時，變更目前的工作目錄。
wxFLP_SMALL：使用較小版本的控制項，其中包含一個小的「...」按鈕，而不是一般的「瀏覽」按鈕。自 wxWidgets 2.9.3 以來，此標記為新增功能。
請參閱
此類別繼承自以下類別，並且可以使用這些類別中的函式：
wxWidgets 文件：wxFilePickerCtrl
事件
此類別發出的事件類型
摘要
類型
-type wxFilePickerCtrl() :: wx:wx_object().
函式
-spec create(This, Parent, Id) -> boolean() when This :: wxFilePickerCtrl(), Parent :: wxWindow:wxWindow(), Id :: integer().
-spec create(This, Parent, Id, [Option]) -> boolean() when This :: wxFilePickerCtrl(), Parent :: wxWindow:wxWindow(), Id :: integer(), Option :: {path, unicode:chardata()} | {message, unicode:chardata()} | {wildcard, unicode:chardata()} | {pos, {X :: integer(), Y :: integer()}} | {size, {W :: integer(), H :: integer()}} | {style, integer()} | {validator, wx:wx_object()}.
使用給定的參數建立此小工具。
傳回值：如果控制項已成功建立則為 true，如果建立失敗則為 false。
-spec destroy(This :: wxFilePickerCtrl()) -> ok.
銷毀物件
-spec getPath(This) -> unicode:charlist() when This :: wxFilePickerCtrl().
傳回目前選取檔案的絕對路徑。
-spec new() -> wxFilePickerCtrl().
-spec new(Parent, Id) -> wxFilePickerCtrl() when Parent :: wxWindow:wxWindow(), Id :: integer().
等同於 new(Parent, Id, [])。
-spec new(Parent, Id, [Option]) -> wxFilePickerCtrl() when Parent :: wxWindow:wxWindow(), Id :: integer(), Option :: {path, unicode:chardata()} | {message, unicode:chardata()} | {wildcard, unicode:chardata()} | {pos, {X :: integer(), Y :: integer()}} | {size, {W :: integer(), H :: integer()}} | {style, integer()} | {validator, wx:wx_object()}.
初始化物件並使用所有參數呼叫 create/4。
-spec setPath(This, Filename) -> ok when This :: wxFilePickerCtrl(), Filename :: unicode:chardata().
設定目前選取檔案的絕對路徑。
如果控制項使用 wxFLP_FILE_MUST_EXIST 且未使用 wxFLP_USE_TEXTCTRL 樣式，則 filename 必須是現有檔案的名稱，如果不是這種情況，則將會被原生 wxGTK 實作簡單地忽略（在其他平台上使用的一般實作目前甚至接受無效的檔案名稱，但這在未來可能會變更，請不要依賴使用它來使用不存在的路徑）。