mirror of https://github.com/python/cpython
1944 lines
62 KiB
Python
1944 lines
62 KiB
Python
# Tkinter.py -- Tk/Tcl widget wrappers
|
|
|
|
__version__ = "$Revision$"
|
|
|
|
import _tkinter # If this fails your Python is not configured for Tk
|
|
tkinter = _tkinter # b/w compat for export
|
|
TclError = _tkinter.TclError
|
|
from types import *
|
|
from Tkconstants import *
|
|
import string; _string = string; del string
|
|
try:
|
|
import MacOS; _MacOS = MacOS; del MacOS
|
|
except ImportError:
|
|
_MacOS = None
|
|
|
|
TkVersion = _string.atof(_tkinter.TK_VERSION)
|
|
TclVersion = _string.atof(_tkinter.TCL_VERSION)
|
|
|
|
READABLE = _tkinter.READABLE
|
|
WRITABLE = _tkinter.WRITABLE
|
|
EXCEPTION = _tkinter.EXCEPTION
|
|
|
|
# These are not always defined, e.g. not on Win32 with Tk 8.0 :-(
|
|
try: _tkinter.createfilehandler
|
|
except AttributeError: _tkinter.createfilehandler = None
|
|
try: _tkinter.deletefilehandler
|
|
except AttributeError: _tkinter.deletefilehandler = None
|
|
|
|
|
|
def _flatten(tuple):
|
|
res = ()
|
|
for item in tuple:
|
|
if type(item) in (TupleType, ListType):
|
|
res = res + _flatten(item)
|
|
elif item is not None:
|
|
res = res + (item,)
|
|
return res
|
|
|
|
def _cnfmerge(cnfs):
|
|
if type(cnfs) is DictionaryType:
|
|
return cnfs
|
|
elif type(cnfs) in (NoneType, StringType):
|
|
return cnfs
|
|
else:
|
|
cnf = {}
|
|
for c in _flatten(cnfs):
|
|
try:
|
|
cnf.update(c)
|
|
except (AttributeError, TypeError), msg:
|
|
print "_cnfmerge: fallback due to:", msg
|
|
for k, v in c.items():
|
|
cnf[k] = v
|
|
return cnf
|
|
|
|
class Event:
|
|
pass
|
|
|
|
_support_default_root = 1
|
|
_default_root = None
|
|
|
|
def NoDefaultRoot():
|
|
global _support_default_root
|
|
_support_default_root = 0
|
|
global _default_root
|
|
_default_root = None
|
|
del _default_root
|
|
|
|
def _tkerror(err):
|
|
pass
|
|
|
|
def _exit(code='0'):
|
|
raise SystemExit, code
|
|
|
|
_varnum = 0
|
|
class Variable:
|
|
_default = ""
|
|
def __init__(self, master=None):
|
|
global _varnum
|
|
if not master:
|
|
master = _default_root
|
|
self._master = master
|
|
self._tk = master.tk
|
|
self._name = 'PY_VAR' + `_varnum`
|
|
_varnum = _varnum + 1
|
|
self.set(self._default)
|
|
def __del__(self):
|
|
self._tk.globalunsetvar(self._name)
|
|
def __str__(self):
|
|
return self._name
|
|
def set(self, value):
|
|
return self._tk.globalsetvar(self._name, value)
|
|
def trace_variable(self, mode, callback):
|
|
cbname = self._master._register(callback)
|
|
self._tk.call("trace", "variable", self._name, mode, cbname)
|
|
return cbname
|
|
trace = trace_variable
|
|
def trace_vdelete(self, mode, cbname):
|
|
self._tk.call("trace", "vdelete", self._name, mode, cbname)
|
|
self._master.deletecommand(cbname)
|
|
def trace_vinfo(self):
|
|
return map(self._tk.split, self._tk.splitlist(
|
|
self._tk.call("trace", "vinfo", self._name)))
|
|
|
|
class StringVar(Variable):
|
|
_default = ""
|
|
def __init__(self, master=None):
|
|
Variable.__init__(self, master)
|
|
def get(self):
|
|
return self._tk.globalgetvar(self._name)
|
|
|
|
class IntVar(Variable):
|
|
_default = 0
|
|
def __init__(self, master=None):
|
|
Variable.__init__(self, master)
|
|
def get(self):
|
|
return getint(self._tk.globalgetvar(self._name))
|
|
|
|
class DoubleVar(Variable):
|
|
_default = 0.0
|
|
def __init__(self, master=None):
|
|
Variable.__init__(self, master)
|
|
def get(self):
|
|
return getdouble(self._tk.globalgetvar(self._name))
|
|
|
|
class BooleanVar(Variable):
|
|
_default = "false"
|
|
def __init__(self, master=None):
|
|
Variable.__init__(self, master)
|
|
def get(self):
|
|
return self._tk.getboolean(self._tk.globalgetvar(self._name))
|
|
|
|
def mainloop(n=0):
|
|
_default_root.tk.mainloop(n)
|
|
|
|
getint = int
|
|
|
|
getdouble = float
|
|
|
|
def getboolean(s):
|
|
return _default_root.tk.getboolean(s)
|
|
|
|
# Methods defined on both toplevel and interior widgets
|
|
class Misc:
|
|
# XXX font command?
|
|
_tclCommands = None
|
|
def destroy(self):
|
|
if self._tclCommands is not None:
|
|
for name in self._tclCommands:
|
|
#print '- Tkinter: deleted command', name
|
|
self.tk.deletecommand(name)
|
|
self._tclCommands = None
|
|
def deletecommand(self, name):
|
|
#print '- Tkinter: deleted command', name
|
|
self.tk.deletecommand(name)
|
|
try:
|
|
self._tclCommands.remove(name)
|
|
except ValueError:
|
|
pass
|
|
def tk_strictMotif(self, boolean=None):
|
|
return self.tk.getboolean(self.tk.call(
|
|
'set', 'tk_strictMotif', boolean))
|
|
def tk_bisque(self):
|
|
self.tk.call('tk_bisque')
|
|
def tk_setPalette(self, *args, **kw):
|
|
self.tk.call(('tk_setPalette',)
|
|
+ _flatten(args) + _flatten(kw.items()))
|
|
def tk_menuBar(self, *args):
|
|
pass # obsolete since Tk 4.0
|
|
def wait_variable(self, name='PY_VAR'):
|
|
self.tk.call('tkwait', 'variable', name)
|
|
waitvar = wait_variable # XXX b/w compat
|
|
def wait_window(self, window=None):
|
|
if window == None:
|
|
window = self
|
|
self.tk.call('tkwait', 'window', window._w)
|
|
def wait_visibility(self, window=None):
|
|
if window == None:
|
|
window = self
|
|
self.tk.call('tkwait', 'visibility', window._w)
|
|
def setvar(self, name='PY_VAR', value='1'):
|
|
self.tk.setvar(name, value)
|
|
def getvar(self, name='PY_VAR'):
|
|
return self.tk.getvar(name)
|
|
getint = int
|
|
getdouble = float
|
|
def getboolean(self, s):
|
|
return self.tk.getboolean(s)
|
|
def focus_set(self):
|
|
self.tk.call('focus', self._w)
|
|
focus = focus_set # XXX b/w compat?
|
|
def focus_force(self):
|
|
self.tk.call('focus', '-force', self._w)
|
|
def focus_get(self):
|
|
name = self.tk.call('focus')
|
|
if name == 'none' or not name: return None
|
|
return self._nametowidget(name)
|
|
def focus_displayof(self):
|
|
name = self.tk.call('focus', '-displayof', self._w)
|
|
if name == 'none' or not name: return None
|
|
return self._nametowidget(name)
|
|
def focus_lastfor(self):
|
|
name = self.tk.call('focus', '-lastfor', self._w)
|
|
if name == 'none' or not name: return None
|
|
return self._nametowidget(name)
|
|
def tk_focusFollowsMouse(self):
|
|
self.tk.call('tk_focusFollowsMouse')
|
|
def tk_focusNext(self):
|
|
name = self.tk.call('tk_focusNext', self._w)
|
|
if not name: return None
|
|
return self._nametowidget(name)
|
|
def tk_focusPrev(self):
|
|
name = self.tk.call('tk_focusPrev', self._w)
|
|
if not name: return None
|
|
return self._nametowidget(name)
|
|
def after(self, ms, func=None, *args):
|
|
if not func:
|
|
# I'd rather use time.sleep(ms*0.001)
|
|
self.tk.call('after', ms)
|
|
else:
|
|
# XXX Disgusting hack to clean up after calling func
|
|
tmp = []
|
|
def callit(func=func, args=args, self=self, tmp=tmp):
|
|
try:
|
|
apply(func, args)
|
|
finally:
|
|
try:
|
|
self.deletecommand(tmp[0])
|
|
except TclError:
|
|
pass
|
|
name = self._register(callit)
|
|
tmp.append(name)
|
|
return self.tk.call('after', ms, name)
|
|
def after_idle(self, func, *args):
|
|
return apply(self.after, ('idle', func) + args)
|
|
def after_cancel(self, id):
|
|
self.tk.call('after', 'cancel', id)
|
|
def bell(self, displayof=0):
|
|
self.tk.call(('bell',) + self._displayof(displayof))
|
|
# Clipboard handling:
|
|
def clipboard_clear(self, **kw):
|
|
if not kw.has_key('displayof'): kw['displayof'] = self._w
|
|
self.tk.call(('clipboard', 'clear') + self._options(kw))
|
|
def clipboard_append(self, string, **kw):
|
|
if not kw.has_key('displayof'): kw['displayof'] = self._w
|
|
self.tk.call(('clipboard', 'append') + self._options(kw)
|
|
+ ('--', string))
|
|
# XXX grab current w/o window argument
|
|
def grab_current(self):
|
|
name = self.tk.call('grab', 'current', self._w)
|
|
if not name: return None
|
|
return self._nametowidget(name)
|
|
def grab_release(self):
|
|
self.tk.call('grab', 'release', self._w)
|
|
def grab_set(self):
|
|
self.tk.call('grab', 'set', self._w)
|
|
def grab_set_global(self):
|
|
self.tk.call('grab', 'set', '-global', self._w)
|
|
def grab_status(self):
|
|
status = self.tk.call('grab', 'status', self._w)
|
|
if status == 'none': status = None
|
|
return status
|
|
def lower(self, belowThis=None):
|
|
self.tk.call('lower', self._w, belowThis)
|
|
def option_add(self, pattern, value, priority = None):
|
|
self.tk.call('option', 'add', pattern, value, priority)
|
|
def option_clear(self):
|
|
self.tk.call('option', 'clear')
|
|
def option_get(self, name, className):
|
|
return self.tk.call('option', 'get', self._w, name, className)
|
|
def option_readfile(self, fileName, priority = None):
|
|
self.tk.call('option', 'readfile', fileName, priority)
|
|
def selection_clear(self, **kw):
|
|
if not kw.has_key('displayof'): kw['displayof'] = self._w
|
|
self.tk.call(('selection', 'clear') + self._options(kw))
|
|
def selection_get(self, **kw):
|
|
if not kw.has_key('displayof'): kw['displayof'] = self._w
|
|
return self.tk.call(('selection', 'get') + self._options(kw))
|
|
def selection_handle(self, command, **kw):
|
|
name = self._register(command)
|
|
self.tk.call(('selection', 'handle') + self._options(kw)
|
|
+ (self._w, name))
|
|
def selection_own(self, **kw):
|
|
"Become owner of X selection."
|
|
self.tk.call(('selection', 'own') +
|
|
self._options(kw) + (self._w,))
|
|
def selection_own_get(self, **kw):
|
|
"Find owner of X selection."
|
|
if not kw.has_key('displayof'): kw['displayof'] = self._w
|
|
name = self.tk.call(('selection', 'own') + self._options(kw))
|
|
if not name: return None
|
|
return self._nametowidget(name)
|
|
def send(self, interp, cmd, *args):
|
|
return self.tk.call(('send', interp, cmd) + args)
|
|
def lower(self, belowThis=None):
|
|
self.tk.call('lower', self._w, belowThis)
|
|
def tkraise(self, aboveThis=None):
|
|
self.tk.call('raise', self._w, aboveThis)
|
|
lift = tkraise
|
|
def colormodel(self, value=None):
|
|
return self.tk.call('tk', 'colormodel', self._w, value)
|
|
def winfo_atom(self, name, displayof=0):
|
|
args = ('winfo', 'atom') + self._displayof(displayof) + (name,)
|
|
return getint(self.tk.call(args))
|
|
def winfo_atomname(self, id, displayof=0):
|
|
args = ('winfo', 'atomname') \
|
|
+ self._displayof(displayof) + (id,)
|
|
return self.tk.call(args)
|
|
def winfo_cells(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'cells', self._w))
|
|
def winfo_children(self):
|
|
return map(self._nametowidget,
|
|
self.tk.splitlist(self.tk.call(
|
|
'winfo', 'children', self._w)))
|
|
def winfo_class(self):
|
|
return self.tk.call('winfo', 'class', self._w)
|
|
def winfo_colormapfull(self):
|
|
return self.tk.getboolean(
|
|
self.tk.call('winfo', 'colormapfull', self._w))
|
|
def winfo_containing(self, rootX, rootY, displayof=0):
|
|
args = ('winfo', 'containing') \
|
|
+ self._displayof(displayof) + (rootX, rootY)
|
|
name = self.tk.call(args)
|
|
if not name: return None
|
|
return self._nametowidget(name)
|
|
def winfo_depth(self):
|
|
return getint(self.tk.call('winfo', 'depth', self._w))
|
|
def winfo_exists(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'exists', self._w))
|
|
def winfo_fpixels(self, number):
|
|
return getdouble(self.tk.call(
|
|
'winfo', 'fpixels', self._w, number))
|
|
def winfo_geometry(self):
|
|
return self.tk.call('winfo', 'geometry', self._w)
|
|
def winfo_height(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'height', self._w))
|
|
def winfo_id(self):
|
|
return self.tk.getint(
|
|
self.tk.call('winfo', 'id', self._w))
|
|
def winfo_interps(self, displayof=0):
|
|
args = ('winfo', 'interps') + self._displayof(displayof)
|
|
return self.tk.splitlist(self.tk.call(args))
|
|
def winfo_ismapped(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'ismapped', self._w))
|
|
def winfo_manager(self):
|
|
return self.tk.call('winfo', 'manager', self._w)
|
|
def winfo_name(self):
|
|
return self.tk.call('winfo', 'name', self._w)
|
|
def winfo_parent(self):
|
|
return self.tk.call('winfo', 'parent', self._w)
|
|
def winfo_pathname(self, id, displayof=0):
|
|
args = ('winfo', 'pathname') \
|
|
+ self._displayof(displayof) + (id,)
|
|
return self.tk.call(args)
|
|
def winfo_pixels(self, number):
|
|
return getint(
|
|
self.tk.call('winfo', 'pixels', self._w, number))
|
|
def winfo_pointerx(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'pointerx', self._w))
|
|
def winfo_pointerxy(self):
|
|
return self._getints(
|
|
self.tk.call('winfo', 'pointerxy', self._w))
|
|
def winfo_pointery(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'pointery', self._w))
|
|
def winfo_reqheight(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'reqheight', self._w))
|
|
def winfo_reqwidth(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'reqwidth', self._w))
|
|
def winfo_rgb(self, color):
|
|
return self._getints(
|
|
self.tk.call('winfo', 'rgb', self._w, color))
|
|
def winfo_rootx(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'rootx', self._w))
|
|
def winfo_rooty(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'rooty', self._w))
|
|
def winfo_screen(self):
|
|
return self.tk.call('winfo', 'screen', self._w)
|
|
def winfo_screencells(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'screencells', self._w))
|
|
def winfo_screendepth(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'screendepth', self._w))
|
|
def winfo_screenheight(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'screenheight', self._w))
|
|
def winfo_screenmmheight(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'screenmmheight', self._w))
|
|
def winfo_screenmmwidth(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'screenmmwidth', self._w))
|
|
def winfo_screenvisual(self):
|
|
return self.tk.call('winfo', 'screenvisual', self._w)
|
|
def winfo_screenwidth(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'screenwidth', self._w))
|
|
def winfo_server(self):
|
|
return self.tk.call('winfo', 'server', self._w)
|
|
def winfo_toplevel(self):
|
|
return self._nametowidget(self.tk.call(
|
|
'winfo', 'toplevel', self._w))
|
|
def winfo_viewable(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'viewable', self._w))
|
|
def winfo_visual(self):
|
|
return self.tk.call('winfo', 'visual', self._w)
|
|
def winfo_visualid(self):
|
|
return self.tk.call('winfo', 'visualid', self._w)
|
|
def winfo_visualsavailable(self, includeids=0):
|
|
data = self.tk.split(
|
|
self.tk.call('winfo', 'visualsavailable', self._w,
|
|
includeids and 'includeids' or None))
|
|
def parseitem(x, self=self):
|
|
return x[:1] + tuple(map(getint, x[1:]))
|
|
return map(parseitem, data)
|
|
def winfo_vrootheight(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'vrootheight', self._w))
|
|
def winfo_vrootwidth(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'vrootwidth', self._w))
|
|
def winfo_vrootx(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'vrootx', self._w))
|
|
def winfo_vrooty(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'vrooty', self._w))
|
|
def winfo_width(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'width', self._w))
|
|
def winfo_x(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'x', self._w))
|
|
def winfo_y(self):
|
|
return getint(
|
|
self.tk.call('winfo', 'y', self._w))
|
|
def update(self):
|
|
self.tk.call('update')
|
|
def update_idletasks(self):
|
|
self.tk.call('update', 'idletasks')
|
|
def bindtags(self, tagList=None):
|
|
if tagList is None:
|
|
return self.tk.splitlist(
|
|
self.tk.call('bindtags', self._w))
|
|
else:
|
|
self.tk.call('bindtags', self._w, tagList)
|
|
def _bind(self, what, sequence, func, add, needcleanup=1):
|
|
if type(func) is StringType:
|
|
self.tk.call(what + (sequence, func))
|
|
elif func:
|
|
funcid = self._register(func, self._substitute,
|
|
needcleanup)
|
|
cmd = ('%sif {"[%s %s]" == "break"} break\n'
|
|
%
|
|
(add and '+' or '',
|
|
funcid,
|
|
_string.join(self._subst_format)))
|
|
self.tk.call(what + (sequence, cmd))
|
|
return funcid
|
|
elif sequence:
|
|
return self.tk.call(what + (sequence,))
|
|
else:
|
|
return self.tk.splitlist(self.tk.call(what))
|
|
def bind(self, sequence=None, func=None, add=None):
|
|
return self._bind(('bind', self._w), sequence, func, add)
|
|
def unbind(self, sequence, funcid=None):
|
|
self.tk.call('bind', self._w, sequence, '')
|
|
if funcid:
|
|
self.deletecommand(funcid)
|
|
def bind_all(self, sequence=None, func=None, add=None):
|
|
return self._bind(('bind', 'all'), sequence, func, add, 0)
|
|
def unbind_all(self, sequence):
|
|
self.tk.call('bind', 'all' , sequence, '')
|
|
def bind_class(self, className, sequence=None, func=None, add=None):
|
|
return self._bind(('bind', className), sequence, func, add, 0)
|
|
def unbind_class(self, className, sequence):
|
|
self.tk.call('bind', className , sequence, '')
|
|
def mainloop(self, n=0):
|
|
self.tk.mainloop(n)
|
|
def quit(self):
|
|
self.tk.quit()
|
|
def _getints(self, string):
|
|
if string:
|
|
return tuple(map(getint, self.tk.splitlist(string)))
|
|
def _getdoubles(self, string):
|
|
if string:
|
|
return tuple(map(getdouble, self.tk.splitlist(string)))
|
|
def _getboolean(self, string):
|
|
if string:
|
|
return self.tk.getboolean(string)
|
|
def _displayof(self, displayof):
|
|
if displayof:
|
|
return ('-displayof', displayof)
|
|
if displayof is None:
|
|
return ('-displayof', self._w)
|
|
return ()
|
|
def _options(self, cnf, kw = None):
|
|
if kw:
|
|
cnf = _cnfmerge((cnf, kw))
|
|
else:
|
|
cnf = _cnfmerge(cnf)
|
|
res = ()
|
|
for k, v in cnf.items():
|
|
if v is not None:
|
|
if k[-1] == '_': k = k[:-1]
|
|
if callable(v):
|
|
v = self._register(v)
|
|
res = res + ('-'+k, v)
|
|
return res
|
|
def nametowidget(self, name):
|
|
w = self
|
|
if name[0] == '.':
|
|
w = w._root()
|
|
name = name[1:]
|
|
find = _string.find
|
|
while name:
|
|
i = find(name, '.')
|
|
if i >= 0:
|
|
name, tail = name[:i], name[i+1:]
|
|
else:
|
|
tail = ''
|
|
w = w.children[name]
|
|
name = tail
|
|
return w
|
|
_nametowidget = nametowidget
|
|
def _register(self, func, subst=None, needcleanup=1):
|
|
f = CallWrapper(func, subst, self).__call__
|
|
name = `id(f)`
|
|
try:
|
|
func = func.im_func
|
|
except AttributeError:
|
|
pass
|
|
try:
|
|
name = name + func.__name__
|
|
except AttributeError:
|
|
pass
|
|
self.tk.createcommand(name, f)
|
|
if needcleanup:
|
|
if self._tclCommands is None:
|
|
self._tclCommands = []
|
|
self._tclCommands.append(name)
|
|
#print '+ Tkinter created command', name
|
|
return name
|
|
register = _register
|
|
def _root(self):
|
|
w = self
|
|
while w.master: w = w.master
|
|
return w
|
|
_subst_format = ('%#', '%b', '%f', '%h', '%k',
|
|
'%s', '%t', '%w', '%x', '%y',
|
|
'%A', '%E', '%K', '%N', '%W', '%T', '%X', '%Y')
|
|
def _substitute(self, *args):
|
|
if len(args) != len(self._subst_format): return args
|
|
getboolean = self.tk.getboolean
|
|
getint = int
|
|
nsign, b, f, h, k, s, t, w, x, y, A, E, K, N, W, T, X, Y = args
|
|
# Missing: (a, c, d, m, o, v, B, R)
|
|
e = Event()
|
|
e.serial = getint(nsign)
|
|
e.num = getint(b)
|
|
try: e.focus = getboolean(f)
|
|
except TclError: pass
|
|
e.height = getint(h)
|
|
e.keycode = getint(k)
|
|
# For Visibility events, event state is a string and
|
|
# not an integer:
|
|
try:
|
|
e.state = getint(s)
|
|
except ValueError:
|
|
e.state = s
|
|
e.time = getint(t)
|
|
e.width = getint(w)
|
|
e.x = getint(x)
|
|
e.y = getint(y)
|
|
e.char = A
|
|
try: e.send_event = getboolean(E)
|
|
except TclError: pass
|
|
e.keysym = K
|
|
e.keysym_num = getint(N)
|
|
e.type = T
|
|
try:
|
|
e.widget = self._nametowidget(W)
|
|
except KeyError:
|
|
e.widget = W
|
|
e.x_root = getint(X)
|
|
e.y_root = getint(Y)
|
|
return (e,)
|
|
def _report_exception(self):
|
|
import sys
|
|
exc, val, tb = sys.exc_type, sys.exc_value, sys.exc_traceback
|
|
root = self._root()
|
|
root.report_callback_exception(exc, val, tb)
|
|
# These used to be defined in Widget:
|
|
def configure(self, cnf=None, **kw):
|
|
# XXX ought to generalize this so tag_config etc. can use it
|
|
if kw:
|
|
cnf = _cnfmerge((cnf, kw))
|
|
elif cnf:
|
|
cnf = _cnfmerge(cnf)
|
|
if cnf is None:
|
|
cnf = {}
|
|
for x in self.tk.split(
|
|
self.tk.call(self._w, 'configure')):
|
|
cnf[x[0][1:]] = (x[0][1:],) + x[1:]
|
|
return cnf
|
|
if type(cnf) is StringType:
|
|
x = self.tk.split(self.tk.call(
|
|
self._w, 'configure', '-'+cnf))
|
|
return (x[0][1:],) + x[1:]
|
|
self.tk.call((self._w, 'configure')
|
|
+ self._options(cnf))
|
|
config = configure
|
|
def cget(self, key):
|
|
return self.tk.call(self._w, 'cget', '-' + key)
|
|
__getitem__ = cget
|
|
def __setitem__(self, key, value):
|
|
self.configure({key: value})
|
|
def keys(self):
|
|
return map(lambda x: x[0][1:],
|
|
self.tk.split(self.tk.call(self._w, 'configure')))
|
|
def __str__(self):
|
|
return self._w
|
|
# Pack methods that apply to the master
|
|
_noarg_ = ['_noarg_']
|
|
def pack_propagate(self, flag=_noarg_):
|
|
if flag is Misc._noarg_:
|
|
return self._getboolean(self.tk.call(
|
|
'pack', 'propagate', self._w))
|
|
else:
|
|
self.tk.call('pack', 'propagate', self._w, flag)
|
|
propagate = pack_propagate
|
|
def pack_slaves(self):
|
|
return map(self._nametowidget,
|
|
self.tk.splitlist(
|
|
self.tk.call('pack', 'slaves', self._w)))
|
|
slaves = pack_slaves
|
|
# Place method that applies to the master
|
|
def place_slaves(self):
|
|
return map(self._nametowidget,
|
|
self.tk.splitlist(
|
|
self.tk.call(
|
|
'place', 'slaves', self._w)))
|
|
# Grid methods that apply to the master
|
|
def grid_bbox(self, column=None, row=None, col2=None, row2=None):
|
|
args = ('grid', 'bbox', self._w)
|
|
if column is not None and row is not None:
|
|
args = args + (column, row)
|
|
if col2 is not None and row2 is not None:
|
|
args = args + (col2, row2)
|
|
return self._getints(apply(self.tk.call, args)) or None
|
|
|
|
bbox = grid_bbox
|
|
def _grid_configure(self, command, index, cnf, kw):
|
|
if type(cnf) is StringType and not kw:
|
|
if cnf[-1:] == '_':
|
|
cnf = cnf[:-1]
|
|
if cnf[:1] != '-':
|
|
cnf = '-'+cnf
|
|
options = (cnf,)
|
|
else:
|
|
options = self._options(cnf, kw)
|
|
if not options:
|
|
res = self.tk.call('grid',
|
|
command, self._w, index)
|
|
words = self.tk.splitlist(res)
|
|
dict = {}
|
|
for i in range(0, len(words), 2):
|
|
key = words[i][1:]
|
|
value = words[i+1]
|
|
if not value:
|
|
value = None
|
|
elif '.' in value:
|
|
value = getdouble(value)
|
|
else:
|
|
value = getint(value)
|
|
dict[key] = value
|
|
return dict
|
|
res = self.tk.call(
|
|
('grid', command, self._w, index)
|
|
+ options)
|
|
if len(options) == 1:
|
|
if not res: return None
|
|
# In Tk 7.5, -width can be a float
|
|
if '.' in res: return getdouble(res)
|
|
return getint(res)
|
|
def grid_columnconfigure(self, index, cnf={}, **kw):
|
|
return self._grid_configure('columnconfigure', index, cnf, kw)
|
|
columnconfigure = grid_columnconfigure
|
|
def grid_propagate(self, flag=_noarg_):
|
|
if flag is Misc._noarg_:
|
|
return self._getboolean(self.tk.call(
|
|
'grid', 'propagate', self._w))
|
|
else:
|
|
self.tk.call('grid', 'propagate', self._w, flag)
|
|
def grid_rowconfigure(self, index, cnf={}, **kw):
|
|
return self._grid_configure('rowconfigure', index, cnf, kw)
|
|
rowconfigure = grid_rowconfigure
|
|
def grid_size(self):
|
|
return self._getints(
|
|
self.tk.call('grid', 'size', self._w)) or None
|
|
size = grid_size
|
|
def grid_slaves(self, row=None, column=None):
|
|
args = ()
|
|
if row:
|
|
args = args + ('-row', row)
|
|
if column:
|
|
args = args + ('-column', column)
|
|
return map(self._nametowidget,
|
|
self.tk.splitlist(self.tk.call(
|
|
('grid', 'slaves', self._w) + args)))
|
|
|
|
# Support for the "event" command, new in Tk 4.2.
|
|
# By Case Roole.
|
|
|
|
def event_add(self, virtual, *sequences):
|
|
args = ('event', 'add', virtual) + sequences
|
|
self.tk.call(args)
|
|
|
|
def event_delete(self, virtual, *sequences):
|
|
args = ('event', 'delete', virtual) + sequences
|
|
self.tk.call(args)
|
|
|
|
def event_generate(self, sequence, **kw):
|
|
args = ('event', 'generate', self._w, sequence)
|
|
for k, v in kw.items():
|
|
args = args + ('-%s' % k, str(v))
|
|
self.tk.call(args)
|
|
|
|
def event_info(self, virtual=None):
|
|
return self.tk.splitlist(
|
|
self.tk.call('event', 'info', virtual))
|
|
|
|
# Image related commands
|
|
|
|
def image_names(self):
|
|
return self.tk.call('image', 'names')
|
|
|
|
def image_types(self):
|
|
return self.tk.call('image', 'types')
|
|
|
|
|
|
class CallWrapper:
|
|
def __init__(self, func, subst, widget):
|
|
self.func = func
|
|
self.subst = subst
|
|
self.widget = widget
|
|
def __call__(self, *args):
|
|
try:
|
|
if self.subst:
|
|
args = apply(self.subst, args)
|
|
return apply(self.func, args)
|
|
except SystemExit, msg:
|
|
raise SystemExit, msg
|
|
except:
|
|
self.widget._report_exception()
|
|
|
|
|
|
class Wm:
|
|
def wm_aspect(self,
|
|
minNumer=None, minDenom=None,
|
|
maxNumer=None, maxDenom=None):
|
|
return self._getints(
|
|
self.tk.call('wm', 'aspect', self._w,
|
|
minNumer, minDenom,
|
|
maxNumer, maxDenom))
|
|
aspect = wm_aspect
|
|
def wm_client(self, name=None):
|
|
return self.tk.call('wm', 'client', self._w, name)
|
|
client = wm_client
|
|
def wm_colormapwindows(self, *wlist):
|
|
args = ('wm', 'colormapwindows', self._w) + _flatten(wlist)
|
|
return map(self._nametowidget, self.tk.call(args))
|
|
colormapwindows = wm_colormapwindows
|
|
def wm_command(self, value=None):
|
|
return self.tk.call('wm', 'command', self._w, value)
|
|
command = wm_command
|
|
def wm_deiconify(self):
|
|
return self.tk.call('wm', 'deiconify', self._w)
|
|
deiconify = wm_deiconify
|
|
def wm_focusmodel(self, model=None):
|
|
return self.tk.call('wm', 'focusmodel', self._w, model)
|
|
focusmodel = wm_focusmodel
|
|
def wm_frame(self):
|
|
return self.tk.call('wm', 'frame', self._w)
|
|
frame = wm_frame
|
|
def wm_geometry(self, newGeometry=None):
|
|
return self.tk.call('wm', 'geometry', self._w, newGeometry)
|
|
geometry = wm_geometry
|
|
def wm_grid(self,
|
|
baseWidth=None, baseHeight=None,
|
|
widthInc=None, heightInc=None):
|
|
return self._getints(self.tk.call(
|
|
'wm', 'grid', self._w,
|
|
baseWidth, baseHeight, widthInc, heightInc))
|
|
grid = wm_grid
|
|
def wm_group(self, pathName=None):
|
|
return self.tk.call('wm', 'group', self._w, pathName)
|
|
group = wm_group
|
|
def wm_iconbitmap(self, bitmap=None):
|
|
return self.tk.call('wm', 'iconbitmap', self._w, bitmap)
|
|
iconbitmap = wm_iconbitmap
|
|
def wm_iconify(self):
|
|
return self.tk.call('wm', 'iconify', self._w)
|
|
iconify = wm_iconify
|
|
def wm_iconmask(self, bitmap=None):
|
|
return self.tk.call('wm', 'iconmask', self._w, bitmap)
|
|
iconmask = wm_iconmask
|
|
def wm_iconname(self, newName=None):
|
|
return self.tk.call('wm', 'iconname', self._w, newName)
|
|
iconname = wm_iconname
|
|
def wm_iconposition(self, x=None, y=None):
|
|
return self._getints(self.tk.call(
|
|
'wm', 'iconposition', self._w, x, y))
|
|
iconposition = wm_iconposition
|
|
def wm_iconwindow(self, pathName=None):
|
|
return self.tk.call('wm', 'iconwindow', self._w, pathName)
|
|
iconwindow = wm_iconwindow
|
|
def wm_maxsize(self, width=None, height=None):
|
|
return self._getints(self.tk.call(
|
|
'wm', 'maxsize', self._w, width, height))
|
|
maxsize = wm_maxsize
|
|
def wm_minsize(self, width=None, height=None):
|
|
return self._getints(self.tk.call(
|
|
'wm', 'minsize', self._w, width, height))
|
|
minsize = wm_minsize
|
|
def wm_overrideredirect(self, boolean=None):
|
|
return self._getboolean(self.tk.call(
|
|
'wm', 'overrideredirect', self._w, boolean))
|
|
overrideredirect = wm_overrideredirect
|
|
def wm_positionfrom(self, who=None):
|
|
return self.tk.call('wm', 'positionfrom', self._w, who)
|
|
positionfrom = wm_positionfrom
|
|
def wm_protocol(self, name=None, func=None):
|
|
if callable(func):
|
|
command = self._register(func)
|
|
else:
|
|
command = func
|
|
return self.tk.call(
|
|
'wm', 'protocol', self._w, name, command)
|
|
protocol = wm_protocol
|
|
def wm_resizable(self, width=None, height=None):
|
|
return self.tk.call('wm', 'resizable', self._w, width, height)
|
|
resizable = wm_resizable
|
|
def wm_sizefrom(self, who=None):
|
|
return self.tk.call('wm', 'sizefrom', self._w, who)
|
|
sizefrom = wm_sizefrom
|
|
def wm_state(self):
|
|
return self.tk.call('wm', 'state', self._w)
|
|
state = wm_state
|
|
def wm_title(self, string=None):
|
|
return self.tk.call('wm', 'title', self._w, string)
|
|
title = wm_title
|
|
def wm_transient(self, master=None):
|
|
return self.tk.call('wm', 'transient', self._w, master)
|
|
transient = wm_transient
|
|
def wm_withdraw(self):
|
|
return self.tk.call('wm', 'withdraw', self._w)
|
|
withdraw = wm_withdraw
|
|
|
|
|
|
class Tk(Misc, Wm):
|
|
_w = '.'
|
|
def __init__(self, screenName=None, baseName=None, className='Tk'):
|
|
global _default_root
|
|
self.master = None
|
|
self.children = {}
|
|
if baseName is None:
|
|
import sys, os
|
|
baseName = os.path.basename(sys.argv[0])
|
|
baseName, ext = os.path.splitext(baseName)
|
|
if ext not in ('.py', '.pyc', '.pyo'):
|
|
baseName = baseName + ext
|
|
self.tk = _tkinter.create(screenName, baseName, className)
|
|
if _MacOS:
|
|
# Disable event scanning except for Command-Period
|
|
_MacOS.SchedParams(1, 0)
|
|
# Work around nasty MacTk bug
|
|
# XXX Is this one still needed?
|
|
self.update()
|
|
# Version sanity checks
|
|
tk_version = self.tk.getvar('tk_version')
|
|
if tk_version != _tkinter.TK_VERSION:
|
|
raise RuntimeError, \
|
|
"tk.h version (%s) doesn't match libtk.a version (%s)" \
|
|
% (_tkinter.TK_VERSION, tk_version)
|
|
tcl_version = self.tk.getvar('tcl_version')
|
|
if tcl_version != _tkinter.TCL_VERSION:
|
|
raise RuntimeError, \
|
|
"tcl.h version (%s) doesn't match libtcl.a version (%s)" \
|
|
% (_tkinter.TCL_VERSION, tcl_version)
|
|
if TkVersion < 4.0:
|
|
raise RuntimeError, \
|
|
"Tk 4.0 or higher is required; found Tk %s" \
|
|
% str(TkVersion)
|
|
self.tk.createcommand('tkerror', _tkerror)
|
|
self.tk.createcommand('exit', _exit)
|
|
self.readprofile(baseName, className)
|
|
if _support_default_root and not _default_root:
|
|
_default_root = self
|
|
def destroy(self):
|
|
for c in self.children.values(): c.destroy()
|
|
self.tk.call('destroy', self._w)
|
|
Misc.destroy(self)
|
|
global _default_root
|
|
if _support_default_root and _default_root is self:
|
|
_default_root = None
|
|
def readprofile(self, baseName, className):
|
|
import os
|
|
if os.environ.has_key('HOME'): home = os.environ['HOME']
|
|
else: home = os.curdir
|
|
class_tcl = os.path.join(home, '.%s.tcl' % className)
|
|
class_py = os.path.join(home, '.%s.py' % className)
|
|
base_tcl = os.path.join(home, '.%s.tcl' % baseName)
|
|
base_py = os.path.join(home, '.%s.py' % baseName)
|
|
dir = {'self': self}
|
|
exec 'from Tkinter import *' in dir
|
|
if os.path.isfile(class_tcl):
|
|
print 'source', `class_tcl`
|
|
self.tk.call('source', class_tcl)
|
|
if os.path.isfile(class_py):
|
|
print 'execfile', `class_py`
|
|
execfile(class_py, dir)
|
|
if os.path.isfile(base_tcl):
|
|
print 'source', `base_tcl`
|
|
self.tk.call('source', base_tcl)
|
|
if os.path.isfile(base_py):
|
|
print 'execfile', `base_py`
|
|
execfile(base_py, dir)
|
|
def report_callback_exception(self, exc, val, tb):
|
|
import traceback, sys
|
|
sys.stderr.write("Exception in Tkinter callback\n")
|
|
sys.last_type = exc
|
|
sys.last_value = val
|
|
sys.last_traceback = tb
|
|
traceback.print_exception(exc, val, tb)
|
|
|
|
# Ideally, the classes Pack, Place and Grid disappear, the
|
|
# pack/place/grid methods are defined on the Widget class, and
|
|
# everybody uses w.pack_whatever(...) instead of Pack.whatever(w,
|
|
# ...), with pack(), place() and grid() being short for
|
|
# pack_configure(), place_configure() and grid_columnconfigure(), and
|
|
# forget() being short for pack_forget(). As a practical matter, I'm
|
|
# afraid that there is too much code out there that may be using the
|
|
# Pack, Place or Grid class, so I leave them intact -- but only as
|
|
# backwards compatibility features. Also note that those methods that
|
|
# take a master as argument (e.g. pack_propagate) have been moved to
|
|
# the Misc class (which now incorporates all methods common between
|
|
# toplevel and interior widgets). Again, for compatibility, these are
|
|
# copied into the Pack, Place or Grid class.
|
|
|
|
class Pack:
|
|
def pack_configure(self, cnf={}, **kw):
|
|
self.tk.call(
|
|
('pack', 'configure', self._w)
|
|
+ self._options(cnf, kw))
|
|
pack = configure = config = pack_configure
|
|
def pack_forget(self):
|
|
self.tk.call('pack', 'forget', self._w)
|
|
forget = pack_forget
|
|
def pack_info(self):
|
|
words = self.tk.splitlist(
|
|
self.tk.call('pack', 'info', self._w))
|
|
dict = {}
|
|
for i in range(0, len(words), 2):
|
|
key = words[i][1:]
|
|
value = words[i+1]
|
|
if value[:1] == '.':
|
|
value = self._nametowidget(value)
|
|
dict[key] = value
|
|
return dict
|
|
info = pack_info
|
|
propagate = pack_propagate = Misc.pack_propagate
|
|
slaves = pack_slaves = Misc.pack_slaves
|
|
|
|
class Place:
|
|
def place_configure(self, cnf={}, **kw):
|
|
for k in ['in_']:
|
|
if kw.has_key(k):
|
|
kw[k[:-1]] = kw[k]
|
|
del kw[k]
|
|
self.tk.call(
|
|
('place', 'configure', self._w)
|
|
+ self._options(cnf, kw))
|
|
place = configure = config = place_configure
|
|
def place_forget(self):
|
|
self.tk.call('place', 'forget', self._w)
|
|
forget = place_forget
|
|
def place_info(self):
|
|
words = self.tk.splitlist(
|
|
self.tk.call('place', 'info', self._w))
|
|
dict = {}
|
|
for i in range(0, len(words), 2):
|
|
key = words[i][1:]
|
|
value = words[i+1]
|
|
if value[:1] == '.':
|
|
value = self._nametowidget(value)
|
|
dict[key] = value
|
|
return dict
|
|
info = place_info
|
|
slaves = place_slaves = Misc.place_slaves
|
|
|
|
class Grid:
|
|
# Thanks to Masazumi Yoshikawa (yosikawa@isi.edu)
|
|
def grid_configure(self, cnf={}, **kw):
|
|
self.tk.call(
|
|
('grid', 'configure', self._w)
|
|
+ self._options(cnf, kw))
|
|
grid = configure = config = grid_configure
|
|
bbox = grid_bbox = Misc.grid_bbox
|
|
columnconfigure = grid_columnconfigure = Misc.grid_columnconfigure
|
|
def grid_forget(self):
|
|
self.tk.call('grid', 'forget', self._w)
|
|
forget = grid_forget
|
|
def grid_info(self):
|
|
words = self.tk.splitlist(
|
|
self.tk.call('grid', 'info', self._w))
|
|
dict = {}
|
|
for i in range(0, len(words), 2):
|
|
key = words[i][1:]
|
|
value = words[i+1]
|
|
if value[:1] == '.':
|
|
value = self._nametowidget(value)
|
|
dict[key] = value
|
|
return dict
|
|
info = grid_info
|
|
def grid_location(self, x, y):
|
|
return self._getints(
|
|
self.tk.call(
|
|
'grid', 'location', self._w, x, y)) or None
|
|
location = grid_location
|
|
propagate = grid_propagate = Misc.grid_propagate
|
|
rowconfigure = grid_rowconfigure = Misc.grid_rowconfigure
|
|
size = grid_size = Misc.grid_size
|
|
slaves = grid_slaves = Misc.grid_slaves
|
|
|
|
class BaseWidget(Misc):
|
|
def _setup(self, master, cnf):
|
|
if _support_default_root:
|
|
global _default_root
|
|
if not master:
|
|
if not _default_root:
|
|
_default_root = Tk()
|
|
master = _default_root
|
|
self.master = master
|
|
self.tk = master.tk
|
|
name = None
|
|
if cnf.has_key('name'):
|
|
name = cnf['name']
|
|
del cnf['name']
|
|
if not name:
|
|
name = `id(self)`
|
|
self._name = name
|
|
if master._w=='.':
|
|
self._w = '.' + name
|
|
else:
|
|
self._w = master._w + '.' + name
|
|
self.children = {}
|
|
if self.master.children.has_key(self._name):
|
|
self.master.children[self._name].destroy()
|
|
self.master.children[self._name] = self
|
|
def __init__(self, master, widgetName, cnf={}, kw={}, extra=()):
|
|
if kw:
|
|
cnf = _cnfmerge((cnf, kw))
|
|
self.widgetName = widgetName
|
|
BaseWidget._setup(self, master, cnf)
|
|
classes = []
|
|
for k in cnf.keys():
|
|
if type(k) is ClassType:
|
|
classes.append((k, cnf[k]))
|
|
del cnf[k]
|
|
self.tk.call(
|
|
(widgetName, self._w) + extra + self._options(cnf))
|
|
for k, v in classes:
|
|
k.configure(self, v)
|
|
def destroy(self):
|
|
for c in self.children.values(): c.destroy()
|
|
if self.master.children.has_key(self._name):
|
|
del self.master.children[self._name]
|
|
self.tk.call('destroy', self._w)
|
|
Misc.destroy(self)
|
|
def _do(self, name, args=()):
|
|
# XXX Obsolete -- better use self.tk.call directly!
|
|
return self.tk.call((self._w, name) + args)
|
|
|
|
class Widget(BaseWidget, Pack, Place, Grid):
|
|
pass
|
|
|
|
class Toplevel(BaseWidget, Wm):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
if kw:
|
|
cnf = _cnfmerge((cnf, kw))
|
|
extra = ()
|
|
for wmkey in ['screen', 'class_', 'class', 'visual',
|
|
'colormap']:
|
|
if cnf.has_key(wmkey):
|
|
val = cnf[wmkey]
|
|
# TBD: a hack needed because some keys
|
|
# are not valid as keyword arguments
|
|
if wmkey[-1] == '_': opt = '-'+wmkey[:-1]
|
|
else: opt = '-'+wmkey
|
|
extra = extra + (opt, val)
|
|
del cnf[wmkey]
|
|
BaseWidget.__init__(self, master, 'toplevel', cnf, {}, extra)
|
|
root = self._root()
|
|
self.iconname(root.iconname())
|
|
self.title(root.title())
|
|
|
|
class Button(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'button', cnf, kw)
|
|
def tkButtonEnter(self, *dummy):
|
|
self.tk.call('tkButtonEnter', self._w)
|
|
def tkButtonLeave(self, *dummy):
|
|
self.tk.call('tkButtonLeave', self._w)
|
|
def tkButtonDown(self, *dummy):
|
|
self.tk.call('tkButtonDown', self._w)
|
|
def tkButtonUp(self, *dummy):
|
|
self.tk.call('tkButtonUp', self._w)
|
|
def tkButtonInvoke(self, *dummy):
|
|
self.tk.call('tkButtonInvoke', self._w)
|
|
def flash(self):
|
|
self.tk.call(self._w, 'flash')
|
|
def invoke(self):
|
|
return self.tk.call(self._w, 'invoke')
|
|
|
|
# Indices:
|
|
# XXX I don't like these -- take them away
|
|
def AtEnd():
|
|
return 'end'
|
|
def AtInsert(*args):
|
|
s = 'insert'
|
|
for a in args:
|
|
if a: s = s + (' ' + a)
|
|
return s
|
|
def AtSelFirst():
|
|
return 'sel.first'
|
|
def AtSelLast():
|
|
return 'sel.last'
|
|
def At(x, y=None):
|
|
if y is None:
|
|
return '@' + `x`
|
|
else:
|
|
return '@' + `x` + ',' + `y`
|
|
|
|
class Canvas(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'canvas', cnf, kw)
|
|
def addtag(self, *args):
|
|
self.tk.call((self._w, 'addtag') + args)
|
|
def addtag_above(self, newtag, tagOrId):
|
|
self.addtag(newtag, 'above', tagOrId)
|
|
def addtag_all(self, newtag):
|
|
self.addtag(newtag, 'all')
|
|
def addtag_below(self, newtag, tagOrId):
|
|
self.addtag(newtag, 'below', tagOrId)
|
|
def addtag_closest(self, newtag, x, y, halo=None, start=None):
|
|
self.addtag(newtag, 'closest', x, y, halo, start)
|
|
def addtag_enclosed(self, newtag, x1, y1, x2, y2):
|
|
self.addtag(newtag, 'enclosed', x1, y1, x2, y2)
|
|
def addtag_overlapping(self, newtag, x1, y1, x2, y2):
|
|
self.addtag(newtag, 'overlapping', x1, y1, x2, y2)
|
|
def addtag_withtag(self, newtag, tagOrId):
|
|
self.addtag(newtag, 'withtag', tagOrId)
|
|
def bbox(self, *args):
|
|
return self._getints(
|
|
self.tk.call((self._w, 'bbox') + args)) or None
|
|
def tag_unbind(self, tagOrId, sequence, funcid=None):
|
|
self.tk.call(self._w, 'bind', tagOrId, sequence, '')
|
|
if funcid:
|
|
self.deletecommand(funcid)
|
|
def tag_bind(self, tagOrId, sequence=None, func=None, add=None):
|
|
return self._bind((self._w, 'bind', tagOrId),
|
|
sequence, func, add)
|
|
def canvasx(self, screenx, gridspacing=None):
|
|
return getdouble(self.tk.call(
|
|
self._w, 'canvasx', screenx, gridspacing))
|
|
def canvasy(self, screeny, gridspacing=None):
|
|
return getdouble(self.tk.call(
|
|
self._w, 'canvasy', screeny, gridspacing))
|
|
def coords(self, *args):
|
|
# XXX Should use _flatten on args
|
|
return map(getdouble,
|
|
self.tk.splitlist(
|
|
self.tk.call((self._w, 'coords') + args)))
|
|
def _create(self, itemType, args, kw): # Args: (val, val, ..., cnf={})
|
|
args = _flatten(args)
|
|
cnf = args[-1]
|
|
if type(cnf) in (DictionaryType, TupleType):
|
|
args = args[:-1]
|
|
else:
|
|
cnf = {}
|
|
return getint(apply(
|
|
self.tk.call,
|
|
(self._w, 'create', itemType)
|
|
+ args + self._options(cnf, kw)))
|
|
def create_arc(self, *args, **kw):
|
|
return self._create('arc', args, kw)
|
|
def create_bitmap(self, *args, **kw):
|
|
return self._create('bitmap', args, kw)
|
|
def create_image(self, *args, **kw):
|
|
return self._create('image', args, kw)
|
|
def create_line(self, *args, **kw):
|
|
return self._create('line', args, kw)
|
|
def create_oval(self, *args, **kw):
|
|
return self._create('oval', args, kw)
|
|
def create_polygon(self, *args, **kw):
|
|
return self._create('polygon', args, kw)
|
|
def create_rectangle(self, *args, **kw):
|
|
return self._create('rectangle', args, kw)
|
|
def create_text(self, *args, **kw):
|
|
return self._create('text', args, kw)
|
|
def create_window(self, *args, **kw):
|
|
return self._create('window', args, kw)
|
|
def dchars(self, *args):
|
|
self.tk.call((self._w, 'dchars') + args)
|
|
def delete(self, *args):
|
|
self.tk.call((self._w, 'delete') + args)
|
|
def dtag(self, *args):
|
|
self.tk.call((self._w, 'dtag') + args)
|
|
def find(self, *args):
|
|
return self._getints(
|
|
self.tk.call((self._w, 'find') + args)) or ()
|
|
def find_above(self, tagOrId):
|
|
return self.find('above', tagOrId)
|
|
def find_all(self):
|
|
return self.find('all')
|
|
def find_below(self, tagOrId):
|
|
return self.find('below', tagOrId)
|
|
def find_closest(self, x, y, halo=None, start=None):
|
|
return self.find('closest', x, y, halo, start)
|
|
def find_enclosed(self, x1, y1, x2, y2):
|
|
return self.find('enclosed', x1, y1, x2, y2)
|
|
def find_overlapping(self, x1, y1, x2, y2):
|
|
return self.find('overlapping', x1, y1, x2, y2)
|
|
def find_withtag(self, tagOrId):
|
|
return self.find('withtag', tagOrId)
|
|
def focus(self, *args):
|
|
return self.tk.call((self._w, 'focus') + args)
|
|
def gettags(self, *args):
|
|
return self.tk.splitlist(
|
|
self.tk.call((self._w, 'gettags') + args))
|
|
def icursor(self, *args):
|
|
self.tk.call((self._w, 'icursor') + args)
|
|
def index(self, *args):
|
|
return getint(self.tk.call((self._w, 'index') + args))
|
|
def insert(self, *args):
|
|
self.tk.call((self._w, 'insert') + args)
|
|
def itemcget(self, tagOrId, option):
|
|
return self.tk.call(
|
|
(self._w, 'itemcget') + (tagOrId, '-'+option))
|
|
def itemconfigure(self, tagOrId, cnf=None, **kw):
|
|
if cnf is None and not kw:
|
|
cnf = {}
|
|
for x in self.tk.split(
|
|
self.tk.call(self._w,
|
|
'itemconfigure', tagOrId)):
|
|
cnf[x[0][1:]] = (x[0][1:],) + x[1:]
|
|
return cnf
|
|
if type(cnf) == StringType and not kw:
|
|
x = self.tk.split(self.tk.call(
|
|
self._w, 'itemconfigure', tagOrId, '-'+cnf))
|
|
return (x[0][1:],) + x[1:]
|
|
self.tk.call((self._w, 'itemconfigure', tagOrId) +
|
|
self._options(cnf, kw))
|
|
itemconfig = itemconfigure
|
|
def lower(self, *args):
|
|
self.tk.call((self._w, 'lower') + args)
|
|
def move(self, *args):
|
|
self.tk.call((self._w, 'move') + args)
|
|
def postscript(self, cnf={}, **kw):
|
|
return self.tk.call((self._w, 'postscript') +
|
|
self._options(cnf, kw))
|
|
def tkraise(self, *args):
|
|
self.tk.call((self._w, 'raise') + args)
|
|
lift = tkraise
|
|
def scale(self, *args):
|
|
self.tk.call((self._w, 'scale') + args)
|
|
def scan_mark(self, x, y):
|
|
self.tk.call(self._w, 'scan', 'mark', x, y)
|
|
def scan_dragto(self, x, y):
|
|
self.tk.call(self._w, 'scan', 'dragto', x, y)
|
|
def select_adjust(self, tagOrId, index):
|
|
self.tk.call(self._w, 'select', 'adjust', tagOrId, index)
|
|
def select_clear(self):
|
|
self.tk.call(self._w, 'select', 'clear')
|
|
def select_from(self, tagOrId, index):
|
|
self.tk.call(self._w, 'select', 'from', tagOrId, index)
|
|
def select_item(self):
|
|
self.tk.call(self._w, 'select', 'item')
|
|
def select_to(self, tagOrId, index):
|
|
self.tk.call(self._w, 'select', 'to', tagOrId, index)
|
|
def type(self, tagOrId):
|
|
return self.tk.call(self._w, 'type', tagOrId) or None
|
|
def xview(self, *args):
|
|
if not args:
|
|
return self._getdoubles(self.tk.call(self._w, 'xview'))
|
|
self.tk.call((self._w, 'xview') + args)
|
|
def xview_moveto(self, fraction):
|
|
self.tk.call(self._w, 'xview', 'moveto', fraction)
|
|
def xview_scroll(self, number, what):
|
|
self.tk.call(self._w, 'xview', 'scroll', number, what)
|
|
def yview(self, *args):
|
|
if not args:
|
|
return self._getdoubles(self.tk.call(self._w, 'yview'))
|
|
self.tk.call((self._w, 'yview') + args)
|
|
def yview_moveto(self, fraction):
|
|
self.tk.call(self._w, 'yview', 'moveto', fraction)
|
|
def yview_scroll(self, number, what):
|
|
self.tk.call(self._w, 'yview', 'scroll', number, what)
|
|
|
|
class Checkbutton(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'checkbutton', cnf, kw)
|
|
def deselect(self):
|
|
self.tk.call(self._w, 'deselect')
|
|
def flash(self):
|
|
self.tk.call(self._w, 'flash')
|
|
def invoke(self):
|
|
return self.tk.call(self._w, 'invoke')
|
|
def select(self):
|
|
self.tk.call(self._w, 'select')
|
|
def toggle(self):
|
|
self.tk.call(self._w, 'toggle')
|
|
|
|
class Entry(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'entry', cnf, kw)
|
|
def delete(self, first, last=None):
|
|
self.tk.call(self._w, 'delete', first, last)
|
|
def get(self):
|
|
return self.tk.call(self._w, 'get')
|
|
def icursor(self, index):
|
|
self.tk.call(self._w, 'icursor', index)
|
|
def index(self, index):
|
|
return getint(self.tk.call(
|
|
self._w, 'index', index))
|
|
def insert(self, index, string):
|
|
self.tk.call(self._w, 'insert', index, string)
|
|
def scan_mark(self, x):
|
|
self.tk.call(self._w, 'scan', 'mark', x)
|
|
def scan_dragto(self, x):
|
|
self.tk.call(self._w, 'scan', 'dragto', x)
|
|
def selection_adjust(self, index):
|
|
self.tk.call(self._w, 'selection', 'adjust', index)
|
|
select_adjust = selection_adjust
|
|
def selection_clear(self):
|
|
self.tk.call(self._w, 'selection', 'clear')
|
|
select_clear = selection_clear
|
|
def selection_from(self, index):
|
|
self.tk.call(self._w, 'selection', 'from', index)
|
|
select_from = selection_from
|
|
def selection_present(self):
|
|
return self.tk.getboolean(
|
|
self.tk.call(self._w, 'selection', 'present'))
|
|
select_present = selection_present
|
|
def selection_range(self, start, end):
|
|
self.tk.call(self._w, 'selection', 'range', start, end)
|
|
select_range = selection_range
|
|
def selection_to(self, index):
|
|
self.tk.call(self._w, 'selection', 'to', index)
|
|
select_to = selection_to
|
|
def xview(self, index):
|
|
self.tk.call(self._w, 'xview', index)
|
|
def xview_moveto(self, fraction):
|
|
self.tk.call(self._w, 'xview', 'moveto', fraction)
|
|
def xview_scroll(self, number, what):
|
|
self.tk.call(self._w, 'xview', 'scroll', number, what)
|
|
|
|
class Frame(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
cnf = _cnfmerge((cnf, kw))
|
|
extra = ()
|
|
if cnf.has_key('class_'):
|
|
extra = ('-class', cnf['class_'])
|
|
del cnf['class_']
|
|
elif cnf.has_key('class'):
|
|
extra = ('-class', cnf['class'])
|
|
del cnf['class']
|
|
Widget.__init__(self, master, 'frame', cnf, {}, extra)
|
|
|
|
class Label(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'label', cnf, kw)
|
|
|
|
class Listbox(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'listbox', cnf, kw)
|
|
def activate(self, index):
|
|
self.tk.call(self._w, 'activate', index)
|
|
def bbox(self, *args):
|
|
return self._getints(
|
|
self.tk.call((self._w, 'bbox') + args)) or None
|
|
def curselection(self):
|
|
# XXX Ought to apply self._getints()...
|
|
return self.tk.splitlist(self.tk.call(
|
|
self._w, 'curselection'))
|
|
def delete(self, first, last=None):
|
|
self.tk.call(self._w, 'delete', first, last)
|
|
def get(self, first, last=None):
|
|
if last:
|
|
return self.tk.splitlist(self.tk.call(
|
|
self._w, 'get', first, last))
|
|
else:
|
|
return self.tk.call(self._w, 'get', first)
|
|
def index(self, index):
|
|
i = self.tk.call(self._w, 'index', index)
|
|
if i == 'none': return None
|
|
return getint(i)
|
|
def insert(self, index, *elements):
|
|
self.tk.call((self._w, 'insert', index) + elements)
|
|
def nearest(self, y):
|
|
return getint(self.tk.call(
|
|
self._w, 'nearest', y))
|
|
def scan_mark(self, x, y):
|
|
self.tk.call(self._w, 'scan', 'mark', x, y)
|
|
def scan_dragto(self, x, y):
|
|
self.tk.call(self._w, 'scan', 'dragto', x, y)
|
|
def see(self, index):
|
|
self.tk.call(self._w, 'see', index)
|
|
def selection_anchor(self, index):
|
|
self.tk.call(self._w, 'selection', 'anchor', index)
|
|
select_anchor = selection_anchor
|
|
def selection_clear(self, first, last=None):
|
|
self.tk.call(self._w,
|
|
'selection', 'clear', first, last)
|
|
select_clear = selection_clear
|
|
def selection_includes(self, index):
|
|
return self.tk.getboolean(self.tk.call(
|
|
self._w, 'selection', 'includes', index))
|
|
select_includes = selection_includes
|
|
def selection_set(self, first, last=None):
|
|
self.tk.call(self._w, 'selection', 'set', first, last)
|
|
select_set = selection_set
|
|
def size(self):
|
|
return getint(self.tk.call(self._w, 'size'))
|
|
def xview(self, *what):
|
|
if not what:
|
|
return self._getdoubles(self.tk.call(self._w, 'xview'))
|
|
self.tk.call((self._w, 'xview') + what)
|
|
def xview_moveto(self, fraction):
|
|
self.tk.call(self._w, 'xview', 'moveto', fraction)
|
|
def xview_scroll(self, number, what):
|
|
self.tk.call(self._w, 'xview', 'scroll', number, what)
|
|
def yview(self, *what):
|
|
if not what:
|
|
return self._getdoubles(self.tk.call(self._w, 'yview'))
|
|
self.tk.call((self._w, 'yview') + what)
|
|
def yview_moveto(self, fraction):
|
|
self.tk.call(self._w, 'yview', 'moveto', fraction)
|
|
def yview_scroll(self, number, what):
|
|
self.tk.call(self._w, 'yview', 'scroll', number, what)
|
|
|
|
class Menu(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'menu', cnf, kw)
|
|
def tk_bindForTraversal(self):
|
|
pass # obsolete since Tk 4.0
|
|
def tk_mbPost(self):
|
|
self.tk.call('tk_mbPost', self._w)
|
|
def tk_mbUnpost(self):
|
|
self.tk.call('tk_mbUnpost')
|
|
def tk_traverseToMenu(self, char):
|
|
self.tk.call('tk_traverseToMenu', self._w, char)
|
|
def tk_traverseWithinMenu(self, char):
|
|
self.tk.call('tk_traverseWithinMenu', self._w, char)
|
|
def tk_getMenuButtons(self):
|
|
return self.tk.call('tk_getMenuButtons', self._w)
|
|
def tk_nextMenu(self, count):
|
|
self.tk.call('tk_nextMenu', count)
|
|
def tk_nextMenuEntry(self, count):
|
|
self.tk.call('tk_nextMenuEntry', count)
|
|
def tk_invokeMenu(self):
|
|
self.tk.call('tk_invokeMenu', self._w)
|
|
def tk_firstMenu(self):
|
|
self.tk.call('tk_firstMenu', self._w)
|
|
def tk_mbButtonDown(self):
|
|
self.tk.call('tk_mbButtonDown', self._w)
|
|
def tk_popup(self, x, y, entry=""):
|
|
self.tk.call('tk_popup', self._w, x, y, entry)
|
|
def activate(self, index):
|
|
self.tk.call(self._w, 'activate', index)
|
|
def add(self, itemType, cnf={}, **kw):
|
|
self.tk.call((self._w, 'add', itemType) +
|
|
self._options(cnf, kw))
|
|
def add_cascade(self, cnf={}, **kw):
|
|
self.add('cascade', cnf or kw)
|
|
def add_checkbutton(self, cnf={}, **kw):
|
|
self.add('checkbutton', cnf or kw)
|
|
def add_command(self, cnf={}, **kw):
|
|
self.add('command', cnf or kw)
|
|
def add_radiobutton(self, cnf={}, **kw):
|
|
self.add('radiobutton', cnf or kw)
|
|
def add_separator(self, cnf={}, **kw):
|
|
self.add('separator', cnf or kw)
|
|
def insert(self, index, itemType, cnf={}, **kw):
|
|
self.tk.call((self._w, 'insert', index, itemType) +
|
|
self._options(cnf, kw))
|
|
def insert_cascade(self, index, cnf={}, **kw):
|
|
self.insert(index, 'cascade', cnf or kw)
|
|
def insert_checkbutton(self, index, cnf={}, **kw):
|
|
self.insert(index, 'checkbutton', cnf or kw)
|
|
def insert_command(self, index, cnf={}, **kw):
|
|
self.insert(index, 'command', cnf or kw)
|
|
def insert_radiobutton(self, index, cnf={}, **kw):
|
|
self.insert(index, 'radiobutton', cnf or kw)
|
|
def insert_separator(self, index, cnf={}, **kw):
|
|
self.insert(index, 'separator', cnf or kw)
|
|
def delete(self, index1, index2=None):
|
|
self.tk.call(self._w, 'delete', index1, index2)
|
|
def entrycget(self, index, option):
|
|
return self.tk.call(self._w, 'entrycget', index, '-' + option)
|
|
def entryconfigure(self, index, cnf=None, **kw):
|
|
if cnf is None and not kw:
|
|
cnf = {}
|
|
for x in self.tk.split(self.tk.call(
|
|
(self._w, 'entryconfigure', index))):
|
|
cnf[x[0][1:]] = (x[0][1:],) + x[1:]
|
|
return cnf
|
|
if type(cnf) == StringType and not kw:
|
|
x = self.tk.split(self.tk.call(
|
|
(self._w, 'entryconfigure', index, '-'+cnf)))
|
|
return (x[0][1:],) + x[1:]
|
|
self.tk.call((self._w, 'entryconfigure', index)
|
|
+ self._options(cnf, kw))
|
|
entryconfig = entryconfigure
|
|
def index(self, index):
|
|
i = self.tk.call(self._w, 'index', index)
|
|
if i == 'none': return None
|
|
return getint(i)
|
|
def invoke(self, index):
|
|
return self.tk.call(self._w, 'invoke', index)
|
|
def post(self, x, y):
|
|
self.tk.call(self._w, 'post', x, y)
|
|
def type(self, index):
|
|
return self.tk.call(self._w, 'type', index)
|
|
def unpost(self):
|
|
self.tk.call(self._w, 'unpost')
|
|
def yposition(self, index):
|
|
return getint(self.tk.call(
|
|
self._w, 'yposition', index))
|
|
|
|
class Menubutton(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'menubutton', cnf, kw)
|
|
|
|
class Message(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'message', cnf, kw)
|
|
|
|
class Radiobutton(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'radiobutton', cnf, kw)
|
|
def deselect(self):
|
|
self.tk.call(self._w, 'deselect')
|
|
def flash(self):
|
|
self.tk.call(self._w, 'flash')
|
|
def invoke(self):
|
|
return self.tk.call(self._w, 'invoke')
|
|
def select(self):
|
|
self.tk.call(self._w, 'select')
|
|
|
|
class Scale(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'scale', cnf, kw)
|
|
def get(self):
|
|
value = self.tk.call(self._w, 'get')
|
|
try:
|
|
return getint(value)
|
|
except ValueError:
|
|
return getdouble(value)
|
|
def set(self, value):
|
|
self.tk.call(self._w, 'set', value)
|
|
def coords(self, value=None):
|
|
return self._getints(self.tk.call(self._w, 'coords', value))
|
|
def identify(self, x, y):
|
|
return self.tk.call(self._w, 'identify', x, y)
|
|
|
|
class Scrollbar(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'scrollbar', cnf, kw)
|
|
def activate(self, index):
|
|
self.tk.call(self._w, 'activate', index)
|
|
def delta(self, deltax, deltay):
|
|
return getdouble(
|
|
self.tk.call(self._w, 'delta', deltax, deltay))
|
|
def fraction(self, x, y):
|
|
return getdouble(self.tk.call(self._w, 'fraction', x, y))
|
|
def identify(self, x, y):
|
|
return self.tk.call(self._w, 'identify', x, y)
|
|
def get(self):
|
|
return self._getdoubles(self.tk.call(self._w, 'get'))
|
|
def set(self, *args):
|
|
self.tk.call((self._w, 'set') + args)
|
|
|
|
class Text(Widget):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'text', cnf, kw)
|
|
def bbox(self, *args):
|
|
return self._getints(
|
|
self.tk.call((self._w, 'bbox') + args)) or None
|
|
def tk_textSelectTo(self, index):
|
|
self.tk.call('tk_textSelectTo', self._w, index)
|
|
def tk_textBackspace(self):
|
|
self.tk.call('tk_textBackspace', self._w)
|
|
def tk_textIndexCloser(self, a, b, c):
|
|
self.tk.call('tk_textIndexCloser', self._w, a, b, c)
|
|
def tk_textResetAnchor(self, index):
|
|
self.tk.call('tk_textResetAnchor', self._w, index)
|
|
def compare(self, index1, op, index2):
|
|
return self.tk.getboolean(self.tk.call(
|
|
self._w, 'compare', index1, op, index2))
|
|
def debug(self, boolean=None):
|
|
return self.tk.getboolean(self.tk.call(
|
|
self._w, 'debug', boolean))
|
|
def delete(self, index1, index2=None):
|
|
self.tk.call(self._w, 'delete', index1, index2)
|
|
def dlineinfo(self, index):
|
|
return self._getints(self.tk.call(self._w, 'dlineinfo', index))
|
|
def get(self, index1, index2=None):
|
|
return self.tk.call(self._w, 'get', index1, index2)
|
|
# (Image commands are new in 8.0)
|
|
def image_cget(self, index, option):
|
|
if option[:1] != "-":
|
|
option = "-" + option
|
|
if option[-1:] == "_":
|
|
option = option[:-1]
|
|
return self.tk.call(self._w, "image", "cget", index, option)
|
|
def image_configure(self, index, cnf={}, **kw):
|
|
if not cnf and not kw:
|
|
cnf = {}
|
|
for x in self.tk.split(
|
|
self.tk.call(
|
|
self._w, "image", "configure", index)):
|
|
cnf[x[0][1:]] = (x[0][1:],) + x[1:]
|
|
return cnf
|
|
apply(self.tk.call,
|
|
(self._w, "image", "configure", index)
|
|
+ self._options(cnf, kw))
|
|
def image_create(self, index, cnf={}, **kw):
|
|
return apply(self.tk.call,
|
|
(self._w, "image", "create", index)
|
|
+ self._options(cnf, kw))
|
|
def image_names(self):
|
|
return self.tk.call(self._w, "image", "names")
|
|
def index(self, index):
|
|
return self.tk.call(self._w, 'index', index)
|
|
def insert(self, index, chars, *args):
|
|
self.tk.call((self._w, 'insert', index, chars) + args)
|
|
def mark_gravity(self, markName, direction=None):
|
|
return self.tk.call(
|
|
(self._w, 'mark', 'gravity', markName, direction))
|
|
def mark_names(self):
|
|
return self.tk.splitlist(self.tk.call(
|
|
self._w, 'mark', 'names'))
|
|
def mark_set(self, markName, index):
|
|
self.tk.call(self._w, 'mark', 'set', markName, index)
|
|
def mark_unset(self, *markNames):
|
|
self.tk.call((self._w, 'mark', 'unset') + markNames)
|
|
def scan_mark(self, x, y):
|
|
self.tk.call(self._w, 'scan', 'mark', x, y)
|
|
def scan_dragto(self, x, y):
|
|
self.tk.call(self._w, 'scan', 'dragto', x, y)
|
|
def search(self, pattern, index, stopindex=None,
|
|
forwards=None, backwards=None, exact=None,
|
|
regexp=None, nocase=None, count=None):
|
|
args = [self._w, 'search']
|
|
if forwards: args.append('-forwards')
|
|
if backwards: args.append('-backwards')
|
|
if exact: args.append('-exact')
|
|
if regexp: args.append('-regexp')
|
|
if nocase: args.append('-nocase')
|
|
if count: args.append('-count'); args.append(count)
|
|
if pattern[0] == '-': args.append('--')
|
|
args.append(pattern)
|
|
args.append(index)
|
|
if stopindex: args.append(stopindex)
|
|
return self.tk.call(tuple(args))
|
|
def see(self, index):
|
|
self.tk.call(self._w, 'see', index)
|
|
def tag_add(self, tagName, index1, index2=None):
|
|
self.tk.call(
|
|
self._w, 'tag', 'add', tagName, index1, index2)
|
|
def tag_unbind(self, tagName, sequence, funcid=None):
|
|
self.tk.call(self._w, 'tag', 'bind', tagName, sequence, '')
|
|
if funcid:
|
|
self.deletecommand(funcid)
|
|
def tag_bind(self, tagName, sequence, func, add=None):
|
|
return self._bind((self._w, 'tag', 'bind', tagName),
|
|
sequence, func, add)
|
|
def tag_cget(self, tagName, option):
|
|
if option[:1] != '-':
|
|
option = '-' + option
|
|
if option[-1:] == '_':
|
|
option = option[:-1]
|
|
return self.tk.call(self._w, 'tag', 'cget', tagName, option)
|
|
def tag_configure(self, tagName, cnf={}, **kw):
|
|
if type(cnf) == StringType:
|
|
x = self.tk.split(self.tk.call(
|
|
self._w, 'tag', 'configure', tagName, '-'+cnf))
|
|
return (x[0][1:],) + x[1:]
|
|
self.tk.call(
|
|
(self._w, 'tag', 'configure', tagName)
|
|
+ self._options(cnf, kw))
|
|
tag_config = tag_configure
|
|
def tag_delete(self, *tagNames):
|
|
self.tk.call((self._w, 'tag', 'delete') + tagNames)
|
|
def tag_lower(self, tagName, belowThis=None):
|
|
self.tk.call(self._w, 'tag', 'lower', tagName, belowThis)
|
|
def tag_names(self, index=None):
|
|
return self.tk.splitlist(
|
|
self.tk.call(self._w, 'tag', 'names', index))
|
|
def tag_nextrange(self, tagName, index1, index2=None):
|
|
return self.tk.splitlist(self.tk.call(
|
|
self._w, 'tag', 'nextrange', tagName, index1, index2))
|
|
def tag_prevrange(self, tagName, index1, index2=None):
|
|
return self.tk.splitlist(self.tk.call(
|
|
self._w, 'tag', 'prevrange', tagName, index1, index2))
|
|
def tag_raise(self, tagName, aboveThis=None):
|
|
self.tk.call(
|
|
self._w, 'tag', 'raise', tagName, aboveThis)
|
|
def tag_ranges(self, tagName):
|
|
return self.tk.splitlist(self.tk.call(
|
|
self._w, 'tag', 'ranges', tagName))
|
|
def tag_remove(self, tagName, index1, index2=None):
|
|
self.tk.call(
|
|
self._w, 'tag', 'remove', tagName, index1, index2)
|
|
def window_cget(self, index, option):
|
|
if option[:1] != '-':
|
|
option = '-' + option
|
|
if option[-1:] == '_':
|
|
option = option[:-1]
|
|
return self.tk.call(self._w, 'window', 'cget', index, option)
|
|
def window_configure(self, index, cnf={}, **kw):
|
|
if type(cnf) == StringType:
|
|
x = self.tk.split(self.tk.call(
|
|
self._w, 'window', 'configure',
|
|
index, '-'+cnf))
|
|
return (x[0][1:],) + x[1:]
|
|
self.tk.call(
|
|
(self._w, 'window', 'configure', index)
|
|
+ self._options(cnf, kw))
|
|
window_config = window_configure
|
|
def window_create(self, index, cnf={}, **kw):
|
|
self.tk.call(
|
|
(self._w, 'window', 'create', index)
|
|
+ self._options(cnf, kw))
|
|
def window_names(self):
|
|
return self.tk.splitlist(
|
|
self.tk.call(self._w, 'window', 'names'))
|
|
def xview(self, *what):
|
|
if not what:
|
|
return self._getdoubles(self.tk.call(self._w, 'xview'))
|
|
self.tk.call((self._w, 'xview') + what)
|
|
def yview(self, *what):
|
|
if not what:
|
|
return self._getdoubles(self.tk.call(self._w, 'yview'))
|
|
self.tk.call((self._w, 'yview') + what)
|
|
def yview_pickplace(self, *what):
|
|
self.tk.call((self._w, 'yview', '-pickplace') + what)
|
|
|
|
class _setit:
|
|
def __init__(self, var, value):
|
|
self.__value = value
|
|
self.__var = var
|
|
def __call__(self, *args):
|
|
self.__var.set(self.__value)
|
|
|
|
class OptionMenu(Menubutton):
|
|
def __init__(self, master, variable, value, *values):
|
|
kw = {"borderwidth": 2, "textvariable": variable,
|
|
"indicatoron": 1, "relief": RAISED, "anchor": "c",
|
|
"highlightthickness": 2}
|
|
Widget.__init__(self, master, "menubutton", kw)
|
|
self.widgetName = 'tk_optionMenu'
|
|
menu = self.__menu = Menu(self, name="menu", tearoff=0)
|
|
self.menuname = menu._w
|
|
menu.add_command(label=value, command=_setit(variable, value))
|
|
for v in values:
|
|
menu.add_command(label=v, command=_setit(variable, v))
|
|
self["menu"] = menu
|
|
|
|
def __getitem__(self, name):
|
|
if name == 'menu':
|
|
return self.__menu
|
|
return Widget.__getitem__(self, name)
|
|
|
|
def destroy(self):
|
|
Menubutton.destroy(self)
|
|
self.__menu = None
|
|
|
|
class Image:
|
|
def __init__(self, imgtype, name=None, cnf={}, master=None, **kw):
|
|
self.name = None
|
|
if not master:
|
|
master = _default_root
|
|
if not master:
|
|
raise RuntimeError, 'Too early to create image'
|
|
self.tk = master.tk
|
|
if not name:
|
|
name = `id(self)`
|
|
# The following is needed for systems where id(x)
|
|
# can return a negative number, such as Linux/m68k:
|
|
if name[0] == '-': name = '_' + name[1:]
|
|
if kw and cnf: cnf = _cnfmerge((cnf, kw))
|
|
elif kw: cnf = kw
|
|
options = ()
|
|
for k, v in cnf.items():
|
|
if callable(v):
|
|
v = self._register(v)
|
|
options = options + ('-'+k, v)
|
|
self.tk.call(('image', 'create', imgtype, name,) + options)
|
|
self.name = name
|
|
def __str__(self): return self.name
|
|
def __del__(self):
|
|
if self.name:
|
|
self.tk.call('image', 'delete', self.name)
|
|
def __setitem__(self, key, value):
|
|
self.tk.call(self.name, 'configure', '-'+key, value)
|
|
def __getitem__(self, key):
|
|
return self.tk.call(self.name, 'configure', '-'+key)
|
|
def configure(self, **kw):
|
|
res = ()
|
|
for k, v in _cnfmerge(kw).items():
|
|
if v is not None:
|
|
if k[-1] == '_': k = k[:-1]
|
|
if callable(v):
|
|
v = self._register(v)
|
|
res = res + ('-'+k, v)
|
|
self.tk.call((self.name, 'config') + res)
|
|
config = configure
|
|
def height(self):
|
|
return getint(
|
|
self.tk.call('image', 'height', self.name))
|
|
def type(self):
|
|
return self.tk.call('image', 'type', self.name)
|
|
def width(self):
|
|
return getint(
|
|
self.tk.call('image', 'width', self.name))
|
|
|
|
class PhotoImage(Image):
|
|
def __init__(self, name=None, cnf={}, master=None, **kw):
|
|
apply(Image.__init__, (self, 'photo', name, cnf, master), kw)
|
|
def blank(self):
|
|
self.tk.call(self.name, 'blank')
|
|
def cget(self, option):
|
|
return self.tk.call(self.name, 'cget', '-' + option)
|
|
# XXX config
|
|
def __getitem__(self, key):
|
|
return self.tk.call(self.name, 'cget', '-' + key)
|
|
# XXX copy -from, -to, ...?
|
|
def copy(self):
|
|
destImage = PhotoImage()
|
|
self.tk.call(destImage, 'copy', self.name)
|
|
return destImage
|
|
def zoom(self,x,y=''):
|
|
destImage = PhotoImage()
|
|
if y=='': y=x
|
|
self.tk.call(destImage, 'copy', self.name, '-zoom',x,y)
|
|
return destImage
|
|
def subsample(self,x,y=''):
|
|
destImage = PhotoImage()
|
|
if y=='': y=x
|
|
self.tk.call(destImage, 'copy', self.name, '-subsample',x,y)
|
|
return destImage
|
|
def get(self, x, y):
|
|
return self.tk.call(self.name, 'get', x, y)
|
|
def put(self, data, to=None):
|
|
args = (self.name, 'put', data)
|
|
if to:
|
|
if to[0] == '-to':
|
|
to = to[1:]
|
|
args = args + ('-to',) + tuple(to)
|
|
self.tk.call(args)
|
|
# XXX read
|
|
def write(self, filename, format=None, from_coords=None):
|
|
args = (self.name, 'write', filename)
|
|
if format:
|
|
args = args + ('-format', format)
|
|
if from_coords:
|
|
args = args + ('-from',) + tuple(from_coords)
|
|
self.tk.call(args)
|
|
|
|
class BitmapImage(Image):
|
|
def __init__(self, name=None, cnf={}, master=None, **kw):
|
|
apply(Image.__init__, (self, 'bitmap', name, cnf, master), kw)
|
|
|
|
def image_names(): return _default_root.tk.call('image', 'names')
|
|
def image_types(): return _default_root.tk.call('image', 'types')
|
|
|
|
######################################################################
|
|
# Extensions:
|
|
|
|
class Studbutton(Button):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'studbutton', cnf, kw)
|
|
self.bind('<Any-Enter>', self.tkButtonEnter)
|
|
self.bind('<Any-Leave>', self.tkButtonLeave)
|
|
self.bind('<1>', self.tkButtonDown)
|
|
self.bind('<ButtonRelease-1>', self.tkButtonUp)
|
|
|
|
class Tributton(Button):
|
|
def __init__(self, master=None, cnf={}, **kw):
|
|
Widget.__init__(self, master, 'tributton', cnf, kw)
|
|
self.bind('<Any-Enter>', self.tkButtonEnter)
|
|
self.bind('<Any-Leave>', self.tkButtonLeave)
|
|
self.bind('<1>', self.tkButtonDown)
|
|
self.bind('<ButtonRelease-1>', self.tkButtonUp)
|
|
self['fg'] = self['bg']
|
|
self['activebackground'] = self['bg']
|
|
|
|
######################################################################
|
|
# Test:
|
|
|
|
def _test():
|
|
root = Tk()
|
|
label = Label(root, text="Proof-of-existence test for Tk")
|
|
label.pack()
|
|
test = Button(root, text="Click me!",
|
|
command=lambda root=root: root.test.configure(
|
|
text="[%s]" % root.test['text']))
|
|
test.pack()
|
|
root.test = test
|
|
quit = Button(root, text="QUIT", command=root.destroy)
|
|
quit.pack()
|
|
# The following three commands are needed so the window pops
|
|
# up on top on Windows...
|
|
root.iconify()
|
|
root.update()
|
|
root.deiconify()
|
|
root.mainloop()
|
|
|
|
if __name__ == '__main__':
|
|
_test()
|