ref: 1211bc2a32c1ffe5614b5a7d6daae3ca3f5faa65
dir: /sys/lib/python/lib-tk/tkCommonDialog.py/
# base class for tk common dialogues
#
# this module provides a base class for accessing the common
# dialogues available in Tk 4.2 and newer.  use tkFileDialog,
# tkColorChooser, and tkMessageBox to access the individual
# dialogs.
#
# written by Fredrik Lundh, May 1997
#
from Tkinter import *
class Dialog:
    command  = None
    def __init__(self, master=None, **options):
        # FIXME: should this be placed on the module level instead?
        if TkVersion < 4.2:
            raise TclError, "this module requires Tk 4.2 or newer"
        self.master  = master
        self.options = options
        if not master and options.get('parent'):
            self.master = options['parent']
    def _fixoptions(self):
        pass # hook
    def _fixresult(self, widget, result):
        return result # hook
    def show(self, **options):
        # update instance options
        for k, v in options.items():
            self.options[k] = v
        self._fixoptions()
        # we need a dummy widget to properly process the options
        # (at least as long as we use Tkinter 1.63)
        w = Frame(self.master)
        try:
            s = w.tk.call(self.command, *w._options(self.options))
            s = self._fixresult(w, s)
        finally:
            try:
                # get rid of the widget
                w.destroy()
            except:
                pass
        return s