Issue #5170: Fixed regression caused when fixing #5768.
[python.git] / Doc / library / tk.rst
blobf04c3ec3926f58e507ef0922bf00cca04631997e
1 .. _tkinter:
3 *********************************
4 Graphical User Interfaces with Tk
5 *********************************
7 .. index::
8    single: GUI
9    single: Graphical User Interface
10    single: Tkinter
11    single: Tk
13 Tk/Tcl has long been an integral part of Python.  It provides a robust and
14 platform independent windowing toolkit, that is available to Python programmers
15 using the :mod:`Tkinter` module, and its extensions, the :mod:`Tix` and
16 the :mod:`ttk` modules.
18 The :mod:`Tkinter` module is a thin object-oriented layer on top of Tcl/Tk. To
19 use :mod:`Tkinter`, you don't need to write Tcl code, but you will need to
20 consult the Tk documentation, and occasionally the Tcl documentation.
21 :mod:`Tkinter` is a set of wrappers that implement the Tk widgets as Python
22 classes.  In addition, the internal module :mod:`_tkinter` provides a threadsafe
23 mechanism which allows Python and Tcl to interact.
25 :mod:`Tkinter`'s chief virtues are that it is fast, and that it usually comes
26 bundled with Python. Although its standard documentation is weak, good
27 material is available, which includes: references, tutorials, a book and
28 others. :mod:`Tkinter` is also famous for having an outdated look and feel,
29 which has been vastly improved in Tk 8.5. Nevertheless, there are many other
30 GUI libraries that you could be interested in. For more information about
31 alternatives, see the :ref:`other-gui-packages` section.
33 .. toctree::
35    tkinter.rst
36    ttk.rst
37    tix.rst
38    scrolledtext.rst
39    turtle.rst
40    idle.rst
41    othergui.rst
43 .. Other sections I have in mind are
44    Tkinter internals
45    Freezing Tkinter applications