cpython-lru_cache-weakref: Doc/lib/tkinter.tex annotate

annotate Doc/lib/tkinter.tex @ 31594:123718d0dc09 legacy-trunk

Add version changed/added to doc

author	Neal Norwitz <nnorwitz@gmail.com>
date	Sat, 28 Feb 2004 15:19:33 +0000
parents	470f95ad6750
children	016d7016c6c6

rev	line source
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1 \chapter{Graphical User Interfaces with Tk \label{tkinter}}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	2
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	3 \index{GUI}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	4 \index{Graphical User Interface}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	5 \index{Tkinter}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	6 \index{Tk}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	7
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	8 Tk/Tcl has long been an integral part of Python. It provides a robust
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	9 and platform independent windowing toolkit, that is available to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	10 Python programmers using the \refmodule{Tkinter} module, and its
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	11 extension, the \refmodule{Tix} module.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	12
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	13 The \refmodule{Tkinter} module is a thin object--oriented layer on top of
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	14 Tcl/Tk. To use \refmodule{Tkinter}, you don't need to write Tcl code,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	15 but you will need to consult the Tk documentation, and occasionally
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	16 the Tcl documentation. \refmodule{Tkinter} is a set of wrappers that
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	17 implement the Tk widgets as Python classes. In addition, the internal
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	18 module \module{\_tkinter} provides a threadsafe mechanism which allows
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	19 Python and Tcl to interact.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	20
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	21 Tk is not the only GUI for Python, but is however the most commonly
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	22 used one; see section~\ref{other-gui-modules}, ``Other User Interface
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	23 Modules and Packages,'' for more information on other GUI toolkits for
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	24 Python.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	25
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	26 % Other sections I have in mind are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	27 % Tkinter internals
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	28 % Freezing Tkinter applications
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	29
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	30 \localmoduletable
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	31
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	32
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	33 \section{\module{Tkinter} ---
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	34 Python interface to Tcl/Tk}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	35
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	36 \declaremodule{standard}{Tkinter}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	37 \modulesynopsis{Interface to Tcl/Tk for graphical user interfaces}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	38 \moduleauthor{Guido van Rossum}{guido@Python.org}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	39
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	40 The \module{Tkinter} module (``Tk interface'') is the standard Python
25196 47081a753ecc Clarify who maintains Tkinter and who maintains Tk. Fred Drake <fdrake@acm.org> parents: 24137 diff changeset	41 interface to the Tk GUI toolkit. Both Tk and \module{Tkinter} are
47081a753ecc Clarify who maintains Tkinter and who maintains Tk. Fred Drake <fdrake@acm.org> parents: 24137 diff changeset	42 available on most \UNIX{} platforms, as well as on Windows and
47081a753ecc Clarify who maintains Tkinter and who maintains Tk. Fred Drake <fdrake@acm.org> parents: 24137 diff changeset	43 Macintosh systems. (Tk itself is not part of Python; it is maintained
47081a753ecc Clarify who maintains Tkinter and who maintains Tk. Fred Drake <fdrake@acm.org> parents: 24137 diff changeset	44 at ActiveState.)
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	45
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	46 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	47 \seetitle[http://www.python.org/topics/tkinter/]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	48 {Python Tkinter Resources}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	49 {The Python Tkinter Topic Guide provides a great
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	50 deal of information on using Tk from Python and links to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	51 other sources of information on Tk.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	52
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	53 \seetitle[http://www.pythonware.com/library/an-introduction-to-tkinter.htm]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	54 {An Introduction to Tkinter}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	55 {Fredrik Lundh's on-line reference material.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	56
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	57 \seetitle[http://www.nmt.edu/tcc/help/pubs/lang.html]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	58 {Tkinter reference: a GUI for Python}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	59 {On-line reference material.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	60
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	61 \seetitle[http://jtkinter.sourceforge.net]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	62 {Tkinter for JPython}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	63 {The Jython interface to Tkinter.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	64
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	65 \seetitle[http://www.amazon.com/exec/obidos/ASIN/1884777813]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	66 {Python and Tkinter Programming}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	67 {The book by John Grayson (ISBN 1-884777-81-3).}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	68 \end{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	69
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	70
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	71 \subsection{Tkinter Modules}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	72
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	73 Most of the time, the \refmodule{Tkinter} module is all you really
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	74 need, but a number of additional modules are available as well. The
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	75 Tk interface is located in a binary module named \module{_tkinter}.
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	76 This module contains the low-level interface to Tk, and should never
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	77 be used directly by application programmers. It is usually a shared
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	78 library (or DLL), but might in some cases be statically linked with
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	79 the Python interpreter.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	80
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	81 In addition to the Tk interface module, \refmodule{Tkinter} includes a
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	82 number of Python modules. The two most important modules are the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	83 \refmodule{Tkinter} module itself, and a module called
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	84 \module{Tkconstants}. The former automatically imports the latter, so
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	85 to use Tkinter, all you need to do is to import one module:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	86
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	87 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	88 import Tkinter
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	89 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	90
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	91 Or, more often:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	92
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	93 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	94 from Tkinter import *
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	95 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	96
31547 470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	97 \begin{classdesc}{Tk}{screenName=None, baseName=None, className='Tk', useTk=1}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	98 The \class{Tk} class is instantiated without arguments.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	99 This creates a toplevel widget of Tk which usually is the main window
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	100 of an appliation. Each instance has its own associated Tcl interpreter.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	101 % FIXME: The following keyword arguments are currently recognized:
31594 123718d0dc09 Add version changed/added to doc Neal Norwitz <nnorwitz@gmail.com> parents: 31547 diff changeset	102 \versionchanged[The \var{useTk} parameter was added]{2.4}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	103 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	104
31547 470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	105 \begin{funcdesc}{Tcl}{screenName=None, baseName=None, className='Tk', useTk=0}
470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	106 The \function{Tcl} function is a factory function which creates an object
470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	107 much like that created by the \class{Tk} class, except that it does not
470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	108 initialize the Tk subsystem. This is most often useful when driving the Tcl
470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	109 interpreter in an environment where one doesn't want to create extraneous
470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	110 toplevel windows, or where one cannot (i.e. Unix/Linux systems without an X
470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	111 server). An object created by the \function{Tcl} object can have a Toplevel
470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	112 window created (and the Tk subsystem initialized) by calling its
470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	113 \method{loadtk} method.
31594 123718d0dc09 Add version changed/added to doc Neal Norwitz <nnorwitz@gmail.com> parents: 31547 diff changeset	114 \versionadded{2.4}
31547 470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	115 \end{funcdesc}
470f95ad6750 Implementation of patch 869468 David Ascher <david.ascher@gmail.com> parents: 30003 diff changeset	116
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	117 Other modules that provide Tk support include:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	118
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	119 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	120 % \declaremodule{standard}{Tkconstants}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	121 % \modulesynopsis{Constants used by Tkinter}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	122 % FIXME
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	123
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	124 \item[\refmodule{ScrolledText}]
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	125 Text widget with a vertical scroll bar built in.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	126
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	127 \item[\module{tkColorChooser}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	128 Dialog to let the user choose a color.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	129
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	130 \item[\module{tkCommonDialog}]
21119 493f932d5829 Add description of tkCommonDialog. Fred Drake <fdrake@acm.org> parents: 21117 diff changeset	131 Base class for the dialogs defined in the other modules listed here.
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	132
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	133 \item[\module{tkFileDialog}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	134 Common dialogs to allow the user to specify a file to open or save.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	135
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	136 \item[\module{tkFont}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	137 Utilities to help work with fonts.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	138
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	139 \item[\module{tkMessageBox}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	140 Access to standard Tk dialog boxes.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	141
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	142 \item[\module{tkSimpleDialog}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	143 Basic dialogs and convenience functions.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	144
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	145 \item[\module{Tkdnd}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	146 Drag-and-drop support for \refmodule{Tkinter}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	147 This is experimental and should become deprecated when it is replaced
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	148 with the Tk DND.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	149
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	150 \item[\refmodule{turtle}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	151 Turtle graphics in a Tk window.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	152
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	153 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	154
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	155 \subsection{Tkinter Life Preserver}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	156 \sectionauthor{Matt Conway}{}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	157 % Converted to LaTeX by Mike Clarkson.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	158
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	159 This section is not designed to be an exhaustive tutorial on either
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	160 Tk or Tkinter. Rather, it is intended as a stop gap, providing some
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	161 introductory orientation on the system.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	162
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	163 Credits:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	164 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	165 \item Tkinter was written by Steen Lumholt and Guido van Rossum.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	166 \item Tk was written by John Ousterhout while at Berkeley.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	167 \item This Life Preserver was written by Matt Conway at
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	168 the University of Virginia.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	169 \item The html rendering, and some liberal editing, was
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	170 produced from a FrameMaker version by Ken Manheimer.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	171 \item Fredrik Lundh elaborated and revised the class interface descriptions,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	172 to get them current with Tk 4.2.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	173 \item Mike Clarkson converted the documentation to \LaTeX, and compiled the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	174 User Interface chapter of the reference manual.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	175 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	176
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	177
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	178 \subsubsection{How To Use This Section}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	179
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	180 This section is designed in two parts: the first half (roughly) covers
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	181 background material, while the second half can be taken to the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	182 keyboard as a handy reference.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	183
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	184 When trying to answer questions of the form ``how do I do blah'', it
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	185 is often best to find out how to do``blah'' in straight Tk, and then
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	186 convert this back into the corresponding \refmodule{Tkinter} call.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	187 Python programmers can often guess at the correct Python command by
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	188 looking at the Tk documentation. This means that in order to use
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	189 Tkinter, you will have to know a little bit about Tk. This document
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	190 can't fulfill that role, so the best we can do is point you to the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	191 best documentation that exists. Here are some hints:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	192
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	193 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	194 \item The authors strongly suggest getting a copy of the Tk man
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	195 pages. Specifically, the man pages in the \code{mann} directory are most
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	196 useful. The \code{man3} man pages describe the C interface to the Tk
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	197 library and thus are not especially helpful for script writers.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	198
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	199 \item Addison-Wesley publishes a book called \citetitle{Tcl and the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	200 Tk Toolkit} by John Ousterhout (ISBN 0-201-63337-X) which is a good
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	201 introduction to Tcl and Tk for the novice. The book is not
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	202 exhaustive, and for many details it defers to the man pages.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	203
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	204 \item \file{Tkinter.py} is a last resort for most, but can be a good
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	205 place to go when nothing else makes sense.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	206 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	207
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	208 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	209 \seetitle[http://tcl.activestate.com/]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	210 {ActiveState Tcl Home Page}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	211 {The Tk/Tcl development is largely taking place at
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	212 ActiveState.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	213 \seetitle[http://www.amazon.com/exec/obidos/ASIN/020163337X]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	214 {Tcl and the Tk Toolkit}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	215 {The book by John Ousterhout, the inventor of Tcl .}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	216 \seetitle[http://www.amazon.com/exec/obidos/ASIN/0130220280]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	217 {Practical Programming in Tcl and Tk}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	218 {Brent Welch's encyclopedic book.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	219 \end{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	220
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	221
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	222 \subsubsection{A Simple Hello World Program} % HelloWorld.html
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	223
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	224 %begin{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	225 %\begin{figure}[hbtp]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	226 %\centerline{\epsfig{file=HelloWorld.gif,width=.9\textwidth}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	227 %\vspace{.5cm}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	228 %\caption{HelloWorld gadget image}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	229 %\end{figure}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	230 %See also the hello-world \ulink{notes}{classes/HelloWorld-notes.html} and
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	231 %\ulink{summary}{classes/HelloWorld-summary.html}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	232 %end{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	233
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	234
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	235 \begin{verbatim}
29186 2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	236 from Tkinter import *
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	237
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	238 class Application(Frame):
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	239 def say_hi(self):
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	240 print "hi there, everyone!"
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	241
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	242 def createWidgets(self):
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	243 self.QUIT = Button(self)
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	244 self.QUIT["text"] = "QUIT"
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	245 self.QUIT["fg"] = "red"
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	246 self.QUIT["command"] = self.quit
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	247
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	248 self.QUIT.pack({"side": "left"})
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	249
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	250 self.hi_there = Button(self)
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	251 self.hi_there["text"] = "Hello",
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	252 self.hi_there["command"] = self.say_hi
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	253
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	254 self.hi_there.pack({"side": "left"})
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	255
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	256 def __init__(self, master=None):
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	257 Frame.__init__(self, master)
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	258 self.pack()
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	259 self.createWidgets()
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	260
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	261 app = Application()
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	262 app.mainloop()
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	263 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	264
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	265
21148 d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	266 \subsection{A (Very) Quick Look at Tcl/Tk} % BriefTclTk.html
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	267
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	268 The class hierarchy looks complicated, but in actual practice,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	269 application programmers almost always refer to the classes at the very
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	270 bottom of the hierarchy.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	271
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	272 Notes:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	273 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	274 \item These classes are provided for the purposes of
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	275 organizing certain functions under one namespace. They aren't meant to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	276 be instantiated independently.
21148 d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	277
d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	278 \item The \class{Tk} class is meant to be instantiated only once in
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	279 an application. Application programmers need not instantiate one
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	280 explicitly, the system creates one whenever any of the other classes
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	281 are instantiated.
21148 d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	282
d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	283 \item The \class{Widget} class is not meant to be instantiated, it
d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	284 is meant only for subclassing to make ``real'' widgets (in \Cpp, this
d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	285 is called an `abstract class').
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	286 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	287
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	288 To make use of this reference material, there will be times when you
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	289 will need to know how to read short passages of Tk and how to identify
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	290 the various parts of a Tk command.
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	291 (See section~\ref{tkinter-basic-mapping} for the
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	292 \refmodule{Tkinter} equivalents of what's below.)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	293
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	294 Tk scripts are Tcl programs. Like all Tcl programs, Tk scripts are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	295 just lists of tokens separated by spaces. A Tk widget is just its
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	296 \emph{class}, the \emph{options} that help configure it, and the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	297 \emph{actions} that make it do useful things.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	298
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	299 To make a widget in Tk, the command is always of the form:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	300
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	301 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	302 classCommand newPathname options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	303 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	304
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	305 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	306 \item[\var{classCommand}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	307 denotes which kind of widget to make (a button, a label, a menu...)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	308
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	309 \item[\var{newPathname}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	310 is the new name for this widget. All names in Tk must be unique. To
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	311 help enforce this, widgets in Tk are named with \emph{pathnames}, just
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	312 like files in a file system. The top level widget, the \emph{root},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	313 is called \code{.} (period) and children are delimited by more
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	314 periods. For example, \code{.myApp.controlPanel.okButton} might be
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	315 the name of a widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	316
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	317 \item[\var{options} ]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	318 configure the widget's appearance and in some cases, its
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	319 behavior. The options come in the form of a list of flags and values.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	320 Flags are proceeded by a `-', like unix shell command flags, and
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	321 values are put in quotes if they are more than one word.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	322 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	323
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	324 For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	325
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	326 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	327 button .fred -fg red -text "hi there"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	328 ^ ^ \_____________________/
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	329 \| \| \|
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	330 class new options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	331 command widget (-opt val -opt val ...)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	332 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	333
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	334 Once created, the pathname to the widget becomes a new command. This
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	335 new \var{widget command} is the programmer's handle for getting the new
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	336 widget to perform some \var{action}. In C, you'd express this as
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	337 someAction(fred, someOptions), in \Cpp, you would express this as
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	338 fred.someAction(someOptions), and in Tk, you say:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	339
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	340 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	341 .fred someAction someOptions
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	342 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	343
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	344 Note that the object name, \code{.fred}, starts with a dot.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	345
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	346 As you'd expect, the legal values for \var{someAction} will depend on
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	347 the widget's class: \code{.fred disable} works if fred is a
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	348 button (fred gets greyed out), but does not work if fred is a label
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	349 (disabling of labels is not supported in Tk).
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	350
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	351 The legal values of \var{someOptions} is action dependent. Some
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	352 actions, like \code{disable}, require no arguments, others, like
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	353 a text-entry box's \code{delete} command, would need arguments
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	354 to specify what range of text to delete.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	355
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	356
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	357 \subsection{Mapping Basic Tk into Tkinter
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	358 \label{tkinter-basic-mapping}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	359
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	360 Class commands in Tk correspond to class constructors in Tkinter.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	361
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	362 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	363 button .fred =====> fred = Button()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	364 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	365
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	366 The master of an object is implicit in the new name given to it at
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	367 creation time. In Tkinter, masters are specified explicitly.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	368
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	369 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	370 button .panel.fred =====> fred = Button(panel)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	371 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	372
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	373 The configuration options in Tk are given in lists of hyphened tags
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	374 followed by values. In Tkinter, options are specified as
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	375 keyword-arguments in the instance constructor, and keyword-args for
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	376 configure calls or as instance indices, in dictionary style, for
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	377 established instances. See section~\ref{tkinter-setting-options} on
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	378 setting options.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	379
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	380 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	381 button .fred -fg red =====> fred = Button(panel, fg = "red")
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	382 .fred configure -fg red =====> fred["fg"] = red
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	383 OR ==> fred.config(fg = "red")
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	384 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	385
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	386 In Tk, to perform an action on a widget, use the widget name as a
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	387 command, and follow it with an action name, possibly with arguments
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	388 (options). In Tkinter, you call methods on the class instance to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	389 invoke actions on the widget. The actions (methods) that a given
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	390 widget can perform are listed in the Tkinter.py module.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	391
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	392 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	393 .fred invoke =====> fred.invoke()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	394 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	395
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	396 To give a widget to the packer (geometry manager), you call pack with
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	397 optional arguments. In Tkinter, the Pack class holds all this
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	398 functionality, and the various forms of the pack command are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	399 implemented as methods. All widgets in \refmodule{Tkinter} are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	400 subclassed from the Packer, and so inherit all the packing
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	401 methods. See the \refmodule{Tix} module documentation for additional
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	402 information on the Form geometry manager.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	403
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	404 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	405 pack .fred -side left =====> fred.pack(side = "left")
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	406 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	407
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	408
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	409 \subsection{How Tk and Tkinter are Related} % Relationship.html
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	410
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	411 \note{This was derived from a graphical image; the image will be used
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	412 more directly in a subsequent version of this document.}
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	413
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	414 From the top down:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	415 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	416 \item[\b{Your App Here (Python)}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	417 A Python application makes a \refmodule{Tkinter} call.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	418
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	419 \item[\b{Tkinter (Python Module)}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	420 This call (say, for example, creating a button widget), is
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	421 implemented in the \emph{Tkinter} module, which is written in
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	422 Python. This Python function will parse the commands and the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	423 arguments and convert them into a form that makes them look as if they
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	424 had come from a Tk script instead of a Python script.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	425
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	426 \item[\b{tkinter (C)}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	427 These commands and their arguments will be passed to a C function
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	428 in the \emph{tkinter} - note the lowercase - extension module.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	429
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	430 \item[\b{Tk Widgets} (C and Tcl)]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	431 This C function is able to make calls into other C modules,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	432 including the C functions that make up the Tk library. Tk is
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	433 implemented in C and some Tcl. The Tcl part of the Tk widgets is used
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	434 to bind certain default behaviors to widgets, and is executed once at
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	435 the point where the Python \refmodule{Tkinter} module is
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	436 imported. (The user never sees this stage).
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	437
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	438 \item[\b{Tk (C)}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	439 The Tk part of the Tk Widgets implement the final mapping to ...
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	440
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	441 \item[\b{Xlib (C)}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	442 the Xlib library to draw graphics on the screen.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	443 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	444
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	445
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	446 \subsection{Handy Reference}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	447
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	448 \subsubsection{Setting Options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	449 \label{tkinter-setting-options}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	450
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	451 Options control things like the color and border width of a widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	452 Options can be set in three ways:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	453
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	454 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	455 \item[At object creation time, using keyword arguments]:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	456 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	457 fred = Button(self, fg = "red", bg = "blue")
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	458 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	459 \item[After object creation, treating the option name like a dictionary index]:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	460 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	461 fred["fg"] = "red"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	462 fred["bg"] = "blue"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	463 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	464 \item[Use the config() method to update multiple attrs subesequent to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	465 object creation]:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	466 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	467 fred.config(fg = "red", bg = "blue")
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	468 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	469 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	470
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	471 For a complete explanation of a given option and its behavior, see the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	472 Tk man pages for the widget in question.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	473
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	474 Note that the man pages list "STANDARD OPTIONS" and "WIDGET SPECIFIC
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	475 OPTIONS" for each widget. The former is a list of options that are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	476 common to many widgets, the latter are the options that are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	477 ideosyncratic to that particular widget. The Standard Options are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	478 documented on the \manpage{options}{3} man page.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	479
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	480 No distinction between standard and widget-specific options is made in
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	481 this document. Some options don't apply to some kinds of widgets.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	482 Whether a given widget responds to a particular option depends on the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	483 class of the widget; buttons have a \code{command} option, labels do not.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	484
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	485 The options supported by a given widget are listed in that widget's
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	486 man page, or can be queried at runtime by calling the
24137 176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	487 \method{config()} method without arguments, or by calling the
176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	488 \method{keys()} method on that widget. The return value of these
176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	489 calls is a dictionary whose key is the name of the option as a string
176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	490 (for example, \code{'relief'}) and whose values are 5-tuples.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	491
24137 176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	492 Some options, like \code{bg} are synonyms for common options with long
176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	493 names (\code{bg} is shorthand for "background"). Passing the
176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	494 \code{config()} method the name of a shorthand option will return a
176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	495 2-tuple, not 5-tuple. The 2-tuple passed back will contain the name of
176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	496 the synonym and the ``real'' option (such as \code{('bg',
176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	497 'background')}).
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	498
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	499 \begin{tableiii}{c\|l\|l}{textrm}{Index}{Meaning}{Example}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	500 \lineiii{0}{option name} {\code{'relief'}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	501 \lineiii{1}{option name for database lookup} {\code{'relief'}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	502 \lineiii{2}{option class for database lookup} {\code{'Relief'}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	503 \lineiii{3}{default value} {\code{'raised'}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	504 \lineiii{4}{current value} {\code{'groove'}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	505 \end{tableiii}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	506
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	507
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	508 Example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	509
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	510 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	511 >>> print fred.config()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	512 {'relief' : ('relief', 'relief', 'Relief', 'raised', 'groove')}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	513 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	514
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	515 Of course, the dictionary printed will include all the options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	516 available and their values. This is meant only as an example.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	517
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	518
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	519 \subsubsection{The Packer} % Packer.html
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	520 \index{packing (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	521
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	522 The packer is one of Tk's geometry-management mechanisms. See also
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	523 \citetitle[classes/ClassPacker.html]{the Packer class interface}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	524
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	525 Geometry managers are used to specify the relative positioning of the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	526 positioning of widgets within their container - their mutual
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	527 \emph{master}. In contrast to the more cumbersome \emph{placer}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	528 (which is used less commonly, and we do not cover here), the packer
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	529 takes qualitative relationship specification - \emph{above}, \emph{to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	530 the left of}, \emph{filling}, etc - and works everything out to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	531 determine the exact placement coordinates for you.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	532
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	533 The size of any \emph{master} widget is determined by the size of
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	534 the "slave widgets" inside. The packer is used to control where slave
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	535 widgets appear inside the master into which they are packed. You can
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	536 pack widgets into frames, and frames into other frames, in order to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	537 achieve the kind of layout you desire. Additionally, the arrangement
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	538 is dynamically adjusted to accomodate incremental changes to the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	539 configuration, once it is packed.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	540
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	541 Note that widgets do not appear until they have had their geometry
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	542 specified with a geometry manager. It's a common early mistake to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	543 leave out the geometry specification, and then be surprised when the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	544 widget is created but nothing appears. A widget will appear only
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	545 after it has had, for example, the packer's \method{pack()} method
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	546 applied to it.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	547
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	548 The pack() method can be called with keyword-option/value pairs that
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	549 control where the widget is to appear within its container, and how it
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	550 is to behave when the main application window is resized. Here are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	551 some examples:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	552
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	553 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	554 fred.pack() # defaults to side = "top"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	555 fred.pack(side = "left")
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	556 fred.pack(expand = 1)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	557 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	558
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	559
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	560 \subsubsection{Packer Options}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	561
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	562 For more extensive information on the packer and the options that it
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	563 can take, see the man pages and page 183 of John Ousterhout's book.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	564
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	565 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	566 \item[\b{anchor }]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	567 Anchor type. Denotes where the packer is to place each slave in its
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	568 parcel.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	569
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	570 \item[\b{expand}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	571 Boolean, \code{0} or \code{1}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	572
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	573 \item[\b{fill}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	574 Legal values: \code{'x'}, \code{'y'}, \code{'both'}, \code{'none'}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	575
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	576 \item[\b{ipadx} and \b{ipady}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	577 A distance - designating internal padding on each side of the slave
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	578 widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	579
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	580 \item[\b{padx} and \b{pady}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	581 A distance - designating external padding on each side of the slave
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	582 widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	583
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	584 \item[\b{side}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	585 Legal values are: \code{'left'}, \code{'right'}, \code{'top'},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	586 \code{'bottom'}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	587 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	588
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	589
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	590 \subsubsection{Coupling Widget Variables} % VarCouplings.html
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	591
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	592 The current-value setting of some widgets (like text entry widgets)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	593 can be connected directly to application variables by using special
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	594 options. These options are \code{variable}, \code{textvariable},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	595 \code{onvalue}, \code{offvalue}, and \code{value}. This
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	596 connection works both ways: if the variable changes for any reason,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	597 the widget it's connected to will be updated to reflect the new value.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	598
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	599 Unfortunately, in the current implementation of \refmodule{Tkinter} it is
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	600 not possible to hand over an arbitrary Python variable to a widget
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	601 through a \code{variable} or \code{textvariable} option. The only
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	602 kinds of variables for which this works are variables that are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	603 subclassed from a class called Variable, defined in the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	604 \refmodule{Tkinter} module.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	605
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	606 There are many useful subclasses of Variable already defined:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	607 \class{StringVar}, \class{IntVar}, \class{DoubleVar}, and
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	608 \class{BooleanVar}. To read the current value of such a variable,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	609 call the \method{get()} method on
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	610 it, and to change its value you call the \method{set()} method. If
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	611 you follow this protocol, the widget will always track the value of
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	612 the variable, with no further intervention on your part.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	613
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	614 For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	615 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	616 class App(Frame):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	617 def __init__(self, master=None):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	618 Frame.__init__(self, master)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	619 self.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	620
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	621 self.entrythingy = Entry()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	622 self.entrythingy.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	623
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	624 self.button.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	625 # here is the application variable
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	626 self.contents = StringVar()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	627 # set it to some value
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	628 self.contents.set("this is a variable")
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	629 # tell the entry widget to watch this variable
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	630 self.entrythingy["textvariable"] = self.contents
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	631
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	632 # and here we get a callback when the user hits return.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	633 # we will have the program print out the value of the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	634 # application variable when the user hits return
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	635 self.entrythingy.bind('<Key-Return>',
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	636 self.print_contents)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	637
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	638 def print_contents(self, event):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	639 print "hi. contents of entry is now ---->", \
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	640 self.contents.get()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	641 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	642
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	643
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	644 \subsubsection{The Window Manager} % WindowMgr.html
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	645 \index{window manager (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	646
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	647 In Tk, there is a utility command, \code{wm}, for interacting with the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	648 window manager. Options to the \code{wm} command allow you to control
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	649 things like titles, placement, icon bitmaps, and the like. In
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	650 \refmodule{Tkinter}, these commands have been implemented as methods
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	651 on the \class{Wm} class. Toplevel widgets are subclassed from the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	652 \class{Wm} class, and so can call the \class{Wm} methods directly.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	653
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	654 %See also \citetitle[classes/ClassWm.html]{the Wm class interface}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	655
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	656 To get at the toplevel window that contains a given widget, you can
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	657 often just refer to the widget's master. Of course if the widget has
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	658 been packed inside of a frame, the master won't represent a toplevel
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	659 window. To get at the toplevel window that contains an arbitrary
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	660 widget, you can call the \method{_root()} method. This
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	661 method begins with an underscore to denote the fact that this function
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	662 is part of the implementation, and not an interface to Tk functionality.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	663
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	664 Here are some examples of typical usage:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	665
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	666 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	667 import Tkinter
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	668 class App(Frame):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	669 def __init__(self, master=None):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	670 Frame.__init__(self, master)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	671 self.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	672
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	673
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	674 # create the application
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	675 myapp = App()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	676
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	677 #
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	678 # here are method calls to the window manager class
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	679 #
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	680 myapp.master.title("My Do-Nothing Application")
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	681 myapp.master.maxsize(1000, 400)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	682
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	683 # start the program
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	684 myapp.mainloop()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	685 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	686
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	687
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	688 \subsubsection{Tk Option Data Types} % OptionTypes.html
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	689
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	690 \index{Tk Option Data Types}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	691
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	692 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	693 \item[anchor]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	694 Legal values are points of the compass: \code{"n"},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	695 \code{"ne"}, \code{"e"}, \code{"se"}, \code{"s"},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	696 \code{"sw"}, \code{"w"}, \code{"nw"}, and also
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	697 \code{"center"}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	698
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	699 \item[bitmap]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	700 There are eight built-in, named bitmaps: \code{'error'}, \code{'gray25'},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	701 \code{'gray50'}, \code{'hourglass'}, \code{'info'}, \code{'questhead'},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	702 \code{'question'}, \code{'warning'}. To specify an X bitmap
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	703 filename, give the full path to the file, preceded with an \code{@},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	704 as in \code{"@/usr/contrib/bitmap/gumby.bit"}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	705
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	706 \item[boolean]
26004 28cff60a6097 Fix SF #632864, Typo string instead of sting in LibDoc. Will backport. Neal Norwitz <nnorwitz@gmail.com> parents: 25750 diff changeset	707 You can pass integers 0 or 1 or the strings \code{"yes"} or \code{"no"} .
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	708
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	709 \item[callback]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	710 This is any Python function that takes no arguments. For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	711 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	712 def print_it():
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	713 print "hi there"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	714 fred["command"] = print_it
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	715 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	716
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	717 \item[color]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	718 Colors can be given as the names of X colors in the rgb.txt file,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	719 or as strings representing RGB values in 4 bit: \code{"\#RGB"}, 8
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	720 bit: \code{"\#RRGGBB"}, 12 bit" \code{"\#RRRGGGBBB"}, or 16 bit
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	721 \code{"\#RRRRGGGGBBBB"} ranges, where R,G,B here represent any
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	722 legal hex digit. See page 160 of Ousterhout's book for details.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	723
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	724 \item[cursor]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	725 The standard X cursor names from \file{cursorfont.h} can be used,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	726 without the \code{XC_} prefix. For example to get a hand cursor
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	727 (\constant{XC_hand2}), use the string \code{"hand2"}. You can also
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	728 specify a bitmap and mask file of your own. See page 179 of
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	729 Ousterhout's book.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	730
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	731 \item[distance]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	732 Screen distances can be specified in either pixels or absolute
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	733 distances. Pixels are given as numbers and absolute distances as
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	734 strings, with the trailing character denoting units: \code{c}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	735 for centimeters, \code{i} for inches, \code{m} for millimeters,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	736 \code{p} for printer's points. For example, 3.5 inches is expressed
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	737 as \code{"3.5i"}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	738
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	739 \item[font]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	740 Tk uses a list font name format, such as \code{\{courier 10 bold\}}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	741 Font sizes with positive numbers are measured in points;
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	742 sizes with negative numbers are measured in pixels.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	743
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	744 \item[geometry]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	745 This is a string of the form \samp{\var{width}x\var{height}}, where
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	746 width and height are measured in pixels for most widgets (in
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	747 characters for widgets displaying text). For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	748 \code{fred["geometry"] = "200x100"}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	749
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	750 \item[justify]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	751 Legal values are the strings: \code{"left"},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	752 \code{"center"}, \code{"right"}, and \code{"fill"}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	753
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	754 \item[region]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	755 This is a string with four space-delimited elements, each of
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	756 which is a legal distance (see above). For example: \code{"2 3 4
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	757 5"} and \code{"3i 2i 4.5i 2i"} and \code{"3c 2c 4c 10.43c"}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	758 are all legal regions.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	759
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	760 \item[relief]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	761 Determines what the border style of a widget will be. Legal
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	762 values are: \code{"raised"}, \code{"sunken"},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	763 \code{"flat"}, \code{"groove"}, and \code{"ridge"}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	764
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	765 \item[scrollcommand]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	766 This is almost always the \method{set()} method of some scrollbar
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	767 widget, but can be any widget method that takes a single argument.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	768 Refer to the file \file{Demo/tkinter/matt/canvas-with-scrollbars.py}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	769 in the Python source distribution for an example.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	770
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	771 \item[wrap:]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	772 Must be one of: \code{"none"}, \code{"char"}, or \code{"word"}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	773 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	774
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	775
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	776 \subsubsection{Bindings and Events} % Bindings.html
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	777
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	778 \index{bind (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	779 \index{events (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	780
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	781 The bind method from the widget command allows you to watch for
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	782 certain events and to have a callback function trigger when that event
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	783 type occurs. The form of the bind method is:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	784
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	785 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	786 def bind(self, sequence, func, add=''):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	787 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	788 where:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	789
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	790 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	791 \item[sequence]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	792 is a string that denotes the target kind of event. (See the bind
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	793 man page and page 201 of John Ousterhout's book for details).
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	794
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	795 \item[func]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	796 is a Python function, taking one argument, to be invoked when the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	797 event occurs. An Event instance will be passed as the argument.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	798 (Functions deployed this way are commonly known as \var{callbacks}.)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	799
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	800 \item[add]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	801 is optional, either \samp{} or \samp{+}. Passing an empty string
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	802 denotes that this binding is to replace any other bindings that this
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	803 event is associated with. Preceeding with a \samp{+} means that this
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	804 function is to be added to the list of functions bound to this event type.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	805 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	806
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	807 For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	808 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	809 def turnRed(self, event):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	810 event.widget["activeforeground"] = "red"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	811
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	812 self.button.bind("<Enter>", self.turnRed)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	813 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	814
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	815 Notice how the widget field of the event is being accesed in the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	816 \method{turnRed()} callback. This field contains the widget that
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	817 caught the X event. The following table lists the other event fields
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	818 you can access, and how they are denoted in Tk, which can be useful
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	819 when referring to the Tk man pages.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	820
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	821 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	822 Tk Tkinter Event Field Tk Tkinter Event Field
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	823 -- ------------------- -- -------------------
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	824 %f focus %A char
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	825 %h height %E send_event
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	826 %k keycode %K keysym
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	827 %s state %N keysym_num
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	828 %t time %T type
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	829 %w width %W widget
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	830 %x x %X x_root
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	831 %y y %Y y_root
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	832 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	833
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	834
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	835 \subsubsection{The index Parameter} % Index.html
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	836
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	837 A number of widgets require``index'' parameters to be passed. These
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	838 are used to point at a specific place in a Text widget, or to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	839 particular characters in an Entry widget, or to particular menu items
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	840 in a Menu widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	841
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	842 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	843 \item[\b{Entry widget indexes (index, view index, etc.)}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	844 Entry widgets have options that refer to character positions in the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	845 text being displayed. You can use these \refmodule{Tkinter} functions
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	846 to access these special points in text widgets:
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	847
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	848 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	849 \item[AtEnd()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	850 refers to the last position in the text
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	851
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	852 \item[AtInsert()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	853 refers to the point where the text cursor is
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	854
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	855 \item[AtSelFirst()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	856 indicates the beginning point of the selected text
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	857
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	858 \item[AtSelLast()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	859 denotes the last point of the selected text and finally
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	860
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	861 \item[At(x\optional{, y})]
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	862 refers to the character at pixel location \var{x}, \var{y} (with
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	863 \var{y} not used in the case of a text entry widget, which contains a
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	864 single line of text).
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	865 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	866
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	867 \item[\b{Text widget indexes}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	868 The index notation for Text widgets is very rich and is best described
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	869 in the Tk man pages.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	870
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	871 \item[\b{Menu indexes (menu.invoke(), menu.entryconfig(), etc.)}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	872
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	873 Some options and methods for menus manipulate specific menu entries.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	874 Anytime a menu index is needed for an option or a parameter, you may
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	875 pass in:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	876 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	877 \item an integer which refers to the numeric position of the entry in
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	878 the widget, counted from the top, starting with 0;
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	879 \item the string \code{'active'}, which refers to the menu position that is
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	880 currently under the cursor;
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	881 \item the string \code{"last"} which refers to the last menu
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	882 item;
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	883 \item An integer preceded by \code{@}, as in \code{@6}, where the integer is
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	884 interpreted as a y pixel coordinate in the menu's coordinate system;
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	885 \item the string \code{"none"}, which indicates no menu entry at all, most
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	886 often used with menu.activate() to deactivate all entries, and
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	887 finally,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	888 \item a text string that is pattern matched against the label of the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	889 menu entry, as scanned from the top of the menu to the bottom. Note
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	890 that this index type is considered after all the others, which means
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	891 that matches for menu items labelled \code{last}, \code{active}, or
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	892 \code{none} may be interpreted as the above literals, instead.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	893 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	894 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	895
26057 13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	896 \subsubsection{Images}
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	897
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	898 Bitmap/Pixelmap images can be created through the subclasses of
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	899 \class{Tkinter.Image}:
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	900
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	901 \begin{itemize}
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	902 \item \class{BitmapImage} can be used for X11 bitmap data.
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	903 \item \class{PhotoImage} can be used for GIF and PPM/PGM color bitmaps.
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	904 \end{itemize}
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	905
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	906 Either type of image is created through either the \code{file} or the
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	907 \code{data} option (other options are available as well).
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	908
26065 d27e5cad38d7 Whoops, fix the typo correctly this time Neal Norwitz <nnorwitz@gmail.com> parents: 26060 diff changeset	909 The image object can then be used wherever an \code{image} option is
26057 13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	910 supported by some widget (e.g. labels, buttons, menus). In these
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	911 cases, Tk will not keep a reference to the image. When the last Python
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	912 reference to the image object is deleted, the image data is deleted as
26065 d27e5cad38d7 Whoops, fix the typo correctly this time Neal Norwitz <nnorwitz@gmail.com> parents: 26060 diff changeset	913 well, and Tk will display an empty box wherever the image was used.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	914
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	915 \section{\module{Tix} ---
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	916 Extension widgets for Tk}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	917
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	918 \declaremodule{standard}{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	919 \modulesynopsis{Tk Extension Widgets for Tkinter}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	920 \sectionauthor{Mike Clarkson}{mikeclarkson@users.sourceforge.net}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	921
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	922 \index{Tix}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	923
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	924 The \module{Tix} (Tk Interface Extension) module provides an
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	925 additional rich set of widgets. Although the standard Tk library has
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	926 many useful widgets, they are far from complete. The \module{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	927 library provides most of the commonly needed widgets that are missing
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	928 from standard Tk: \class{HList}, \class{ComboBox}, \class{Control}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	929 (a.k.a. SpinBox) and an assortment of scrollable widgets. \module{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	930 also includes many more widgets that are generally useful in a wide
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	931 range of applications: \class{NoteBook}, \class{FileEntry},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	932 \class{PanedWindow}, etc; there are more than 40 of them.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	933
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	934 With all these new widgets, you can introduce new interaction
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	935 techniques into applications, creating more useful and more intuitive
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	936 user interfaces. You can design your application by choosing the most
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	937 appropriate widgets to match the special needs of your application and
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	938 users.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	939
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	940 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	941 \seetitle[http://tix.sourceforge.net/]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	942 {Tix Homepage}
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	943 {The home page for \module{Tix}. This includes links to
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	944 additional documentation and downloads.}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	945 \seetitle[http://tix.sourceforge.net/dist/current/man/]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	946 {Tix Man Pages}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	947 {On-line version of the man pages and reference material.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	948 \seetitle[http://tix.sourceforge.net/dist/current/docs/tix-book/tix.book.html]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	949 {Tix Programming Guide}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	950 {On-line version of the programmer's reference material.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	951 \seetitle[http://tix.sourceforge.net/Tide/]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	952 {Tix Development Applications}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	953 {Tix applications for development of Tix and Tkinter programs.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	954 Tide applications work under Tk or Tkinter, and include
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	955 \program{TixInspect}, an inspector to remotely modify and
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	956 debug Tix/Tk/Tkinter applications.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	957 \end{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	958
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	959
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	960 \subsection{Using Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	961
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	962 \begin{classdesc}{Tix}{screenName\optional{, baseName\optional{, className}}}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	963 Toplevel widget of Tix which represents mostly the main window
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	964 of an application. It has an associated Tcl interpreter.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	965
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	966 Classes in the \refmodule{Tix} module subclasses the classes in the
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	967 \refmodule{Tkinter} module. The former imports the latter, so to use
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	968 \refmodule{Tix} with Tkinter, all you need to do is to import one
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	969 module. In general, you can just import \refmodule{Tix}, and replace
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	970 the toplevel call to \class{Tkinter.Tk} with \class{Tix.Tk}:
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	971 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	972 import Tix
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	973 from Tkconstants import *
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	974 root = Tix.Tk()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	975 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	976 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	977
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	978 To use \refmodule{Tix}, you must have the \refmodule{Tix} widgets installed,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	979 usually alongside your installation of the Tk widgets.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	980 To test your installation, try the following:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	981 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	982 import Tix
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	983 root = Tix.Tk()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	984 root.tk.eval('package require Tix')
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	985 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	986
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	987 If this fails, you have a Tk installation problem which must be
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	988 resolved before proceeding. Use the environment variable \envvar{TIX_LIBRARY}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	989 to point to the installed \refmodule{Tix} library directory, and
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	990 make sure you have the dynamic object library (\file{tix8183.dll} or
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	991 \file{libtix8183.so}) in the same directory that contains your Tk
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	992 dynamic object library (\file{tk8183.dll} or \file{libtk8183.so}). The
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	993 directory with the dynamic object library should also have a file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	994 called \file{pkgIndex.tcl} (case sensitive), which contains the line:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	995
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	996 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	997 package ifneeded Tix 8.1 [list load "[file join $dir tix8183.dll]" Tix]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	998 \end{verbatim} % $ <-- bow to font-lock
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	999
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1000
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1001 \subsection{Tix Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1002
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1003 \ulink{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1004 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/TixIntro.htm}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1005 introduces over 40 widget classes to the \refmodule{Tkinter}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1006 repertoire. There is a demo of all the \refmodule{Tix} widgets in the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1007 \file{Demo/tix} directory of the standard distribution.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1008
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1009
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1010 % The Python sample code is still being added to Python, hence commented out
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1011
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1012
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1013 \subsubsection{Basic Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1014
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1015 \begin{classdesc}{Balloon}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1016 A \ulink{Balloon}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1017 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixBalloon.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1018 that pops up over a widget to provide help. When the user moves the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1019 cursor inside a widget to which a Balloon widget has been bound, a
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1020 small pop-up window with a descriptive message will be shown on the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1021 screen.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1022 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1023
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1024 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1025 % \ulink{Balloon}{http://tix.sourceforge.net/dist/current/demos/samples/Balloon.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1026
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1027 \begin{classdesc}{ButtonBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1028 The \ulink{ButtonBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1029 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixButtonBox.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1030 widget creates a box of buttons, such as is commonly used for \code{Ok
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1031 Cancel}.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1032 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1033
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1034 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1035 % \ulink{ButtonBox}{http://tix.sourceforge.net/dist/current/demos/samples/BtnBox.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1036
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1037 \begin{classdesc}{ComboBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1038 The \ulink{ComboBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1039 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixComboBox.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1040 widget is similar to the combo box control in MS Windows. The user can
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1041 select a choice by either typing in the entry subwdget or selecting
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1042 from the listbox subwidget.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1043 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1044
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1045 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1046 % \ulink{ComboBox}{http://tix.sourceforge.net/dist/current/demos/samples/ComboBox.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1047
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1048 \begin{classdesc}{Control}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1049 The \ulink{Control}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1050 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixControl.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1051 widget is also known as the \class{SpinBox} widget. The user can
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1052 adjust the value by pressing the two arrow buttons or by entering the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1053 value directly into the entry. The new value will be checked against
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1054 the user-defined upper and lower limits.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1055 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1056
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1057 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1058 % \ulink{Control}{http://tix.sourceforge.net/dist/current/demos/samples/Control.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1059
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1060 \begin{classdesc}{LabelEntry}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1061 The \ulink{LabelEntry}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1062 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixLabelEntry.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1063 widget packages an entry widget and a label into one mega widget. It
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1064 can be used be used to simplify the creation of ``entry-form'' type of
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1065 interface.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1066 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1067
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1068 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1069 % \ulink{LabelEntry}{http://tix.sourceforge.net/dist/current/demos/samples/LabEntry.tcl}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1070
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1071 \begin{classdesc}{LabelFrame}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1072 The \ulink{LabelFrame}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1073 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixLabelFrame.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1074 widget packages a frame widget and a label into one mega widget. To
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1075 create widgets inside a LabelFrame widget, one creates the new widgets
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1076 relative to the \member{frame} subwidget and manage them inside the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1077 \member{frame} subwidget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1078 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1079
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1080 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1081 % \ulink{LabelFrame}{http://tix.sourceforge.net/dist/current/demos/samples/LabFrame.tcl}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1082
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1083 \begin{classdesc}{Meter}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1084 The \ulink{Meter}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1085 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixMeter.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1086 widget can be used to show the progress of a background job which may
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1087 take a long time to execute.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1088 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1089
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1090 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1091 % \ulink{Meter}{http://tix.sourceforge.net/dist/current/demos/samples/Meter.tcl}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1092
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1093 \begin{classdesc}{OptionMenu}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1094 The \ulink{OptionMenu}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1095 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixOptionMenu.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1096 creates a menu button of options.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1097 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1098
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1099 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1100 % \ulink{OptionMenu}{http://tix.sourceforge.net/dist/current/demos/samples/OptMenu.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1101
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1102 \begin{classdesc}{PopupMenu}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1103 The \ulink{PopupMenu}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1104 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixPopupMenu.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1105 widget can be used as a replacement of the \code{tk_popup}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1106 command. The advantage of the \refmodule{Tix} \class{PopupMenu} widget
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1107 is it requires less application code to manipulate.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1108 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1109
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1110 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1111 % \ulink{PopupMenu}{http://tix.sourceforge.net/dist/current/demos/samples/PopMenu.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1112
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1113 \begin{classdesc}{Select}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1114 The \ulink{Select}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1115 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixSelect.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1116 widget is a container of button subwidgets. It can be used to provide
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1117 radio-box or check-box style of selection options for the user.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1118 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1119
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1120 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1121 % \ulink{Select}{http://tix.sourceforge.net/dist/current/demos/samples/Select.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1122
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1123 \begin{classdesc}{StdButtonBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1124 The \ulink{StdButtonBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1125 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixStdButtonBox.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1126 widget is a group of standard buttons for Motif-like dialog boxes.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1127 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1128
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1129 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1130 % \ulink{StdButtonBox}{http://tix.sourceforge.net/dist/current/demos/samples/StdBBox.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1131
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1132
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1133 \subsubsection{File Selectors}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1134
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1135 \begin{classdesc}{DirList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1136 The \ulink{DirList}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1137 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixDirList.htm} widget
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1138 displays a list view of a directory, its previous directories and its
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1139 sub-directories. The user can choose one of the directories displayed
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1140 in the list or change to another directory.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1141 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1142
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1143 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1144 % \ulink{DirList}{http://tix.sourceforge.net/dist/current/demos/samples/DirList.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1145
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1146 \begin{classdesc}{DirTree}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1147 The \ulink{DirTree}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1148 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixDirTree.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1149 widget displays a tree view of a directory, its previous directories
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1150 and its sub-directories. The user can choose one of the directories
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1151 displayed in the list or change to another directory.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1152 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1153
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1154 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1155 % \ulink{DirTree}{http://tix.sourceforge.net/dist/current/demos/samples/DirTree.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1156
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1157 \begin{classdesc}{DirSelectDialog}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1158 The \ulink{DirSelectDialog}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1159 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixDirSelectDialog.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1160 widget presents the directories in the file system in a dialog
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1161 window. The user can use this dialog window to navigate through the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1162 file system to select the desired directory.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1163 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1164
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1165 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1166 % \ulink{DirSelectDialog}{http://tix.sourceforge.net/dist/current/demos/samples/DirDlg.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1167
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1168 \begin{classdesc}{DirSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1169 The \class{DirSelectBox} is similar
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1170 to the standard Motif(TM) directory-selection box. It is generally used for
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1171 the user to choose a directory. DirSelectBox stores the directories mostly
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1172 recently selected into a ComboBox widget so that they can be quickly
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1173 selected again.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1174 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1175
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1176 \begin{classdesc}{ExFileSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1177 The \ulink{ExFileSelectBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1178 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixExFileSelectBox.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1179 widget is usually embedded in a tixExFileSelectDialog widget. It
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1180 provides an convenient method for the user to select files. The style
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1181 of the \class{ExFileSelectBox} widget is very similar to the standard
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1182 file dialog on MS Windows 3.1.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1183 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1184
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1185 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1186 %\ulink{ExFileSelectDialog}{http://tix.sourceforge.net/dist/current/demos/samples/EFileDlg.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1187
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1188 \begin{classdesc}{FileSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1189 The \ulink{FileSelectBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1190 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixFileSelectBox.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1191 is similar to the standard Motif(TM) file-selection box. It is
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1192 generally used for the user to choose a file. FileSelectBox stores the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1193 files mostly recently selected into a \class{ComboBox} widget so that
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1194 they can be quickly selected again.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1195 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1196
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1197 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1198 % \ulink{FileSelectDialog}{http://tix.sourceforge.net/dist/current/demos/samples/FileDlg.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1199
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1200 \begin{classdesc}{FileEntry}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1201 The \ulink{FileEntry}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1202 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixFileEntry.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1203 widget can be used to input a filename. The user can type in the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1204 filename manually. Alternatively, the user can press the button widget
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1205 that sits next to the entry, which will bring up a file selection
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1206 dialog.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1207 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1208
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1209 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1210 % \ulink{FileEntry}{http://tix.sourceforge.net/dist/current/demos/samples/FileEnt.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1211
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1212
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1213 \subsubsection{Hierachical ListBox}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1214
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1215 \begin{classdesc}{HList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1216 The \ulink{HList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1217 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixHList.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1218 widget can be used to display any data that have a hierarchical
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1219 structure, for example, file system directory trees. The list entries
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1220 are indented and connected by branch lines according to their places
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1221 in the hierachy.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1222 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1223
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1224 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1225 % \ulink{HList}{http://tix.sourceforge.net/dist/current/demos/samples/HList1.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1226
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1227 \begin{classdesc}{CheckList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1228 The \ulink{CheckList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1229 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixCheckList.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1230 widget displays a list of items to be selected by the user. CheckList
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1231 acts similarly to the Tk checkbutton or radiobutton widgets, except it
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1232 is capable of handling many more items than checkbuttons or
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1233 radiobuttons.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1234 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1235
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1236 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1237 % \ulink{ CheckList}{http://tix.sourceforge.net/dist/current/demos/samples/ChkList.tcl}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1238 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1239 % \ulink{ScrolledHList (1)}{http://tix.sourceforge.net/dist/current/demos/samples/SHList.tcl}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1240 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1241 % \ulink{ScrolledHList (2)}{http://tix.sourceforge.net/dist/current/demos/samples/SHList2.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1242
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1243 \begin{classdesc}{Tree}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1244 The \ulink{Tree}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1245 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixTree.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1246 widget can be used to display hierachical data in a tree form. The
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1247 user can adjust the view of the tree by opening or closing parts of
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1248 the tree.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1249 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1250
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1251 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1252 % \ulink{Tree}{http://tix.sourceforge.net/dist/current/demos/samples/Tree.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1253
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1254 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1255 % \ulink{Tree (Dynamic)}{http://tix.sourceforge.net/dist/current/demos/samples/DynTree.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1256
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1257
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1258 \subsubsection{Tabular ListBox}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1259
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1260 \begin{classdesc}{TList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1261 The \ulink{TList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1262 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixTList.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1263 widget can be used to display data in a tabular format. The list
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1264 entries of a \class{TList} widget are similar to the entries in the Tk
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1265 listbox widget. The main differences are (1) the \class{TList} widget
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1266 can display the list entries in a two dimensional format and (2) you
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1267 can use graphical images as well as multiple colors and fonts for the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1268 list entries.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1269 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1270
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1271 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1272 % \ulink{ScrolledTList (1)}{http://tix.sourceforge.net/dist/current/demos/samples/STList1.tcl}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1273 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1274 % \ulink{ScrolledTList (2)}{http://tix.sourceforge.net/dist/current/demos/samples/STList2.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1275
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1276 % Grid has yet to be added to Python
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1277 % \subsubsection{Grid Widget}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1278 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1279 % \ulink{Simple Grid}{http://tix.sourceforge.net/dist/current/demos/samples/SGrid0.tcl}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1280 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1281 % \ulink{ScrolledGrid}{http://tix.sourceforge.net/dist/current/demos/samples/SGrid1.tcl}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1282 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1283 % \ulink{Editable Grid}{http://tix.sourceforge.net/dist/current/demos/samples/EditGrid.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1284
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1285
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1286 \subsubsection{Manager Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1287
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1288 \begin{classdesc}{PanedWindow}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1289 The \ulink{PanedWindow}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1290 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixPanedWindow.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1291 widget allows the user to interactively manipulate the sizes of
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1292 several panes. The panes can be arranged either vertically or
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1293 horizontally. The user changes the sizes of the panes by dragging the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1294 resize handle between two panes.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1295 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1296
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1297 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1298 % \ulink{PanedWindow}{http://tix.sourceforge.net/dist/current/demos/samples/PanedWin.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1299
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1300 \begin{classdesc}{ListNoteBook}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1301 The \ulink{ListNoteBook}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1302 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixListNoteBook.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1303 widget is very similar to the \class{TixNoteBook} widget: it can be
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1304 used to display many windows in a limited space using a notebook
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1305 metaphor. The notebook is divided into a stack of pages (windows). At
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1306 one time only one of these pages can be shown. The user can navigate
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1307 through these pages by choosing the name of the desired page in the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1308 \member{hlist} subwidget.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1309 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1310
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1311 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1312 % \ulink{ListNoteBook}{http://tix.sourceforge.net/dist/current/demos/samples/ListNBK.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1313
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1314 \begin{classdesc}{NoteBook}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1315 The \ulink{NoteBook}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1316 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixNoteBook.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1317 widget can be used to display many windows in a limited space using a
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1318 notebook metaphor. The notebook is divided into a stack of pages. At
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1319 one time only one of these pages can be shown. The user can navigate
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1320 through these pages by choosing the visual ``tabs'' at the top of the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1321 NoteBook widget.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1322 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1323
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1324 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1325 % \ulink{NoteBook}{http://tix.sourceforge.net/dist/current/demos/samples/NoteBook.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1326
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1327
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1328 % \subsubsection{Scrolled Widgets}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1329 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1330 % \ulink{ScrolledListBox}{http://tix.sourceforge.net/dist/current/demos/samples/SListBox.tcl}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1331 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1332 % \ulink{ScrolledText}{http://tix.sourceforge.net/dist/current/demos/samples/SText.tcl}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1333 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1334 % \ulink{ScrolledWindow}{http://tix.sourceforge.net/dist/current/demos/samples/SWindow.tcl}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1335 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1336 % \ulink{Canvas Object View}{http://tix.sourceforge.net/dist/current/demos/samples/CObjView.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1337
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1338
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1339 \subsubsection{Image Types}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1340
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1341 The \refmodule{Tix} module adds:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1342 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1343 \item
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1344 \ulink{pixmap}
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1345 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/pixmap.htm}
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1346 capabilities to all \refmodule{Tix} and \refmodule{Tkinter} widgets to
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1347 create color images from XPM files.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1348
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1349 % Python Demo of:
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1350 % \ulink{XPM Image In Button}{http://tix.sourceforge.net/dist/current/demos/samples/Xpm.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1351
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1352 % Python Demo of:
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1353 % \ulink{XPM Image In Menu}{http://tix.sourceforge.net/dist/current/demos/samples/Xpm1.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1354
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1355 \item
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1356 \ulink{Compound}
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1357 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/compound.html}
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1358 image types can be used to create images that consists of multiple
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1359 horizontal lines; each line is composed of a series of items (texts,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1360 bitmaps, images or spaces) arranged from left to right. For example, a
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1361 compound image can be used to display a bitmap and a text string
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1362 simutaneously in a Tk \class{Button} widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1363
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1364 % Python Demo of:
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1365 % \ulink{Compound Image In Buttons}{http://tix.sourceforge.net/dist/current/demos/samples/CmpImg.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1366
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1367 % Python Demo of:
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1368 % \ulink{Compound Image In NoteBook}{http://tix.sourceforge.net/dist/current/demos/samples/CmpImg2.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1369
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1370 % Python Demo of:
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1371 % \ulink{Compound Image Notebook Color Tabs}{http://tix.sourceforge.net/dist/current/demos/samples/CmpImg4.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1372
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1373 % Python Demo of:
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1374 % \ulink{Compound Image Icons}{http://tix.sourceforge.net/dist/current/demos/samples/CmpImg3.tcl}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1375 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1376
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1377
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1378 \subsubsection{Miscellaneous Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1379
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1380 \begin{classdesc}{InputOnly}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1381 The \ulink{InputOnly}
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1382 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixInputOnly.htm}
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1383 widgets are to accept inputs from the user, which can be done with the
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1384 \code{bind} command (\UNIX{} only).
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1385 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1386
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1387 \subsubsection{Form Geometry Manager}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1388
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1389 In addition, \refmodule{Tix} augments \refmodule{Tkinter} by providing:
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1390
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1391 \begin{classdesc}{Form}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1392 The \ulink{Form}
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1393 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixForm.htm}
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1394 geometry manager based on attachment rules for all Tk widgets.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1395 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1396
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1397
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1398 %begin{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1399 %\subsection{Tix Class Structure}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1400 %
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1401 %\begin{figure}[hbtp]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1402 %\centerline{\epsfig{file=hierarchy.png,width=.9\textwidth}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1403 %\vspace{.5cm}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1404 %\caption{The Class Hierarchy of Tix Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1405 %\end{figure}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1406 %end{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1407
21109 05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1408 \subsection{Tix Commands}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1409
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1410 \begin{classdesc}{tixCommand}{}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1411 The \ulink{tix commands}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1412 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tix.htm}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1413 provide access to miscellaneous elements of \refmodule{Tix}'s internal
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1414 state and the \refmodule{Tix} application context. Most of the information
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1415 manipulated by these methods pertains to the application as a whole,
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1416 or to a screen or display, rather than to a particular window.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1417
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1418 To view the current settings, the common usage is:
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1419 \begin{verbatim}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1420 import Tix
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1421 root = Tix.Tk()
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1422 print root.tix_configure()
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1423 \end{verbatim}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1424 \end{classdesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1425
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1426 \begin{methoddesc}{tix_configure}{\optional{cnf,} **kw}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1427 Query or modify the configuration options of the Tix application
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1428 context. If no option is specified, returns a dictionary all of the
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1429 available options. If option is specified with no value, then the
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1430 method returns a list describing the one named option (this list will
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1431 be identical to the corresponding sublist of the value returned if no
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1432 option is specified). If one or more option-value pairs are
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1433 specified, then the method modifies the given option(s) to have the
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1434 given value(s); in this case the method returns an empty string.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1435 Option may be any of the configuration options.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1436 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1437
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1438 \begin{methoddesc}{tix_cget}{option}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1439 Returns the current value of the configuration option given by
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1440 \var{option}. Option may be any of the configuration options.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1441 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1442
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1443 \begin{methoddesc}{tix_getbitmap}{name}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1444 Locates a bitmap file of the name \code{name.xpm} or \code{name} in
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1445 one of the bitmap directories (see the \method{tix_addbitmapdir()}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1446 method). By using \method{tix_getbitmap()}, you can avoid hard
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1447 coding the pathnames of the bitmap files in your application. When
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1448 successful, it returns the complete pathname of the bitmap file,
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1449 prefixed with the character \samp{@}. The returned value can be used to
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1450 configure the \code{bitmap} option of the Tk and Tix widgets.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1451 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1452
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1453 \begin{methoddesc}{tix_addbitmapdir}{directory}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1454 Tix maintains a list of directories under which the
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1455 \method{tix_getimage()} and \method{tix_getbitmap()} methods will
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1456 search for image files. The standard bitmap directory is
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1457 \file{\$TIX_LIBRARY/bitmaps}. The \method{tix_addbitmapdir()} method
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1458 adds \var{directory} into this list. By using this method, the image
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1459 files of an applications can also be located using the
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1460 \method{tix_getimage()} or \method{tix_getbitmap()} method.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1461 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1462
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1463 \begin{methoddesc}{tix_filedialog}{\optional{dlgclass}}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1464 Returns the file selection dialog that may be shared among different
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1465 calls from this application. This method will create a file selection
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1466 dialog widget when it is called the first time. This dialog will be
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1467 returned by all subsequent calls to \method{tix_filedialog()}. An
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1468 optional dlgclass parameter can be passed as a string to specified
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1469 what type of file selection dialog widget is desired. Possible
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1470 options are \code{tix}, \code{FileSelectDialog} or
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1471 \code{tixExFileSelectDialog}.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1472 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1473
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1474
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1475 \begin{methoddesc}{tix_getimage}{self, name}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1476 Locates an image file of the name \file{name.xpm}, \file{name.xbm} or
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1477 \file{name.ppm} in one of the bitmap directories (see the
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1478 \method{tix_addbitmapdir()} method above). If more than one file with
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1479 the same name (but different extensions) exist, then the image type is
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1480 chosen according to the depth of the X display: xbm images are chosen
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1481 on monochrome displays and color images are chosen on color
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1482 displays. By using \method{tix_getimage()}, you can avoid hard coding
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1483 the pathnames of the image files in your application. When successful,
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1484 this method returns the name of the newly created image, which can be
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1485 used to configure the \code{image} option of the Tk and Tix widgets.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1486 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1487
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1488 \begin{methoddesc}{tix_option_get}{name}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1489 Gets the options manitained by the Tix scheme mechanism.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1490 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1491
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1492 \begin{methoddesc}{tix_resetoptions}{newScheme, newFontSet\optional{,
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1493 newScmPrio}}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1494 Resets the scheme and fontset of the Tix application to
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1495 \var{newScheme} and \var{newFontSet}, respectively. This affects only
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1496 those widgets created after this call. Therefore, it is best to call
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1497 the resetoptions method before the creation of any widgets in a Tix
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1498 application.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1499
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1500 The optional parameter \var{newScmPrio} can be given to reset the
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1501 priority level of the Tk options set by the Tix schemes.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1502
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1503 Because of the way Tk handles the X option database, after Tix has
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1504 been has imported and inited, it is not possible to reset the color
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1505 schemes and font sets using the \method{tix_config()} method.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1506 Instead, the \method{tix_resetoptions()} method must be used.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1507 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1508
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1509
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1510
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1511 \section{\module{ScrolledText} ---
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1512 Scrolled Text Widget}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1513
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1514 \declaremodule{standard}{ScrolledText}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1515 \platform{Tk}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1516 \modulesynopsis{Text widget with a vertical scroll bar.}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1517 \sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1518
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1519 The \module{ScrolledText} module provides a class of the same name
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1520 which implements a basic text widget which has a vertical scroll bar
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1521 configured to do the ``right thing.'' Using the \class{ScrolledText}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1522 class is a lot easier than setting up a text widget and scroll bar
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1523 directly. The constructor is the same as that of the
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1524 \class{Tkinter.Text} class.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1525
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1526 The text widget and scrollbar are packed together in a \class{Frame},
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1527 and the methods of the \class{Grid} and \class{Pack} geometry managers
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1528 are acquired from the \class{Frame} object. This allows the
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1529 \class{ScrolledText} widget to be used directly to achieve most normal
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1530 geometry management behavior.
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1531
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1532 Should more specific control be necessary, the following attributes
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1533 are available:
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1534
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1535 \begin{memberdesc}[ScrolledText]{frame}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1536 The frame which surrounds the text and scroll bar widgets.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1537 \end{memberdesc}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1538
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1539 \begin{memberdesc}[ScrolledText]{vbar}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1540 The scroll bar widget.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1541 \end{memberdesc}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1542
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1543
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1544 \input{libturtle}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1545
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1546
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1547 \section{Idle \label{idle}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1548
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1549 %\declaremodule{standard}{idle}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1550 %\modulesynopsis{A Python Integrated Developement Environment}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1551 \moduleauthor{Guido van Rossum}{guido@Python.org}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1552
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1553 Idle is the Python IDE built with the \refmodule{Tkinter} GUI toolkit.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1554 \index{Idle}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1555 \index{Python Editor}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1556 \index{Integrated Developement Environment}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1557
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1558
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1559 IDLE has the following features:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1560
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1561 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1562 \item coded in 100\% pure Python, using the \refmodule{Tkinter} GUI toolkit
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1563
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1564 \item cross-platform: works on Windows and \UNIX{} (on Mac OS, there are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1565 currently problems with Tcl/Tk)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1566
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1567 \item multi-window text editor with multiple undo, Python colorizing
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1568 and many other features, e.g. smart indent and call tips
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1569
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1570 \item Python shell window (a.k.a. interactive interpreter)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1571
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1572 \item debugger (not complete, but you can set breakpoints, view and step)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1573 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1574
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1575
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1576 \subsection{Menus}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1577
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1578 \subsubsection{File menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1579
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1580 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1581 \item[New window] create a new editing window
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1582 \item[Open...] open an existing file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1583 \item[Open module...] open an existing module (searches sys.path)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1584 \item[Class browser] show classes and methods in current file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1585 \item[Path browser] show sys.path directories, modules, classes and methods
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1586 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1587 \index{Class browser}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1588 \index{Path browser}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1589
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1590 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1591 \item[Save] save current window to the associated file (unsaved
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1592 windows have a * before and after the window title)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1593
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1594 \item[Save As...] save current window to new file, which becomes
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1595 the associated file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1596 \item[Save Copy As...] save current window to different file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1597 without changing the associated file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1598 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1599
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1600 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1601 \item[Close] close current window (asks to save if unsaved)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1602 \item[Exit] close all windows and quit IDLE (asks to save if unsaved)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1603 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1604
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1605
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1606 \subsubsection{Edit menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1607
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1608 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1609 \item[Undo] Undo last change to current window (max 1000 changes)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1610 \item[Redo] Redo last undone change to current window
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1611 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1612
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1613 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1614 \item[Cut] Copy selection into system-wide clipboard; then delete selection
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1615 \item[Copy] Copy selection into system-wide clipboard
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1616 \item[Paste] Insert system-wide clipboard into window
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1617 \item[Select All] Select the entire contents of the edit buffer
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1618 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1619
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1620 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1621 \item[Find...] Open a search dialog box with many options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1622 \item[Find again] Repeat last search
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1623 \item[Find selection] Search for the string in the selection
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1624 \item[Find in Files...] Open a search dialog box for searching files
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1625 \item[Replace...] Open a search-and-replace dialog box
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1626 \item[Go to line] Ask for a line number and show that line
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1627 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1628
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1629 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1630 \item[Indent region] Shift selected lines right 4 spaces
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1631 \item[Dedent region] Shift selected lines left 4 spaces
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1632 \item[Comment out region] Insert \#\# in front of selected lines
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1633 \item[Uncomment region] Remove leading \# or \#\# from selected lines
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1634 \item[Tabify region] Turns \emph{leading} stretches of spaces into tabs
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1635 \item[Untabify region] Turn \emph{all} tabs into the right number of spaces
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1636 \item[Expand word] Expand the word you have typed to match another
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1637 word in the same buffer; repeat to get a different expansion
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1638 \item[Format Paragraph] Reformat the current blank-line-separated paragraph
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1639 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1640
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1641 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1642 \item[Import module] Import or reload the current module
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1643 \item[Run script] Execute the current file in the __main__ namespace
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1644 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1645
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1646 \index{Import module}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1647 \index{Run script}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1648
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1649
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1650 \subsubsection{Windows menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1651
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1652 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1653 \item[Zoom Height] toggles the window between normal size (24x80)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1654 and maximum height.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1655 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1656
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1657 The rest of this menu lists the names of all open windows; select one
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1658 to bring it to the foreground (deiconifying it if necessary).
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1659
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1660
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1661 \subsubsection{Debug menu (in the Python Shell window only)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1662
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1663 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1664 \item[Go to file/line] look around the insert point for a filename
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1665 and linenumber, open the file, and show the line.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1666 \item[Open stack viewer] show the stack traceback of the last exception
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1667 \item[Debugger toggle] Run commands in the shell under the debugger
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1668 \item[JIT Stack viewer toggle] Open stack viewer on traceback
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1669 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1670
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1671 \index{stack viewer}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1672 \index{debugger}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1673
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1674
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1675 \subsection{Basic editing and navigation}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1676
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1677 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1678 \item \kbd{Backspace} deletes to the left; \kbd{Del} deletes to the right
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1679 \item Arrow keys and \kbd{Page Up}/\kbd{Page Down} to move around
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1680 \item \kbd{Home}/\kbd{End} go to begin/end of line
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1681 \item \kbd{C-Home}/\kbd{C-End} go to begin/end of file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1682 \item Some \program{Emacs} bindings may also work, including \kbd{C-B},
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1683 \kbd{C-P}, \kbd{C-A}, \kbd{C-E}, \kbd{C-D}, \kbd{C-L}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1684 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1685
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1686
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1687 \subsubsection{Automatic indentation}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1688
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1689 After a block-opening statement, the next line is indented by 4 spaces
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1690 (in the Python Shell window by one tab). After certain keywords
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1691 (break, return etc.) the next line is dedented. In leading
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1692 indentation, \kbd{Backspace} deletes up to 4 spaces if they are there.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1693 \kbd{Tab} inserts 1-4 spaces (in the Python Shell window one tab).
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1694 See also the indent/dedent region commands in the edit menu.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1695
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1696
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1697 \subsubsection{Python Shell window}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1698
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1699 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1700 \item \kbd{C-C} interrupts executing command
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1701 \item \kbd{C-D} sends end-of-file; closes window if typed at
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1702 a \samp{>>>~} prompt
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1703 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1704
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1705 \begin{itemize}
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1706 \item \kbd{Alt-p} retrieves previous command matching what you have typed
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1707 \item \kbd{Alt-n} retrieves next
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1708 \item \kbd{Return} while on any previous command retrieves that command
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1709 \item \kbd{Alt-/} (Expand word) is also useful here
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1710 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1711
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1712 \index{indentation}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1713
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1714
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1715 \subsection{Syntax colors}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1716
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1717 The coloring is applied in a background ``thread,'' so you may
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1718 occasionally see uncolorized text. To change the color
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1719 scheme, edit the \code{[Colors]} section in \file{config.txt}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1720
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1721 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1722 \item[Python syntax colors:]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1723
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1724 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1725 \item[Keywords] orange
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1726 \item[Strings ] green
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1727 \item[Comments] red
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1728 \item[Definitions] blue
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1729 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1730
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1731 \item[Shell colors:]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1732 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1733 \item[Console output] brown
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1734 \item[stdout] blue
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1735 \item[stderr] dark green
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1736 \item[stdin] black
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1737 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1738 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1739
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1740
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1741 \subsubsection{Command line usage}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1742
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1743 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1744 idle.py [-c command] [-d] [-e] [-s] [-t title] [arg] ...
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1745
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1746 -c command run this command
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1747 -d enable debugger
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1748 -e edit mode; arguments are files to be edited
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1749 -s run $IDLESTARTUP or $PYTHONSTARTUP first
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1750 -t title set title of shell window
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1751 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1752
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1753 If there are arguments:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1754
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1755 \begin{enumerate}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1756 \item If \programopt{-e} is used, arguments are files opened for
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1757 editing and \code{sys.argv} reflects the arguments passed to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1758 IDLE itself.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1759
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1760 \item Otherwise, if \programopt{-c} is used, all arguments are
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1761 placed in \code{sys.argv[1:...]}, with \code{sys.argv[0]} set
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1762 to \code{'-c'}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1763
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1764 \item Otherwise, if neither \programopt{-e} nor \programopt{-c} is
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1765 used, the first argument is a script which is executed with
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1766 the remaining arguments in \code{sys.argv[1:...]} and
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1767 \code{sys.argv[0]} set to the script name. If the script name
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1768 is '-', no script is executed but an interactive Python
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1769 session is started; the arguments are still available in
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1770 \code{sys.argv}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1771 \end{enumerate}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1772
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1773
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1774 \section{Other Graphical User Interface Packages
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1775 \label{other-gui-packages}}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1776
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1777
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1778 There are an number of extension widget sets to \refmodule{Tkinter}.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1779
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1780 \begin{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1781 \seetitle[http://pmw.sourceforge.net/]{Python megawidgets}{is a
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1782 toolkit for building high-level compound widgets in Python using the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1783 \refmodule{Tkinter} module. It consists of a set of base classes and
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1784 a library of flexible and extensible megawidgets built on this
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1785 foundation. These megawidgets include notebooks, comboboxes, selection
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1786 widgets, paned widgets, scrolled widgets, dialog windows, etc. Also,
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1787 with the Pmw.Blt interface to BLT, the busy, graph, stripchart, tabset
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1788 and vector commands are be available.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1789
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1790 The initial ideas for Pmw were taken from the Tk \code{itcl}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1791 extensions \code{[incr Tk]} by Michael McLennan and \code{[incr
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1792 Widgets]} by Mark Ulferts. Several of the megawidgets are direct
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1793 translations from the itcl to Python. It offers most of the range of
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1794 widgets that \code{[incr Widgets]} does, and is almost as complete as
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1795 Tix, lacking however Tix's fast \class{HList} widget for drawing trees.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1796 }
29779 2fcde32a8a57 Update Tkinter3000 notes based on text from Fredrik Lundh. Fred Drake <fdrake@acm.org> parents: 29186 diff changeset	1797
2fcde32a8a57 Update Tkinter3000 notes based on text from Fredrik Lundh. Fred Drake <fdrake@acm.org> parents: 29186 diff changeset	1798 \seetitle[http://tkinter.effbot.org/]{Tkinter3000 Widget Construction
2fcde32a8a57 Update Tkinter3000 notes based on text from Fredrik Lundh. Fred Drake <fdrake@acm.org> parents: 29186 diff changeset	1799 Kit (WCK)}{%
2fcde32a8a57 Update Tkinter3000 notes based on text from Fredrik Lundh. Fred Drake <fdrake@acm.org> parents: 29186 diff changeset	1800 is a library that allows you to write new Tkinter widgets in pure
2fcde32a8a57 Update Tkinter3000 notes based on text from Fredrik Lundh. Fred Drake <fdrake@acm.org> parents: 29186 diff changeset	1801 Python. The WCK framework gives you full control over widget
2fcde32a8a57 Update Tkinter3000 notes based on text from Fredrik Lundh. Fred Drake <fdrake@acm.org> parents: 29186 diff changeset	1802 creation, configuration, screen appearance, and event handling. WCK
2fcde32a8a57 Update Tkinter3000 notes based on text from Fredrik Lundh. Fred Drake <fdrake@acm.org> parents: 29186 diff changeset	1803 widgets can be very fast and light-weight, since they can operate
2fcde32a8a57 Update Tkinter3000 notes based on text from Fredrik Lundh. Fred Drake <fdrake@acm.org> parents: 29186 diff changeset	1804 directly on Python data structures, without having to transfer data
2fcde32a8a57 Update Tkinter3000 notes based on text from Fredrik Lundh. Fred Drake <fdrake@acm.org> parents: 29186 diff changeset	1805 through the Tk/Tcl layer.}
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1806 \end{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1807
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1808
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	1809 Tk is not the only GUI for Python, but is however the
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1810 most commonly used one.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1811
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1812 \begin{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1813 \seetitle[http://www.wxwindows.org]{wxWindows}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1814 is a GUI toolkit that combines the most attractive attributes of Qt,
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1815 Tk, Motif, and GTK+ in one powerful and efficient package. It is
21062 bc02c3b09626 Clean up some markup cruft. A number of the macros that take no Fred Drake <fdrake@acm.org> parents: 20997 diff changeset	1816 implemented in \Cpp. wxWindows supports two flavors of \UNIX{}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1817 implementation: GTK+ and Motif, and under Windows, it has a standard
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1818 Microsoft Foundation Classes (MFC) appearance, because it uses Win32
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1819 widgets. There is a Python class wrapper, independent of Tkinter.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1820
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1821 wxWindows is much richer in widgets than \refmodule{Tkinter}, with its
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1822 help system, sophisticated HTML and image viewers, and other
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1823 specialized widgets, extensive documentation, and printing capabilities.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1824 }
23595 4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1825 \seetitle[]{PyQt}{
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1826 PyQt is a \program{sip}-wrapped binding to the Qt toolkit. Qt is an
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1827 extensive \Cpp{} GUI toolkit that is available for \UNIX, Windows and
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1828 Mac OS X. \program{sip} is a tool for generating bindings for \Cpp{}
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1829 libraries as Python classes, and is specifically designed for Python.
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1830 An online manual is available at
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1831 \url{http://www.opendocspublishing.com/pyqt/} (errata are located at
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1832 \url{http://www.valdyas.org/python/book.html}).
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1833 }
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1834 \seetitle[http://www.riverbankcomputing.co.uk/pykde/index.php]{PyKDE}{
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1835 PyKDE is a \program{sip}-wrapped interface to the KDE desktop
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1836 libraries. KDE is a desktop environment for \UNIX{} computers; the
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1837 graphical components are based on Qt.
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1838 }
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1839 \seetitle[http://fxpy.sourceforge.net/]{FXPy}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1840 is a Python extension module which provides an interface to the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1841 \citetitle[http://www.cfdrc.com/FOX/fox.html]{FOX} GUI.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1842 FOX is a \Cpp{} based Toolkit for developing Graphical User Interfaces
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1843 easily and effectively. It offers a wide, and growing, collection of
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1844 Controls, and provides state of the art facilities such as drag and
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1845 drop, selection, as well as OpenGL widgets for 3D graphical
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1846 manipulation. FOX also implements icons, images, and user-convenience
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1847 features such as status line help, and tooltips.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1848
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1849 Even though FOX offers a large collection of controls already, FOX
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1850 leverages \Cpp{} to allow programmers to easily build additional Controls
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1851 and GUI elements, simply by taking existing controls, and creating a
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1852 derived class which simply adds or redefines the desired behavior.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1853 }
30003 35dea10dcdc4 Update URL. Fred Drake <fdrake@acm.org> parents: 29779 diff changeset	1854 \seetitle[http://www.daa.com.au/\textasciitilde james/software/pygtk/]{PyGTK}{
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1855 is a set of bindings for the \ulink{GTK}{http://www.gtk.org/} widget set.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1856 It provides an object oriented interface that is slightly higher
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1857 level than the C one. It automatically does all the type casting and
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1858 reference counting that you would have to do normally with the C
25750 ec0a48ae8eb4 Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25196 diff changeset	1859 API. There are also
ec0a48ae8eb4 Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25196 diff changeset	1860 \ulink{bindings}{http://www.daa.com.au/\textasciitilde james/gnome/}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1861 to \ulink{GNOME}{http://www.gnome.org}, and a
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1862 \ulink{tutorial}
25750 ec0a48ae8eb4 Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25196 diff changeset	1863 {http://laguna.fmedic.unam.mx/\textasciitilde daniel/pygtutorial/pygtutorial/index.html}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1864 is available.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1865 }
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1866 \end{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1867
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1868 % XXX Reference URLs that compare the different UI packages

Mercurial > cpython-lru_cache-weakref

annotate Doc/lib/tkinter.tex @ 31594:123718d0dc09 legacy-trunk