Tkinter 對話方塊

tkinter.simpledialog — 標準 Tkinter 輸入對話方塊

原始碼: Lib/tkinter/simpledialog.py


tkinter.simpledialog 模組包含用於建立簡單的模態對話方塊以從使用者獲取值的便利類和函式。

tkinter.simpledialog.askfloat(title, prompt, **kw)
tkinter.simpledialog.askinteger(title, prompt, **kw)
tkinter.simpledialog.askstring(title, prompt, **kw)

以上三個函式提供對話方塊,提示使用者輸入所需型別的值。

class tkinter.simpledialog.Dialog(parent, title=None)

自定義對話方塊的基類。

body(master)

重寫以構建對話方塊的介面並返回應具有初始焦點的視窗小部件。

buttonbox()

預設行為新增“確定”和“取消”按鈕。重寫以自定義按鈕佈局。

tkinter.filedialog — 檔案選擇對話方塊

原始碼: Lib/tkinter/filedialog.py


tkinter.filedialog 模組提供用於建立檔案/目錄選擇視窗的類和工廠函式。

原生載入/儲存對話方塊

以下類和函式提供檔案對話視窗,這些視窗結合了原生外觀和自定義行為的配置選項。以下關鍵字引數適用於下面列出的類和函式

parent - 對話方塊放置在其頂部的視窗
title - 視窗的標題
initialdir - 對話方塊開始所在的目錄
initialfile - 開啟對話方塊時選擇的檔案
filetypes - (標籤, 模式) 元組的序列,允許使用“*”萬用字元
defaultextension - 要附加到檔案的預設副檔名(儲存對話方塊)
multiple - 當為 true 時,允許選擇多個專案

靜態工廠函式

以下函式在呼叫時會建立一個模態的原生外觀對話方塊,等待使用者選擇,然後將選定的值返回給呼叫者,如果未選擇則返回 None

tkinter.filedialog.askopenfile(mode='r', **options)
tkinter.filedialog.askopenfiles(mode='r', **options)

以上兩個函式建立一個 Open 對話方塊,並返回以只讀模式開啟的檔案物件。

tkinter.filedialog.asksaveasfile(mode='w', **options)

建立一個 SaveAs 對話方塊,並返回以只寫模式開啟的檔案物件。

tkinter.filedialog.askopenfilename(**options)
tkinter.filedialog.askopenfilenames(**options)

以上兩個函式建立一個 Open 對話方塊,並返回與現有檔案對應的選定檔名。

tkinter.filedialog.asksaveasfilename(**options)

建立一個 SaveAs 對話方塊,並返回選定的檔名。

tkinter.filedialog.askdirectory(**options)
提示使用者選擇一個目錄。
其他關鍵字選項
mustexist - 確定選擇是否必須是現有目錄。
class tkinter.filedialog.Open(master=None, **options)
class tkinter.filedialog.SaveAs(master=None, **options)

以上兩個類提供用於儲存和載入檔案的原生對話視窗。

便利類

以下類用於從頭開始建立檔案/目錄視窗。這些不模擬平臺的原生外觀。

class tkinter.filedialog.Directory(master=None, **options)

建立一個提示使用者選擇目錄的對話方塊。

注意

應該對 FileDialog 類進行子類化,以進行自定義事件處理和行為。

class tkinter.filedialog.FileDialog(master, title=None)

建立一個基本的檔案選擇對話方塊。

cancel_command(event=None)

觸發對話方塊視窗的終止。

dirs_double_event(event)

目錄雙擊事件的事件處理程式。

dirs_select_event(event)

目錄單擊事件的事件處理程式。

files_double_event(event)

檔案雙擊事件的事件處理程式。

files_select_event(event)

檔案單擊事件的事件處理程式。

filter_command(event=None)

按目錄篩選檔案。

get_filter()

檢索當前使用的檔案過濾器。

get_selection()

檢索當前選定的項。

go(dir_or_file=os.curdir, pattern='*', default='', key=None)

渲染對話方塊並啟動事件迴圈。

ok_event(event)

退出對話方塊並返回當前選擇。

quit(how=None)

退出對話方塊並返回檔名(如果有)。

set_filter(dir, pat)

設定檔案過濾器。

set_selection(file)

將當前檔案選擇更新為 *file*。

class tkinter.filedialog.LoadFileDialog(master, title=None)

FileDialog 的子類,用於建立選擇現有檔案的對話方塊視窗。

ok_command()

測試是否提供了檔案,以及選擇是否指示已存在的檔案。

class tkinter.filedialog.SaveFileDialog(master, title=None)

FileDialog 的子類,用於建立選擇目標檔案的對話方塊視窗。

ok_command()

測試選擇是否指向有效的非目錄檔案。如果選擇已存在的檔案,則需要確認。

tkinter.commondialog — 對話方塊視窗模板

原始碼: Lib/tkinter/commondialog.py


tkinter.commondialog 模組提供了 Dialog 類,它是其他支援模組中定義的對話方塊的基類。

class tkinter.commondialog.Dialog(master=None, **options)
show(color=None, **options)

渲染對話方塊視窗。