tkinter.messagebox — Tkinter 訊息提示框

原始碼: Lib/tkinter/messagebox.py

tkinter.messagebox 模組提供了模板基類以及各種方便的方法，用於常用配置。訊息框是模態的，將根據使用者的選擇返回 (True, False, None, OK, CANCEL, YES, NO) 的子集。常見的訊息框樣式和佈局包括但不限於

../_images/tk_msg.png
class tkinter.messagebox.Message(master=None, **options)

建立一個訊息視窗，其中包含應用程式指定的訊息、圖示和一組按鈕。訊息視窗中的每個按鈕都由一個唯一的符號名稱標識（參見 type 選項）。

支援以下選項：

command

指定當使用者關閉對話方塊時要呼叫的函式。作為引數傳遞的是使用者點選關閉對話方塊的按鈕名稱。這僅在 macOS 上可用。

default

給出此訊息視窗的預設按鈕的符號名稱（OK、CANCEL 等）。如果未指定此選項，則對話方塊中的第一個按鈕將成為預設按鈕。

detail

指定 message 選項給出的主訊息的輔助訊息。訊息詳情將顯示在主訊息下方，如果作業系統支援，字型會比主訊息不那麼強調。

icon

指定要顯示的圖示。如果未指定此選項，則將顯示INFO圖示。

message

指定此訊息框中要顯示的訊息。預設值為空字串。

parent

使指定視窗成為訊息框的邏輯父視窗。訊息框顯示在其父視窗之上。

title

指定要作為訊息框標題顯示的字串。此選項在 macOS 上被忽略，因為平臺指南禁止在此類對話方塊上使用標題。

type

安排顯示預定義的一組按鈕。

show(**options)

顯示訊息視窗並等待使用者選擇其中一個按鈕。然後返回所選按鈕的符號名稱。關鍵字引數可以覆蓋建構函式中指定的選項。

資訊訊息框

tkinter.messagebox.showinfo(title=None, message=None, **options)

建立並顯示一個帶有指定標題和訊息的資訊訊息框。

警告訊息框

tkinter.messagebox.showwarning(title=None, message=None, **options)

建立並顯示一個帶有指定標題和訊息的警告訊息框。

tkinter.messagebox.showerror(title=None, message=None, **options)

建立並顯示一個帶有指定標題和訊息的錯誤訊息框。

問題訊息框

tkinter.messagebox.askquestion(title=None, message=None, *, type=YESNO, **options)

提出一個問題。預設顯示 YES 和 NO 按鈕。返回所選按鈕的符號名稱。

tkinter.messagebox.askokcancel(title=None, message=None, **options)

詢問操作是否應繼續。顯示 OK 和 CANCEL 按鈕。如果答案是 ok，則返回 True，否則返回 False。

tkinter.messagebox.askretrycancel(title=None, message=None, **options)

詢問操作是否應重試。顯示 RETRY 和 CANCEL 按鈕。如果答案是是，則返回 True，否則返回 False。

tkinter.messagebox.askyesno(title=None, message=None, **options)

提出一個問題。顯示 YES 和 NO 按鈕。如果答案是是，則返回 True，否則返回 False。

tkinter.messagebox.askyesnocancel(title=None, message=None, **options)

提出一個問題。顯示 YES、NO 和 CANCEL 按鈕。如果答案是是，則返回 True，如果取消，則返回 None，否則返回 False。

按鈕的符號名稱

tkinter.messagebox.ABORT = 'abort'
tkinter.messagebox.RETRY = 'retry'
tkinter.messagebox.IGNORE = 'ignore'
tkinter.messagebox.OK = 'ok'
tkinter.messagebox.CANCEL = 'cancel'
tkinter.messagebox.YES = 'yes'
tkinter.messagebox.NO = 'no'

預定義的按鈕集

tkinter.messagebox.ABORTRETRYIGNORE = 'abortretryignore'

顯示三個按鈕，其符號名稱分別為 ABORT、RETRY 和 IGNORE。

tkinter.messagebox.OK = 'ok'

顯示一個按鈕，其符號名稱為 OK。

tkinter.messagebox.OKCANCEL = 'okcancel'

顯示兩個按鈕，其符號名稱分別為 OK 和 CANCEL。

tkinter.messagebox.RETRYCANCEL = 'retrycancel'

顯示兩個按鈕，其符號名稱分別為 RETRY 和 CANCEL。

tkinter.messagebox.YESNO = 'yesno'

顯示兩個按鈕，其符號名稱分別為 YES 和 NO。

tkinter.messagebox.YESNOCANCEL = 'yesnocancel'

顯示三個按鈕，其符號名稱分別為 YES、NO 和 CANCEL。

圖示影像

tkinter.messagebox.ERROR = 'error'
tkinter.messagebox.INFO = 'info'
tkinter.messagebox.QUESTION = 'question'
tkinter.messagebox.WARNING = 'warning'