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

给出此消息窗口的默认按钮的符号名称OKCANCEL 等)。如果未指定此选项,则对话框中的第一个按钮将成为默认按钮。

detail

指定 *message* 选项给出的主要消息的辅助消息。消息详细信息将显示在主要消息下方,并且在操作系统支持的情况下,将以比主要消息 less emphasized 的字体显示。

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)

询问一个问题。默认情况下显示按钮 YESNO。返回所选按钮的符号名称。

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

询问是否继续操作。显示按钮 OKCANCEL。如果答案是“确定”,则返回 True,否则返回 False

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

询问是否应重试操作。显示按钮 RETRYCANCEL。如果答案是“是”,则返回 True,否则返回 False

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

询问一个问题。显示按钮 YESNO。如果答案是“是”,则返回 True,否则返回 False

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

询问一个问题。显示按钮 YESNOCANCEL。如果答案是“是”,则返回 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'

显示三个按钮,其符号名称为 ABORTRETRYIGNORE

tkinter.messagebox.OK = 'ok'

显示一个按钮,其符号名称为 OK

tkinter.messagebox.OKCANCEL = 'okcancel'

显示两个按钮,其符号名称为 OKCANCEL

tkinter.messagebox.RETRYCANCEL = 'retrycancel'

显示两个按钮,其符号名称为 RETRYCANCEL

tkinter.messagebox.YESNO = 'yesno'

显示两个按钮,其符号名称为 YESNO

tkinter.messagebox.YESNOCANCEL = 'yesnocancel'

显示三个按钮,其符号名称分别为 YESNOCANCEL

图标图像

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