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

annotate Doc/lib/tkinter.tex @ 25838:8540887bcec6 2.2

Backport of 2.183: Fix memory leak in add_subclass() found by NealN with valgrind.

author	Guido van Rossum <guido@python.org>
date	Fri, 18 Oct 2002 13:42:21 +0000
parents	9bd2f9792efb
children	28cff60a6097

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
25197 64d105dd0823 Clarify who maintains Tkinter and who maintains Tk. Fred Drake <fdrake@acm.org> parents: 24138 diff changeset	41 interface to the Tk GUI toolkit. Both Tk and \module{Tkinter} are
64d105dd0823 Clarify who maintains Tkinter and who maintains Tk. Fred Drake <fdrake@acm.org> parents: 24138 diff changeset	42 available on most \UNIX{} platforms, as well as on Windows and
64d105dd0823 Clarify who maintains Tkinter and who maintains Tk. Fred Drake <fdrake@acm.org> parents: 24138 diff changeset	43 Macintosh systems. (Tk itself is not part of Python; it is maintained
64d105dd0823 Clarify who maintains Tkinter and who maintains Tk. Fred Drake <fdrake@acm.org> parents: 24138 diff changeset	44 at ActiveState.)
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	45
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	46 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	47 \seetitle[http://www.python.org/topics/tkinter/]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	48 {Python Tkinter Resources}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	49 {The Python Tkinter Topic Guide provides a great
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	50 deal of information on using Tk from Python and links to
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	51 other sources of information on Tk.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	52
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	53 \seetitle[http://www.pythonware.com/library/an-introduction-to-tkinter.htm]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	54 {An Introduction to Tkinter}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	55 {Fredrik Lundh's on-line reference material.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	56
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	57 \seetitle[http://www.nmt.edu/tcc/help/pubs/lang.html]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	58 {Tkinter reference: a GUI for Python}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	59 {On-line reference material.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	60
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	61 \seetitle[http://jtkinter.sourceforge.net]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	62 {Tkinter for JPython}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	63 {The Jython interface to Tkinter.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	64
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	65 \seetitle[http://www.amazon.com/exec/obidos/ASIN/1884777813]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	66 {Python and Tkinter Programming}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	67 {The book by John Grayson (ISBN 1-884777-81-3).}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	68 \end{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	69
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	70
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	71 \subsection{Tkinter Modules}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	72
20997 84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	73 Most of the time, the \refmodule{Tkinter} module is all you really
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	74 need, but a number of additional modules are available as well. The
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	75 Tk interface is located in a binary module named \module{_tkinter}.
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	76 This module contains the low-level interface to Tk, and should never
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	77 be used directly by application programmers. It is usually a shared
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	78 library (or DLL), but might in some cases be statically linked with
84bca1ef1168 Clean up some markup a little bit more. Make this work with the PDF format, Fred Drake <fdrake@acm.org> parents: 20994 diff changeset	79 the Python interpreter.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	80
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	81 In addition to the Tk interface module, \refmodule{Tkinter} includes a
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	82 number of Python modules. The two most important modules are the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	83 \refmodule{Tkinter} module itself, and a module called
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	84 \module{Tkconstants}. The former automatically imports the latter, so
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	85 to use Tkinter, all you need to do is to import one module:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	86
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	87 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	88 import Tkinter
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	89 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	90
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	91 Or, more often:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	92
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	93 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	94 from Tkinter import *
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	95 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	96
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	97 \begin{classdesc}{Tk}{screenName=None, baseName=None, className='Tk'}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	98 The \class{Tk} class is instantiated without arguments.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	99 This creates a toplevel widget of Tk which usually is the main window
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	100 of an appliation. Each instance has its own associated Tcl interpreter.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	101 % FIXME: The following keyword arguments are currently recognized:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	102 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	103
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	104 Other modules that provide Tk support include:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	105
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	106 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	107 % \declaremodule{standard}{Tkconstants}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	108 % \modulesynopsis{Constants used by Tkinter}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	109 % FIXME
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	110
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	111 \item[\refmodule{ScrolledText}]
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	112 Text widget with a vertical scroll bar built in.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	113
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	114 \item[\module{tkColorChooser}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	115 Dialog to let the user choose a color.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	116
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	117 \item[\module{tkCommonDialog}]
21119 493f932d5829 Add description of tkCommonDialog. Fred Drake <fdrake@acm.org> parents: 21117 diff changeset	118 Base class for the dialogs defined in the other modules listed here.
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	119
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	120 \item[\module{tkFileDialog}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	121 Common dialogs to allow the user to specify a file to open or save.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	122
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	123 \item[\module{tkFont}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	124 Utilities to help work with fonts.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	125
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	126 \item[\module{tkMessageBox}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	127 Access to standard Tk dialog boxes.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	128
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	129 \item[\module{tkSimpleDialog}]
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	130 Basic dialogs and convenience functions.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	131
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	132 \item[\module{Tkdnd}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	133 Drag-and-drop support for \refmodule{Tkinter}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	134 This is experimental and should become deprecated when it is replaced
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	135 with the Tk DND.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	136
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	137 \item[\refmodule{turtle}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	138 Turtle graphics in a Tk window.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	139
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	140 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	141
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	142 \subsection{Tkinter Life Preserver}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	143 \sectionauthor{Matt Conway}{}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	144 % Converted to LaTeX by Mike Clarkson.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	145
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	146 This section is not designed to be an exhaustive tutorial on either
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	147 Tk or Tkinter. Rather, it is intended as a stop gap, providing some
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	148 introductory orientation on the system.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	149
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	150 Credits:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	151 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	152 \item Tkinter was written by Steen Lumholt and Guido van Rossum.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	153 \item Tk was written by John Ousterhout while at Berkeley.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	154 \item This Life Preserver was written by Matt Conway at
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	155 the University of Virginia.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	156 \item The html rendering, and some liberal editing, was
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	157 produced from a FrameMaker version by Ken Manheimer.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	158 \item Fredrik Lundh elaborated and revised the class interface descriptions,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	159 to get them current with Tk 4.2.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	160 \item Mike Clarkson converted the documentation to \LaTeX, and compiled the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	161 User Interface chapter of the reference manual.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	162 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	163
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	164
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	165 \subsubsection{How To Use This Section}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	166
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	167 This section is designed in two parts: the first half (roughly) covers
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	168 background material, while the second half can be taken to the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	169 keyboard as a handy reference.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	170
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	171 When trying to answer questions of the form ``how do I do blah'', it
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	172 is often best to find out how to do``blah'' in straight Tk, and then
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	173 convert this back into the corresponding \refmodule{Tkinter} call.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	174 Python programmers can often guess at the correct Python command by
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	175 looking at the Tk documentation. This means that in order to use
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	176 Tkinter, you will have to know a little bit about Tk. This document
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	177 can't fulfill that role, so the best we can do is point you to the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	178 best documentation that exists. Here are some hints:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	179
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	180 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	181 \item The authors strongly suggest getting a copy of the Tk man
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	182 pages. Specifically, the man pages in the \code{mann} directory are most
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	183 useful. The \code{man3} man pages describe the C interface to the Tk
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	184 library and thus are not especially helpful for script writers.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	185
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	186 \item Addison-Wesley publishes a book called \citetitle{Tcl and the
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	187 Tk Toolkit} by John Ousterhout (ISBN 0-201-63337-X) which is a good
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	188 introduction to Tcl and Tk for the novice. The book is not
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	189 exhaustive, and for many details it defers to the man pages.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	190
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	191 \item \file{Tkinter.py} is a last resort for most, but can be a good
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	192 place to go when nothing else makes sense.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	193 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	194
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	195 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	196 \seetitle[http://tcl.activestate.com/]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	197 {ActiveState Tcl Home Page}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	198 {The Tk/Tcl development is largely taking place at
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	199 ActiveState.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	200 \seetitle[http://www.amazon.com/exec/obidos/ASIN/020163337X]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	201 {Tcl and the Tk Toolkit}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	202 {The book by John Ousterhout, the inventor of Tcl .}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	203 \seetitle[http://www.amazon.com/exec/obidos/ASIN/0130220280]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	204 {Practical Programming in Tcl and Tk}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	205 {Brent Welch's encyclopedic book.}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	206 \end{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	207
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	208
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	209 \subsubsection{A Simple Hello World Program} % HelloWorld.html
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	210
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	211 %begin{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	212 %\begin{figure}[hbtp]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	213 %\centerline{\epsfig{file=HelloWorld.gif,width=.9\textwidth}}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	214 %\vspace{.5cm}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	215 %\caption{HelloWorld gadget image}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	216 %\end{figure}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	217 %See also the hello-world \ulink{notes}{classes/HelloWorld-notes.html} and
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	218 %\ulink{summary}{classes/HelloWorld-summary.html}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	219 %end{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	220
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	221
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	222 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	223 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	224 2
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	225 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	226 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	227 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	228 6
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	229 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	230 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	231 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	232 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	233 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	234 12
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	235 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	236 14
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 = Button(self) 15
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["text"] = "Hello", 16
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	239 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	240 18
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	241 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	242 20
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	243 21
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	244 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	245 Frame.__init__(self, master) 23
21640 851e4bf30358 Fix indentation error in example from the Tkinter Life Preserver. Fred Drake <fdrake@acm.org> parents: 21380 diff changeset	246 self.pack() 24
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	247 self.createWidgets() 25
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	248 26
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	249 app = Application() 27
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	250 app.mainloop() 28
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	251 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	252
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	253
21148 d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	254 \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	255
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	256 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	257 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	258 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	259
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	260 Notes:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	261 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	262 \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	263 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	264 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	265
d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	266 \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	267 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	268 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	269 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	270
d4509cf93f50 Clean up some material that is not part of the standard documentation. Fred Drake <fdrake@acm.org> parents: 21119 diff changeset	271 \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	272 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	273 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	274 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	275
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	276 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	277 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	278 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	279 (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	280 \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	281
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	282 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	283 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	284 \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	285 \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	286
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	287 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	288
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	289 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	290 classCommand newPathname options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	291 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	292
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	293 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	294 \item[\var{classCommand}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	295 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	296
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	297 \item[\var{newPathname}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	298 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	299 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	300 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	301 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	302 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	303 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	304
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	305 \item[\var{options} ]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	306 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	307 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	308 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	309 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	310 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	311
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	312 For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	313
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	314 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	315 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	316 ^ ^ \_____________________/
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	317 \| \| \|
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	318 class new options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	319 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	320 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	321
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	322 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	323 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	324 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	325 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	326 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	327
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	328 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	329 .fred someAction someOptions
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	330 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	331
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	332 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	333
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	334 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	335 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	336 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	337 (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	338
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	339 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	340 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	341 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	342 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	343
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	344
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	345 \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	346 \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	347
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	348 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	349
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	350 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	351 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	352 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	353
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	354 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	355 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	356
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	357 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	358 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	359 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	360
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	361 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	362 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	363 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	364 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	365 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	366 setting options.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	367
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	368 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	369 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	370 .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	371 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	372 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	373
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	374 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	375 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	376 (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	377 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	378 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	379
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	380 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	381 .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	382 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	383
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	384 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	385 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	386 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	387 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	388 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	389 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	390 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	391
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	392 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	393 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	394 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	395
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	396
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	397 \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	398
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	399 \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	400 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	401
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	402 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	403 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	404 \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	405 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	406
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	407 \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	408 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	409 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	410 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	411 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	412 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	413
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	414 \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	415 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	416 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	417
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	418 \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	419 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	420 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	421 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	422 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	423 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	424 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	425
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	426 \item[\b{Tk (C)}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	427 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	428
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	429 \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	430 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	431 \end{description}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	434 \subsection{Handy Reference}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	435
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	436 \subsubsection{Setting Options
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	437 \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	438
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	439 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	440 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	441
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	442 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	443 \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	444 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	445 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	446 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	447 \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	448 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	449 fred["fg"] = "red"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	450 fred["bg"] = "blue"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	451 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	452 \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	453 object creation]:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	454 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	455 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	456 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	457 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	458
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	459 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	460 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	461
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	462 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	463 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	464 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	465 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	466 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	467
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	468 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	469 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	470 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	471 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	472
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	473 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	474 man page, or can be queried at runtime by calling the
24138 c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	475 \method{config()} method without arguments, or by calling the
c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	476 \method{keys()} method on that widget. The return value of these
c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	477 calls is a dictionary whose key is the name of the option as a string
c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	478 (for example, \code{'relief'}) and whose values are 5-tuples.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	479
24138 c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	480 Some options, like \code{bg} are synonyms for common options with long
c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	481 names (\code{bg} is shorthand for "background"). Passing the
c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	482 \code{config()} method the name of a shorthand option will return a
c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	483 2-tuple, not 5-tuple. The 2-tuple passed back will contain the name of
c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	484 the synonym and the ``real'' option (such as \code{('bg',
c36be79fdbea Fix typo reported by Kent Engström, and a bunch of broken markup. Fred Drake <fdrake@acm.org> parents: 23596 diff changeset	485 'background')}).
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	486
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	487 \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	488 \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	489 \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	490 \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	491 \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	492 \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	493 \end{tableiii}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	496 Example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	497
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	498 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	499 >>> print fred.config()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	500 {'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	501 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	502
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	503 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	504 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	505
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	506
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	507 \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	508 \index{packing (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	509
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	510 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	511 \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	512
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	513 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	514 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	515 \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	516 (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	517 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	518 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	519 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	520
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	521 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	522 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	523 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	524 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	525 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	526 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	527 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	528
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	529 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	530 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	531 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	532 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	533 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	534 applied to it.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	535
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	536 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	537 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	538 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	539 some examples:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	540
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	541 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	542 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	543 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	544 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	545 \end{verbatim}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	548 \subsubsection{Packer Options}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	549
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	550 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	551 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	552
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	553 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	554 \item[\b{anchor }]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	555 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	556 parcel.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	557
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	558 \item[\b{expand}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	559 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	560
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	561 \item[\b{fill}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	562 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	563
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	564 \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	565 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	566 widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	567
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	568 \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	569 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	570 widget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	571
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	572 \item[\b{side}]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	573 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	574 \code{'bottom'}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	575 \end{description}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	578 \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	579
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	580 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	581 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	582 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	583 \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	584 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	585 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	586
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	587 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	588 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	589 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	590 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	591 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	592 \refmodule{Tkinter} module.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	593
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	594 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	595 \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	596 \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	597 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	598 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	599 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	600 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	601
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	602 For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	603 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	604 class App(Frame):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	605 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	606 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	607 self.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	608
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	609 self.entrythingy = Entry()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	610 self.entrythingy.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	611
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	612 self.button.pack()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	613 # 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	614 self.contents = StringVar()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	615 # 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	616 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	617 # 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	618 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	619
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	620 # 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	621 # 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	622 # 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	623 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	624 self.print_contents)
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	625
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	626 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	627 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	628 self.contents.get()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	629 \end{verbatim}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	632 \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	633 \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	634
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	635 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	636 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	637 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	638 \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	639 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	640 \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	641
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	642 %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	643
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	644 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	645 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	646 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	647 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	648 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	649 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	650 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	651
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	652 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	653
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	654 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	655 import Tkinter
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	656 class App(Frame):
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	657 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	658 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	659 self.pack()
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	662 # create the application
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	663 myapp = App()
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 #
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	666 # 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	667 #
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	668 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	669 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	670
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	671 # start the program
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	672 myapp.mainloop()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	673 \end{verbatim}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	676 \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	677
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	678 \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	679
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	680 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	681 \item[anchor]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	682 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	683 \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	684 \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	685 \code{"center"}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	686
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	687 \item[bitmap]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	688 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	689 \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	690 \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	691 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	692 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	693
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	694 \item[boolean]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	695 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	696
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	697 \item[callback]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	698 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	699 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	700 def print_it():
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	701 print "hi there"
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	702 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	703 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	704
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	705 \item[color]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	706 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	707 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	708 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	709 \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	710 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	711
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	712 \item[cursor]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	713 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	714 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	715 (\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	716 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	717 Ousterhout's book.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	718
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	719 \item[distance]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	720 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	721 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	722 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	723 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	724 \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	725 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	726
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	727 \item[font]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	728 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	729 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	730 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	731
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	732 \item[geometry]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	733 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	734 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	735 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	736 \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	737
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	738 \item[justify]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	739 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	740 \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	741
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	742 \item[region]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	743 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	744 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	745 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	746 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	747
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	748 \item[relief]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	749 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	750 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	751 \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	752
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	753 \item[scrollcommand]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	754 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	755 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	756 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	757 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	758
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	759 \item[wrap:]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	760 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	761 \end{description}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	764 \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	765
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	766 \index{bind (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	767 \index{events (widgets)}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	768
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	769 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	770 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	771 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	772
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	773 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	774 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	775 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	776 where:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	777
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	778 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	779 \item[sequence]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	780 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	781 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	782
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	783 \item[func]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	784 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	785 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	786 (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	787
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	788 \item[add]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	789 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	790 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	791 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	792 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	793 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	794
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	795 For example:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	796 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	797 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	798 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	799
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	800 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	801 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	802
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	803 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	804 \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	805 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	806 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	807 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	808
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	809 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	810 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	811 -- ------------------- -- -------------------
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	812 %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	813 %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	814 %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	815 %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	816 %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	817 %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	818 %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	819 %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	820 \end{verbatim}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	823 \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	824
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	825 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	826 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	827 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	828 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	829
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	830 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	831 \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	832 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	833 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	834 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	835
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	836 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	837 \item[AtEnd()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	838 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	839
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	840 \item[AtInsert()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	841 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	842
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	843 \item[AtSelFirst()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	844 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	845
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	846 \item[AtSelLast()]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	847 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	848
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 \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	850 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	851 \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	852 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	853 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	854
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	855 \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	856 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	857 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	858
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	859 \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	860
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	861 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	862 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	863 pass in:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	864 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	865 \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	866 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	867 \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	868 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	869 \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	870 item;
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	871 \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	872 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	873 \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	874 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	875 finally,
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	876 \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	877 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	878 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	879 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	880 \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	881 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	882 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	883
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	884
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	885 \section{\module{Tix} ---
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	886 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	887
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	888 \declaremodule{standard}{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	889 \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	890 \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	891
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	892 \index{Tix}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	893
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	894 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	895 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	896 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	897 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	898 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	899 (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	900 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	901 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	902 \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	903
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	904 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	905 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	906 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	907 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	908 users.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	909
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	910 \begin{seealso}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	911 \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	912 {Tix Homepage}
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	913 {The home page for \module{Tix}. This includes links to
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	914 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	915 \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	916 {Tix Man Pages}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	917 {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	918 \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	919 {Tix Programming Guide}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	920 {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	921 \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	922 {Tix Development Applications}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	923 {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	924 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	925 \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	926 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	927 \end{seealso}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	930 \subsection{Using Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	931
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	932 \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	933 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	934 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	935
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	936 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	937 \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	938 \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	939 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	940 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	941 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	942 import Tix
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	943 from Tkconstants import *
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	944 root = Tix.Tk()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	945 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	946 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	947
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	948 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	949 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	950 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	951 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	952 import Tix
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	953 root = Tix.Tk()
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	954 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	955 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	956
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	957 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	958 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	959 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	960 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	961 \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	962 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	963 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	964 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	965
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	966 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	967 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	968 \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	969
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	970
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	971 \subsection{Tix Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	972
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	973 \ulink{Tix}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	974 {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	975 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	976 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	977 \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	978
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	979
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	980 % 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	981
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	982
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	983 \subsubsection{Basic Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	984
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	985 \begin{classdesc}{Balloon}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	986 A \ulink{Balloon}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	987 {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	988 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	989 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	990 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	991 screen.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	992 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	993
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	994 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	995 % \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	996
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	997 \begin{classdesc}{ButtonBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	998 The \ulink{ButtonBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	999 {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	1000 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	1001 Cancel}.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1002 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1003
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1004 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1005 % \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	1006
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1007 \begin{classdesc}{ComboBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1008 The \ulink{ComboBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1009 {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	1010 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	1011 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	1012 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	1013 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1014
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1015 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1016 % \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	1017
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1018 \begin{classdesc}{Control}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1019 The \ulink{Control}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1020 {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	1021 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	1022 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	1023 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	1024 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	1025 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1026
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1027 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1028 % \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	1029
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1030 \begin{classdesc}{LabelEntry}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1031 The \ulink{LabelEntry}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1032 {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	1033 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	1034 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	1035 interface.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1036 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1037
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1038 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1039 % \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	1040
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1041 \begin{classdesc}{LabelFrame}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1042 The \ulink{LabelFrame}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1043 {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	1044 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	1045 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	1046 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	1047 \member{frame} subwidget.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1048 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1049
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1050 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1051 % \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	1052
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1053 \begin{classdesc}{Meter}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1054 The \ulink{Meter}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1055 {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	1056 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	1057 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	1058 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1059
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1060 % Python Demo of:
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1061 % \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	1062
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1063 \begin{classdesc}{OptionMenu}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1064 The \ulink{OptionMenu}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1065 {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	1066 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	1067 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1068
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1069 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1070 % \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	1071
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1072 \begin{classdesc}{PopupMenu}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1073 The \ulink{PopupMenu}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1074 {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	1075 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	1076 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	1077 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	1078 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1079
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1080 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1081 % \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	1082
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1083 \begin{classdesc}{Select}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1084 The \ulink{Select}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1085 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixSelect.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1086 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	1087 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	1088 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1089
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1090 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1091 % \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	1092
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1093 \begin{classdesc}{StdButtonBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1094 The \ulink{StdButtonBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1095 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixStdButtonBox.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1096 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	1097 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1098
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1099 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1100 % \ulink{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	1101
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1102
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1103 \subsubsection{File Selectors}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1104
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1105 \begin{classdesc}{DirList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1106 The \ulink{DirList}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1107 {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	1108 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	1109 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	1110 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	1111 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1112
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1113 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1114 % \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	1115
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1116 \begin{classdesc}{DirTree}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1117 The \ulink{DirTree}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1118 {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	1119 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	1120 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	1121 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	1122 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1123
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1124 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1125 % \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	1126
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1127 \begin{classdesc}{DirSelectDialog}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1128 The \ulink{DirSelectDialog}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1129 {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	1130 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	1131 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	1132 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	1133 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1134
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1135 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1136 % \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	1137
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1138 \begin{classdesc}{DirSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1139 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	1140 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	1141 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	1142 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	1143 selected again.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1144 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1145
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1146 \begin{classdesc}{ExFileSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1147 The \ulink{ExFileSelectBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1148 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixExFileSelectBox.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1149 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	1150 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	1151 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	1152 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	1153 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1154
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1155 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1156 %\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	1157
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1158 \begin{classdesc}{FileSelectBox}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1159 The \ulink{FileSelectBox}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1160 {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	1161 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	1162 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	1163 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	1164 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	1165 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1166
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1167 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1168 % \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	1169
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1170 \begin{classdesc}{FileEntry}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1171 The \ulink{FileEntry}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1172 {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	1173 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	1174 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	1175 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	1176 dialog.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1177 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1178
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1179 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1180 % \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	1181
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1182
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1183 \subsubsection{Hierachical ListBox}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1184
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1185 \begin{classdesc}{HList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1186 The \ulink{HList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1187 {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	1188 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	1189 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	1190 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	1191 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	1192 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1193
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1194 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1195 % \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	1196
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1197 \begin{classdesc}{CheckList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1198 The \ulink{CheckList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1199 {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	1200 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	1201 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	1202 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	1203 radiobuttons.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1204 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1205
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1206 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1207 % \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	1208 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1209 % \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	1210 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1211 % \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	1212
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1213 \begin{classdesc}{Tree}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1214 The \ulink{Tree}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1215 {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	1216 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	1217 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	1218 the tree.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1219 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1220
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1221 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1222 % \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	1223
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1224 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1225 % \ulink{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	1226
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1227
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1228 \subsubsection{Tabular ListBox}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1229
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1230 \begin{classdesc}{TList}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1231 The \ulink{TList}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1232 {http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixTList.htm}
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1233 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	1234 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	1235 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	1236 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	1237 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	1238 list entries.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1239 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1240
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1241 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1242 % \ulink{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	1243 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1244 % \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	1245
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1246 % 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	1247 % \subsubsection{Grid Widget}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1248 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1249 % \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	1250 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1251 % \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	1252 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1253 % \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	1254
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1255
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1256 \subsubsection{Manager Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1257
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1258 \begin{classdesc}{PanedWindow}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1259 The \ulink{PanedWindow}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1260 {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	1261 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	1262 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	1263 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	1264 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	1265 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1266
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1267 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1268 % \ulink{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	1269
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1270 \begin{classdesc}{ListNoteBook}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1271 The \ulink{ListNoteBook}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1272 {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	1273 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	1274 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	1275 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	1276 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	1277 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	1278 \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	1279 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1280
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1281 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1282 % \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	1283
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1284 \begin{classdesc}{NoteBook}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1285 The \ulink{NoteBook}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1286 {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	1287 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	1288 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	1289 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	1290 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	1291 NoteBook widget.
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1292 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1293
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1294 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1295 % \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	1296
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1297
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1298 % \subsubsection{Scrolled Widgets}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1299 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1300 % \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	1301 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1302 % \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	1303 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1304 % \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	1305 % Python Demo of:
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1306 % \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	1307
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1308
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1309 \subsubsection{Image Types}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1310
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1311 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	1312 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1313 \item
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1314 \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	1315 {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	1316 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	1317 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	1318
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1319 % Python Demo of:
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1320 % \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	1321
21380 44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1322 % Python Demo of:
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1323 % \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	1324
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1325 \item
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1326 \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	1327 {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	1328 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	1329 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	1330 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	1331 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	1332 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	1333
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	1334 % 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	1335 % \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	1336
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	1337 % 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	1338 % \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	1339
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	1340 % 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	1341 % \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	1342
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	1343 % 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	1344 % \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	1345 \end{itemize}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1348 \subsubsection{Miscellaneous Widgets}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1349
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1350 \begin{classdesc}{InputOnly}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1351 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	1352 {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	1353 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	1354 \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	1355 \end{classdesc}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1356
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1357 \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	1358
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1359 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	1360
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1361 \begin{classdesc}{Form}{}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1362 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	1363 {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	1364 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	1365 \end{classdesc}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1368 %begin{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1369 %\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	1370 %
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1371 %\begin{figure}[hbtp]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1372 %\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	1373 %\vspace{.5cm}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1374 %\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	1375 %\end{figure}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1376 %end{latexonly}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1377
21109 05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1378 \subsection{Tix Commands}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1379
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1380 \begin{classdesc}{tixCommand}{}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1381 The \ulink{tix commands}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1382 {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	1383 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	1384 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	1385 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	1386 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	1387
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1388 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	1389 \begin{verbatim}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1390 import Tix
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1391 root = Tix.Tk()
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1392 print root.tix_configure()
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1393 \end{verbatim}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1394 \end{classdesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1395
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1396 \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	1397 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	1398 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	1399 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	1400 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	1401 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	1402 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	1403 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	1404 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	1405 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	1406 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1407
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1408 \begin{methoddesc}{tix_cget}{option}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1409 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	1410 \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	1411 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1412
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1413 \begin{methoddesc}{tix_getbitmap}{name}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1414 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	1415 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	1416 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	1417 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	1418 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	1419 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	1420 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	1421 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1422
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1423 \begin{methoddesc}{tix_addbitmapdir}{directory}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1424 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	1425 \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	1426 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	1427 \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	1428 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	1429 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	1430 \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	1431 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1432
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1433 \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	1434 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	1435 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	1436 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	1437 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	1438 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	1439 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	1440 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	1441 \code{tixExFileSelectDialog}.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1442 \end{methoddesc}
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
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1445 \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	1446 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	1447 \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	1448 \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	1449 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	1450 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	1451 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	1452 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	1453 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	1454 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	1455 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	1456 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1457
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1458 \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	1459 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	1460 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1461
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1462 \begin{methoddesc}{tix_resetoptions}{newScheme, newFontSet\optional{,
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1463 newScmPrio}}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1464 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	1465 \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	1466 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	1467 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	1468 application.
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1469
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1470 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	1471 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	1472
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1473 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	1474 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	1475 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	1476 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	1477 \end{methoddesc}
05095398f939 More information about Tix support, contributed by Mike Clarkson. Fred Drake <fdrake@acm.org> parents: 21062 diff changeset	1478
20980 4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1479
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1480
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1481 \section{\module{ScrolledText} ---
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1482 Scrolled Text Widget}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1483
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1484 \declaremodule{standard}{ScrolledText}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1485 \platform{Tk}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1486 \modulesynopsis{Text widget with a vertical scroll bar.}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1487 \sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1488
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1489 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	1490 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	1491 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	1492 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	1493 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	1494 \class{Tkinter.Text} class.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1495
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1496 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	1497 and the methods of the \class{Grid} and \class{Pack} geometry managers
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1498 are acquired from the \class{Frame} object. This allows the
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1499 \class{ScrolledText} widget to be used directly to achieve most normal
44ebeab269c5 Minor adjustments. Fred Drake <fdrake@acm.org> parents: 21175 diff changeset	1500 geometry management behavior.
21175 c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1501
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1502 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	1503 are available:
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1504
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1505 \begin{memberdesc}[ScrolledText]{frame}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1506 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	1507 \end{memberdesc}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1508
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1509 \begin{memberdesc}[ScrolledText]{vbar}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1510 The scroll bar widget.
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1511 \end{memberdesc}
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1512
c9a796400a51 Added documentation on the ScrolledText module. Fred Drake <fdrake@acm.org> parents: 21148 diff changeset	1513
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1514 \input{libturtle}
20980 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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1517 \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	1518
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1519 %\declaremodule{standard}{idle}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1520 %\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	1521 \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	1522
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1523 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	1524 \index{Idle}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1525 \index{Python Editor}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1526 \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	1527
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1528
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1529 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	1530
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1531 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1532 \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	1533
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1534 \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	1535 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	1536
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1537 \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	1538 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	1539
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1540 \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	1541
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1542 \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	1543 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1544
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1545
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1546 \subsection{Menus}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1547
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1548 \subsubsection{File menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1549
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1550 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1551 \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	1552 \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	1553 \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	1554 \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	1555 \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	1556 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1557 \index{Class browser}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1558 \index{Path browser}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1559
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1560 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1561 \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	1562 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	1563
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1564 \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	1565 the associated file
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1566 \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	1567 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	1568 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1569
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1570 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1571 \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	1572 \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	1573 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1574
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1575
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1576 \subsubsection{Edit menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1577
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1578 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1579 \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	1580 \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	1581 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1582
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1583 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1584 \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	1585 \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	1586 \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	1587 \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	1588 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1589
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1590 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1591 \item[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	1592 \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	1593 \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	1594 \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	1595 \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	1596 \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	1597 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1598
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1599 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1600 \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	1601 \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	1602 \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	1603 \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	1604 \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	1605 \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	1606 \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	1607 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	1608 \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	1609 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1610
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1611 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1612 \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	1613 \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	1614 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1615
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1616 \index{Import module}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1617 \index{Run script}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1620 \subsubsection{Windows menu}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1621
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1622 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1623 \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	1624 and maximum height.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1625 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1626
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1627 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	1628 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	1629
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1630
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1631 \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	1632
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1633 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1634 \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	1635 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	1636 \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	1637 \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	1638 \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	1639 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1640
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1641 \index{stack viewer}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1642 \index{debugger}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1645 \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	1646
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1647 \begin{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1648 \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	1649 \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	1650 \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	1651 \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	1652 \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	1653 \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	1654 \end{itemize}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1657 \subsubsection{Automatic indentation}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1658
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1659 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	1660 (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	1661 (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	1662 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	1663 \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	1664 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	1665
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1666
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1667 \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	1668
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1669 \begin{itemize}
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-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	1671 \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	1672 a \samp{>>>~} prompt
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1673 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1674
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1675 \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	1676 \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	1677 \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	1678 \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	1679 \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	1680 \end{itemize}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1681
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1682 \index{indentation}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1685 \subsection{Syntax colors}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1686
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1687 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	1688 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	1689 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	1690
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1691 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1692 \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	1693
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1694 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1695 \item[Keywords] orange
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1696 \item[Strings ] green
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1697 \item[Comments] red
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1698 \item[Definitions] blue
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1699 \end{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1700
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1701 \item[Shell colors:]
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1702 \begin{description}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1703 \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	1704 \item[stdout] blue
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1705 \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	1706 \item[stdin] black
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 \end{description}
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
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1711 \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	1712
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1713 \begin{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1714 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	1715
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1716 -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	1717 -d enable debugger
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1718 -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	1719 -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	1720 -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	1721 \end{verbatim}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1722
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1723 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	1724
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1725 \begin{enumerate}
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1726 \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	1727 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	1728 IDLE itself.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1729
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1730 \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	1731 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	1732 to \code{'-c'}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1733
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1734 \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	1735 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	1736 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	1737 \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	1738 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	1739 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	1740 \code{sys.argv}.
4b9e63cf02a6 Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter Fred Drake <fdrake@acm.org> parents: diff changeset	1741 \end{enumerate}
20994 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
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1744 \section{Other Graphical User Interface Packages
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1745 \label{other-gui-packages}}
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
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1748 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	1749
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1750 \begin{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1751 \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	1752 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	1753 \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	1754 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	1755 foundation. These megawidgets include notebooks, comboboxes, selection
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1756 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	1757 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	1758 and vector commands are be available.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1759
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1760 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	1761 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	1762 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	1763 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	1764 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	1765 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	1766 }
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1767 \seetitle[http://tkinter.effbot.org]{Tkinter3000}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1768 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	1769 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	1770 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	1771 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	1772 still in the early stages.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1773 }
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1774 \end{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1775
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1776
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	1777 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	1778 most commonly used one.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1779
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1780 \begin{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1781 \seetitle[http://www.wxwindows.org]{wxWindows}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1782 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	1783 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	1784 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	1785 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	1786 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	1787 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	1788
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1789 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	1790 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	1791 specialized widgets, extensive documentation, and printing capabilities.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1792 }
23596 c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1793 \seetitle[]{PyQt}{
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1794 PyQt is a \program{sip}-wrapped binding to the Qt toolkit. Qt is an
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1795 extensive \Cpp{} GUI toolkit that is available for \UNIX, Windows and
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1796 Mac OS X. \program{sip} is a tool for generating bindings for \Cpp{}
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1797 libraries as Python classes, and is specifically designed for Python.
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1798 An online manual is available at
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1799 \url{http://www.opendocspublishing.com/pyqt/} (errata are located at
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1800 \url{http://www.valdyas.org/python/book.html}).
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1801 }
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1802 \seetitle[http://www.riverbankcomputing.co.uk/pykde/index.php]{PyKDE}{
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1803 PyKDE is a \program{sip}-wrapped interface to the KDE desktop
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1804 libraries. KDE is a desktop environment for \UNIX{} computers; the
c2bc2ed145f7 Update links and information on PyQt/PyKDE. Fred Drake <fdrake@acm.org> parents: 21640 diff changeset	1805 graphical components are based on Qt.
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1806 }
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1807 \seetitle[http://fxpy.sourceforge.net/]{FXPy}{
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1808 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	1809 \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	1810 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	1811 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	1812 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	1813 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	1814 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	1815 features such as status line help, and tooltips.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1816
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1817 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	1818 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	1819 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	1820 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	1821 }
25751 9bd2f9792efb Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25197 diff changeset	1822 \seetitle[http://www.daa.com.au/\textasciitilde james/pygtk/]{PyGTK}{
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1823 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	1824 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	1825 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	1826 reference counting that you would have to do normally with the C
25751 9bd2f9792efb Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25197 diff changeset	1827 API. There are also
9bd2f9792efb Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25197 diff changeset	1828 \ulink{bindings}{http://www.daa.com.au/\textasciitilde james/gnome/}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1829 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	1830 \ulink{tutorial}
25751 9bd2f9792efb Fix tildes in URLs. Closes SF bug #614821. Fred Drake <fdrake@acm.org> parents: 25197 diff changeset	1831 {http://laguna.fmedic.unam.mx/\textasciitilde daniel/pygtutorial/pygtutorial/index.html}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1832 is available.
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1833 }
21117 cf7970334041 Change the chapter title to reflect the Tk affinity. Fred Drake <fdrake@acm.org> parents: 21109 diff changeset	1834 \end{seealso*}
20994 09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1835
09244c46830f Switched a couple of sections around. Fred Drake <fdrake@acm.org> parents: 20980 diff changeset	1836 % XXX Reference URLs that compare the different UI packages

Mercurial > cpython-lru_cache-weakref

annotate Doc/lib/tkinter.tex @ 25838:8540887bcec6 2.2