@@ -67,23 +67,13 @@ installed, so you can read the Tcl/Tk documentation specific to that version.
67
67
Tkinter Modules
68
68
---------------
69
69
70
- Most of the time, :mod: `tkinter ` is all you really need, but a number of
71
- additional modules are available as well. The Tk interface is located in a
72
- binary module named :mod: `_tkinter `. This module contains the low-level
73
- interface to Tk, and should never be used directly by application programmers.
74
- It is usually a shared library (or DLL), but might in some cases be statically
75
- linked with the Python interpreter.
76
-
77
- In addition to the Tk interface module, :mod: `tkinter ` includes a number of
78
- Python modules, :mod: `tkinter.constants ` being one of the most important.
79
- Importing :mod: `tkinter ` will automatically import :mod: `tkinter.constants `,
80
- so, usually, to use Tkinter all you need is a simple import statement::
70
+ Support for Tkinter is spread across several modules. Most applications will need the
71
+ main :mod: `tkinter ` module, as well as the :mod: `tkinter.ttk ` module, which provides
72
+ the modern themed widget set and API::
81
73
82
- import tkinter
83
-
84
- Or, more often::
85
74
86
75
from tkinter import *
76
+ from tkinter import ttk
87
77
88
78
89
79
.. class :: Tk(screenName=None, baseName=None, className='Tk', useTk=1)
@@ -106,7 +96,10 @@ Or, more often::
106
96
subsystem initialized) by calling its :meth: `loadtk ` method.
107
97
108
98
109
- Other modules that provide Tk support include:
99
+ The modules that provide Tk support include:
100
+
101
+ :mod: `tkinter `
102
+ Main Tkinter module.
110
103
111
104
:mod: `tkinter.colorchooser `
112
105
Dialog to let the user choose a color.
@@ -129,9 +122,35 @@ Other modules that provide Tk support include:
129
122
:mod: `tkinter.simpledialog `
130
123
Basic dialogs and convenience functions.
131
124
125
+ :mod: `tkinter.ttk `
126
+ Themed widget set introduced in Tk 8.5, providing modern alternatives
127
+ for many of the classic widgets in the main :mod: `tkinter ` module.
128
+
129
+ Additional modules:
130
+
131
+ :mod: `_tkinter `
132
+ A binary module that contains the low-level interface to Tcl/Tk.
133
+ It is automatically imported by the main :mod: `tkinter ` module,
134
+ and should never be used directly by application programmers.
135
+ It is usually a shared library (or DLL), but might in some cases be
136
+ statically linked with the Python interpreter.
137
+
138
+ :mod: `idlelib `
139
+ Python's Integrated Development and Learning Environment (IDLE). Based
140
+ on :mod: `tkinter `.
141
+
142
+ :mod: `tkinter.constants `
143
+ Symbolic constants that can be used in place of strings when passing
144
+ various parameters to Tkinter calls. Automatically imported by the
145
+ main :mod: `tkinter ` module.
146
+
132
147
:mod: `tkinter.dnd `
133
- Drag-and-drop support for :mod: `tkinter `. This is experimental and should
134
- become deprecated when it is replaced with the Tk DND.
148
+ (experimental) Drag-and-drop support for :mod: `tkinter `. This will
149
+ become deprecated when it is replaced with the Tk DND.
150
+
151
+ :mod: `tkinter.tix `
152
+ (deprecated) An older third-party Tcl/Tk package that adds several new
153
+ widgets. Better alternatives for most can be found in :mod: `tkinter.ttk `.
135
154
136
155
:mod: `turtle `
137
156
Turtle graphics in a Tk window.
0 commit comments