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

annotate Doc/lib/tkinter.tex @ 21467:4e35fa5d5708 legacy-trunk

Add documentation for the help() built-in; contributed by Ka-Ping Yee. This is part of SF patch #494622.

author	Fred Drake <fdrake@acm.org>
date	Tue, 18 Dec 2001 16:31:08 +0000
parents	44ebeab269c5
children	62219ed21599

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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	41 interface to the Tk GUI toolkit, now maintained at ActiveState. Both
21062 bc02c3b09626 Clean up some markup cruft. A number of the macros that take no Fred Drake <fdrake@acm.org> parents: 20997 diff changeset	42 Tk and \module{Tkinter} are available on most \UNIX{} platforms, as well
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	43 as on Windows and Macintosh systems.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	44
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	45 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	46 \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	47 {Python Tkinter Resources}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	48 {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	49 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	50 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	51
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	52 \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	53 {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	54 {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	55
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	56 \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	57 {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	58 {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	59
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	60 \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	61 {Tkinter for JPython}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	62 {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	63
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	64 \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	65 {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	66 {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	67 \end{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	68
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 \subsection{Tkinter Modules}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	71
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	72 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	73 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	74 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	75 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	76 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	77 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	78 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	79
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	80 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	81 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	82 \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	83 \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	84 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	85
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	86 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	87 import Tkinter
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	88 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	89
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	90 Or, more often:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	91
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	92 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	93 from Tkinter import *
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	94 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	95
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	96 \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	97 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	98 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	99 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	100 % 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	101 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	102
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	103 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	104
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	105 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	106 % \declaremodule{standard}{Tkconstants}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	107 % \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	108 % FIXME
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	109
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	110 \item[\refmodule{ScrolledText}]
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	111 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	112
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	113 \item[\module{tkColorChooser}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	114 Dialog to let the user choose a color.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	115
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	116 \item[\module{tkCommonDialog}]
21119 493f932d5829 Add description of tkCommonDialog. Fred Drake <fdrake@acm.org> parents: 21117 diff changeset	117 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	118
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	119 \item[\module{tkFileDialog}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	120 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	121
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	122 \item[\module{tkFont}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	123 Utilities to help work with fonts.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	124
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	125 \item[\module{tkMessageBox}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	126 Access to standard Tk dialog boxes.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	127
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	128 \item[\module{tkSimpleDialog}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	129 Basic dialogs and convenience functions.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	130
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	131 \item[\module{Tkdnd}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	132 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	133 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	134 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	135
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	136 \item[\refmodule{turtle}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	137 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	138
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	139 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	140
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	141 \subsection{Tkinter Life Preserver}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	142 \sectionauthor{Matt Conway}{}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	143 % 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	144
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	145 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	146 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	147 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	148
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	149 Credits:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	150 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	151 \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	152 \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	153 \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	154 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	155 \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	156 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	157 \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	158 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	159 \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	160 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	161 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	162
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	163
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	164 \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	165
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	166 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	167 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	168 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	169
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	170 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	171 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	172 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	173 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	174 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	175 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	176 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	177 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	178
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	179 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	180 \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	181 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	182 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	183 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	184
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	185 \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	186 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	187 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	188 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	189
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	190 \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	191 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	192 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	193
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	194 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	195 \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	196 {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	197 {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	198 ActiveState.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	199 \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	200 {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	201 {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	202 \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	203 {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	204 {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	205 \end{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	206
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 \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	209
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	210 %begin{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	211 %\begin{figure}[hbtp]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	212 %\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	213 %\vspace{.5cm}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	214 %\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	215 %\end{figure}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	216 %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	217 %\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	218 %end{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	219
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 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	222 from Tkinter import * 1
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	223 2
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	224 class Application(Frame): 3
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	225 def say_hi(self): 4
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	226 print "hi there, everyone!" 5
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	227 6
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	228 def createWidgets(self): 7
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	229 self.QUIT = Button(self) 8
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	230 self.QUIT["text"] = "QUIT" 9
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	231 self.QUIT["fg"] = "red" 10
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	232 self.QUIT["command"] = self.quit 11
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	233 12
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	234 self.QUIT.pack({"side": "left"}) 13
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	235 14
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	236 self.hi_there = Button(self) 15
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	237 self.hi_there["text"] = "Hello", 16
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	238 self.hi_there["command"] = self.say_hi 17
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	239 18
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	240 self.hi_there.pack({"side": "left"}) 19
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	241 20
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	242 21
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	243 def __init__(self, master=None): 22
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	244 Frame.__init__(self, master) 23
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	245 self.pack() 24
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	246 self.createWidgets() 25
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	247 26
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	248 app = Application() 27
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	249 app.mainloop() 28
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	474 \kbd{config()} method with arguments, or by calling the keys()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	475 method on that widget. The return value of these calls is a dictionary
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	476 whose key is the name of the option (e.g. \kbd{relief}) and whose
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	477 values are 5 tuples.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	478
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	479 (Some options, like \kbd{bg} are synonyms for common options with
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	480 hard-to-type names (\kbd{bg} is shorthand for "background").
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	481 Passing the \kbd{config()} method the name of a
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	482 shorthand option will return a 2-tuple, not 5-tuple. The 2-tuple
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	483 passed back will contain the name of the synonym ``real''
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	484 option. (\kbd{bg}, \kbd{background}))
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]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	694 You can pass integers 0 or 1 or the stings \code{"yes"} or \code{"no"} .
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	883
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	884 \section{\module{Tix} ---
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	885 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	886
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	887 \declaremodule{standard}{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	888 \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	889 \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	890
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	891 \index{Tix}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	892
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	893 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	894 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	895 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	896 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	897 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	898 (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	899 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	900 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	901 \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	902
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	903 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	904 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	905 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	906 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	907 users.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	908
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	909 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	910 \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	911 {Tix Homepage}
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	912 {The home page for \module{Tix}. This includes links to
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	913 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	914 \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	915 {Tix Man Pages}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	916 {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	917 \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	918 {Tix Programming Guide}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	919 {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	920 \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	921 {Tix Development Applications}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	922 {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	923 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	924 \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	925 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	926 \end{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	927
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	928
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	929 \subsection{Using Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	930
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	931 \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	932 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	933 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	934
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	935 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	936 \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	937 \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	938 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	939 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	940 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	941 import Tix
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	942 from Tkconstants import *
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	943 root = Tix.Tk()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	944 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	945 \end{classdesc}
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 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	948 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	949 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	950 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	951 import Tix
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	952 root = Tix.Tk()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	953 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	954 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	955
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	956 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	957 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	958 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	959 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	960 \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	961 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	962 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	963 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	964
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	965 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	966 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	967 \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	968
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	969
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	970 \subsection{Tix Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	971
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	972 \ulink{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	973 {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	974 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	975 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	976 \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	977
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	978
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	979 % 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	980
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	981
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	982 \subsubsection{Basic Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	983
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	984 \begin{classdesc}{Balloon}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	985 A \ulink{Balloon}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	986 {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	987 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	988 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	989 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	990 screen.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	991 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	992
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	993 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	994 % \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	995
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	996 \begin{classdesc}{ButtonBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	997 The \ulink{ButtonBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	998 {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	999 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	1000 Cancel}.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1001 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1002
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1003 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1004 % \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	1005
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1006 \begin{classdesc}{ComboBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1007 The \ulink{ComboBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1008 {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	1009 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	1010 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	1011 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	1012 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1013
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1014 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1015 % \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	1016
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1017 \begin{classdesc}{Control}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1018 The \ulink{Control}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1019 {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	1020 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	1021 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	1022 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	1023 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	1024 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1025
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1026 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1027 % \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	1028
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1029 \begin{classdesc}{LabelEntry}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1030 The \ulink{LabelEntry}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1031 {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	1032 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	1033 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	1034 interface.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1035 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1036
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1037 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1038 % \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	1039
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1040 \begin{classdesc}{LabelFrame}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1041 The \ulink{LabelFrame}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1042 {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	1043 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	1044 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	1045 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	1046 \member{frame} subwidget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1047 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1048
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1049 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1050 % \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	1051
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1052 \begin{classdesc}{Meter}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1053 The \ulink{Meter}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1054 {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	1055 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	1056 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	1057 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1058
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1059 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1060 % \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	1061
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1062 \begin{classdesc}{OptionMenu}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1063 The \ulink{OptionMenu}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1064 {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	1065 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	1066 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1067
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1068 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1069 % \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	1070
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1071 \begin{classdesc}{PopupMenu}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1072 The \ulink{PopupMenu}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1073 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixPopupMenu.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1074 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	1075 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	1076 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	1077 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1078
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1079 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1080 % \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	1081
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1082 \begin{classdesc}{Select}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1083 The \ulink{Select}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1084 {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	1085 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	1086 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	1087 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1088
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1089 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1090 % \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	1091
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1092 \begin{classdesc}{StdButtonBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1093 The \ulink{StdButtonBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1094 {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	1095 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	1096 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1097
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1098 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1099 % \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	1100
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1101
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1102 \subsubsection{File Selectors}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1103
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1104 \begin{classdesc}{DirList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1105 The \ulink{DirList}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1106 {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	1107 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	1108 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	1109 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	1110 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1111
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1112 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1113 % \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	1114
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1115 \begin{classdesc}{DirTree}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1116 The \ulink{DirTree}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1117 {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	1118 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	1119 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	1120 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	1121 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1122
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1123 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1124 % \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	1125
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1126 \begin{classdesc}{DirSelectDialog}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1127 The \ulink{DirSelectDialog}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1128 {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	1129 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	1130 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	1131 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	1132 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1133
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1134 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1135 % \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	1136
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1137 \begin{classdesc}{DirSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1138 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	1139 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	1140 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	1141 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	1142 selected again.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1143 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1144
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1145 \begin{classdesc}{ExFileSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1146 The \ulink{ExFileSelectBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1147 {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	1148 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	1149 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	1150 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	1151 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	1152 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1153
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1154 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1155 %\ulink{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	1156
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1157 \begin{classdesc}{FileSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1158 The \ulink{FileSelectBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1159 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixFileSelectBox.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1160 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	1161 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	1162 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	1163 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	1164 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1165
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1166 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1167 % \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	1168
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1169 \begin{classdesc}{FileEntry}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1170 The \ulink{FileEntry}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1171 {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	1172 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	1173 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	1174 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	1175 dialog.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1176 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1177
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1178 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1179 % \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	1180
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1181
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1182 \subsubsection{Hierachical ListBox}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1183
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1184 \begin{classdesc}{HList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1185 The \ulink{HList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1186 {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	1187 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	1188 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	1189 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	1190 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	1191 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1192
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1193 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1194 % \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	1195
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1196 \begin{classdesc}{CheckList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1197 The \ulink{CheckList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1198 {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	1199 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	1200 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	1201 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	1202 radiobuttons.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1203 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1204
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1205 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1206 % \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	1207 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1208 % \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	1209 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1210 % \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	1211
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1212 \begin{classdesc}{Tree}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1213 The \ulink{Tree}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1214 {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	1215 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	1216 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	1217 the tree.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1218 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1219
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1220 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1221 % \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	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{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	1225
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1226
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1227 \subsubsection{Tabular ListBox}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1228
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1229 \begin{classdesc}{TList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1230 The \ulink{TList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1231 {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	1232 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	1233 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	1234 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	1235 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	1236 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	1237 list entries.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1238 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1239
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1240 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1241 % \ulink{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	1242 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1243 % \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	1244
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1245 % 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	1246 % \subsubsection{Grid Widget}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1247 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1248 % \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	1249 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1250 % \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	1251 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1252 % \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	1253
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1254
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1255 \subsubsection{Manager Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1256
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1257 \begin{classdesc}{PanedWindow}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1258 The \ulink{PanedWindow}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1259 {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	1260 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	1261 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	1262 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	1263 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	1264 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1265
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1266 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1267 % \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	1268
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1269 \begin{classdesc}{ListNoteBook}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1270 The \ulink{ListNoteBook}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1271 {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	1272 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	1273 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	1274 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	1275 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	1276 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	1277 \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	1278 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1279
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1280 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1281 % \ulink{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	1282
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1283 \begin{classdesc}{NoteBook}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1284 The \ulink{NoteBook}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1285 {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	1286 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	1287 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	1288 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	1289 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	1290 NoteBook widget.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1291 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1292
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1293 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1294 % \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	1295
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1296
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1297 % \subsubsection{Scrolled Widgets}
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{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	1300 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1301 % \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	1302 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1303 % \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	1304 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1305 % \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	1306
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1307
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1308 \subsubsection{Image Types}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1309
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1310 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	1311 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1312 \item
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1313 \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	1314 {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	1315 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	1316 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	1317
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1318 % Python Demo of:
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1319 % \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	1320
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1321 % Python Demo of:
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1322 % \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	1323
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1324 \item
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1325 \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	1326 {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	1327 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	1328 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	1329 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	1330 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	1331 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	1332
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	1333 % 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	1334 % \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	1335
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	1336 % 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	1337 % \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	1338
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	1339 % 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	1340 % \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	1341
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	1342 % 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	1343 % \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	1344 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1345
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1346
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1347 \subsubsection{Miscellaneous Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1348
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1349 \begin{classdesc}{InputOnly}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1350 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	1351 {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	1352 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	1353 \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	1354 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1355
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1356 \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	1357
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1358 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	1359
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1360 \begin{classdesc}{Form}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1361 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	1362 {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	1363 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	1364 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1365
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{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1368 %\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	1369 %
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1370 %\begin{figure}[hbtp]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1371 %\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	1372 %\vspace{.5cm}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1373 %\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	1374 %\end{figure}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1375 %end{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1376
21109 05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1377 \subsection{Tix Commands}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1378
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1379 \begin{classdesc}{tixCommand}{}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1380 The \ulink{tix commands}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1381 {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	1382 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	1383 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	1384 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	1385 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	1386
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1387 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	1388 \begin{verbatim}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1389 import Tix
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1390 root = Tix.Tk()
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1391 print root.tix_configure()
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1392 \end{verbatim}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1393 \end{classdesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1394
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1395 \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	1396 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	1397 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	1398 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	1399 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	1400 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	1401 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	1402 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	1403 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	1404 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	1405 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1406
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1407 \begin{methoddesc}{tix_cget}{option}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1408 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	1409 \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	1410 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1411
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1412 \begin{methoddesc}{tix_getbitmap}{name}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1413 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	1414 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	1415 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	1416 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	1417 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	1418 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	1419 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	1420 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1421
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1422 \begin{methoddesc}{tix_addbitmapdir}{directory}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1423 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	1424 \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	1425 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	1426 \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	1427 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	1428 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	1429 \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	1430 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1431
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1432 \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	1433 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	1434 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	1435 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	1436 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	1437 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	1438 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	1439 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	1440 \code{tixExFileSelectDialog}.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1441 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1442
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1443
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1444 \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	1445 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	1446 \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	1447 \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	1448 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	1449 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	1450 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	1451 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	1452 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	1453 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	1454 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	1455 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1456
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1457 \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	1458 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	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 \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	1462 newScmPrio}}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1463 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	1464 \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	1465 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	1466 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	1467 application.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1468
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1469 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	1470 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	1471
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1472 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	1473 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	1474 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	1475 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	1476 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1477
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1478
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1479
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1480 \section{\module{ScrolledText} ---
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1481 Scrolled Text Widget}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1482
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1483 \declaremodule{standard}{ScrolledText}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1484 \platform{Tk}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1485 \modulesynopsis{Text widget with a vertical scroll bar.}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1486 \sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1487
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1488 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	1489 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	1490 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	1491 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	1492 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	1493 \class{Tkinter.Text} class.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1494
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1495 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	1496 and the methods of the \class{Grid} and \class{Pack} geometry managers
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1497 are acquired from the \class{Frame} object. This allows the
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1498 \class{ScrolledText} widget to be used directly to achieve most normal
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1499 geometry management behavior.
21175 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 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	1502 are available:
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1503
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1504 \begin{memberdesc}[ScrolledText]{frame}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1505 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	1506 \end{memberdesc}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1507
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1508 \begin{memberdesc}[ScrolledText]{vbar}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1509 The scroll bar widget.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1510 \end{memberdesc}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1511
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1512
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1513 \input{libturtle}
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1514
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1515
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1516 \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	1517
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1518 %\declaremodule{standard}{idle}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1519 %\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	1520 \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	1521
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1522 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	1523 \index{Idle}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1524 \index{Python Editor}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1525 \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	1526
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1527
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1528 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	1529
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1530 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1531 \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	1532
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1533 \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	1534 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	1535
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1536 \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	1537 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	1538
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1539 \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	1540
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1541 \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	1542 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1543
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 \subsection{Menus}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1546
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1547 \subsubsection{File menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1548
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1549 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1550 \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	1551 \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	1552 \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	1553 \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	1554 \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	1555 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1556 \index{Class browser}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1557 \index{Path browser}
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 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1560 \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	1561 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	1562
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1563 \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	1564 the associated file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1565 \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	1566 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	1567 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1568
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1569 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1570 \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	1571 \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	1572 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1573
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1574
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1575 \subsubsection{Edit menu}
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[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	1579 \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	1580 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1581
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1582 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1583 \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	1584 \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	1585 \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	1586 \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	1587 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1588
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1589 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1590 \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	1591 \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	1592 \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	1593 \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	1594 \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	1595 \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	1596 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1597
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1598 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1599 \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	1600 \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	1601 \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	1602 \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	1603 \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	1604 \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	1605 \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	1606 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	1607 \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	1608 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1609
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1610 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1611 \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	1612 \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	1613 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1614
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1615 \index{Import module}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1616 \index{Run script}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1617
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1618
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1619 \subsubsection{Windows menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1620
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1621 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1622 \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	1623 and maximum height.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1624 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1625
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1626 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	1627 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	1628
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1629
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1630 \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	1631
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1632 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1633 \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	1634 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	1635 \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	1636 \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	1637 \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	1638 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1639
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1640 \index{stack viewer}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1641 \index{debugger}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1642
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 \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	1645
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1646 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1647 \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	1648 \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	1649 \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	1650 \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	1651 \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	1652 \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	1653 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1654
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1655
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1656 \subsubsection{Automatic indentation}
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 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	1659 (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	1660 (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	1661 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	1662 \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	1663 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	1664
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1665
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1666 \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	1667
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1668 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1669 \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	1670 \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	1671 a \samp{>>>~} prompt
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1672 \end{itemize}
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 \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	1675 \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	1676 \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	1677 \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	1678 \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	1679 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1680
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1681 \index{indentation}
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 \subsection{Syntax colors}
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 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	1687 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	1688 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	1689
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1690 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1691 \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	1692
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1693 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1694 \item[Keywords] orange
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1695 \item[Strings ] green
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1696 \item[Comments] red
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1697 \item[Definitions] blue
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1698 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1699
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1700 \item[Shell colors:]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1701 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1702 \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	1703 \item[stdout] blue
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1704 \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	1705 \item[stdin] black
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1706 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1707 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1708
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1709
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1710 \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	1711
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1712 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1713 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	1714
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1715 -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	1716 -d enable debugger
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1717 -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	1718 -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	1719 -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	1720 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1721
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1722 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	1723
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1724 \begin{enumerate}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1725 \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	1726 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	1727 IDLE itself.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1728
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1729 \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	1730 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	1731 to \code{'-c'}.
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 \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	1734 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	1735 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	1736 \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	1737 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	1738 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	1739 \code{sys.argv}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1740 \end{enumerate}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1741
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1742
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1743 \section{Other Graphical User Interface Packages
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1744 \label{other-gui-packages}}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1745
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1746
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1747 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	1748
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1749 \begin{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1750 \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	1751 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	1752 \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	1753 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	1754 foundation. These megawidgets include notebooks, comboboxes, selection
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1755 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	1756 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	1757 and vector commands are be available.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1758
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1759 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	1760 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	1761 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	1762 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	1763 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	1764 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	1765 }
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1766 \seetitle[http://tkinter.effbot.org]{Tkinter3000}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1767 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	1768 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	1769 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	1770 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	1771 still in the early stages.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1772 }
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1773 \end{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1774
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1775
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	1776 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	1777 most commonly used one.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1778
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1779 \begin{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1780 \seetitle[http://www.wxwindows.org]{wxWindows}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1781 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	1782 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	1783 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	1784 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	1785 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	1786 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	1787
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1788 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	1789 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	1790 specialized widgets, extensive documentation, and printing capabilities.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1791 }
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1792 \seetitle[http://www.thekompany.com]{PyKDE}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1793 PyKDE is a SIP wrapped interface to the Qt toolkit.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1794 The Qt \Cpp{} toolkit lies at the heart of the KDE desktop, and the
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1795 Qt toolkit allows very tight integration with KDE, and also Windows
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1796 portability. SIP is a tool for generating bindings for \Cpp{} libraries
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1797 as Python classes, and is specifically designed for Python.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1798 }
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1799 \seetitle[http://fxpy.sourceforge.net/]{FXPy}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1800 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	1801 \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	1802 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	1803 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	1804 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	1805 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	1806 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	1807 features such as status line help, and tooltips.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1808
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1809 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	1810 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	1811 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	1812 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	1813 }
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1814 \seetitle[http://www.daa.com.au/\~james/pygtk/]{PyGTK}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1815 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	1816 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	1817 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	1818 reference counting that you would have to do normally with the C
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1819 API. There are also \ulink{bindings}{http://www.daa.com.au/\~james/gnome/}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1820 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	1821 \ulink{tutorial}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1822 {http://laguna.fmedic.unam.mx/\~daniel/pygtutorial/pygtutorial/index.html}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1823 is available.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1824 }
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1825 \end{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1826
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1827 % XXX Reference URLs that compare the different UI packages

Mercurial > cpython-lru_cache-weakref

annotate Doc/lib/tkinter.tex @ 21467:4e35fa5d5708 legacy-trunk