# 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