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

annotate Doc/lib/tkinter.tex @ 29186:2aaa39edc511 legacy-trunk

Remove unused line numbers from example code. Line numbering of examples is not used elsewhere.

author	Fred Drake <fdrake@acm.org>
date	Tue, 20 May 2003 15:21:08 +0000
parents	d27e5cad38d7
children	2fcde32a8a57

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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	97 \begin{classdesc}{Tk}{screenName=None, baseName=None, className='Tk'}
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:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	102 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	103
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	104 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	105
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	106 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	107 % \declaremodule{standard}{Tkconstants}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	108 % \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	109 % FIXME
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	110
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	111 \item[\refmodule{ScrolledText}]
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	112 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	113
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	114 \item[\module{tkColorChooser}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	115 Dialog to let the user choose a color.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	116
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	117 \item[\module{tkCommonDialog}]
21119 493f932d5829 Add description of tkCommonDialog. Fred Drake <fdrake@acm.org> parents: 21117 diff changeset	118 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	119
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	120 \item[\module{tkFileDialog}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	121 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	122
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	123 \item[\module{tkFont}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	124 Utilities to help work with fonts.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	125
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	126 \item[\module{tkMessageBox}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	127 Access to standard Tk dialog boxes.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	128
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	129 \item[\module{tkSimpleDialog}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	130 Basic dialogs and convenience functions.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	131
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	132 \item[\module{Tkdnd}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	133 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	134 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	135 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	136
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	137 \item[\refmodule{turtle}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	138 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	139
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	140 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	141
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	142 \subsection{Tkinter Life Preserver}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	143 \sectionauthor{Matt Conway}{}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	144 % 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	145
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	146 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	147 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	148 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	149
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	150 Credits:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	151 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	152 \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	153 \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	154 \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	155 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	156 \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	157 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	158 \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	159 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	160 \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	161 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	162 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	163
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	164
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	165 \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	166
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	167 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	168 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	169 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	170
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	171 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	172 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	173 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	174 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	175 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	176 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	177 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	178 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	179
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	180 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	181 \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	182 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	183 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	184 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	185
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	186 \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	187 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	188 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	189 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	190
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	191 \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	192 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	193 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	194
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	195 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	196 \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	197 {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	198 {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	199 ActiveState.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	200 \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	201 {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	202 {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	203 \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	204 {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	205 {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	206 \end{seealso}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	209 \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	210
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	211 %begin{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	212 %\begin{figure}[hbtp]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	213 %\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	214 %\vspace{.5cm}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	215 %\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	216 %\end{figure}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	217 %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	218 %\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	219 %end{latexonly}
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 \begin{verbatim}
29186 2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	223 from Tkinter import *
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	224
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	225 class Application(Frame):
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	226 def say_hi(self):
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	227 print "hi there, everyone!"
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	228
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	229 def createWidgets(self):
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	230 self.QUIT = Button(self)
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	231 self.QUIT["text"] = "QUIT"
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	232 self.QUIT["fg"] = "red"
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	233 self.QUIT["command"] = self.quit
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	234
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	235 self.QUIT.pack({"side": "left"})
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	236
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	237 self.hi_there = Button(self)
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	238 self.hi_there["text"] = "Hello",
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	239 self.hi_there["command"] = self.say_hi
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	240
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	241 self.hi_there.pack({"side": "left"})
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	242
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	243 def __init__(self, master=None):
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	244 Frame.__init__(self, master)
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	245 self.pack()
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	246 self.createWidgets()
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 app = Application()
2aaa39edc511 Remove unused line numbers from example code. Fred Drake <fdrake@acm.org> parents: 26065 diff changeset	249 app.mainloop()
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	250 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	251
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	252
21148 d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	253 \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	254
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	255 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	256 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	257 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	258
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	259 Notes:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	260 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	261 \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	262 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	263 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	264
d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	265 \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	266 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	267 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	268 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	269
d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	270 \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	271 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	272 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	273 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	274
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	275 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	276 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	277 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	278 (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	279 \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	280
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	281 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	282 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	283 \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	284 \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	285
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	286 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	287
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	288 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	289 classCommand newPathname options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	290 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	291
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	292 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	293 \item[\var{classCommand}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	294 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	295
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	296 \item[\var{newPathname}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	297 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	298 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	299 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	300 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	301 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	302 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	303
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	304 \item[\var{options} ]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	305 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	306 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	307 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	308 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	309 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	310
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	311 For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	312
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	313 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	314 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	315 ^ ^ \_____________________/
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 class new options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	318 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	319 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	320
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	321 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	322 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	323 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	324 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	325 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	326
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	327 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	328 .fred someAction someOptions
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	329 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	330
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	331 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	332
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	333 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	334 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	335 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	336 (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	337
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	338 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	339 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	340 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	341 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	342
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 \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	345 \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	346
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	347 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	348
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	349 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	350 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	351 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	352
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	353 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	354 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	355
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	356 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	357 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	358 \end{verbatim}
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 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	361 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	362 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	363 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	364 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	365 setting options.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	366
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	367 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	368 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	369 .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	370 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	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 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	374 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	375 (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	376 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	377 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	378
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	379 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	380 .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	381 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	382
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	383 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	384 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	385 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	386 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	387 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	388 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	389 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	390
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	391 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	392 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	393 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	394
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 \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	397
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	398 \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	399 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	400
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	401 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	402 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	403 \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	404 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	405
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	406 \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	407 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	408 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	409 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	410 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	411 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	412
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	413 \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	414 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	415 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	416
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	417 \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	418 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	419 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	420 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	421 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	422 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	423 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	424
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	425 \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	426 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	427
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	428 \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	429 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	430 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	431
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	432
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	433 \subsection{Handy Reference}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	434
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	435 \subsubsection{Setting Options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	436 \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	437
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	438 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	439 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	440
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	441 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	442 \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	443 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	444 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	445 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	446 \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	447 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	448 fred["fg"] = "red"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	449 fred["bg"] = "blue"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	450 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	451 \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	452 object creation]:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	453 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	454 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	455 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	456 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	457
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	458 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	459 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	460
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	461 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	462 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	463 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	464 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	465 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	466
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	467 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	468 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	469 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	470 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	471
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	472 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	473 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	474 \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	475 \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	476 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	477 (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	478
24137 176ad706afbc Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23595 diff changeset	479 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	480 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	481 \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	482 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	483 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	484 'background')}).
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	485
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	486 \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	487 \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	488 \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	489 \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	490 \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	491 \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	492 \end{tableiii}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	493
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	494
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	495 Example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	496
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	497 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	498 >>> print fred.config()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	499 {'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	500 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	501
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	502 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	503 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	504
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	505
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	506 \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	507 \index{packing (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	508
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	509 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	510 \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	511
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	512 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	513 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	514 \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	515 (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	516 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	517 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	518 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	519
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	520 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	521 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	522 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	523 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	524 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	525 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	526 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	527
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	528 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	529 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	530 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	531 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	532 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	533 applied to it.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	534
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	535 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	536 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	537 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	538 some examples:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	539
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	540 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	541 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	542 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	543 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	544 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	545
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	546
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	547 \subsubsection{Packer Options}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	548
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	549 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	550 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	551
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	552 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	553 \item[\b{anchor }]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	554 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	555 parcel.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	556
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	557 \item[\b{expand}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	558 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	559
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	560 \item[\b{fill}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	561 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	562
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	563 \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	564 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	565 widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	566
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	567 \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	568 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	569 widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	570
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	571 \item[\b{side}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	572 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	573 \code{'bottom'}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	574 \end{description}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	577 \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	578
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	579 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	580 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	581 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	582 \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	583 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	584 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	585
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	586 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	587 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	588 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	589 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	590 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	591 \refmodule{Tkinter} module.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	592
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	593 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	594 \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	595 \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	596 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	597 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	598 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	599 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	600
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	601 For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	602 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	603 class App(Frame):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	604 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	605 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	606 self.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	607
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	608 self.entrythingy = Entry()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	609 self.entrythingy.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	610
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	611 self.button.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	612 # 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	613 self.contents = StringVar()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	614 # 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	615 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	616 # 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	617 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	618
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	619 # 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	620 # 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	621 # 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	622 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	623 self.print_contents)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	624
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	625 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	626 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	627 self.contents.get()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	628 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	629
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	630
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	631 \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	632 \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	633
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	634 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	635 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	636 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	637 \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	638 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	639 \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	640
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	641 %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	642
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	643 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	644 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	645 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	646 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	647 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	648 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	649 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	650
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	651 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	652
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	653 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	654 import Tkinter
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	655 class App(Frame):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	656 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	657 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	658 self.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	659
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	660
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	661 # create the application
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	662 myapp = App()
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 #
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	665 # 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	666 #
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	667 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	668 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	669
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	670 # start the program
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	671 myapp.mainloop()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	672 \end{verbatim}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	675 \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	676
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	677 \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	678
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	679 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	680 \item[anchor]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	681 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	682 \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	683 \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	684 \code{"center"}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	685
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	686 \item[bitmap]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	687 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	688 \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	689 \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	690 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	691 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	692
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	693 \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	694 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	695
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	696 \item[callback]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	697 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	698 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	699 def print_it():
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	700 print "hi there"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	701 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	702 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	703
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	704 \item[color]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	705 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	706 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	707 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	708 \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	709 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	710
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	711 \item[cursor]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	712 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	713 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	714 (\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	715 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	716 Ousterhout's book.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	717
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	718 \item[distance]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	719 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	720 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	721 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	722 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	723 \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	724 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	725
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	726 \item[font]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	727 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	728 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	729 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	730
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	731 \item[geometry]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	732 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	733 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	734 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	735 \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	736
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	737 \item[justify]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	738 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	739 \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	740
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	741 \item[region]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	742 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	743 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	744 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	745 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	746
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	747 \item[relief]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	748 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	749 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	750 \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	751
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	752 \item[scrollcommand]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	753 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	754 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	755 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	756 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	757
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	758 \item[wrap:]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	759 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	760 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	761
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	762
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	763 \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	764
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	765 \index{bind (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	766 \index{events (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	767
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	768 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	769 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	770 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	771
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	772 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	773 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	774 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	775 where:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	776
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	777 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	778 \item[sequence]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	779 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	780 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	781
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	782 \item[func]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	783 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	784 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	785 (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	786
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	787 \item[add]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	788 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	789 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	790 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	791 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	792 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	793
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	794 For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	795 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	796 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	797 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	798
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	799 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	800 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	801
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	802 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	803 \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	804 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	805 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	806 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	807
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 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	810 -- ------------------- -- -------------------
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	811 %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	812 %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	813 %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	814 %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	815 %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	816 %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	817 %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	818 %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	819 \end{verbatim}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	822 \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	823
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	824 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	825 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	826 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	827 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	828
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	829 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	830 \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	831 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	832 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	833 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	834
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	835 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	836 \item[AtEnd()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	837 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	838
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	839 \item[AtInsert()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	840 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	841
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	842 \item[AtSelFirst()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	843 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	844
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	845 \item[AtSelLast()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	846 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	847
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	848 \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	849 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	850 \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	851 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	852 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	853
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	854 \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	855 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	856 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	857
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	858 \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	859
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	860 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	861 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	862 pass in:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	863 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	864 \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	865 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	866 \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	867 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	868 \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	869 item;
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	870 \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	871 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	872 \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	873 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	874 finally,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	875 \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	876 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	877 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	878 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	879 \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	880 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	881 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	882
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	883 \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	884
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	885 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	886 \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	887
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	888 \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	889 \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	890 \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	891 \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	892
13b2ec536e07 Document that images go away when they go away. Fixes #632323. Martin v. Löwis <martin@v.loewis.de> parents: 26004 diff changeset	893 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	894 \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	895
26065 d27e5cad38d7 Whoops, fix the typo correctly this time Neal Norwitz <nnorwitz@gmail.com> parents: 26060 diff changeset	896 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	897 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	898 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	899 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	900 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	901
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	902 \section{\module{Tix} ---
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	903 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	904
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	905 \declaremodule{standard}{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	906 \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	907 \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	908
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	909 \index{Tix}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	910
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	911 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	912 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	913 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	914 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	915 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	916 (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	917 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	918 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	919 \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	920
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	921 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	922 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	923 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	924 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	925 users.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	926
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	927 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	928 \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	929 {Tix Homepage}
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	930 {The home page for \module{Tix}. This includes links to
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	931 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	932 \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	933 {Tix Man Pages}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	934 {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	935 \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	936 {Tix Programming Guide}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	937 {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	938 \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	939 {Tix Development Applications}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	940 {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	941 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	942 \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	943 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	944 \end{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	945
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	946
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	947 \subsection{Using Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	948
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	949 \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	950 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	951 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	952
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	953 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	954 \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	955 \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	956 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	957 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	958 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	959 import Tix
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	960 from Tkconstants import *
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	961 root = Tix.Tk()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	962 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	963 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	964
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	965 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	966 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	967 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	968 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	969 import Tix
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	970 root = Tix.Tk()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	971 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	972 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	973
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	974 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	975 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	976 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	977 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	978 \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	979 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	980 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	981 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	982
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	983 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	984 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	985 \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	986
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	987
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	988 \subsection{Tix Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	989
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	990 \ulink{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	991 {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	992 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	993 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	994 \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	995
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	996
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	997 % 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	998
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 \subsubsection{Basic Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1001
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1002 \begin{classdesc}{Balloon}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1003 A \ulink{Balloon}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1004 {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	1005 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	1006 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	1007 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	1008 screen.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1009 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1010
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1011 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1012 % \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	1013
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1014 \begin{classdesc}{ButtonBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1015 The \ulink{ButtonBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1016 {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	1017 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	1018 Cancel}.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1019 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1020
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1021 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1022 % \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	1023
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1024 \begin{classdesc}{ComboBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1025 The \ulink{ComboBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1026 {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	1027 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	1028 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	1029 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	1030 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1031
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1032 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1033 % \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	1034
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1035 \begin{classdesc}{Control}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1036 The \ulink{Control}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1037 {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	1038 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	1039 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	1040 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	1041 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	1042 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1043
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1044 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1045 % \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	1046
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1047 \begin{classdesc}{LabelEntry}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1048 The \ulink{LabelEntry}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1049 {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	1050 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	1051 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	1052 interface.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1053 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1054
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1055 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1056 % \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	1057
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1058 \begin{classdesc}{LabelFrame}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1059 The \ulink{LabelFrame}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1060 {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	1061 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	1062 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	1063 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	1064 \member{frame} subwidget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1065 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1066
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1067 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1068 % \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	1069
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1070 \begin{classdesc}{Meter}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1071 The \ulink{Meter}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1072 {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	1073 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	1074 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	1075 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1076
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1077 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1078 % \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	1079
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1080 \begin{classdesc}{OptionMenu}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1081 The \ulink{OptionMenu}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1082 {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	1083 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	1084 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1085
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1086 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1087 % \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	1088
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1089 \begin{classdesc}{PopupMenu}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1090 The \ulink{PopupMenu}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1091 {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	1092 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	1093 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	1094 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	1095 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1096
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1097 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1098 % \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	1099
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1100 \begin{classdesc}{Select}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1101 The \ulink{Select}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1102 {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	1103 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	1104 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	1105 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1106
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1107 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1108 % \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	1109
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1110 \begin{classdesc}{StdButtonBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1111 The \ulink{StdButtonBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1112 {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	1113 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	1114 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1115
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1116 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1117 % \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	1118
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1119
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1120 \subsubsection{File Selectors}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1121
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1122 \begin{classdesc}{DirList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1123 The \ulink{DirList}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1124 {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	1125 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	1126 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	1127 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	1128 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1129
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1130 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1131 % \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	1132
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1133 \begin{classdesc}{DirTree}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1134 The \ulink{DirTree}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1135 {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	1136 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	1137 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	1138 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	1139 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1140
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1141 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1142 % \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	1143
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1144 \begin{classdesc}{DirSelectDialog}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1145 The \ulink{DirSelectDialog}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1146 {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	1147 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	1148 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	1149 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	1150 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1151
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1152 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1153 % \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	1154
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1155 \begin{classdesc}{DirSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1156 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	1157 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	1158 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	1159 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	1160 selected again.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1161 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1162
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1163 \begin{classdesc}{ExFileSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1164 The \ulink{ExFileSelectBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1165 {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	1166 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	1167 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	1168 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	1169 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	1170 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1171
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1172 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1173 %\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	1174
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1175 \begin{classdesc}{FileSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1176 The \ulink{FileSelectBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1177 {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	1178 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	1179 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	1180 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	1181 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	1182 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1183
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1184 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1185 % \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	1186
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1187 \begin{classdesc}{FileEntry}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1188 The \ulink{FileEntry}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1189 {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	1190 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	1191 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	1192 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	1193 dialog.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1194 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1195
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1196 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1197 % \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	1198
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 \subsubsection{Hierachical ListBox}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1201
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1202 \begin{classdesc}{HList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1203 The \ulink{HList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1204 {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	1205 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	1206 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	1207 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	1208 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	1209 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1210
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1211 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1212 % \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	1213
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1214 \begin{classdesc}{CheckList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1215 The \ulink{CheckList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1216 {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	1217 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	1218 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	1219 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	1220 radiobuttons.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1221 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1222
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1223 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1224 % \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	1225 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1226 % \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	1227 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1228 % \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	1229
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1230 \begin{classdesc}{Tree}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1231 The \ulink{Tree}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1232 {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	1233 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	1234 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	1235 the tree.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1236 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1237
20994 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{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	1240
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1241 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1242 % \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	1243
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1244
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1245 \subsubsection{Tabular ListBox}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1246
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1247 \begin{classdesc}{TList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1248 The \ulink{TList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1249 {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	1250 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	1251 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	1252 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	1253 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	1254 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	1255 list entries.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1256 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1257
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1258 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1259 % \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	1260 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1261 % \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	1262
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1263 % 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	1264 % \subsubsection{Grid Widget}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1265 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1266 % \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	1267 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1268 % \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	1269 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1270 % \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	1271
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1272
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1273 \subsubsection{Manager Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1274
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1275 \begin{classdesc}{PanedWindow}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1276 The \ulink{PanedWindow}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1277 {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	1278 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	1279 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	1280 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	1281 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	1282 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1283
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1284 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1285 % \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	1286
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1287 \begin{classdesc}{ListNoteBook}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1288 The \ulink{ListNoteBook}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1289 {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	1290 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	1291 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	1292 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	1293 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	1294 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	1295 \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	1296 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1297
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1298 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1299 % \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	1300
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1301 \begin{classdesc}{NoteBook}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1302 The \ulink{NoteBook}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1303 {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	1304 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	1305 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	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 visual ``tabs'' at the top of the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1308 NoteBook widget.
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{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	1313
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1314
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1315 % \subsubsection{Scrolled Widgets}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1316 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1317 % \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	1318 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1319 % \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	1320 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1321 % \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	1322 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1323 % \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	1324
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1325
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1326 \subsubsection{Image Types}
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 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	1329 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1330 \item
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1331 \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	1332 {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	1333 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	1334 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	1335
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1336 % Python Demo of:
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1337 % \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	1338
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1339 % Python Demo of:
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1340 % \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	1341
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1342 \item
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1343 \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	1344 {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	1345 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	1346 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	1347 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	1348 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	1349 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	1350
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	1351 % 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	1352 % \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	1353
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	1354 % 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	1355 % \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	1356
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 % 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	1358 % \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	1359
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	1360 % 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	1361 % \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	1362 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1363
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1364
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1365 \subsubsection{Miscellaneous Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1366
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1367 \begin{classdesc}{InputOnly}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1368 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	1369 {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	1370 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	1371 \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	1372 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1373
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1374 \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	1375
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1376 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	1377
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1378 \begin{classdesc}{Form}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1379 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	1380 {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	1381 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	1382 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1383
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1384
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1385 %begin{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1386 %\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	1387 %
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1388 %\begin{figure}[hbtp]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1389 %\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	1390 %\vspace{.5cm}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1391 %\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	1392 %\end{figure}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1393 %end{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1394
21109 05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1395 \subsection{Tix Commands}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1396
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1397 \begin{classdesc}{tixCommand}{}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1398 The \ulink{tix commands}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1399 {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	1400 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	1401 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	1402 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	1403 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	1404
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1405 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	1406 \begin{verbatim}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1407 import Tix
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1408 root = Tix.Tk()
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1409 print root.tix_configure()
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1410 \end{verbatim}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1411 \end{classdesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1412
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1413 \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	1414 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	1415 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	1416 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	1417 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	1418 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	1419 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	1420 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	1421 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	1422 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	1423 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1424
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1425 \begin{methoddesc}{tix_cget}{option}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1426 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	1427 \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	1428 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1429
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1430 \begin{methoddesc}{tix_getbitmap}{name}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1431 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	1432 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	1433 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	1434 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	1435 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	1436 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	1437 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	1438 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1439
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1440 \begin{methoddesc}{tix_addbitmapdir}{directory}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1441 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	1442 \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	1443 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	1444 \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	1445 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	1446 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	1447 \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	1448 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1449
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1450 \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	1451 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	1452 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	1453 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	1454 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	1455 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	1456 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	1457 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	1458 \code{tixExFileSelectDialog}.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1459 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1460
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1461
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1462 \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	1463 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	1464 \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	1465 \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	1466 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	1467 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	1468 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	1469 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	1470 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	1471 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	1472 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	1473 \end{methoddesc}
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_option_get}{name}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1476 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	1477 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1478
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1479 \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	1480 newScmPrio}}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1481 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	1482 \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	1483 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	1484 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	1485 application.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1486
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1487 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	1488 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	1489
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1490 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	1491 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	1492 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	1493 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	1494 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1495
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1496
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1497
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1498 \section{\module{ScrolledText} ---
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1499 Scrolled Text Widget}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1500
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1501 \declaremodule{standard}{ScrolledText}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1502 \platform{Tk}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1503 \modulesynopsis{Text widget with a vertical scroll bar.}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1504 \sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1505
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1506 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	1507 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	1508 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	1509 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	1510 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	1511 \class{Tkinter.Text} class.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1512
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1513 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	1514 and the methods of the \class{Grid} and \class{Pack} geometry managers
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1515 are acquired from the \class{Frame} object. This allows the
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1516 \class{ScrolledText} widget to be used directly to achieve most normal
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1517 geometry management behavior.
21175 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 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	1520 are available:
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1521
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1522 \begin{memberdesc}[ScrolledText]{frame}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1523 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	1524 \end{memberdesc}
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 \begin{memberdesc}[ScrolledText]{vbar}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1527 The scroll bar widget.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1528 \end{memberdesc}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1529
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1530
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1531 \input{libturtle}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1532
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1533
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1534 \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	1535
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1536 %\declaremodule{standard}{idle}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1537 %\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	1538 \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	1539
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1540 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	1541 \index{Idle}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1542 \index{Python Editor}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1543 \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	1544
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 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	1547
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1548 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1549 \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	1550
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1551 \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	1552 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	1553
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1554 \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	1555 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	1556
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1557 \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	1558
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1559 \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	1560 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1561
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1562
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1563 \subsection{Menus}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1564
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1565 \subsubsection{File menu}
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 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1568 \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	1569 \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	1570 \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	1571 \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	1572 \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	1573 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1574 \index{Class browser}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1575 \index{Path browser}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1576
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1577 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1578 \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	1579 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	1580
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1581 \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	1582 the associated file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1583 \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	1584 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	1585 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1586
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1587 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1588 \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	1589 \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	1590 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1591
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1592
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1593 \subsubsection{Edit menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1594
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1595 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1596 \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	1597 \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	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[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	1602 \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	1603 \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	1604 \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	1605 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1606
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1607 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1608 \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	1609 \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	1610 \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	1611 \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	1612 \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	1613 \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	1614 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1615
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1616 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1617 \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	1618 \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	1619 \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	1620 \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	1621 \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	1622 \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	1623 \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	1624 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	1625 \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	1626 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1627
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1628 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1629 \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	1630 \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	1631 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1632
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1633 \index{Import module}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1634 \index{Run script}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1635
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1636
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1637 \subsubsection{Windows menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1638
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1639 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1640 \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	1641 and maximum height.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1642 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1643
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1644 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	1645 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	1646
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1647
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1648 \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	1649
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1650 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1651 \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	1652 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	1653 \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	1654 \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	1655 \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	1656 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1657
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1658 \index{stack viewer}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1659 \index{debugger}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1662 \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	1663
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1664 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1665 \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	1666 \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	1667 \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	1668 \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	1669 \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	1670 \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	1671 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1672
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 \subsubsection{Automatic indentation}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1675
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1676 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	1677 (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	1678 (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	1679 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	1680 \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	1681 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	1682
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1683
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1684 \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	1685
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1686 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1687 \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	1688 \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	1689 a \samp{>>>~} prompt
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1690 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1691
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1692 \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	1693 \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	1694 \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	1695 \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	1696 \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	1697 \end{itemize}
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 \index{indentation}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1700
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1701
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1702 \subsection{Syntax colors}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1703
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1704 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	1705 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	1706 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	1707
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1708 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1709 \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	1710
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1711 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1712 \item[Keywords] orange
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1713 \item[Strings ] green
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1714 \item[Comments] red
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1715 \item[Definitions] blue
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1716 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1717
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1718 \item[Shell colors:]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1719 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1720 \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	1721 \item[stdout] blue
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1722 \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	1723 \item[stdin] black
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1724 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1725 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1726
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1727
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1728 \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	1729
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1730 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1731 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	1732
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1733 -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	1734 -d enable debugger
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1735 -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	1736 -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	1737 -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	1738 \end{verbatim}
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 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	1741
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1742 \begin{enumerate}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1743 \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	1744 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	1745 IDLE itself.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1746
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1747 \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	1748 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	1749 to \code{'-c'}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1750
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1751 \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	1752 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	1753 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	1754 \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	1755 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	1756 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	1757 \code{sys.argv}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1758 \end{enumerate}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1759
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1760
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1761 \section{Other Graphical User Interface Packages
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1762 \label{other-gui-packages}}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1763
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1764
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1765 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	1766
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1767 \begin{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1768 \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	1769 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	1770 \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	1771 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	1772 foundation. These megawidgets include notebooks, comboboxes, selection
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1773 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	1774 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	1775 and vector commands are be available.
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 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	1778 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	1779 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	1780 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	1781 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	1782 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	1783 }
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1784 \seetitle[http://tkinter.effbot.org]{Tkinter3000}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1785 is a Widget Construction Kit that allows you to write new Tkinter
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1786 widgets in Python using Mixins. It is built on top of Tkinter,
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1787 and does not offer the extended range of widgets that \refmodule{Tix} does,
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1788 but does allow a form of building mega-widgets. The project is
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1789 still in the early stages.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1790 }
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1791 \end{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1792
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1793
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	1794 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	1795 most commonly used one.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1796
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1797 \begin{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1798 \seetitle[http://www.wxwindows.org]{wxWindows}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1799 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	1800 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	1801 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	1802 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	1803 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	1804 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	1805
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1806 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	1807 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	1808 specialized widgets, extensive documentation, and printing capabilities.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1809 }
23595 4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1810 \seetitle[]{PyQt}{
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1811 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	1812 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	1813 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	1814 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	1815 An online manual is available at
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1816 \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	1817 \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	1818 }
4380a7aa18dc Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21639 diff changeset	1819 \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	1820 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	1821 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	1822 graphical components are based on Qt.
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1823 }
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1824 \seetitle[http://fxpy.sourceforge.net/]{FXPy}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1825 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	1826 \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	1827 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	1828 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	1829 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	1830 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	1831 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	1832 features such as status line help, and tooltips.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1833
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1834 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	1835 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	1836 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	1837 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	1838 }
25750 ec0a48ae8eb4 Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25196 diff changeset	1839 \seetitle[http://www.daa.com.au/\textasciitilde james/pygtk/]{PyGTK}{
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1840 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	1841 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	1842 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	1843 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	1844 API. There are also
ec0a48ae8eb4 Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25196 diff changeset	1845 \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	1846 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	1847 \ulink{tutorial}
25750 ec0a48ae8eb4 Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25196 diff changeset	1848 {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	1849 is available.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1850 }
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1851 \end{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1852
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1853 % XXX Reference URLs that compare the different UI packages

Mercurial > cpython-lru_cache-weakref

annotate Doc/lib/tkinter.tex @ 29186:2aaa39edc511 legacy-trunk