Guido van Rossum | d77d699 | 2007-07-16 23:10:57 +0000 | [diff] [blame] | 1 | # -*-mode: python; fill-column: 75; tab-width: 8 -*- |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 2 | # |
| 3 | # $Id$ |
| 4 | # |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 5 | # Tix.py -- Tix widget wrappers. |
| 6 | # |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 7 | # For Tix, see http://tix.sourceforge.net |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 8 | # |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 9 | # - Sudhir Shenoy (sshenoy@gol.com), Dec. 1995. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 10 | # based on an idea of Jean-Marc Lugrin (lugrin@ms.com) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 11 | # |
| 12 | # NOTE: In order to minimize changes to Tkinter.py, some of the code here |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 13 | # (TixWidget.__init__) has been taken from Tkinter (Widget.__init__) |
| 14 | # and will break if there are major changes in Tkinter. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 15 | # |
| 16 | # The Tix widgets are represented by a class hierarchy in python with proper |
| 17 | # inheritance of base classes. |
| 18 | # |
| 19 | # As a result after creating a 'w = StdButtonBox', I can write |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 20 | # w.ok['text'] = 'Who Cares' |
| 21 | # or w.ok['bg'] = w['bg'] |
| 22 | # or even w.ok.invoke() |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 23 | # etc. |
| 24 | # |
| 25 | # Compare the demo tixwidgets.py to the original Tcl program and you will |
| 26 | # appreciate the advantages. |
| 27 | # |
| 28 | |
Georg Brandl | 14fc427 | 2008-05-17 18:39:55 +0000 | [diff] [blame] | 29 | from tkinter import * |
Victor Stinner | 7fa767e | 2014-03-20 09:16:38 +0100 | [diff] [blame^] | 30 | from tkinter import _cnfmerge, _default_root |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 31 | |
| 32 | # WARNING - TkVersion is a limited precision floating point number |
| 33 | if TkVersion < 3.999: |
Collin Winter | ce36ad8 | 2007-08-30 01:19:48 +0000 | [diff] [blame] | 34 | raise ImportError("This version of Tix.py requires Tk 4.0 or higher") |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 35 | |
| 36 | import _tkinter # If this fails your Python may not be configured for Tk |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 37 | |
| 38 | # Some more constants (for consistency with Tkinter) |
| 39 | WINDOW = 'window' |
| 40 | TEXT = 'text' |
| 41 | STATUS = 'status' |
| 42 | IMMEDIATE = 'immediate' |
| 43 | IMAGE = 'image' |
| 44 | IMAGETEXT = 'imagetext' |
| 45 | BALLOON = 'balloon' |
| 46 | AUTO = 'auto' |
| 47 | ACROSSTOP = 'acrosstop' |
| 48 | |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 49 | # A few useful constants for the Grid widget |
| 50 | ASCII = 'ascii' |
| 51 | CELL = 'cell' |
| 52 | COLUMN = 'column' |
| 53 | DECREASING = 'decreasing' |
| 54 | INCREASING = 'increasing' |
| 55 | INTEGER = 'integer' |
| 56 | MAIN = 'main' |
| 57 | MAX = 'max' |
| 58 | REAL = 'real' |
| 59 | ROW = 'row' |
| 60 | S_REGION = 's-region' |
| 61 | X_REGION = 'x-region' |
| 62 | Y_REGION = 'y-region' |
| 63 | |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 64 | # Some constants used by Tkinter dooneevent() |
| 65 | TCL_DONT_WAIT = 1 << 1 |
| 66 | TCL_WINDOW_EVENTS = 1 << 2 |
| 67 | TCL_FILE_EVENTS = 1 << 3 |
| 68 | TCL_TIMER_EVENTS = 1 << 4 |
| 69 | TCL_IDLE_EVENTS = 1 << 5 |
| 70 | TCL_ALL_EVENTS = 0 |
| 71 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 72 | # BEWARE - this is implemented by copying some code from the Widget class |
| 73 | # in Tkinter (to override Widget initialization) and is therefore |
| 74 | # liable to break. |
Georg Brandl | 14fc427 | 2008-05-17 18:39:55 +0000 | [diff] [blame] | 75 | import tkinter, os |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 76 | |
| 77 | # Could probably add this to Tkinter.Misc |
| 78 | class tixCommand: |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 79 | """The tix commands provide access to miscellaneous elements |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 80 | of Tix's internal state and the Tix application context. |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 81 | Most of the information manipulated by these commands pertains |
| 82 | to the application as a whole, or to a screen or |
| 83 | display, rather than to a particular window. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 84 | |
| 85 | This is a mixin class, assumed to be mixed to Tkinter.Tk |
| 86 | that supports the self.tk.call method. |
| 87 | """ |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 88 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 89 | def tix_addbitmapdir(self, directory): |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 90 | """Tix maintains a list of directories under which |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 91 | the tix_getimage and tix_getbitmap commands will |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 92 | search for image files. The standard bitmap directory |
| 93 | is $TIX_LIBRARY/bitmaps. The addbitmapdir command |
| 94 | adds directory into this list. By using this |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 95 | command, the image files of an applications can |
| 96 | also be located using the tix_getimage or tix_getbitmap |
| 97 | command. |
| 98 | """ |
| 99 | return self.tk.call('tix', 'addbitmapdir', directory) |
| 100 | |
| 101 | def tix_cget(self, option): |
| 102 | """Returns the current value of the configuration |
| 103 | option given by option. Option may be any of the |
| 104 | options described in the CONFIGURATION OPTIONS section. |
| 105 | """ |
| 106 | return self.tk.call('tix', 'cget', option) |
| 107 | |
| 108 | def tix_configure(self, cnf=None, **kw): |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 109 | """Query or modify the configuration options of the Tix application |
| 110 | context. If no option is specified, returns a dictionary all of the |
| 111 | available options. If option is specified with no value, then the |
| 112 | command returns a list describing the one named option (this list |
| 113 | will be identical to the corresponding sublist of the value |
| 114 | returned if no option is specified). If one or more option-value |
| 115 | pairs are specified, then the command modifies the given option(s) |
| 116 | to have the given value(s); in this case the command returns an |
| 117 | empty string. Option may be any of the configuration options. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 118 | """ |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 119 | # Copied from Tkinter.py |
| 120 | if kw: |
| 121 | cnf = _cnfmerge((cnf, kw)) |
| 122 | elif cnf: |
| 123 | cnf = _cnfmerge(cnf) |
| 124 | if cnf is None: |
Serhiy Storchaka | 848972c | 2013-12-25 16:35:38 +0200 | [diff] [blame] | 125 | return self._getconfigure('tix', 'configure') |
Serhiy Storchaka | 975fce3 | 2013-09-16 11:01:31 +0300 | [diff] [blame] | 126 | if isinstance(cnf, str): |
Serhiy Storchaka | 848972c | 2013-12-25 16:35:38 +0200 | [diff] [blame] | 127 | return self._getconfigure1('tix', 'configure', '-'+cnf) |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 128 | return self.tk.call(('tix', 'configure') + self._options(cnf)) |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 129 | |
| 130 | def tix_filedialog(self, dlgclass=None): |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 131 | """Returns the file selection dialog that may be shared among |
| 132 | different calls from this application. This command will create a |
| 133 | file selection dialog widget when it is called the first time. This |
| 134 | dialog will be returned by all subsequent calls to tix_filedialog. |
| 135 | An optional dlgclass parameter can be passed to specified what type |
| 136 | of file selection dialog widget is desired. Possible options are |
| 137 | tix FileSelectDialog or tixExFileSelectDialog. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 138 | """ |
| 139 | if dlgclass is not None: |
| 140 | return self.tk.call('tix', 'filedialog', dlgclass) |
| 141 | else: |
| 142 | return self.tk.call('tix', 'filedialog') |
| 143 | |
| 144 | def tix_getbitmap(self, name): |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 145 | """Locates a bitmap file of the name name.xpm or name in one of the |
| 146 | bitmap directories (see the tix_addbitmapdir command above). By |
| 147 | using tix_getbitmap, you can avoid hard coding the pathnames of the |
| 148 | bitmap files in your application. When successful, it returns the |
| 149 | complete pathname of the bitmap file, prefixed with the character |
| 150 | '@'. The returned value can be used to configure the -bitmap |
| 151 | option of the TK and Tix widgets. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 152 | """ |
| 153 | return self.tk.call('tix', 'getbitmap', name) |
| 154 | |
| 155 | def tix_getimage(self, name): |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 156 | """Locates an image file of the name name.xpm, name.xbm or name.ppm |
| 157 | in one of the bitmap directories (see the addbitmapdir command |
| 158 | above). If more than one file with the same name (but different |
| 159 | extensions) exist, then the image type is chosen according to the |
| 160 | depth of the X display: xbm images are chosen on monochrome |
| 161 | displays and color images are chosen on color displays. By using |
Ezio Melotti | 42da663 | 2011-03-15 05:18:48 +0200 | [diff] [blame] | 162 | tix_ getimage, you can avoid hard coding the pathnames of the |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 163 | image files in your application. When successful, this command |
| 164 | returns the name of the newly created image, which can be used to |
| 165 | configure the -image option of the Tk and Tix widgets. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 166 | """ |
| 167 | return self.tk.call('tix', 'getimage', name) |
| 168 | |
| 169 | def tix_option_get(self, name): |
Ezio Melotti | 1392500 | 2011-03-16 11:05:33 +0200 | [diff] [blame] | 170 | """Gets the options maintained by the Tix |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 171 | scheme mechanism. Available options include: |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 172 | |
| 173 | active_bg active_fg bg |
| 174 | bold_font dark1_bg dark1_fg |
| 175 | dark2_bg dark2_fg disabled_fg |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 176 | fg fixed_font font |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 177 | inactive_bg inactive_fg input1_bg |
| 178 | input2_bg italic_font light1_bg |
| 179 | light1_fg light2_bg light2_fg |
| 180 | menu_font output1_bg output2_bg |
| 181 | select_bg select_fg selector |
| 182 | """ |
| 183 | # could use self.tk.globalgetvar('tixOption', name) |
| 184 | return self.tk.call('tix', 'option', 'get', name) |
| 185 | |
| 186 | def tix_resetoptions(self, newScheme, newFontSet, newScmPrio=None): |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 187 | """Resets the scheme and fontset of the Tix application to |
| 188 | newScheme and newFontSet, respectively. This affects only those |
| 189 | widgets created after this call. Therefore, it is best to call the |
| 190 | resetoptions command before the creation of any widgets in a Tix |
| 191 | application. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 192 | |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 193 | The optional parameter newScmPrio can be given to reset the |
| 194 | priority level of the Tk options set by the Tix schemes. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 195 | |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 196 | Because of the way Tk handles the X option database, after Tix has |
| 197 | been has imported and inited, it is not possible to reset the color |
| 198 | schemes and font sets using the tix config command. Instead, the |
| 199 | tix_resetoptions command must be used. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 200 | """ |
| 201 | if newScmPrio is not None: |
| 202 | return self.tk.call('tix', 'resetoptions', newScheme, newFontSet, newScmPrio) |
| 203 | else: |
| 204 | return self.tk.call('tix', 'resetoptions', newScheme, newFontSet) |
| 205 | |
Georg Brandl | 14fc427 | 2008-05-17 18:39:55 +0000 | [diff] [blame] | 206 | class Tk(tkinter.Tk, tixCommand): |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 207 | """Toplevel widget of Tix which represents mostly the main window |
| 208 | of an application. It has an associated Tcl interpreter.""" |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 209 | def __init__(self, screenName=None, baseName=None, className='Tix'): |
Georg Brandl | 14fc427 | 2008-05-17 18:39:55 +0000 | [diff] [blame] | 210 | tkinter.Tk.__init__(self, screenName, baseName, className) |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 211 | tixlib = os.environ.get('TIX_LIBRARY') |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 212 | self.tk.eval('global auto_path; lappend auto_path [file dir [info nameof]]') |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 213 | if tixlib is not None: |
| 214 | self.tk.eval('global auto_path; lappend auto_path {%s}' % tixlib) |
| 215 | self.tk.eval('global tcl_pkgPath; lappend tcl_pkgPath {%s}' % tixlib) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 216 | # Load Tix - this should work dynamically or statically |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 217 | # If it's static, tcl/tix8.1/pkgIndex.tcl should have |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 218 | # 'load {} Tix' |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 219 | # If it's dynamic under Unix, tcl/tix8.1/pkgIndex.tcl should have |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 220 | # 'load libtix8.1.8.3.so Tix' |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 221 | self.tk.eval('package require Tix') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 222 | |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 223 | def destroy(self): |
| 224 | # For safety, remove an delete_window binding before destroy |
| 225 | self.protocol("WM_DELETE_WINDOW", "") |
Georg Brandl | 14fc427 | 2008-05-17 18:39:55 +0000 | [diff] [blame] | 226 | tkinter.Tk.destroy(self) |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 227 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 228 | # The Tix 'tixForm' geometry manager |
| 229 | class Form: |
| 230 | """The Tix Form geometry manager |
| 231 | |
| 232 | Widgets can be arranged by specifying attachments to other widgets. |
| 233 | See Tix documentation for complete details""" |
| 234 | |
| 235 | def config(self, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 236 | self.tk.call('tixForm', self._w, *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 237 | |
| 238 | form = config |
| 239 | |
| 240 | def __setitem__(self, key, value): |
Guido van Rossum | 49fa2bd | 2001-08-13 14:12:35 +0000 | [diff] [blame] | 241 | Form.form(self, {key: value}) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 242 | |
| 243 | def check(self): |
| 244 | return self.tk.call('tixForm', 'check', self._w) |
| 245 | |
| 246 | def forget(self): |
| 247 | self.tk.call('tixForm', 'forget', self._w) |
| 248 | |
| 249 | def grid(self, xsize=0, ysize=0): |
| 250 | if (not xsize) and (not ysize): |
| 251 | x = self.tk.call('tixForm', 'grid', self._w) |
| 252 | y = self.tk.splitlist(x) |
| 253 | z = () |
| 254 | for x in y: |
| 255 | z = z + (self.tk.getint(x),) |
| 256 | return z |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 257 | return self.tk.call('tixForm', 'grid', self._w, xsize, ysize) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 258 | |
| 259 | def info(self, option=None): |
| 260 | if not option: |
| 261 | return self.tk.call('tixForm', 'info', self._w) |
| 262 | if option[0] != '-': |
| 263 | option = '-' + option |
| 264 | return self.tk.call('tixForm', 'info', self._w, option) |
| 265 | |
| 266 | def slaves(self): |
Alexander Belopolsky | 022f049 | 2010-11-22 19:40:51 +0000 | [diff] [blame] | 267 | return [self._nametowidget(x) for x in |
| 268 | self.tk.splitlist( |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 269 | self.tk.call( |
Alexander Belopolsky | 022f049 | 2010-11-22 19:40:51 +0000 | [diff] [blame] | 270 | 'tixForm', 'slaves', self._w))] |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 271 | |
| 272 | |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 273 | |
Georg Brandl | 14fc427 | 2008-05-17 18:39:55 +0000 | [diff] [blame] | 274 | tkinter.Widget.__bases__ = tkinter.Widget.__bases__ + (Form,) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 275 | |
Georg Brandl | 14fc427 | 2008-05-17 18:39:55 +0000 | [diff] [blame] | 276 | class TixWidget(tkinter.Widget): |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 277 | """A TixWidget class is used to package all (or most) Tix widgets. |
| 278 | |
| 279 | Widget initialization is extended in two ways: |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 280 | 1) It is possible to give a list of options which must be part of |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 281 | the creation command (so called Tix 'static' options). These cannot be |
| 282 | given as a 'config' command later. |
| 283 | 2) It is possible to give the name of an existing TK widget. These are |
| 284 | child widgets created automatically by a Tix mega-widget. The Tk call |
| 285 | to create these widgets is therefore bypassed in TixWidget.__init__ |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 286 | |
| 287 | Both options are for use by subclasses only. |
| 288 | """ |
| 289 | def __init__ (self, master=None, widgetName=None, |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 290 | static_options=None, cnf={}, kw={}): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 291 | # Merge keywords and dictionary arguments |
| 292 | if kw: |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 293 | cnf = _cnfmerge((cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 294 | else: |
| 295 | cnf = _cnfmerge(cnf) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 296 | |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 297 | # Move static options into extra. static_options must be |
| 298 | # a list of keywords (or None). |
| 299 | extra=() |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 300 | |
| 301 | # 'options' is always a static option |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 302 | if static_options: |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 303 | static_options.append('options') |
| 304 | else: |
| 305 | static_options = ['options'] |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 306 | |
Hirokazu Yamamoto | 21027e6 | 2009-01-10 12:15:23 +0000 | [diff] [blame] | 307 | for k,v in list(cnf.items()): |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 308 | if k in static_options: |
| 309 | extra = extra + ('-' + k, v) |
| 310 | del cnf[k] |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 311 | |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 312 | self.widgetName = widgetName |
| 313 | Widget._setup(self, master, cnf) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 314 | |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 315 | # If widgetName is None, this is a dummy creation call where the |
| 316 | # corresponding Tk widget has already been created by Tix |
| 317 | if widgetName: |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 318 | self.tk.call(widgetName, self._w, *extra) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 319 | |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 320 | # Non-static options - to be done via a 'config' command |
| 321 | if cnf: |
| 322 | Widget.config(self, cnf) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 323 | |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 324 | # Dictionary to hold subwidget names for easier access. We can't |
| 325 | # use the children list because the public Tix names may not be the |
| 326 | # same as the pathname component |
| 327 | self.subwidget_list = {} |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 328 | |
| 329 | # We set up an attribute access function so that it is possible to |
| 330 | # do w.ok['text'] = 'Hello' rather than w.subwidget('ok')['text'] = 'Hello' |
| 331 | # when w is a StdButtonBox. |
| 332 | # We can even do w.ok.invoke() because w.ok is subclassed from the |
| 333 | # Button class if you go through the proper constructors |
| 334 | def __getattr__(self, name): |
Guido van Rossum | e014a13 | 2006-08-19 16:53:45 +0000 | [diff] [blame] | 335 | if name in self.subwidget_list: |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 336 | return self.subwidget_list[name] |
Collin Winter | ce36ad8 | 2007-08-30 01:19:48 +0000 | [diff] [blame] | 337 | raise AttributeError(name) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 338 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 339 | def set_silent(self, value): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 340 | """Set a variable without calling its action routine""" |
| 341 | self.tk.call('tixSetSilent', self._w, value) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 342 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 343 | def subwidget(self, name): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 344 | """Return the named subwidget (which must have been created by |
| 345 | the sub-class).""" |
| 346 | n = self._subwidget_name(name) |
| 347 | if not n: |
Collin Winter | ce36ad8 | 2007-08-30 01:19:48 +0000 | [diff] [blame] | 348 | raise TclError("Subwidget " + name + " not child of " + self._name) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 349 | # Remove header of name and leading dot |
| 350 | n = n[len(self._w)+1:] |
| 351 | return self._nametowidget(n) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 352 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 353 | def subwidgets_all(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 354 | """Return all subwidgets.""" |
| 355 | names = self._subwidget_names() |
| 356 | if not names: |
| 357 | return [] |
| 358 | retlist = [] |
| 359 | for name in names: |
| 360 | name = name[len(self._w)+1:] |
| 361 | try: |
| 362 | retlist.append(self._nametowidget(name)) |
| 363 | except: |
| 364 | # some of the widgets are unknown e.g. border in LabelFrame |
| 365 | pass |
| 366 | return retlist |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 367 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 368 | def _subwidget_name(self,name): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 369 | """Get a subwidget name (returns a String, not a Widget !)""" |
| 370 | try: |
| 371 | return self.tk.call(self._w, 'subwidget', name) |
| 372 | except TclError: |
| 373 | return None |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 374 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 375 | def _subwidget_names(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 376 | """Return the name of all subwidgets.""" |
| 377 | try: |
| 378 | x = self.tk.call(self._w, 'subwidgets', '-all') |
Serhiy Storchaka | 848972c | 2013-12-25 16:35:38 +0200 | [diff] [blame] | 379 | return self.tk.splitlist(x) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 380 | except TclError: |
| 381 | return None |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 382 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 383 | def config_all(self, option, value): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 384 | """Set configuration options for all subwidgets (and self).""" |
| 385 | if option == '': |
| 386 | return |
Serhiy Storchaka | 975fce3 | 2013-09-16 11:01:31 +0300 | [diff] [blame] | 387 | elif not isinstance(option, str): |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 388 | option = repr(option) |
Serhiy Storchaka | 975fce3 | 2013-09-16 11:01:31 +0300 | [diff] [blame] | 389 | if not isinstance(value, str): |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 390 | value = repr(value) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 391 | names = self._subwidget_names() |
| 392 | for name in names: |
| 393 | self.tk.call(name, 'configure', '-' + option, value) |
Neal Norwitz | 731a986 | 2002-12-10 02:18:49 +0000 | [diff] [blame] | 394 | # These are missing from Tkinter |
| 395 | def image_create(self, imgtype, cnf={}, master=None, **kw): |
| 396 | if not master: |
Georg Brandl | 14fc427 | 2008-05-17 18:39:55 +0000 | [diff] [blame] | 397 | master = tkinter._default_root |
Neal Norwitz | 731a986 | 2002-12-10 02:18:49 +0000 | [diff] [blame] | 398 | if not master: |
Collin Winter | ce36ad8 | 2007-08-30 01:19:48 +0000 | [diff] [blame] | 399 | raise RuntimeError('Too early to create image') |
Neal Norwitz | 731a986 | 2002-12-10 02:18:49 +0000 | [diff] [blame] | 400 | if kw and cnf: cnf = _cnfmerge((cnf, kw)) |
| 401 | elif kw: cnf = kw |
| 402 | options = () |
| 403 | for k, v in cnf.items(): |
Florent Xicluna | 5d1155c | 2011-10-28 14:45:05 +0200 | [diff] [blame] | 404 | if callable(v): |
Neal Norwitz | 731a986 | 2002-12-10 02:18:49 +0000 | [diff] [blame] | 405 | v = self._register(v) |
| 406 | options = options + ('-'+k, v) |
| 407 | return master.tk.call(('image', 'create', imgtype,) + options) |
| 408 | def image_delete(self, imgname): |
| 409 | try: |
| 410 | self.tk.call('image', 'delete', imgname) |
| 411 | except TclError: |
| 412 | # May happen if the root was destroyed |
| 413 | pass |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 414 | |
| 415 | # Subwidgets are child widgets created automatically by mega-widgets. |
| 416 | # In python, we have to create these subwidgets manually to mirror their |
| 417 | # existence in Tk/Tix. |
| 418 | class TixSubWidget(TixWidget): |
| 419 | """Subwidget class. |
| 420 | |
| 421 | This is used to mirror child widgets automatically created |
| 422 | by Tix/Tk as part of a mega-widget in Python (which is not informed |
| 423 | of this)""" |
| 424 | |
| 425 | def __init__(self, master, name, |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 426 | destroy_physically=1, check_intermediate=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 427 | if check_intermediate: |
| 428 | path = master._subwidget_name(name) |
| 429 | try: |
| 430 | path = path[len(master._w)+1:] |
Neal Norwitz | ebb4190 | 2002-05-31 20:51:31 +0000 | [diff] [blame] | 431 | plist = path.split('.') |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 432 | except: |
| 433 | plist = [] |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 434 | |
Thomas Wouters | 89f507f | 2006-12-13 04:49:30 +0000 | [diff] [blame] | 435 | if not check_intermediate: |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 436 | # immediate descendant |
| 437 | TixWidget.__init__(self, master, None, None, {'name' : name}) |
| 438 | else: |
| 439 | # Ensure that the intermediate widgets exist |
| 440 | parent = master |
| 441 | for i in range(len(plist) - 1): |
Neal Norwitz | ebb4190 | 2002-05-31 20:51:31 +0000 | [diff] [blame] | 442 | n = '.'.join(plist[:i+1]) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 443 | try: |
| 444 | w = master._nametowidget(n) |
| 445 | parent = w |
| 446 | except KeyError: |
| 447 | # Create the intermediate widget |
| 448 | parent = TixSubWidget(parent, plist[i], |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 449 | destroy_physically=0, |
| 450 | check_intermediate=0) |
Thomas Wouters | 89f507f | 2006-12-13 04:49:30 +0000 | [diff] [blame] | 451 | # The Tk widget name is in plist, not in name |
| 452 | if plist: |
| 453 | name = plist[-1] |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 454 | TixWidget.__init__(self, parent, None, None, {'name' : name}) |
| 455 | self.destroy_physically = destroy_physically |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 456 | |
| 457 | def destroy(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 458 | # For some widgets e.g., a NoteBook, when we call destructors, |
| 459 | # we must be careful not to destroy the frame widget since this |
| 460 | # also destroys the parent NoteBook thus leading to an exception |
| 461 | # in Tkinter when it finally calls Tcl to destroy the NoteBook |
Hirokazu Yamamoto | 21027e6 | 2009-01-10 12:15:23 +0000 | [diff] [blame] | 462 | for c in list(self.children.values()): c.destroy() |
Guido van Rossum | e014a13 | 2006-08-19 16:53:45 +0000 | [diff] [blame] | 463 | if self._name in self.master.children: |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 464 | del self.master.children[self._name] |
Guido van Rossum | e014a13 | 2006-08-19 16:53:45 +0000 | [diff] [blame] | 465 | if self._name in self.master.subwidget_list: |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 466 | del self.master.subwidget_list[self._name] |
| 467 | if self.destroy_physically: |
| 468 | # This is bypassed only for a few widgets |
| 469 | self.tk.call('destroy', self._w) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 470 | |
| 471 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 472 | # Useful class to create a display style - later shared by many items. |
| 473 | # Contributed by Steffen Kremser |
| 474 | class DisplayStyle: |
| 475 | """DisplayStyle - handle configuration options shared by |
| 476 | (multiple) Display Items""" |
| 477 | |
Thomas Wouters | 73e5a5b | 2006-06-08 15:35:45 +0000 | [diff] [blame] | 478 | def __init__(self, itemtype, cnf={}, **kw): |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 479 | master = _default_root # global from Tkinter |
Guido van Rossum | e014a13 | 2006-08-19 16:53:45 +0000 | [diff] [blame] | 480 | if not master and 'refwindow' in cnf: master=cnf['refwindow'] |
| 481 | elif not master and 'refwindow' in kw: master= kw['refwindow'] |
Collin Winter | ce36ad8 | 2007-08-30 01:19:48 +0000 | [diff] [blame] | 482 | elif not master: raise RuntimeError("Too early to create display style: no root window") |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 483 | self.tk = master.tk |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 484 | self.stylename = self.tk.call('tixDisplayStyle', itemtype, |
| 485 | *self._options(cnf,kw) ) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 486 | |
| 487 | def __str__(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 488 | return self.stylename |
| 489 | |
Thomas Wouters | 73e5a5b | 2006-06-08 15:35:45 +0000 | [diff] [blame] | 490 | def _options(self, cnf, kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 491 | if kw and cnf: |
| 492 | cnf = _cnfmerge((cnf, kw)) |
| 493 | elif kw: |
| 494 | cnf = kw |
| 495 | opts = () |
| 496 | for k, v in cnf.items(): |
| 497 | opts = opts + ('-'+k, v) |
| 498 | return opts |
| 499 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 500 | def delete(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 501 | self.tk.call(self.stylename, 'delete') |
| 502 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 503 | def __setitem__(self,key,value): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 504 | self.tk.call(self.stylename, 'configure', '-%s'%key, value) |
| 505 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 506 | def config(self, cnf={}, **kw): |
Serhiy Storchaka | 848972c | 2013-12-25 16:35:38 +0200 | [diff] [blame] | 507 | return self._getconfigure( |
| 508 | self.stylename, 'configure', *self._options(cnf,kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 509 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 510 | def __getitem__(self,key): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 511 | return self.tk.call(self.stylename, 'cget', '-%s'%key) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 512 | |
| 513 | |
| 514 | ###################################################### |
| 515 | ### The Tix Widget classes - in alphabetical order ### |
| 516 | ###################################################### |
| 517 | |
| 518 | class Balloon(TixWidget): |
| 519 | """Balloon help widget. |
| 520 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 521 | Subwidget Class |
| 522 | --------- ----- |
Fred Drake | 723293c | 2001-12-13 04:53:07 +0000 | [diff] [blame] | 523 | label Label |
| 524 | message Message""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 525 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 526 | # FIXME: It should inherit -superclass tixShell |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 527 | def __init__(self, master=None, cnf={}, **kw): |
Martin v. Löwis | 652e191 | 2001-11-25 14:50:56 +0000 | [diff] [blame] | 528 | # static seem to be -installcolormap -initwait -statusbar -cursor |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 529 | static = ['options', 'installcolormap', 'initwait', 'statusbar', |
| 530 | 'cursor'] |
| 531 | TixWidget.__init__(self, master, 'tixBalloon', static, cnf, kw) |
| 532 | self.subwidget_list['label'] = _dummyLabel(self, 'label', |
| 533 | destroy_physically=0) |
| 534 | self.subwidget_list['message'] = _dummyLabel(self, 'message', |
| 535 | destroy_physically=0) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 536 | |
| 537 | def bind_widget(self, widget, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 538 | """Bind balloon widget to another. |
| 539 | One balloon widget may be bound to several widgets at the same time""" |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 540 | self.tk.call(self._w, 'bind', widget._w, *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 541 | |
| 542 | def unbind_widget(self, widget): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 543 | self.tk.call(self._w, 'unbind', widget._w) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 544 | |
| 545 | class ButtonBox(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 546 | """ButtonBox - A container for pushbuttons. |
| 547 | Subwidgets are the buttons added with the add method. |
| 548 | """ |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 549 | def __init__(self, master=None, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 550 | TixWidget.__init__(self, master, 'tixButtonBox', |
| 551 | ['orientation', 'options'], cnf, kw) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 552 | |
| 553 | def add(self, name, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 554 | """Add a button with given name to box.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 555 | |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 556 | btn = self.tk.call(self._w, 'add', name, *self._options(cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 557 | self.subwidget_list[name] = _dummyButton(self, name) |
| 558 | return btn |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 559 | |
| 560 | def invoke(self, name): |
Guido van Rossum | e014a13 | 2006-08-19 16:53:45 +0000 | [diff] [blame] | 561 | if name in self.subwidget_list: |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 562 | self.tk.call(self._w, 'invoke', name) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 563 | |
| 564 | class ComboBox(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 565 | """ComboBox - an Entry field with a dropdown menu. The user can select a |
Ezio Melotti | 1392500 | 2011-03-16 11:05:33 +0200 | [diff] [blame] | 566 | choice by either typing in the entry subwidget or selecting from the |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 567 | listbox subwidget. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 568 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 569 | Subwidget Class |
| 570 | --------- ----- |
| 571 | entry Entry |
| 572 | arrow Button |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 573 | slistbox ScrolledListBox |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 574 | tick Button |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 575 | cross Button : present if created with the fancy option""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 576 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 577 | # FIXME: It should inherit -superclass tixLabelWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 578 | def __init__ (self, master=None, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 579 | TixWidget.__init__(self, master, 'tixComboBox', |
| 580 | ['editable', 'dropdown', 'fancy', 'options'], |
| 581 | cnf, kw) |
| 582 | self.subwidget_list['label'] = _dummyLabel(self, 'label') |
| 583 | self.subwidget_list['entry'] = _dummyEntry(self, 'entry') |
| 584 | self.subwidget_list['arrow'] = _dummyButton(self, 'arrow') |
| 585 | self.subwidget_list['slistbox'] = _dummyScrolledListBox(self, |
| 586 | 'slistbox') |
| 587 | try: |
| 588 | self.subwidget_list['tick'] = _dummyButton(self, 'tick') |
| 589 | self.subwidget_list['cross'] = _dummyButton(self, 'cross') |
| 590 | except TypeError: |
| 591 | # unavailable when -fancy not specified |
| 592 | pass |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 593 | |
Neal Norwitz | 731a986 | 2002-12-10 02:18:49 +0000 | [diff] [blame] | 594 | # align |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 595 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 596 | def add_history(self, str): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 597 | self.tk.call(self._w, 'addhistory', str) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 598 | |
| 599 | def append_history(self, str): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 600 | self.tk.call(self._w, 'appendhistory', str) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 601 | |
| 602 | def insert(self, index, str): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 603 | self.tk.call(self._w, 'insert', index, str) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 604 | |
| 605 | def pick(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 606 | self.tk.call(self._w, 'pick', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 607 | |
| 608 | class Control(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 609 | """Control - An entry field with value change arrows. The user can |
| 610 | adjust the value by pressing the two arrow buttons or by entering |
| 611 | the value directly into the entry. The new value will be checked |
| 612 | against the user-defined upper and lower limits. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 613 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 614 | Subwidget Class |
| 615 | --------- ----- |
| 616 | incr Button |
| 617 | decr Button |
| 618 | entry Entry |
| 619 | label Label""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 620 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 621 | # FIXME: It should inherit -superclass tixLabelWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 622 | def __init__ (self, master=None, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 623 | TixWidget.__init__(self, master, 'tixControl', ['options'], cnf, kw) |
| 624 | self.subwidget_list['incr'] = _dummyButton(self, 'incr') |
| 625 | self.subwidget_list['decr'] = _dummyButton(self, 'decr') |
| 626 | self.subwidget_list['label'] = _dummyLabel(self, 'label') |
| 627 | self.subwidget_list['entry'] = _dummyEntry(self, 'entry') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 628 | |
| 629 | def decrement(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 630 | self.tk.call(self._w, 'decr') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 631 | |
| 632 | def increment(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 633 | self.tk.call(self._w, 'incr') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 634 | |
| 635 | def invoke(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 636 | self.tk.call(self._w, 'invoke') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 637 | |
| 638 | def update(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 639 | self.tk.call(self._w, 'update') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 640 | |
| 641 | class DirList(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 642 | """DirList - displays a list view of a directory, its previous |
| 643 | directories and its sub-directories. The user can choose one of |
| 644 | the directories displayed in the list or change to another directory. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 645 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 646 | Subwidget Class |
| 647 | --------- ----- |
| 648 | hlist HList |
| 649 | hsb Scrollbar |
| 650 | vsb Scrollbar""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 651 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 652 | # FIXME: It should inherit -superclass tixScrolledHList |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 653 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 654 | TixWidget.__init__(self, master, 'tixDirList', ['options'], cnf, kw) |
| 655 | self.subwidget_list['hlist'] = _dummyHList(self, 'hlist') |
| 656 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 657 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 658 | |
| 659 | def chdir(self, dir): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 660 | self.tk.call(self._w, 'chdir', dir) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 661 | |
| 662 | class DirTree(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 663 | """DirTree - Directory Listing in a hierarchical view. |
| 664 | Displays a tree view of a directory, its previous directories and its |
| 665 | sub-directories. The user can choose one of the directories displayed |
| 666 | in the list or change to another directory. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 667 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 668 | Subwidget Class |
| 669 | --------- ----- |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 670 | hlist HList |
| 671 | hsb Scrollbar |
| 672 | vsb Scrollbar""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 673 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 674 | # FIXME: It should inherit -superclass tixScrolledHList |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 675 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 676 | TixWidget.__init__(self, master, 'tixDirTree', ['options'], cnf, kw) |
| 677 | self.subwidget_list['hlist'] = _dummyHList(self, 'hlist') |
| 678 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 679 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 680 | |
| 681 | def chdir(self, dir): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 682 | self.tk.call(self._w, 'chdir', dir) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 683 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 684 | class DirSelectBox(TixWidget): |
| 685 | """DirSelectBox - Motif style file select box. |
| 686 | It is generally used for |
| 687 | the user to choose a file. FileSelectBox stores the files mostly |
| 688 | recently selected into a ComboBox widget so that they can be quickly |
| 689 | selected again. |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 690 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 691 | Subwidget Class |
| 692 | --------- ----- |
| 693 | selection ComboBox |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 694 | filter ComboBox |
| 695 | dirlist ScrolledListBox |
| 696 | filelist ScrolledListBox""" |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 697 | |
| 698 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 699 | TixWidget.__init__(self, master, 'tixDirSelectBox', ['options'], cnf, kw) |
| 700 | self.subwidget_list['dirlist'] = _dummyDirList(self, 'dirlist') |
| 701 | self.subwidget_list['dircbx'] = _dummyFileComboBox(self, 'dircbx') |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 702 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 703 | class ExFileSelectBox(TixWidget): |
| 704 | """ExFileSelectBox - MS Windows style file select box. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 705 | It provides an convenient method for the user to select files. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 706 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 707 | Subwidget Class |
| 708 | --------- ----- |
| 709 | cancel Button |
| 710 | ok Button |
| 711 | hidden Checkbutton |
| 712 | types ComboBox |
| 713 | dir ComboBox |
| 714 | file ComboBox |
| 715 | dirlist ScrolledListBox |
| 716 | filelist ScrolledListBox""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 717 | |
| 718 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 719 | TixWidget.__init__(self, master, 'tixExFileSelectBox', ['options'], cnf, kw) |
| 720 | self.subwidget_list['cancel'] = _dummyButton(self, 'cancel') |
| 721 | self.subwidget_list['ok'] = _dummyButton(self, 'ok') |
| 722 | self.subwidget_list['hidden'] = _dummyCheckbutton(self, 'hidden') |
| 723 | self.subwidget_list['types'] = _dummyComboBox(self, 'types') |
| 724 | self.subwidget_list['dir'] = _dummyComboBox(self, 'dir') |
| 725 | self.subwidget_list['dirlist'] = _dummyDirList(self, 'dirlist') |
| 726 | self.subwidget_list['file'] = _dummyComboBox(self, 'file') |
| 727 | self.subwidget_list['filelist'] = _dummyScrolledListBox(self, 'filelist') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 728 | |
| 729 | def filter(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 730 | self.tk.call(self._w, 'filter') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 731 | |
| 732 | def invoke(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 733 | self.tk.call(self._w, 'invoke') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 734 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 735 | |
| 736 | # Should inherit from a Dialog class |
| 737 | class DirSelectDialog(TixWidget): |
| 738 | """The DirSelectDialog widget presents the directories in the file |
| 739 | system in a dialog window. The user can use this dialog window to |
| 740 | navigate through the file system to select the desired directory. |
| 741 | |
| 742 | Subwidgets Class |
| 743 | ---------- ----- |
| 744 | dirbox DirSelectDialog""" |
| 745 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 746 | # FIXME: It should inherit -superclass tixDialogShell |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 747 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 748 | TixWidget.__init__(self, master, 'tixDirSelectDialog', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 749 | ['options'], cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 750 | self.subwidget_list['dirbox'] = _dummyDirSelectBox(self, 'dirbox') |
| 751 | # cancel and ok buttons are missing |
| 752 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 753 | def popup(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 754 | self.tk.call(self._w, 'popup') |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 755 | |
| 756 | def popdown(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 757 | self.tk.call(self._w, 'popdown') |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 758 | |
| 759 | |
| 760 | # Should inherit from a Dialog class |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 761 | class ExFileSelectDialog(TixWidget): |
| 762 | """ExFileSelectDialog - MS Windows style file select dialog. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 763 | It provides an convenient method for the user to select files. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 764 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 765 | Subwidgets Class |
| 766 | ---------- ----- |
| 767 | fsbox ExFileSelectBox""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 768 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 769 | # FIXME: It should inherit -superclass tixDialogShell |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 770 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 771 | TixWidget.__init__(self, master, 'tixExFileSelectDialog', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 772 | ['options'], cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 773 | self.subwidget_list['fsbox'] = _dummyExFileSelectBox(self, 'fsbox') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 774 | |
| 775 | def popup(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 776 | self.tk.call(self._w, 'popup') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 777 | |
| 778 | def popdown(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 779 | self.tk.call(self._w, 'popdown') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 780 | |
| 781 | class FileSelectBox(TixWidget): |
| 782 | """ExFileSelectBox - Motif style file select box. |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 783 | It is generally used for |
| 784 | the user to choose a file. FileSelectBox stores the files mostly |
| 785 | recently selected into a ComboBox widget so that they can be quickly |
| 786 | selected again. |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 787 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 788 | Subwidget Class |
| 789 | --------- ----- |
| 790 | selection ComboBox |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 791 | filter ComboBox |
| 792 | dirlist ScrolledListBox |
| 793 | filelist ScrolledListBox""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 794 | |
| 795 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 796 | TixWidget.__init__(self, master, 'tixFileSelectBox', ['options'], cnf, kw) |
| 797 | self.subwidget_list['dirlist'] = _dummyScrolledListBox(self, 'dirlist') |
| 798 | self.subwidget_list['filelist'] = _dummyScrolledListBox(self, 'filelist') |
| 799 | self.subwidget_list['filter'] = _dummyComboBox(self, 'filter') |
| 800 | self.subwidget_list['selection'] = _dummyComboBox(self, 'selection') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 801 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 802 | def apply_filter(self): # name of subwidget is same as command |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 803 | self.tk.call(self._w, 'filter') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 804 | |
| 805 | def invoke(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 806 | self.tk.call(self._w, 'invoke') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 807 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 808 | # Should inherit from a Dialog class |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 809 | class FileSelectDialog(TixWidget): |
| 810 | """FileSelectDialog - Motif style file select dialog. |
| 811 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 812 | Subwidgets Class |
| 813 | ---------- ----- |
| 814 | btns StdButtonBox |
| 815 | fsbox FileSelectBox""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 816 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 817 | # FIXME: It should inherit -superclass tixStdDialogShell |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 818 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 819 | TixWidget.__init__(self, master, 'tixFileSelectDialog', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 820 | ['options'], cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 821 | self.subwidget_list['btns'] = _dummyStdButtonBox(self, 'btns') |
| 822 | self.subwidget_list['fsbox'] = _dummyFileSelectBox(self, 'fsbox') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 823 | |
| 824 | def popup(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 825 | self.tk.call(self._w, 'popup') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 826 | |
| 827 | def popdown(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 828 | self.tk.call(self._w, 'popdown') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 829 | |
| 830 | class FileEntry(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 831 | """FileEntry - Entry field with button that invokes a FileSelectDialog. |
| 832 | The user can type in the filename manually. Alternatively, the user can |
| 833 | press the button widget that sits next to the entry, which will bring |
| 834 | up a file selection dialog. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 835 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 836 | Subwidgets Class |
| 837 | ---------- ----- |
| 838 | button Button |
| 839 | entry Entry""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 840 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 841 | # FIXME: It should inherit -superclass tixLabelWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 842 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 843 | TixWidget.__init__(self, master, 'tixFileEntry', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 844 | ['dialogtype', 'options'], cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 845 | self.subwidget_list['button'] = _dummyButton(self, 'button') |
| 846 | self.subwidget_list['entry'] = _dummyEntry(self, 'entry') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 847 | |
| 848 | def invoke(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 849 | self.tk.call(self._w, 'invoke') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 850 | |
| 851 | def file_dialog(self): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 852 | # FIXME: return python object |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 853 | pass |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 854 | |
Guilherme Polo | 1fff008 | 2009-08-14 15:05:30 +0000 | [diff] [blame] | 855 | class HList(TixWidget, XView, YView): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 856 | """HList - Hierarchy display widget can be used to display any data |
| 857 | that have a hierarchical structure, for example, file system directory |
| 858 | trees. The list entries are indented and connected by branch lines |
Ezio Melotti | 1392500 | 2011-03-16 11:05:33 +0200 | [diff] [blame] | 859 | according to their places in the hierarchy. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 860 | |
| 861 | Subwidgets - None""" |
| 862 | |
| 863 | def __init__ (self,master=None,cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 864 | TixWidget.__init__(self, master, 'tixHList', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 865 | ['columns', 'options'], cnf, kw) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 866 | |
| 867 | def add(self, entry, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 868 | return self.tk.call(self._w, 'add', entry, *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 869 | |
| 870 | def add_child(self, parent=None, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 871 | if not parent: |
| 872 | parent = '' |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 873 | return self.tk.call( |
| 874 | self._w, 'addchild', parent, *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 875 | |
| 876 | def anchor_set(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 877 | self.tk.call(self._w, 'anchor', 'set', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 878 | |
| 879 | def anchor_clear(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 880 | self.tk.call(self._w, 'anchor', 'clear') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 881 | |
| 882 | def column_width(self, col=0, width=None, chars=None): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 883 | if not chars: |
| 884 | return self.tk.call(self._w, 'column', 'width', col, width) |
| 885 | else: |
| 886 | return self.tk.call(self._w, 'column', 'width', col, |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 887 | '-char', chars) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 888 | |
| 889 | def delete_all(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 890 | self.tk.call(self._w, 'delete', 'all') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 891 | |
| 892 | def delete_entry(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 893 | self.tk.call(self._w, 'delete', 'entry', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 894 | |
| 895 | def delete_offsprings(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 896 | self.tk.call(self._w, 'delete', 'offsprings', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 897 | |
| 898 | def delete_siblings(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 899 | self.tk.call(self._w, 'delete', 'siblings', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 900 | |
| 901 | def dragsite_set(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 902 | self.tk.call(self._w, 'dragsite', 'set', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 903 | |
| 904 | def dragsite_clear(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 905 | self.tk.call(self._w, 'dragsite', 'clear') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 906 | |
| 907 | def dropsite_set(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 908 | self.tk.call(self._w, 'dropsite', 'set', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 909 | |
| 910 | def dropsite_clear(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 911 | self.tk.call(self._w, 'dropsite', 'clear') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 912 | |
| 913 | def header_create(self, col, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 914 | self.tk.call(self._w, 'header', 'create', col, *self._options(cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 915 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 916 | def header_configure(self, col, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 917 | if cnf is None: |
Serhiy Storchaka | 848972c | 2013-12-25 16:35:38 +0200 | [diff] [blame] | 918 | return self._getconfigure(self._w, 'header', 'configure', col) |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 919 | self.tk.call(self._w, 'header', 'configure', col, |
| 920 | *self._options(cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 921 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 922 | def header_cget(self, col, opt): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 923 | return self.tk.call(self._w, 'header', 'cget', col, opt) |
| 924 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 925 | def header_exists(self, col): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 926 | return self.tk.call(self._w, 'header', 'exists', col) |
| 927 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 928 | def header_delete(self, col): |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 929 | self.tk.call(self._w, 'header', 'delete', col) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 930 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 931 | def header_size(self, col): |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 932 | return self.tk.call(self._w, 'header', 'size', col) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 933 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 934 | def hide_entry(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 935 | self.tk.call(self._w, 'hide', 'entry', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 936 | |
| 937 | def indicator_create(self, entry, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 938 | self.tk.call( |
| 939 | self._w, 'indicator', 'create', entry, *self._options(cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 940 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 941 | def indicator_configure(self, entry, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 942 | if cnf is None: |
Serhiy Storchaka | 848972c | 2013-12-25 16:35:38 +0200 | [diff] [blame] | 943 | return self._getconfigure( |
| 944 | self._w, 'indicator', 'configure', entry) |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 945 | self.tk.call( |
| 946 | self._w, 'indicator', 'configure', entry, *self._options(cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 947 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 948 | def indicator_cget(self, entry, opt): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 949 | return self.tk.call(self._w, 'indicator', 'cget', entry, opt) |
| 950 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 951 | def indicator_exists(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 952 | return self.tk.call (self._w, 'indicator', 'exists', entry) |
| 953 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 954 | def indicator_delete(self, entry): |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 955 | self.tk.call(self._w, 'indicator', 'delete', entry) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 956 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 957 | def indicator_size(self, entry): |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 958 | return self.tk.call(self._w, 'indicator', 'size', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 959 | |
| 960 | def info_anchor(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 961 | return self.tk.call(self._w, 'info', 'anchor') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 962 | |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 963 | def info_bbox(self, entry): |
| 964 | return self._getints( |
| 965 | self.tk.call(self._w, 'info', 'bbox', entry)) or None |
| 966 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 967 | def info_children(self, entry=None): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 968 | c = self.tk.call(self._w, 'info', 'children', entry) |
| 969 | return self.tk.splitlist(c) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 970 | |
| 971 | def info_data(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 972 | return self.tk.call(self._w, 'info', 'data', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 973 | |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 974 | def info_dragsite(self): |
| 975 | return self.tk.call(self._w, 'info', 'dragsite') |
| 976 | |
| 977 | def info_dropsite(self): |
| 978 | return self.tk.call(self._w, 'info', 'dropsite') |
| 979 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 980 | def info_exists(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 981 | return self.tk.call(self._w, 'info', 'exists', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 982 | |
| 983 | def info_hidden(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 984 | return self.tk.call(self._w, 'info', 'hidden', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 985 | |
| 986 | def info_next(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 987 | return self.tk.call(self._w, 'info', 'next', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 988 | |
| 989 | def info_parent(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 990 | return self.tk.call(self._w, 'info', 'parent', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 991 | |
| 992 | def info_prev(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 993 | return self.tk.call(self._w, 'info', 'prev', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 994 | |
| 995 | def info_selection(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 996 | c = self.tk.call(self._w, 'info', 'selection') |
| 997 | return self.tk.splitlist(c) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 998 | |
Martin v. Löwis | 3e04848 | 2001-10-09 11:50:55 +0000 | [diff] [blame] | 999 | def item_cget(self, entry, col, opt): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1000 | return self.tk.call(self._w, 'item', 'cget', entry, col, opt) |
| 1001 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1002 | def item_configure(self, entry, col, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1003 | if cnf is None: |
Serhiy Storchaka | 848972c | 2013-12-25 16:35:38 +0200 | [diff] [blame] | 1004 | return self._getconfigure(self._w, 'item', 'configure', entry, col) |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1005 | self.tk.call(self._w, 'item', 'configure', entry, col, |
| 1006 | *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1007 | |
| 1008 | def item_create(self, entry, col, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1009 | self.tk.call( |
| 1010 | self._w, 'item', 'create', entry, col, *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1011 | |
| 1012 | def item_exists(self, entry, col): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1013 | return self.tk.call(self._w, 'item', 'exists', entry, col) |
| 1014 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1015 | def item_delete(self, entry, col): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1016 | self.tk.call(self._w, 'item', 'delete', entry, col) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1017 | |
Martin v. Löwis | 433fa69 | 2004-03-21 15:26:44 +0000 | [diff] [blame] | 1018 | def entrycget(self, entry, opt): |
| 1019 | return self.tk.call(self._w, 'entrycget', entry, opt) |
| 1020 | |
| 1021 | def entryconfigure(self, entry, cnf={}, **kw): |
| 1022 | if cnf is None: |
Serhiy Storchaka | 848972c | 2013-12-25 16:35:38 +0200 | [diff] [blame] | 1023 | return self._getconfigure(self._w, 'entryconfigure', entry) |
Martin v. Löwis | 433fa69 | 2004-03-21 15:26:44 +0000 | [diff] [blame] | 1024 | self.tk.call(self._w, 'entryconfigure', entry, |
| 1025 | *self._options(cnf, kw)) |
| 1026 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1027 | def nearest(self, y): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1028 | return self.tk.call(self._w, 'nearest', y) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1029 | |
| 1030 | def see(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1031 | self.tk.call(self._w, 'see', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1032 | |
| 1033 | def selection_clear(self, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1034 | self.tk.call(self._w, 'selection', 'clear', *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1035 | |
| 1036 | def selection_includes(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1037 | return self.tk.call(self._w, 'selection', 'includes', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1038 | |
| 1039 | def selection_set(self, first, last=None): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1040 | self.tk.call(self._w, 'selection', 'set', first, last) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1041 | |
| 1042 | def show_entry(self, entry): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1043 | return self.tk.call(self._w, 'show', 'entry', entry) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1044 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1045 | class InputOnly(TixWidget): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1046 | """InputOnly - Invisible widget. Unix only. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1047 | |
| 1048 | Subwidgets - None""" |
| 1049 | |
| 1050 | def __init__ (self,master=None,cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1051 | TixWidget.__init__(self, master, 'tixInputOnly', None, cnf, kw) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1052 | |
| 1053 | class LabelEntry(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1054 | """LabelEntry - Entry field with label. Packages an entry widget |
| 1055 | and a label into one mega widget. It can beused be used to simplify |
| 1056 | the creation of ``entry-form'' type of interface. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1057 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 1058 | Subwidgets Class |
| 1059 | ---------- ----- |
| 1060 | label Label |
| 1061 | entry Entry""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1062 | |
| 1063 | def __init__ (self,master=None,cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1064 | TixWidget.__init__(self, master, 'tixLabelEntry', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1065 | ['labelside','options'], cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1066 | self.subwidget_list['label'] = _dummyLabel(self, 'label') |
| 1067 | self.subwidget_list['entry'] = _dummyEntry(self, 'entry') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1068 | |
| 1069 | class LabelFrame(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1070 | """LabelFrame - Labelled Frame container. Packages a frame widget |
| 1071 | and a label into one mega widget. To create widgets inside a |
| 1072 | LabelFrame widget, one creates the new widgets relative to the |
| 1073 | frame subwidget and manage them inside the frame subwidget. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1074 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 1075 | Subwidgets Class |
| 1076 | ---------- ----- |
| 1077 | label Label |
| 1078 | frame Frame""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1079 | |
| 1080 | def __init__ (self,master=None,cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1081 | TixWidget.__init__(self, master, 'tixLabelFrame', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1082 | ['labelside','options'], cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1083 | self.subwidget_list['label'] = _dummyLabel(self, 'label') |
| 1084 | self.subwidget_list['frame'] = _dummyFrame(self, 'frame') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1085 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1086 | |
| 1087 | class ListNoteBook(TixWidget): |
| 1088 | """A ListNoteBook widget is very similar to the TixNoteBook widget: |
| 1089 | it can be used to display many windows in a limited space using a |
| 1090 | notebook metaphor. The notebook is divided into a stack of pages |
| 1091 | (windows). At one time only one of these pages can be shown. |
| 1092 | The user can navigate through these pages by |
| 1093 | choosing the name of the desired page in the hlist subwidget.""" |
| 1094 | |
| 1095 | def __init__(self, master, cnf={}, **kw): |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1096 | TixWidget.__init__(self, master, 'tixListNoteBook', ['options'], cnf, kw) |
| 1097 | # Is this necessary? It's not an exposed subwidget in Tix. |
| 1098 | self.subwidget_list['pane'] = _dummyPanedWindow(self, 'pane', |
| 1099 | destroy_physically=0) |
| 1100 | self.subwidget_list['hlist'] = _dummyHList(self, 'hlist') |
| 1101 | self.subwidget_list['shlist'] = _dummyScrolledHList(self, 'shlist') |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1102 | |
| 1103 | def add(self, name, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1104 | self.tk.call(self._w, 'add', name, *self._options(cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1105 | self.subwidget_list[name] = TixSubWidget(self, name) |
| 1106 | return self.subwidget_list[name] |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1107 | |
Martin v. Löwis | 01824bf | 2002-09-19 08:12:55 +0000 | [diff] [blame] | 1108 | def page(self, name): |
Tim Peters | 182b5ac | 2004-07-18 06:16:08 +0000 | [diff] [blame] | 1109 | return self.subwidget(name) |
Martin v. Löwis | 01824bf | 2002-09-19 08:12:55 +0000 | [diff] [blame] | 1110 | |
| 1111 | def pages(self): |
Tim Peters | 182b5ac | 2004-07-18 06:16:08 +0000 | [diff] [blame] | 1112 | # Can't call subwidgets_all directly because we don't want .nbframe |
| 1113 | names = self.tk.split(self.tk.call(self._w, 'pages')) |
| 1114 | ret = [] |
| 1115 | for x in names: |
| 1116 | ret.append(self.subwidget(x)) |
| 1117 | return ret |
Martin v. Löwis | 01824bf | 2002-09-19 08:12:55 +0000 | [diff] [blame] | 1118 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1119 | def raise_page(self, name): # raise is a python keyword |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1120 | self.tk.call(self._w, 'raise', name) |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1121 | |
| 1122 | class Meter(TixWidget): |
| 1123 | """The Meter widget can be used to show the progress of a background |
| 1124 | job which may take a long time to execute. |
| 1125 | """ |
| 1126 | |
| 1127 | def __init__(self, master=None, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1128 | TixWidget.__init__(self, master, 'tixMeter', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1129 | ['options'], cnf, kw) |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1130 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1131 | class NoteBook(TixWidget): |
| 1132 | """NoteBook - Multi-page container widget (tabbed notebook metaphor). |
| 1133 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 1134 | Subwidgets Class |
| 1135 | ---------- ----- |
| 1136 | nbframe NoteBookFrame |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1137 | <pages> page widgets added dynamically with the add method""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1138 | |
| 1139 | def __init__ (self,master=None,cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1140 | TixWidget.__init__(self,master,'tixNoteBook', ['options'], cnf, kw) |
| 1141 | self.subwidget_list['nbframe'] = TixSubWidget(self, 'nbframe', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1142 | destroy_physically=0) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1143 | |
| 1144 | def add(self, name, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1145 | self.tk.call(self._w, 'add', name, *self._options(cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1146 | self.subwidget_list[name] = TixSubWidget(self, name) |
| 1147 | return self.subwidget_list[name] |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1148 | |
| 1149 | def delete(self, name): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1150 | self.tk.call(self._w, 'delete', name) |
| 1151 | self.subwidget_list[name].destroy() |
| 1152 | del self.subwidget_list[name] |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1153 | |
| 1154 | def page(self, name): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1155 | return self.subwidget(name) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1156 | |
| 1157 | def pages(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1158 | # Can't call subwidgets_all directly because we don't want .nbframe |
| 1159 | names = self.tk.split(self.tk.call(self._w, 'pages')) |
| 1160 | ret = [] |
| 1161 | for x in names: |
| 1162 | ret.append(self.subwidget(x)) |
| 1163 | return ret |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1164 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 1165 | def raise_page(self, name): # raise is a python keyword |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1166 | self.tk.call(self._w, 'raise', name) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1167 | |
| 1168 | def raised(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1169 | return self.tk.call(self._w, 'raised') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1170 | |
| 1171 | class NoteBookFrame(TixWidget): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1172 | # FIXME: This is dangerous to expose to be called on its own. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1173 | pass |
| 1174 | |
| 1175 | class OptionMenu(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1176 | """OptionMenu - creates a menu button of options. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1177 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 1178 | Subwidget Class |
| 1179 | --------- ----- |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1180 | menubutton Menubutton |
| 1181 | menu Menu""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1182 | |
| 1183 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1184 | TixWidget.__init__(self, master, 'tixOptionMenu', ['options'], cnf, kw) |
| 1185 | self.subwidget_list['menubutton'] = _dummyMenubutton(self, 'menubutton') |
| 1186 | self.subwidget_list['menu'] = _dummyMenu(self, 'menu') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1187 | |
| 1188 | def add_command(self, name, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1189 | self.tk.call(self._w, 'add', 'command', name, *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1190 | |
| 1191 | def add_separator(self, name, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1192 | self.tk.call(self._w, 'add', 'separator', name, *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1193 | |
| 1194 | def delete(self, name): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1195 | self.tk.call(self._w, 'delete', name) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1196 | |
| 1197 | def disable(self, name): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1198 | self.tk.call(self._w, 'disable', name) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1199 | |
| 1200 | def enable(self, name): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1201 | self.tk.call(self._w, 'enable', name) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1202 | |
| 1203 | class PanedWindow(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1204 | """PanedWindow - Multi-pane container widget |
| 1205 | allows the user to interactively manipulate the sizes of several |
| 1206 | panes. The panes can be arranged either vertically or horizontally.The |
| 1207 | user changes the sizes of the panes by dragging the resize handle |
| 1208 | between two panes. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1209 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 1210 | Subwidgets Class |
| 1211 | ---------- ----- |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1212 | <panes> g/p widgets added dynamically with the add method.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1213 | |
| 1214 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1215 | TixWidget.__init__(self, master, 'tixPanedWindow', ['orientation', 'options'], cnf, kw) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1216 | |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1217 | # add delete forget panecget paneconfigure panes setsize |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1218 | def add(self, name, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1219 | self.tk.call(self._w, 'add', name, *self._options(cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1220 | self.subwidget_list[name] = TixSubWidget(self, name, |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1221 | check_intermediate=0) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1222 | return self.subwidget_list[name] |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1223 | |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1224 | def delete(self, name): |
| 1225 | self.tk.call(self._w, 'delete', name) |
| 1226 | self.subwidget_list[name].destroy() |
| 1227 | del self.subwidget_list[name] |
| 1228 | |
| 1229 | def forget(self, name): |
| 1230 | self.tk.call(self._w, 'forget', name) |
| 1231 | |
| 1232 | def panecget(self, entry, opt): |
| 1233 | return self.tk.call(self._w, 'panecget', entry, opt) |
| 1234 | |
| 1235 | def paneconfigure(self, entry, cnf={}, **kw): |
| 1236 | if cnf is None: |
Serhiy Storchaka | 848972c | 2013-12-25 16:35:38 +0200 | [diff] [blame] | 1237 | return self._getconfigure(self._w, 'paneconfigure', entry) |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1238 | self.tk.call(self._w, 'paneconfigure', entry, *self._options(cnf, kw)) |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1239 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1240 | def panes(self): |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1241 | names = self.tk.splitlist(self.tk.call(self._w, 'panes')) |
| 1242 | return [self.subwidget(x) for x in names] |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1243 | |
| 1244 | class PopupMenu(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1245 | """PopupMenu widget can be used as a replacement of the tk_popup command. |
| 1246 | The advantage of the Tix PopupMenu widget is it requires less application |
| 1247 | code to manipulate. |
| 1248 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1249 | |
Moshe Zadka | 2271082 | 2001-03-21 17:24:49 +0000 | [diff] [blame] | 1250 | Subwidgets Class |
| 1251 | ---------- ----- |
| 1252 | menubutton Menubutton |
| 1253 | menu Menu""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1254 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1255 | # FIXME: It should inherit -superclass tixShell |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1256 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1257 | TixWidget.__init__(self, master, 'tixPopupMenu', ['options'], cnf, kw) |
| 1258 | self.subwidget_list['menubutton'] = _dummyMenubutton(self, 'menubutton') |
| 1259 | self.subwidget_list['menu'] = _dummyMenu(self, 'menu') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1260 | |
| 1261 | def bind_widget(self, widget): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1262 | self.tk.call(self._w, 'bind', widget._w) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1263 | |
| 1264 | def unbind_widget(self, widget): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1265 | self.tk.call(self._w, 'unbind', widget._w) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1266 | |
| 1267 | def post_widget(self, widget, x, y): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1268 | self.tk.call(self._w, 'post', widget._w, x, y) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1269 | |
| 1270 | class ResizeHandle(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1271 | """Internal widget to draw resize handles on Scrolled widgets.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1272 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1273 | # There seems to be a Tix bug rejecting the configure method |
| 1274 | # Let's try making the flags -static |
| 1275 | flags = ['options', 'command', 'cursorfg', 'cursorbg', |
| 1276 | 'handlesize', 'hintcolor', 'hintwidth', |
| 1277 | 'x', 'y'] |
| 1278 | # In fact, x y height width are configurable |
| 1279 | TixWidget.__init__(self, master, 'tixResizeHandle', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1280 | flags, cnf, kw) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1281 | |
| 1282 | def attach_widget(self, widget): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1283 | self.tk.call(self._w, 'attachwidget', widget._w) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1284 | |
Martin v. Löwis | 652e191 | 2001-11-25 14:50:56 +0000 | [diff] [blame] | 1285 | def detach_widget(self, widget): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1286 | self.tk.call(self._w, 'detachwidget', widget._w) |
Martin v. Löwis | 652e191 | 2001-11-25 14:50:56 +0000 | [diff] [blame] | 1287 | |
| 1288 | def hide(self, widget): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1289 | self.tk.call(self._w, 'hide', widget._w) |
Martin v. Löwis | 652e191 | 2001-11-25 14:50:56 +0000 | [diff] [blame] | 1290 | |
| 1291 | def show(self, widget): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1292 | self.tk.call(self._w, 'show', widget._w) |
Martin v. Löwis | 652e191 | 2001-11-25 14:50:56 +0000 | [diff] [blame] | 1293 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1294 | class ScrolledHList(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1295 | """ScrolledHList - HList with automatic scrollbars.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1296 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1297 | # FIXME: It should inherit -superclass tixScrolledWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1298 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1299 | TixWidget.__init__(self, master, 'tixScrolledHList', ['options'], |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1300 | cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1301 | self.subwidget_list['hlist'] = _dummyHList(self, 'hlist') |
| 1302 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1303 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1304 | |
| 1305 | class ScrolledListBox(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1306 | """ScrolledListBox - Listbox with automatic scrollbars.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1307 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1308 | # FIXME: It should inherit -superclass tixScrolledWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1309 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1310 | TixWidget.__init__(self, master, 'tixScrolledListBox', ['options'], cnf, kw) |
| 1311 | self.subwidget_list['listbox'] = _dummyListbox(self, 'listbox') |
| 1312 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1313 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1314 | |
| 1315 | class ScrolledText(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1316 | """ScrolledText - Text with automatic scrollbars.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1317 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1318 | # FIXME: It should inherit -superclass tixScrolledWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1319 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1320 | TixWidget.__init__(self, master, 'tixScrolledText', ['options'], cnf, kw) |
| 1321 | self.subwidget_list['text'] = _dummyText(self, 'text') |
| 1322 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1323 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1324 | |
| 1325 | class ScrolledTList(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1326 | """ScrolledTList - TList with automatic scrollbars.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1327 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1328 | # FIXME: It should inherit -superclass tixScrolledWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1329 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1330 | TixWidget.__init__(self, master, 'tixScrolledTList', ['options'], |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1331 | cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1332 | self.subwidget_list['tlist'] = _dummyTList(self, 'tlist') |
| 1333 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1334 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1335 | |
| 1336 | class ScrolledWindow(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1337 | """ScrolledWindow - Window with automatic scrollbars.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1338 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1339 | # FIXME: It should inherit -superclass tixScrolledWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1340 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1341 | TixWidget.__init__(self, master, 'tixScrolledWindow', ['options'], cnf, kw) |
| 1342 | self.subwidget_list['window'] = _dummyFrame(self, 'window') |
| 1343 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1344 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1345 | |
| 1346 | class Select(TixWidget): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1347 | """Select - Container of button subwidgets. It can be used to provide |
| 1348 | radio-box or check-box style of selection options for the user. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1349 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1350 | Subwidgets are buttons added dynamically using the add method.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1351 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1352 | # FIXME: It should inherit -superclass tixLabelWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1353 | def __init__(self, master, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1354 | TixWidget.__init__(self, master, 'tixSelect', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1355 | ['allowzero', 'radio', 'orientation', 'labelside', |
| 1356 | 'options'], |
| 1357 | cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1358 | self.subwidget_list['label'] = _dummyLabel(self, 'label') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1359 | |
| 1360 | def add(self, name, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1361 | self.tk.call(self._w, 'add', name, *self._options(cnf, kw)) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1362 | self.subwidget_list[name] = _dummyButton(self, name) |
| 1363 | return self.subwidget_list[name] |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1364 | |
| 1365 | def invoke(self, name): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1366 | self.tk.call(self._w, 'invoke', name) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1367 | |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1368 | class Shell(TixWidget): |
| 1369 | """Toplevel window. |
| 1370 | |
| 1371 | Subwidgets - None""" |
| 1372 | |
| 1373 | def __init__ (self,master=None,cnf={}, **kw): |
| 1374 | TixWidget.__init__(self, master, 'tixShell', ['options', 'title'], cnf, kw) |
| 1375 | |
| 1376 | class DialogShell(TixWidget): |
| 1377 | """Toplevel window, with popup popdown and center methods. |
| 1378 | It tells the window manager that it is a dialog window and should be |
| 1379 | treated specially. The exact treatment depends on the treatment of |
| 1380 | the window manager. |
| 1381 | |
| 1382 | Subwidgets - None""" |
| 1383 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1384 | # FIXME: It should inherit from Shell |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1385 | def __init__ (self,master=None,cnf={}, **kw): |
| 1386 | TixWidget.__init__(self, master, |
| 1387 | 'tixDialogShell', |
| 1388 | ['options', 'title', 'mapped', |
| 1389 | 'minheight', 'minwidth', |
| 1390 | 'parent', 'transient'], cnf, kw) |
| 1391 | |
| 1392 | def popdown(self): |
| 1393 | self.tk.call(self._w, 'popdown') |
| 1394 | |
| 1395 | def popup(self): |
| 1396 | self.tk.call(self._w, 'popup') |
| 1397 | |
| 1398 | def center(self): |
| 1399 | self.tk.call(self._w, 'center') |
| 1400 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1401 | class StdButtonBox(TixWidget): |
| 1402 | """StdButtonBox - Standard Button Box (OK, Apply, Cancel and Help) """ |
| 1403 | |
| 1404 | def __init__(self, master=None, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1405 | TixWidget.__init__(self, master, 'tixStdButtonBox', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1406 | ['orientation', 'options'], cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1407 | self.subwidget_list['ok'] = _dummyButton(self, 'ok') |
| 1408 | self.subwidget_list['apply'] = _dummyButton(self, 'apply') |
| 1409 | self.subwidget_list['cancel'] = _dummyButton(self, 'cancel') |
| 1410 | self.subwidget_list['help'] = _dummyButton(self, 'help') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1411 | |
| 1412 | def invoke(self, name): |
Guido van Rossum | e014a13 | 2006-08-19 16:53:45 +0000 | [diff] [blame] | 1413 | if name in self.subwidget_list: |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1414 | self.tk.call(self._w, 'invoke', name) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1415 | |
Guilherme Polo | 1fff008 | 2009-08-14 15:05:30 +0000 | [diff] [blame] | 1416 | class TList(TixWidget, XView, YView): |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1417 | """TList - Hierarchy display widget which can be |
| 1418 | used to display data in a tabular format. The list entries of a TList |
| 1419 | widget are similar to the entries in the Tk listbox widget. The main |
| 1420 | differences are (1) the TList widget can display the list entries in a |
| 1421 | two dimensional format and (2) you can use graphical images as well as |
| 1422 | multiple colors and fonts for the list entries. |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1423 | |
| 1424 | Subwidgets - None""" |
| 1425 | |
| 1426 | def __init__ (self,master=None,cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1427 | TixWidget.__init__(self, master, 'tixTList', ['options'], cnf, kw) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1428 | |
| 1429 | def active_set(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1430 | self.tk.call(self._w, 'active', 'set', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1431 | |
| 1432 | def active_clear(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1433 | self.tk.call(self._w, 'active', 'clear') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1434 | |
| 1435 | def anchor_set(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1436 | self.tk.call(self._w, 'anchor', 'set', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1437 | |
| 1438 | def anchor_clear(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1439 | self.tk.call(self._w, 'anchor', 'clear') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1440 | |
| 1441 | def delete(self, from_, to=None): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1442 | self.tk.call(self._w, 'delete', from_, to) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1443 | |
| 1444 | def dragsite_set(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1445 | self.tk.call(self._w, 'dragsite', 'set', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1446 | |
| 1447 | def dragsite_clear(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1448 | self.tk.call(self._w, 'dragsite', 'clear') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1449 | |
| 1450 | def dropsite_set(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1451 | self.tk.call(self._w, 'dropsite', 'set', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1452 | |
| 1453 | def dropsite_clear(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1454 | self.tk.call(self._w, 'dropsite', 'clear') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1455 | |
| 1456 | def insert(self, index, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1457 | self.tk.call(self._w, 'insert', index, *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1458 | |
| 1459 | def info_active(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1460 | return self.tk.call(self._w, 'info', 'active') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1461 | |
| 1462 | def info_anchor(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1463 | return self.tk.call(self._w, 'info', 'anchor') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1464 | |
| 1465 | def info_down(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1466 | return self.tk.call(self._w, 'info', 'down', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1467 | |
| 1468 | def info_left(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1469 | return self.tk.call(self._w, 'info', 'left', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1470 | |
| 1471 | def info_right(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1472 | return self.tk.call(self._w, 'info', 'right', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1473 | |
| 1474 | def info_selection(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1475 | c = self.tk.call(self._w, 'info', 'selection') |
| 1476 | return self.tk.splitlist(c) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1477 | |
| 1478 | def info_size(self): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1479 | return self.tk.call(self._w, 'info', 'size') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1480 | |
| 1481 | def info_up(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1482 | return self.tk.call(self._w, 'info', 'up', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1483 | |
| 1484 | def nearest(self, x, y): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1485 | return self.tk.call(self._w, 'nearest', x, y) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1486 | |
| 1487 | def see(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1488 | self.tk.call(self._w, 'see', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1489 | |
| 1490 | def selection_clear(self, cnf={}, **kw): |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1491 | self.tk.call(self._w, 'selection', 'clear', *self._options(cnf, kw)) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1492 | |
| 1493 | def selection_includes(self, index): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1494 | return self.tk.call(self._w, 'selection', 'includes', index) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1495 | |
| 1496 | def selection_set(self, first, last=None): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1497 | self.tk.call(self._w, 'selection', 'set', first, last) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1498 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1499 | class Tree(TixWidget): |
Ezio Melotti | 1392500 | 2011-03-16 11:05:33 +0200 | [diff] [blame] | 1500 | """Tree - The tixTree widget can be used to display hierarchical |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1501 | data in a tree form. The user can adjust |
| 1502 | the view of the tree by opening or closing parts of the tree.""" |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1503 | |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1504 | # FIXME: It should inherit -superclass tixScrolledWidget |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1505 | def __init__(self, master=None, cnf={}, **kw): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1506 | TixWidget.__init__(self, master, 'tixTree', |
Neal Norwitz | f539bde | 2002-11-14 02:43:40 +0000 | [diff] [blame] | 1507 | ['options'], cnf, kw) |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1508 | self.subwidget_list['hlist'] = _dummyHList(self, 'hlist') |
| 1509 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1510 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1511 | |
| 1512 | def autosetmode(self): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1513 | '''This command calls the setmode method for all the entries in this |
| 1514 | Tree widget: if an entry has no child entries, its mode is set to |
| 1515 | none. Otherwise, if the entry has any hidden child entries, its mode is |
| 1516 | set to open; otherwise its mode is set to close.''' |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1517 | self.tk.call(self._w, 'autosetmode') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1518 | |
| 1519 | def close(self, entrypath): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1520 | '''Close the entry given by entryPath if its mode is close.''' |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1521 | self.tk.call(self._w, 'close', entrypath) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1522 | |
| 1523 | def getmode(self, entrypath): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1524 | '''Returns the current mode of the entry given by entryPath.''' |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1525 | return self.tk.call(self._w, 'getmode', entrypath) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1526 | |
| 1527 | def open(self, entrypath): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1528 | '''Open the entry given by entryPath if its mode is open.''' |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1529 | self.tk.call(self._w, 'open', entrypath) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1530 | |
| 1531 | def setmode(self, entrypath, mode='none'): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1532 | '''This command is used to indicate whether the entry given by |
| 1533 | entryPath has children entries and whether the children are visible. mode |
| 1534 | must be one of open, close or none. If mode is set to open, a (+) |
Ezio Melotti | e130a52 | 2011-10-19 10:58:56 +0300 | [diff] [blame] | 1535 | indicator is drawn next the entry. If mode is set to close, a (-) |
| 1536 | indicator is drawn next the entry. If mode is set to none, no |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1537 | indicators will be drawn for this entry. The default mode is none. The |
| 1538 | open mode indicates the entry has hidden children and this entry can be |
| 1539 | opened by the user. The close mode indicates that all the children of the |
| 1540 | entry are now visible and the entry can be closed by the user.''' |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1541 | self.tk.call(self._w, 'setmode', entrypath, mode) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1542 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1543 | |
| 1544 | # Could try subclassing Tree for CheckList - would need another arg to init |
| 1545 | class CheckList(TixWidget): |
| 1546 | """The CheckList widget |
| 1547 | displays a list of items to be selected by the user. CheckList acts |
| 1548 | similarly to the Tk checkbutton or radiobutton widgets, except it is |
| 1549 | capable of handling many more items than checkbuttons or radiobuttons. |
| 1550 | """ |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1551 | # FIXME: It should inherit -superclass tixTree |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1552 | def __init__(self, master=None, cnf={}, **kw): |
| 1553 | TixWidget.__init__(self, master, 'tixCheckList', |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1554 | ['options', 'radio'], cnf, kw) |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1555 | self.subwidget_list['hlist'] = _dummyHList(self, 'hlist') |
| 1556 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1557 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1558 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1559 | def autosetmode(self): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1560 | '''This command calls the setmode method for all the entries in this |
| 1561 | Tree widget: if an entry has no child entries, its mode is set to |
| 1562 | none. Otherwise, if the entry has any hidden child entries, its mode is |
| 1563 | set to open; otherwise its mode is set to close.''' |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1564 | self.tk.call(self._w, 'autosetmode') |
| 1565 | |
| 1566 | def close(self, entrypath): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1567 | '''Close the entry given by entryPath if its mode is close.''' |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1568 | self.tk.call(self._w, 'close', entrypath) |
| 1569 | |
| 1570 | def getmode(self, entrypath): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1571 | '''Returns the current mode of the entry given by entryPath.''' |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1572 | return self.tk.call(self._w, 'getmode', entrypath) |
| 1573 | |
| 1574 | def open(self, entrypath): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1575 | '''Open the entry given by entryPath if its mode is open.''' |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1576 | self.tk.call(self._w, 'open', entrypath) |
| 1577 | |
| 1578 | def getselection(self, mode='on'): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1579 | '''Returns a list of items whose status matches status. If status is |
| 1580 | not specified, the list of items in the "on" status will be returned. |
| 1581 | Mode can be on, off, default''' |
| 1582 | c = self.tk.split(self.tk.call(self._w, 'getselection', mode)) |
| 1583 | return self.tk.splitlist(c) |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1584 | |
| 1585 | def getstatus(self, entrypath): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1586 | '''Returns the current status of entryPath.''' |
| 1587 | return self.tk.call(self._w, 'getstatus', entrypath) |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1588 | |
| 1589 | def setstatus(self, entrypath, mode='on'): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1590 | '''Sets the status of entryPath to be status. A bitmap will be |
| 1591 | displayed next to the entry its status is on, off or default.''' |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1592 | self.tk.call(self._w, 'setstatus', entrypath, mode) |
| 1593 | |
| 1594 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1595 | ########################################################################### |
| 1596 | ### The subclassing below is used to instantiate the subwidgets in each ### |
| 1597 | ### mega widget. This allows us to access their methods directly. ### |
| 1598 | ########################################################################### |
| 1599 | |
| 1600 | class _dummyButton(Button, TixSubWidget): |
| 1601 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1602 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1603 | |
| 1604 | class _dummyCheckbutton(Checkbutton, TixSubWidget): |
| 1605 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1606 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1607 | |
| 1608 | class _dummyEntry(Entry, TixSubWidget): |
| 1609 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1610 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1611 | |
| 1612 | class _dummyFrame(Frame, TixSubWidget): |
| 1613 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1614 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1615 | |
| 1616 | class _dummyLabel(Label, TixSubWidget): |
| 1617 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1618 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1619 | |
| 1620 | class _dummyListbox(Listbox, TixSubWidget): |
| 1621 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1622 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1623 | |
| 1624 | class _dummyMenu(Menu, TixSubWidget): |
| 1625 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1626 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1627 | |
| 1628 | class _dummyMenubutton(Menubutton, TixSubWidget): |
| 1629 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1630 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1631 | |
| 1632 | class _dummyScrollbar(Scrollbar, TixSubWidget): |
| 1633 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1634 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1635 | |
| 1636 | class _dummyText(Text, TixSubWidget): |
| 1637 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1638 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1639 | |
| 1640 | class _dummyScrolledListBox(ScrolledListBox, TixSubWidget): |
| 1641 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1642 | TixSubWidget.__init__(self, master, name, destroy_physically) |
| 1643 | self.subwidget_list['listbox'] = _dummyListbox(self, 'listbox') |
| 1644 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1645 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1646 | |
| 1647 | class _dummyHList(HList, TixSubWidget): |
| 1648 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1649 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1650 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1651 | class _dummyScrolledHList(ScrolledHList, TixSubWidget): |
| 1652 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1653 | TixSubWidget.__init__(self, master, name, destroy_physically) |
| 1654 | self.subwidget_list['hlist'] = _dummyHList(self, 'hlist') |
| 1655 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1656 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1657 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1658 | class _dummyTList(TList, TixSubWidget): |
| 1659 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1660 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1661 | |
| 1662 | class _dummyComboBox(ComboBox, TixSubWidget): |
| 1663 | def __init__(self, master, name, destroy_physically=1): |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 1664 | TixSubWidget.__init__(self, master, name, ['fancy',destroy_physically]) |
| 1665 | self.subwidget_list['label'] = _dummyLabel(self, 'label') |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1666 | self.subwidget_list['entry'] = _dummyEntry(self, 'entry') |
| 1667 | self.subwidget_list['arrow'] = _dummyButton(self, 'arrow') |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 1668 | |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1669 | self.subwidget_list['slistbox'] = _dummyScrolledListBox(self, |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 1670 | 'slistbox') |
| 1671 | try: |
| 1672 | self.subwidget_list['tick'] = _dummyButton(self, 'tick') |
| 1673 | #cross Button : present if created with the fancy option |
| 1674 | self.subwidget_list['cross'] = _dummyButton(self, 'cross') |
| 1675 | except TypeError: |
| 1676 | # unavailable when -fancy not specified |
| 1677 | pass |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1678 | |
| 1679 | class _dummyDirList(DirList, TixSubWidget): |
| 1680 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1681 | TixSubWidget.__init__(self, master, name, destroy_physically) |
| 1682 | self.subwidget_list['hlist'] = _dummyHList(self, 'hlist') |
| 1683 | self.subwidget_list['vsb'] = _dummyScrollbar(self, 'vsb') |
| 1684 | self.subwidget_list['hsb'] = _dummyScrollbar(self, 'hsb') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1685 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1686 | class _dummyDirSelectBox(DirSelectBox, TixSubWidget): |
| 1687 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1688 | TixSubWidget.__init__(self, master, name, destroy_physically) |
| 1689 | self.subwidget_list['dirlist'] = _dummyDirList(self, 'dirlist') |
| 1690 | self.subwidget_list['dircbx'] = _dummyFileComboBox(self, 'dircbx') |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1691 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1692 | class _dummyExFileSelectBox(ExFileSelectBox, TixSubWidget): |
| 1693 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1694 | TixSubWidget.__init__(self, master, name, destroy_physically) |
| 1695 | self.subwidget_list['cancel'] = _dummyButton(self, 'cancel') |
| 1696 | self.subwidget_list['ok'] = _dummyButton(self, 'ok') |
| 1697 | self.subwidget_list['hidden'] = _dummyCheckbutton(self, 'hidden') |
| 1698 | self.subwidget_list['types'] = _dummyComboBox(self, 'types') |
| 1699 | self.subwidget_list['dir'] = _dummyComboBox(self, 'dir') |
| 1700 | self.subwidget_list['dirlist'] = _dummyScrolledListBox(self, 'dirlist') |
| 1701 | self.subwidget_list['file'] = _dummyComboBox(self, 'file') |
| 1702 | self.subwidget_list['filelist'] = _dummyScrolledListBox(self, 'filelist') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1703 | |
| 1704 | class _dummyFileSelectBox(FileSelectBox, TixSubWidget): |
| 1705 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1706 | TixSubWidget.__init__(self, master, name, destroy_physically) |
| 1707 | self.subwidget_list['dirlist'] = _dummyScrolledListBox(self, 'dirlist') |
| 1708 | self.subwidget_list['filelist'] = _dummyScrolledListBox(self, 'filelist') |
| 1709 | self.subwidget_list['filter'] = _dummyComboBox(self, 'filter') |
| 1710 | self.subwidget_list['selection'] = _dummyComboBox(self, 'selection') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1711 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1712 | class _dummyFileComboBox(ComboBox, TixSubWidget): |
| 1713 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1714 | TixSubWidget.__init__(self, master, name, destroy_physically) |
| 1715 | self.subwidget_list['dircbx'] = _dummyComboBox(self, 'dircbx') |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1716 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1717 | class _dummyStdButtonBox(StdButtonBox, TixSubWidget): |
| 1718 | def __init__(self, master, name, destroy_physically=1): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1719 | TixSubWidget.__init__(self, master, name, destroy_physically) |
| 1720 | self.subwidget_list['ok'] = _dummyButton(self, 'ok') |
| 1721 | self.subwidget_list['apply'] = _dummyButton(self, 'apply') |
| 1722 | self.subwidget_list['cancel'] = _dummyButton(self, 'cancel') |
| 1723 | self.subwidget_list['help'] = _dummyButton(self, 'help') |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1724 | |
| 1725 | class _dummyNoteBookFrame(NoteBookFrame, TixSubWidget): |
| 1726 | def __init__(self, master, name, destroy_physically=0): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1727 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1728 | |
Martin v. Löwis | 01824bf | 2002-09-19 08:12:55 +0000 | [diff] [blame] | 1729 | class _dummyPanedWindow(PanedWindow, TixSubWidget): |
| 1730 | def __init__(self, master, name, destroy_physically=1): |
Tim Peters | 182b5ac | 2004-07-18 06:16:08 +0000 | [diff] [blame] | 1731 | TixSubWidget.__init__(self, master, name, destroy_physically) |
Martin v. Löwis | 01824bf | 2002-09-19 08:12:55 +0000 | [diff] [blame] | 1732 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1733 | ######################## |
| 1734 | ### Utility Routines ### |
| 1735 | ######################## |
| 1736 | |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 1737 | #mike Should tixDestroy be exposed as a wrapper? - but not for widgets. |
| 1738 | |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1739 | def OptionName(widget): |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 1740 | '''Returns the qualified path name for the widget. Normally used to set |
| 1741 | default options for subwidgets. See tixwidgets.py''' |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1742 | return widget.tk.call('tixOptionName', widget._w) |
| 1743 | |
| 1744 | # Called with a dictionary argument of the form |
| 1745 | # {'*.c':'C source files', '*.txt':'Text Files', '*':'All files'} |
| 1746 | # returns a string which can be used to configure the fsbox file types |
| 1747 | # in an ExFileSelectBox. i.e., |
| 1748 | # '{{*} {* - All files}} {{*.c} {*.c - C source files}} {{*.txt} {*.txt - Text Files}}' |
| 1749 | def FileTypeList(dict): |
| 1750 | s = '' |
| 1751 | for type in dict.keys(): |
Martin v. Löwis | 0c0d56a | 2002-03-28 16:26:40 +0000 | [diff] [blame] | 1752 | s = s + '{{' + type + '} {' + type + ' - ' + dict[type] + '}} ' |
Martin v. Löwis | b21cb5f | 2001-03-21 07:42:07 +0000 | [diff] [blame] | 1753 | return s |
| 1754 | |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1755 | # Still to be done: |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1756 | # tixIconView |
Martin v. Löwis | b7b3260 | 2001-11-02 23:48:20 +0000 | [diff] [blame] | 1757 | class CObjView(TixWidget): |
| 1758 | """This file implements the Canvas Object View widget. This is a base |
| 1759 | class of IconView. It implements automatic placement/adjustment of the |
| 1760 | scrollbars according to the canvas objects inside the canvas subwidget. |
| 1761 | The scrollbars are adjusted so that the canvas is just large enough |
| 1762 | to see all the objects. |
| 1763 | """ |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1764 | # FIXME: It should inherit -superclass tixScrolledWidget |
| 1765 | pass |
| 1766 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1767 | |
Guilherme Polo | 1fff008 | 2009-08-14 15:05:30 +0000 | [diff] [blame] | 1768 | class Grid(TixWidget, XView, YView): |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 1769 | '''The Tix Grid command creates a new window and makes it into a |
| 1770 | tixGrid widget. Additional options, may be specified on the command |
| 1771 | line or in the option database to configure aspects such as its cursor |
| 1772 | and relief. |
| 1773 | |
| 1774 | A Grid widget displays its contents in a two dimensional grid of cells. |
| 1775 | Each cell may contain one Tix display item, which may be in text, |
| 1776 | graphics or other formats. See the DisplayStyle class for more information |
| 1777 | about Tix display items. Individual cells, or groups of cells, can be |
| 1778 | formatted with a wide range of attributes, such as its color, relief and |
| 1779 | border. |
| 1780 | |
| 1781 | Subwidgets - None''' |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1782 | # valid specific resources as of Tk 8.4 |
| 1783 | # editdonecmd, editnotifycmd, floatingcols, floatingrows, formatcmd, |
| 1784 | # highlightbackground, highlightcolor, leftmargin, itemtype, selectmode, |
| 1785 | # selectunit, topmargin, |
| 1786 | def __init__(self, master=None, cnf={}, **kw): |
| 1787 | static= [] |
| 1788 | self.cnf= cnf |
| 1789 | TixWidget.__init__(self, master, 'tixGrid', static, cnf, kw) |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 1790 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1791 | # valid options as of Tk 8.4 |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1792 | # anchor, bdtype, cget, configure, delete, dragsite, dropsite, entrycget, |
| 1793 | # edit, entryconfigure, format, geometryinfo, info, index, move, nearest, |
| 1794 | # selection, set, size, unset, xview, yview |
| 1795 | def anchor_clear(self): |
| 1796 | """Removes the selection anchor.""" |
| 1797 | self.tk.call(self, 'anchor', 'clear') |
| 1798 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1799 | def anchor_get(self): |
| 1800 | "Get the (x,y) coordinate of the current anchor cell" |
| 1801 | return self._getints(self.tk.call(self, 'anchor', 'get')) |
| 1802 | |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1803 | def anchor_set(self, x, y): |
| 1804 | """Set the selection anchor to the cell at (x, y).""" |
| 1805 | self.tk.call(self, 'anchor', 'set', x, y) |
| 1806 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1807 | def delete_row(self, from_, to=None): |
| 1808 | """Delete rows between from_ and to inclusive. |
| 1809 | If to is not provided, delete only row at from_""" |
| 1810 | if to is None: |
| 1811 | self.tk.call(self, 'delete', 'row', from_) |
| 1812 | else: |
| 1813 | self.tk.call(self, 'delete', 'row', from_, to) |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1814 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1815 | def delete_column(self, from_, to=None): |
| 1816 | """Delete columns between from_ and to inclusive. |
| 1817 | If to is not provided, delete only column at from_""" |
| 1818 | if to is None: |
| 1819 | self.tk.call(self, 'delete', 'column', from_) |
| 1820 | else: |
| 1821 | self.tk.call(self, 'delete', 'column', from_, to) |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1822 | |
| 1823 | def edit_apply(self): |
| 1824 | """If any cell is being edited, de-highlight the cell and applies |
| 1825 | the changes.""" |
| 1826 | self.tk.call(self, 'edit', 'apply') |
| 1827 | |
| 1828 | def edit_set(self, x, y): |
| 1829 | """Highlights the cell at (x, y) for editing, if the -editnotify |
| 1830 | command returns True for this cell.""" |
| 1831 | self.tk.call(self, 'edit', 'set', x, y) |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1832 | |
| 1833 | def entrycget(self, x, y, option): |
| 1834 | "Get the option value for cell at (x,y)" |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1835 | if option and option[0] != '-': |
| 1836 | option = '-' + option |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1837 | return self.tk.call(self, 'entrycget', x, y, option) |
| 1838 | |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1839 | def entryconfigure(self, x, y, cnf=None, **kw): |
| 1840 | return self._configure(('entryconfigure', x, y), cnf, kw) |
| 1841 | |
Neal Norwitz | d8b5e3f | 2002-12-30 23:52:01 +0000 | [diff] [blame] | 1842 | # def format |
| 1843 | # def index |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1844 | |
| 1845 | def info_exists(self, x, y): |
| 1846 | "Return True if display item exists at (x,y)" |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1847 | return self._getboolean(self.tk.call(self, 'info', 'exists', x, y)) |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1848 | |
| 1849 | def info_bbox(self, x, y): |
| 1850 | # This seems to always return '', at least for 'text' displayitems |
| 1851 | return self.tk.call(self, 'info', 'bbox', x, y) |
| 1852 | |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1853 | def move_column(self, from_, to, offset): |
Ezio Melotti | e130a52 | 2011-10-19 10:58:56 +0300 | [diff] [blame] | 1854 | """Moves the range of columns from position FROM through TO by |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1855 | the distance indicated by OFFSET. For example, move_column(2, 4, 1) |
| 1856 | moves the columns 2,3,4 to columns 3,4,5.""" |
| 1857 | self.tk.call(self, 'move', 'column', from_, to, offset) |
| 1858 | |
| 1859 | def move_row(self, from_, to, offset): |
Ezio Melotti | e130a52 | 2011-10-19 10:58:56 +0300 | [diff] [blame] | 1860 | """Moves the range of rows from position FROM through TO by |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1861 | the distance indicated by OFFSET. |
| 1862 | For example, move_row(2, 4, 1) moves the rows 2,3,4 to rows 3,4,5.""" |
| 1863 | self.tk.call(self, 'move', 'row', from_, to, offset) |
| 1864 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1865 | def nearest(self, x, y): |
| 1866 | "Return coordinate of cell nearest pixel coordinate (x,y)" |
| 1867 | return self._getints(self.tk.call(self, 'nearest', x, y)) |
| 1868 | |
| 1869 | # def selection adjust |
| 1870 | # def selection clear |
| 1871 | # def selection includes |
| 1872 | # def selection set |
| 1873 | # def selection toggle |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1874 | |
| 1875 | def set(self, x, y, itemtype=None, **kw): |
| 1876 | args= self._options(self.cnf, kw) |
| 1877 | if itemtype is not None: |
| 1878 | args= ('-itemtype', itemtype) + args |
| 1879 | self.tk.call(self, 'set', x, y, *args) |
| 1880 | |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1881 | def size_column(self, index, **kw): |
Terry Jan Reedy | c30b7b1 | 2013-03-11 17:57:08 -0400 | [diff] [blame] | 1882 | """Queries or sets the size of the column given by |
| 1883 | INDEX. INDEX may be any non-negative |
| 1884 | integer that gives the position of a given column. |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1885 | INDEX can also be the string "default"; in this case, this command |
| 1886 | queries or sets the default size of all columns. |
Terry Jan Reedy | c30b7b1 | 2013-03-11 17:57:08 -0400 | [diff] [blame] | 1887 | When no option-value pair is given, this command returns a tuple |
| 1888 | containing the current size setting of the given column. When |
| 1889 | option-value pairs are given, the corresponding options of the |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1890 | size setting of the given column are changed. Options may be one |
Terry Jan Reedy | c30b7b1 | 2013-03-11 17:57:08 -0400 | [diff] [blame] | 1891 | of the follwing: |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1892 | pad0 pixels |
| 1893 | Specifies the paddings to the left of a column. |
| 1894 | pad1 pixels |
Terry Jan Reedy | c30b7b1 | 2013-03-11 17:57:08 -0400 | [diff] [blame] | 1895 | Specifies the paddings to the right of a column. |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1896 | size val |
Terry Jan Reedy | c30b7b1 | 2013-03-11 17:57:08 -0400 | [diff] [blame] | 1897 | Specifies the width of a column. Val may be: |
| 1898 | "auto" -- the width of the column is set to the |
| 1899 | width of the widest cell in the column; |
| 1900 | a valid Tk screen distance unit; |
| 1901 | or a real number following by the word chars |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1902 | (e.g. 3.4chars) that sets the width of the column to the |
| 1903 | given number of characters.""" |
| 1904 | return self.tk.split(self.tk.call(self._w, 'size', 'column', index, |
| 1905 | *self._options({}, kw))) |
| 1906 | |
| 1907 | def size_row(self, index, **kw): |
Terry Jan Reedy | c30b7b1 | 2013-03-11 17:57:08 -0400 | [diff] [blame] | 1908 | """Queries or sets the size of the row given by |
| 1909 | INDEX. INDEX may be any non-negative |
| 1910 | integer that gives the position of a given row . |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1911 | INDEX can also be the string "default"; in this case, this command |
| 1912 | queries or sets the default size of all rows. |
Terry Jan Reedy | c30b7b1 | 2013-03-11 17:57:08 -0400 | [diff] [blame] | 1913 | When no option-value pair is given, this command returns a list con- |
| 1914 | taining the current size setting of the given row . When option-value |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1915 | pairs are given, the corresponding options of the size setting of the |
| 1916 | given row are changed. Options may be one of the follwing: |
| 1917 | pad0 pixels |
| 1918 | Specifies the paddings to the top of a row. |
| 1919 | pad1 pixels |
Ezio Melotti | e130a52 | 2011-10-19 10:58:56 +0300 | [diff] [blame] | 1920 | Specifies the paddings to the bottom of a row. |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1921 | size val |
Terry Jan Reedy | c30b7b1 | 2013-03-11 17:57:08 -0400 | [diff] [blame] | 1922 | Specifies the height of a row. Val may be: |
| 1923 | "auto" -- the height of the row is set to the |
| 1924 | height of the highest cell in the row; |
| 1925 | a valid Tk screen distance unit; |
| 1926 | or a real number following by the word chars |
Guilherme Polo | bcd03df | 2009-08-18 15:35:57 +0000 | [diff] [blame] | 1927 | (e.g. 3.4chars) that sets the height of the row to the |
| 1928 | given number of characters.""" |
| 1929 | return self.tk.split(self.tk.call( |
| 1930 | self, 'size', 'row', index, *self._options({}, kw))) |
| 1931 | |
| 1932 | def unset(self, x, y): |
| 1933 | """Clears the cell at (x, y) by removing its display item.""" |
| 1934 | self.tk.call(self._w, 'unset', x, y) |
| 1935 | |
Raymond Hettinger | ff41c48 | 2003-04-06 09:01:11 +0000 | [diff] [blame] | 1936 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1937 | class ScrolledGrid(Grid): |
Martin v. Löwis | 4687428 | 2002-12-06 10:33:45 +0000 | [diff] [blame] | 1938 | '''Scrolled Grid widgets''' |
| 1939 | |
| 1940 | # FIXME: It should inherit -superclass tixScrolledWidget |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1941 | def __init__(self, master=None, cnf={}, **kw): |
| 1942 | static= [] |
| 1943 | self.cnf= cnf |
| 1944 | TixWidget.__init__(self, master, 'tixScrolledGrid', static, cnf, kw) |