FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

[3.10] bpo-42560: reorganize Tkinter docs modules section for clarity (GH-27840) by miss-islington · Pull Request #27894 · python/cpython · GitHub

  1. python
  2. cpython

Repository navigation

[3.10] bpo-42560: reorganize Tkinter docs modules section for clarity (GH-27840) #27894

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
miss-islington merged 1 commit into from
Aug 22, 2021
Conversation 4 Commits 1 Checks 0 Files changed
Merged

[3.10] bpo-42560: reorganize Tkinter docs modules section for clarity (GH-27840) #27894

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension .rst  (1) All 1 file type selected
Viewed files
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Unified
Split
Hide whitespace
Diff view
Unified
Split
Hide whitespace
53 changes: 36 additions & 17 deletions Doc/library/tkinter.rst
Show comments
View file
Open in desktop
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Show hidden characters
Original file line number Diff line number Diff line change
Expand Up @@ -119,23 +119,13 @@ Tix
Tkinter Modules
---------------

Most of the time, :mod:`tkinter` is all you really need, but a number of
additional modules are available as well. The Tk interface is located in a
binary module named :mod:`_tkinter`. This module contains the low-level
interface to Tk, and should never be used directly by application programmers.
It is usually a shared library (or DLL), but might in some cases be statically
linked with the Python interpreter.

In addition to the Tk interface module, :mod:`tkinter` includes a number of
Python modules, :mod:`tkinter.constants` being one of the most important.
Importing :mod:`tkinter` will automatically import :mod:`tkinter.constants`,
so, usually, to use Tkinter all you need is a simple import statement::
Support for Tkinter is spread across several modules. Most applications will need the
main :mod:`tkinter` module, as well as the :mod:`tkinter.ttk` module, which provides
the modern themed widget set and API::

import tkinter

Or, more often::

from tkinter import *
from tkinter import ttk


.. class:: Tk(screenName=None, baseName=None, className='Tk', useTk=1)
Expand All @@ -158,7 +148,10 @@ Or, more often::
subsystem initialized) by calling its :meth:`loadtk` method.


Other modules that provide Tk support include:
The modules that provide Tk support include:

:mod:`tkinter`
Main Tkinter module.

:mod:`tkinter.colorchooser`
Dialog to let the user choose a color.
Expand All @@ -181,9 +174,35 @@ Other modules that provide Tk support include:
:mod:`tkinter.simpledialog`
Basic dialogs and convenience functions.

:mod:`tkinter.ttk`
Themed widget set introduced in Tk 8.5, providing modern alternatives
for many of the classic widgets in the main :mod:`tkinter` module.

Additional modules:

:mod:`_tkinter`
A binary module that contains the low-level interface to Tcl/Tk.
It is automatically imported by the main :mod:`tkinter` module,
and should never be used directly by application programmers.
It is usually a shared library (or DLL), but might in some cases be
statically linked with the Python interpreter.

:mod:`idlelib`
Python's Integrated Development and Learning Environment (IDLE). Based
on :mod:`tkinter`.

:mod:`tkinter.constants`
Symbolic constants that can be used in place of strings when passing
various parameters to Tkinter calls. Automatically imported by the
main :mod:`tkinter` module.

:mod:`tkinter.dnd`
Drag-and-drop support for :mod:`tkinter`. This is experimental and should
become deprecated when it is replaced with the Tk DND.
(experimental) Drag-and-drop support for :mod:`tkinter`. This will
become deprecated when it is replaced with the Tk DND.

:mod:`tkinter.tix`
(deprecated) An older third-party Tcl/Tk package that adds several new
widgets. Better alternatives for most can be found in :mod:`tkinter.ttk`.

:mod:`turtle`
Turtle graphics in a Tk window.
Expand Down
Back | FazBrowse Home | New Git URL