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'