tkinter.messagebox — Tkinter 消息提示框

源代码: Lib/tkinter/messagebox.py

---

tkinter.messagebox 模块提供了模板基类以及各种方便的方法，用于常用配置。消息框是模态的，将根据用户的选择返回 (True, False, None, OK, CANCEL, YES, NO) 的子集。常见的消息框样式和布局包括但不限于

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'