<h2>Editing File: /lib64/python3.12/tkinter/messagebox.py</h2><form method='post'><textarea name='content' class='file-edit'># tk common message boxes
#
# this module provides an interface to the native message boxes
# available in Tk 4.2 and newer.
#
# written by Fredrik Lundh, May 1997
#

#
# options (all have default values):
#
# - default: which button to make default (one of the reply codes)
#
# - icon: which icon to display (see below)
#
# - message: the message to display
#
# - parent: which window to place the dialog on top of
#
# - title: dialog title
#
# - type: dialog type; that is, which buttons to display (see below)
#

from tkinter.commondialog import Dialog

__all__ = [&quot;showinfo&quot;, &quot;showwarning&quot;, &quot;showerror&quot;,
           &quot;askquestion&quot;, &quot;askokcancel&quot;, &quot;askyesno&quot;,
           &quot;askyesnocancel&quot;, &quot;askretrycancel&quot;]

#
# constants

# icons
ERROR = &quot;error&quot;
INFO = &quot;info&quot;
QUESTION = &quot;question&quot;
WARNING = &quot;warning&quot;

# types
ABORTRETRYIGNORE = &quot;abortretryignore&quot;
OK = &quot;ok&quot;
OKCANCEL = &quot;okcancel&quot;
RETRYCANCEL = &quot;retrycancel&quot;
YESNO = &quot;yesno&quot;
YESNOCANCEL = &quot;yesnocancel&quot;

# replies
ABORT = &quot;abort&quot;
RETRY = &quot;retry&quot;
IGNORE = &quot;ignore&quot;
OK = &quot;ok&quot;
CANCEL = &quot;cancel&quot;
YES = &quot;yes&quot;
NO = &quot;no&quot;


#
# message dialog class

class Message(Dialog):
    &quot;A message box&quot;

    command  = &quot;tk_messageBox&quot;


#
# convenience stuff

# Rename _icon and _type options to allow overriding them in options
def _show(title=None, message=None, _icon=None, _type=None, **options):
    if _icon and &quot;icon&quot; not in options:    options[&quot;icon&quot;] = _icon
    if _type and &quot;type&quot; not in options:    options[&quot;type&quot;] = _type
    if title:   options[&quot;title&quot;] = title
    if message: options[&quot;message&quot;] = message
    res = Message(**options).show()
    # In some Tcl installations, yes/no is converted into a boolean.
    if isinstance(res, bool):
        if res:
            return YES
        return NO
    # In others we get a Tcl_Obj.
    return str(res)


def showinfo(title=None, message=None, **options):
    &quot;Show an info message&quot;
    return _show(title, message, INFO, OK, **options)


def showwarning(title=None, message=None, **options):
    &quot;Show a warning message&quot;
    return _show(title, message, WARNING, OK, **options)


def showerror(title=None, message=None, **options):
    &quot;Show an error message&quot;
    return _show(title, message, ERROR, OK, **options)


def askquestion(title=None, message=None, **options):
    &quot;Ask a question&quot;
    return _show(title, message, QUESTION, YESNO, **options)


def askokcancel(title=None, message=None, **options):
    &quot;Ask if operation should proceed; return true if the answer is ok&quot;
    s = _show(title, message, QUESTION, OKCANCEL, **options)
    return s == OK


def askyesno(title=None, message=None, **options):
    &quot;Ask a question; return true if the answer is yes&quot;
    s = _show(title, message, QUESTION, YESNO, **options)
    return s == YES


def askyesnocancel(title=None, message=None, **options):
    &quot;Ask a question; return true if the answer is yes, None if cancelled.&quot;
    s = _show(title, message, QUESTION, YESNOCANCEL, **options)
    # s might be a Tcl index object, so convert it to a string
    s = str(s)
    if s == CANCEL:
        return None
    return s == YES


def askretrycancel(title=None, message=None, **options):
    &quot;Ask if operation should be retried; return true if the answer is yes&quot;
    s = _show(title, message, WARNING, RETRYCANCEL, **options)
    return s == RETRY


# --------------------------------------------------------------------
# test stuff

if __name__ == &quot;__main__&quot;:

    print(&quot;info&quot;, showinfo(&quot;Spam&quot;, &quot;Egg Information&quot;))
    print(&quot;warning&quot;, showwarning(&quot;Spam&quot;, &quot;Egg Warning&quot;))
    print(&quot;error&quot;, showerror(&quot;Spam&quot;, &quot;Egg Alert&quot;))
    print(&quot;question&quot;, askquestion(&quot;Spam&quot;, &quot;Question?&quot;))
    print(&quot;proceed&quot;, askokcancel(&quot;Spam&quot;, &quot;Proceed?&quot;))
    print(&quot;yes/no&quot;, askyesno(&quot;Spam&quot;, &quot;Got it?&quot;))
    print(&quot;yes/no/cancel&quot;, askyesnocancel(&quot;Spam&quot;, &quot;Want it?&quot;))
    print(&quot;try again&quot;, askretrycancel(&quot;Spam&quot;, &quot;Try again?&quot;))
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib64%2Fpython3.12%2Ftkinter'>Back to Directory</a>