tkinter.md

1> **Источник:** https://python-all.ru/3.13/library/tkinter.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `tkinter` – интерфейс Python к Tcl/Tk89**Исходный код:** [Lib/tkinter/\_\_init\_\_.py](https://python-all.ru/src/3.13/Lib/tkinter/__init__.py)1011---1213Пакет `tkinter` («Tk interface») – это стандартный интерфейс Python к набору инструментов GUI Tcl/Tk. Как Tk, так и `tkinter` доступны на большинстве Unix-платформ, включая macOS, а также в Windows.1415Запуск `python -m tkinter` из командной строки должен открыть окно, демонстрирующее простой интерфейс Tk, показывая, что `tkinter` корректно установлен в системе, а также отображая версию Tcl/Tk, чтобы можно было прочитать документацию Tcl/Tk, соответствующую этой версии.1617Tkinter поддерживает ряд версий Tcl/Tk, собранных как с поддержкой потоков, так и без неё. Минимальная поддерживаемая версия – Tcl/Tk 8.5.12; официальный бинарный релиз Python поставляется с Tcl/Tk 8.6. За информацией о поддерживаемых версиях обратитесь к исходному коду модуля [`_tkinter`](https://python-all.ru/3.13/library/tkinter.html#module-_tkinter).1819Изменено в версии 3.11: Поддержка версий Tcl/Tk старше 8.5.12 удалена.2021Tkinter – не тонкая обёртка; он добавляет значительную долю собственной логики, чтобы сделать работу более питоничной. Данная документация сосредоточена на этих дополнениях и изменениях, а за неизменными деталями отсылает к официальной документации Tcl/Tk.2223> **Примечание**24>25> Tcl/Tk 8.5 (2007) представил современный набор тематических компонентов пользовательского интерфейса вместе с новым API для их использования. Как старый, так и новый API всё ещё доступны. Большинство онлайн-документации всё ещё использует старый API и может быть безнадёжно устаревшей.2627> **См. также**28>29> - **[TkDocs](https://python-all.ru/3.13/library/tkinter.html)**30>31>   Обширное руководство по созданию пользовательских интерфейсов с помощью Tkinter. Объясняет ключевые концепции и иллюстрирует рекомендуемые подходы с использованием современного API.32> - **[Справочник по Tkinter 8.5: GUI для Python](https://python-all.ru/3.13/library/tkinter.html)**33>34>   Справочная документация по Tkinter 8.5 с подробным описанием доступных классов, методов и опций.35>36> Ресурсы по Tcl/Tk:37>38> - **[Команды Tk](https://python-all.ru/3.13/library/tkinter.html)**39>40>   Исчерпывающий справочник по каждой из базовых команд Tcl/Tk, используемых Tkinter.41> - **[Домашняя страница Tcl/Tk](https://python-all.ru/3.13/library/tkinter.html)**42>43>   Дополнительная документация и ссылки на разработку ядра Tcl/Tk.44>45> Книги:46>47> - **[Современный Tkinter для занятых разработчиков Python](https://python-all.ru/3.13/library/tkinter.html)**48>49>   Автор: Mark Roseman. (ISBN 978-1999149567)50> - **[Программирование GUI на Python с помощью Tkinter](https://python-all.ru/3.13/library/tkinter.html)**51>52>   Автор: Alan D. Moore. (ISBN 978-1788835886)53> - **[Программирование на Python](https://python-all.ru/3.13/library/tkinter.html)**54>55>   Автор: Mark Lutz; отличное освещение Tkinter. (ISBN 978-0596158101)56> - **[Tcl и инструментарий Tk (2-е издание)](https://python-all.ru/3.13/library/tkinter.html)**57>58>   Авторы: John Ousterhout, изобретатель Tcl/Tk, и Ken Jones; Tkinter не рассматривается. (ISBN 978-0321336330)5960## Архитектура6162Tcl/Tk – это не одна библиотека, а набор из нескольких отдельных модулей, каждый со своей функциональностью и собственной официальной документацией. Бинарные дистрибутивы Python также включают дополнительный модуль.6364**Tcl**6566Tcl – это динамический интерпретируемый язык программирования, так же как Python. Хотя его можно использовать самостоятельно как язык общего назначения, чаще всего он встраивается в C-приложения в качестве скриптового движка или интерфейса к набору инструментов Tk. Библиотека Tcl имеет C-интерфейс для создания и управления одним или несколькими экземплярами интерпретатора Tcl, выполнения команд и сценариев Tcl в этих экземплярах, а также добавления пользовательских команд, реализованных на Tcl или C. Каждый интерпретатор имеет очередь событий, и существуют средства для отправки событий в неё и их обработки. В отличие от Python, модель выполнения Tcl построена на кооперативной многозадачности, и Tkinter устраняет это различие (подробнее см. [модель потоков](https://python-all.ru/3.13/library/tkinter.html#threading-model)).6768**Tk**6970Tk – это [пакет Tcl](https://python-all.ru/3.13/library/tkinter.html), реализованный на C, который добавляет пользовательские команды для создания и управления GUI-виджетами. Каждый объект [`Tk`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk) содержит собственный экземпляр интерпретатора Tcl с загруженным Tk. Виджеты Tk очень настраиваемы, хотя и ценой устаревшего внешнего вида. Tk использует очередь событий Tcl для генерации и обработки событий GUI.7172**Ttk**7374Themed Tk (Ttk) – это новое семейство виджетов Tk, которое обеспечивает гораздо лучший внешний вид на разных платформах по сравнению со многими классическими виджетами Tk. Ttk распространяется как часть Tk, начиная с версии Tk 8.5. Привязки для Python предоставляются в отдельном модуле [`tkinter.ttk`](https://python-all.ru/3.13/library/tkinter.ttk.html#module-tkinter.ttk).7576Внутри Tk и Ttk используют возможности нижележащей операционной системы: Xlib на Unix/X11, Cocoa на macOS, GDI на Windows.7778Когда ваше Python-приложение использует класс в Tkinter, например, для создания виджета, модуль `tkinter` сначала собирает строку команды Tcl/Tk. Он передаёт эту строку команды Tcl внутреннему двоичному модулю [`_tkinter`](https://python-all.ru/3.13/library/tkinter.html#module-_tkinter), который затем вызывает интерпретатор Tcl для её выполнения. Интерпретатор Tcl, в свою очередь, обращается к пакетам Tk и/или Ttk, которые затем вызывают Xlib, Cocoa или GDI.7980## Модули Tkinter8182Поддержка Tkinter распределена по нескольким модулям. Большинству приложений понадобится основной модуль `tkinter`, а также модуль [`tkinter.ttk`](https://python-all.ru/3.13/library/tkinter.ttk.html#module-tkinter.ttk), предоставляющий современный набор тематических виджетов и API:8384```python85from tkinter import *86from tkinter import ttk87```8889Модули, обеспечивающие поддержку Tk, включают:9091**`tkinter`**9293Основной модуль Tkinter.9495**[`tkinter.colorchooser`](https://python-all.ru/3.13/library/tkinter.colorchooser.html#module-tkinter.colorchooser)**9697Диалоговое окно для выбора цвета пользователем.9899**[`tkinter.commondialog`](https://python-all.ru/3.13/library/dialog.html#module-tkinter.commondialog)**100101Базовый класс для диалогов, определённых в других перечисленных здесь модулях.102103**[`tkinter.filedialog`](https://python-all.ru/3.13/library/dialog.html#module-tkinter.filedialog)**104105Стандартные диалоги для указания файла для открытия или сохранения.106107**[`tkinter.font`](https://python-all.ru/3.13/library/tkinter.font.html#module-tkinter.font)**108109Утилиты для работы со шрифтами.110111**[`tkinter.messagebox`](https://python-all.ru/3.13/library/tkinter.messagebox.html#module-tkinter.messagebox)**112113Доступ к стандартным диалоговым окнам Tk.114115**[`tkinter.scrolledtext`](https://python-all.ru/3.13/library/tkinter.scrolledtext.html#module-tkinter.scrolledtext)**116117Текстовый виджет со встроенной вертикальной полосой прокрутки.118119**[`tkinter.simpledialog`](https://python-all.ru/3.13/library/dialog.html#module-tkinter.simpledialog)**120121Базовые диалоги и вспомогательные функции.122123**[`tkinter.ttk`](https://python-all.ru/3.13/library/tkinter.ttk.html#module-tkinter.ttk)**124125Набор тематических виджетов, представленный в Tk 8.5, предоставляющий современные альтернативы многим классическим виджетам из основного модуля `tkinter`.126127Дополнительные модули:128129**[`_tkinter`](https://python-all.ru/3.13/library/tkinter.html#module-_tkinter)**130131Двоичный модуль, содержащий низкоуровневый интерфейс к Tcl/Tk. Он автоматически импортируется основным модулем `tkinter` и никогда не должен использоваться напрямую программистами приложений. Обычно это разделяемая библиотека (или DLL), но в некоторых случаях может быть статически слинкована с интерпретатором Python.132133**[`idlelib`](https://python-all.ru/3.13/library/idle.html#module-idlelib)**134135Интегрированная среда разработки и обучения Python (IDLE). Основана на `tkinter`.136137**`tkinter.constants`**138139Символические константы, которые можно использовать вместо строк при передаче различных параметров вызовам Tkinter. Автоматически импортируются основным модулем `tkinter`.140141**[`tkinter.dnd`](https://python-all.ru/3.13/library/tkinter.dnd.html#module-tkinter.dnd)**142143(экспериментально) Поддержка перетаскивания для `tkinter`. Станет устаревшим, когда будет заменён на Tk DND.144145**[`turtle`](https://python-all.ru/3.13/library/turtle.html#module-turtle)**146147Черепашья графика в окне Tk.148149## Краткое руководство по Tkinter150151Этот раздел не задумывался как исчерпывающее руководство по Tk или Tkinter. Для этого обратитесь к одному из внешних ресурсов, упомянутых ранее. Вместо этого данный раздел даёт очень краткое представление о том, как выглядит приложение Tkinter, знакомит с основными концепциями Tk и объясняет структуру обёртки Tkinter.152153Оставшаяся часть этого раздела поможет вам определить классы, методы и параметры, которые понадобятся в вашем приложении Tkinter, а также где найти более подробную документацию по ним, включая официальное справочное руководство Tcl/Tk.154155### Программа «Hello World»156157Начнём с разбора приложения «Hello World» на Tkinter. Это не самая минимальная версия, которую можно написать, но в ней достаточно деталей, чтобы проиллюстрировать некоторые ключевые концепции, которые необходимо знать.158159```python160from tkinter import *161from tkinter import ttk162root = Tk()163frm = ttk.Frame(root, padding=10)164frm.grid()165ttk.Label(frm, text="Hello World!").grid(column=0, row=0)166ttk.Button(frm, text="Quit", command=root.destroy).grid(column=1, row=0)167root.mainloop()168```169170После импортов следующая строка создаёт экземпляр класса [`Tk`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk), который инициализирует Tk и создаёт связанный с ним интерпретатор Tcl. Она также создаёт главное окно, известное как корневое окно, которое служит основным окном приложения.171172Следующая строка создаёт виджет Frame, который в данном случае будет содержать метку и кнопку, которые мы создадим далее. Frame помещается внутрь корневого окна.173174Следующая строка создаёт виджет Label с текстовой строкой. Метод [`grid()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.grid) используется для указания относительного расположения (позиции) метки внутри содержащего её виджета Frame, аналогично тому, как работают таблицы в HTML.175176Затем создаётся виджет Button, который размещается справа от метки. При нажатии он вызывает метод [`destroy()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.destroy) корневого окна.177178Наконец, метод [`mainloop()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.mainloop) выводит всё на экран и реагирует на ввод пользователя до завершения программы.179180### Важные концепции Tk181182Даже эта простая программа иллюстрирует следующие ключевые концепции Tk:183184**виджеты**185186Пользовательский интерфейс Tkinter состоит из отдельных *виджетов*. Каждый виджет представлен объектом Python, создаваемым из классов, таких как [`ttk.Frame`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Frame), [`ttk.Label`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Label) и [`ttk.Button`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Button).187188**иерархия виджетов**189190Виджеты организованы в *иерархию*. Метка и кнопка были размещены внутри фрейма, который, в свою очередь, находился внутри корневого окна. При создании каждого *дочернего* виджета его *родительский* виджет передаётся первым аргументом конструктору виджета.191192**параметры конфигурации**193194Виджеты имеют *параметры конфигурации*, которые изменяют их внешний вид и поведение, например текст, отображаемый в метке или кнопке. Разные классы виджетов имеют разные наборы параметров.195196**управление геометрией**197198Виджеты не добавляются в интерфейс автоматически при их создании. *Менеджер геометрии*, такой как `grid`, управляет тем, где они размещаются в интерфейсе.199200**цикл событий**201202Tkinter реагирует на ввод пользователя, изменения в программе и даже обновляет экран только при активном выполнении *цикла событий*. Если программа не выполняет цикл событий, интерфейс не будет обновляться.203204### Понимание того, как Tkinter оборачивает Tcl/Tk205206Когда ваше приложение использует классы и методы Tkinter, внутри Tkinter собирает строки, представляющие команды Tcl/Tk, и выполняет их в интерпретаторе Tcl, прикреплённом к экземпляру [`Tk`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk) вашего приложения.207208Будь то попытка разобраться в справочной документации, поиск нужного метода или параметра, адаптация существующего кода или отладка приложения Tkinter, бывают моменты, когда полезно понимать, как выглядят эти базовые команды Tcl/Tk.209210Для иллюстрации ниже приведён эквивалент на Tcl/Tk основной части скрипта Tkinter, показанного выше.211212```python213ttk::frame .frm -padding 10214grid .frm215grid [ttk::label .frm.lbl -text "Hello World!"] -column 0 -row 0216grid [ttk::button .frm.btn -text "Quit" -command "destroy ."] -column 1 -row 0217```218219Синтаксис Tcl похож на многие оболочки: первое слово – это команда, за которой следуют её аргументы, разделённые пробелами. Не вдаваясь в подробности, обратите внимание на следующее:220221- Команды для создания виджетов (например, `ttk::frame`) соответствуют классам виджетов в Tkinter.222- Параметры виджетов Tcl (например, `-text`) соответствуют именованным аргументам в Tkinter.223- В Tcl виджеты идентифицируются по *пути* (например, `.frm.btn`), тогда как Tkinter использует не имена, а ссылки на объекты.224- Положение виджета в иерархии закодировано в его (иерархическом) пути, который использует `.` (точку) в качестве разделителя. Путь корневого окна – это просто `.` (точка). В Tkinter иерархия определяется не путём, а указанием родительского виджета при создании каждого дочернего виджета.225- Операции, которые реализованы как отдельные *команды* в Tcl (например, `grid` или `destroy`), представлены как *методы* объектов виджетов Tkinter. Как вы скоро увидите, в других случаях Tcl использует то, что выглядит как вызовы методов объектов виджетов, что более точно отражает подход Tkinter.226227### Как сделать…? Какой параметр…?228229Если вы не уверены, как сделать что-то в Tkinter, и не можете сразу найти это в используемом учебнике или справочной документации, есть несколько стратегий, которые могут помочь.230231Во-первых, помните, что детали работы отдельных виджетов могут различаться в разных версиях как Tkinter, так и Tcl/Tk. При поиске документации убедитесь, что она соответствует версиям Python и Tcl/Tk, установленным в вашей системе.232233При поиске способа использования API полезно знать точное имя класса, параметра или метода, которые вы используете. Интроспекция, будь то в интерактивной оболочке Python или с помощью [`print()`](https://python-all.ru/3.13/library/functions.html#print), может помочь определить, что вам нужно.234235Чтобы узнать, какие параметры конфигурации доступны для любого виджета, вызовите его метод [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.configure), который возвращает словарь с различной информацией о каждом объекте, включая его значения по умолчанию и текущие значения. Используйте [`keys()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.keys), чтобы получить только имена каждого параметра.236237```python238btn = ttk.Button(frm, ...)239print(btn.configure().keys())240```241242Поскольку большинство виджетов имеют много общих параметров конфигурации, может быть полезно выяснить, какие из них специфичны для конкретного класса виджетов. Один из способов – сравнить список параметров с аналогичным списком более простого виджета, например фрейма.243244```python245print(set(btn.configure().keys()) - set(frm.configure().keys()))246```247248Аналогично, можно найти доступные методы объекта виджета с помощью стандартной функции [`dir()`](https://python-all.ru/3.13/library/functions.html#dir). Если попробовать, окажется, что существует более 200 общих методов виджетов, поэтому снова полезно определить методы, специфичные для класса виджета.249250```python251print(dir(btn))252print(set(dir(btn)) - set(dir(frm)))253```254255### Навигация по справочному руководству Tcl/Tk256257Как уже отмечалось, официальное справочное руководство по [командам Tk](https://python-all.ru/3.13/library/tkinter.html) (страницы man) часто является наиболее точным описанием того, что делают конкретные операции с виджетами. Даже если вы знаете имя нужного параметра или метода, вам всё равно может потребоваться поискать в нескольких местах.258259Хотя все операции в Tkinter реализованы как вызовы методов объектов виджетов, многие операции Tcl/Tk представлены в виде команд, которые принимают путь к виджету в качестве первого параметра, за которым следуют необязательные параметры, например260261```python262destroy .263grid .frm.btn -column 0 -row 0264```265266Другие же больше похожи на методы, вызываемые для объекта виджета (на самом деле, при создании виджета в Tcl/Tk создаётся команда Tcl с именем пути к виджету, первым параметром которой является имя вызываемого метода).267268```python269.frm.btn invoke270.frm.lbl configure -text "Goodbye"271```272273В официальной справочной документации Tcl/Tk большинство операций, похожих на вызовы методов, можно найти на man-странице конкретного виджета (например, метод [`invoke()`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Button.invoke) есть на man-странице [ttk::button](https://python-all.ru/3.13/library/tkinter.html)), тогда как функции, принимающие виджет в качестве параметра, часто имеют собственную man-страницу (например, [grid](https://python-all.ru/3.13/library/tkinter.html)).274275Многие общие параметры и методы можно найти на man-страницах [options](https://python-all.ru/3.13/library/tkinter.html) или [ttk::widget](https://python-all.ru/3.13/library/tkinter.html), тогда как остальные находятся на man-странице конкретного класса виджета.276277Многие методы Tkinter имеют составные имена, например, [`winfo_x()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_x), [`winfo_height()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_height), [`winfo_viewable()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_viewable). Документацию по всем ним можно найти на man-странице [winfo](https://python-all.ru/3.13/library/tkinter.html).278279> **Примечание**280>281> Несколько сбивает с толку то, что у всех виджетов Tkinter есть методы, которые на самом деле не работают с виджетом, а действуют на глобальном уровне, независимо от какого-либо виджета. Примерами являются методы для доступа к буферу обмена или системному звонку. (Они реализованы как методы в базовом классе [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget), от которого наследуют все виджеты Tkinter).282283## Модель многопоточности284285Python и Tcl/Tk имеют очень разные модели многопоточности, которые `tkinter` пытается согласовать. При использовании потоков следует учитывать это.286287Интерпретатор Python может иметь множество связанных с ним потоков. В Tcl можно создавать несколько потоков, но каждый поток имеет отдельный экземпляр интерпретатора Tcl. Потоки также могут создавать более одного экземпляра интерпретатора, но каждый экземпляр может использоваться только тем потоком, который его создал.288289Каждый объект [`Tk`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk), созданный `tkinter`, содержит интерпретатор Tcl. Он также отслеживает, какой поток создал этот интерпретатор. Вызовы `tkinter` могут производиться из любого потока Python. Внутренне, если вызов поступает из потока, отличного от создавшего объект `Tk`, в очередь событий интерпретатора помещается событие, и при его выполнении результат возвращается вызывающему потоку Python.290291Приложения Tcl/Tk обычно управляются событиями, то есть после инициализации интерпретатор запускает цикл событий (то есть [`Tk.mainloop`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.mainloop)) и реагирует на события. Поскольку он однопоточный, обработчики событий должны отвечать быстро, иначе они заблокируют обработку других событий. Чтобы избежать этого, длительные вычисления не должны выполняться в обработчике событий; их либо разбивают на более мелкие части с помощью таймеров, либо запускают в другом потоке. Это отличается от многих наборов инструментов для графического интерфейса, где графический интерфейс работает в полностью отдельном потоке от всего кода приложения, включая обработчики событий.292293Если интерпретатор Tcl не выполняет цикл событий и не обрабатывает события, любые вызовы `tkinter` из потоков, отличных от того, в котором работает интерпретатор Tcl, завершатся ошибкой.294295Существует ряд особых случаев:296297- Библиотеки Tcl/Tk, собранные без поддержки потоков, сейчас редки: встроенный Tcl/Tk 8.6 собран с поддержкой потоков, поэтому этот случай возникает только с некоторыми старыми сборками без поддержки потоков. Когда библиотека не учитывает потоки, `tkinter` вызывает библиотеку из исходного потока Python, даже если он отличается от потока, создавшего интерпретатор Tcl. Глобальная блокировка гарантирует, что за один раз происходит только один вызов.298- Хотя `tkinter` позволяет создать более одного экземпляра объекта [`Tk`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk) (с собственным интерпретатором), все интерпретаторы, принадлежащие одному и тому же потоку, используют общую очередь событий, что быстро приводит к проблемам. На практике не следует создавать более одного экземпляра `Tk` одновременно. В противном случае лучше создавать их в отдельных потоках и убедиться, что используется сборка Tcl/Tk с поддержкой потоков.299- Блокирующие обработчики событий – не единственный способ помешать интерпретатору Tcl снова войти в цикл событий. Можно даже запускать несколько вложенных циклов событий или полностью отказаться от цикла событий. Если выполняются какие-либо нетривиальные действия с событиями или потоками, следует учитывать эти возможности.300- Существует несколько отдельных функций `tkinter`, которые в настоящее время работают только при вызове из потока, создавшего интерпретатор Tcl.301302## Удобный справочник303304### Настройка параметров305306Параметры управляют такими вещами, как цвет и ширина границы виджета. Параметры можно задать тремя способами:307308**При создании объекта – с помощью именованных аргументов**309310```python311fred = Button(self, fg="red", bg="blue")312```313314**После создания объекта – используя имя параметра как индекс словаря**315316```python317fred["fg"] = "red"318fred["bg"] = "blue"319```320321**Использовать метод config() для обновления нескольких атрибутов после создания объекта**322323```python324fred.config(fg="red", bg="blue")325```326327Полное объяснение конкретного параметра и его поведения можно найти на man-страницах Tk для соответствующего виджета.328329Обратите внимание, что man-страницы перечисляют «СТАНДАРТНЫЕ ПАРАМЕТРЫ» и «ПАРАМЕТРЫ, СПЕЦИФИЧНЫЕ ДЛЯ ВИДЖЕТА» для каждого виджета. Первое – список параметров, общих для многих виджетов, второе – параметры, свойственные конкретному виджету. Стандартные параметры задокументированы на man-странице *[options(3)](https://python-all.ru/3.13/library/tkinter.html)*.330331В этом документе не делается различий между стандартными и специфичными для виджета параметрами. Некоторые параметры не применимы к некоторым типам виджетов. Реагирует ли данный виджет на определённый параметр, зависит от класса виджета: кнопки имеют параметр `command`, а метки – нет.332333Параметры, поддерживаемые данным виджетом, перечислены на его man-странице, или их можно запросить во время выполнения, вызвав метод [`config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.config) без аргументов, или вызвав метод [`keys()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.keys) для этого виджета. Возвращаемое значение этих вызовов – словарь, ключом которого является имя параметра в виде строки (например, `'relief'`), а значениями – 5-кортежи.334335Некоторые параметры, например `bg`, являются синонимами распространённых параметров с длинными именами (`bg` – сокращение для «background»). При передаче методу `config()` имени сокращённого параметра будет возвращён 2-кортеж, а не 5-кортеж. Возвращаемый 2-кортеж содержит имя синонима и «реальный» параметр (например, `('bg', 'background')`).336337| Индекс | Значение | Пример |338| --- | --- | --- |339| 0 | имя параметра | `'relief'` |340| 1 | имя параметра для поиска в базе данных | `'relief'` |341| 2 | класс параметра для поиска в базе данных | `'Relief'` |342| 3 | значение по умолчанию | `'raised'` |343| 4 | текущее значение | `'groove'` |344345Пример:346347```python348>>> print(fred.config())349{'relief': ('relief', 'relief', 'Relief', 'raised', 'groove')}350```351352Разумеется, выведенный словарь будет содержать все доступные опции и их значения. Это приведено только в качестве примера.353354### Упаковщик355356Упаковщик – один из механизмов управления геометрией в Tk. Менеджеры геометрии используются для указания относительного расположения виджетов внутри их контейнера. В отличие от более громоздкого *разместителя* (который используется реже и не рассматривается здесь), упаковщик принимает качественные спецификации отношений – *выше*, *слева от*, *заполнение* и т. д. – и самостоятельно вычисляет точные координаты размещения.357358Размер любого контейнерного виджета определяется размером «дочерних виджетов» внутри него. Упаковщик используется для управления тем, где дочерние виджеты появляются внутри контейнера, в который они упаковываются. Виджеты можно упаковывать в рамки, а рамки – в другие рамки, чтобы добиться желаемого расположения. Кроме того, после упаковки расположение динамически корректируется при постепенных изменениях конфигурации.359360Обратите внимание, что виджеты не появляются, пока для них не будет указана геометрия с помощью менеджера геометрии. Распространённая ошибка новичков – пропустить указание геометрии, а затем удивляться, что виджет создан, но ничего не отображается. Виджет появится только после того, как к нему будет применён, например, метод [`pack()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.pack) упаковщика.361362Метод pack() можно вызывать с парами «ключевая опция/значение», которые управляют тем, где виджет будет располагаться внутри контейнера и как он будет вести себя при изменении размера главного окна приложения. Вот несколько примеров:363364```python365fred.pack()                     # по умолчанию side = "top"366fred.pack(side="left")367fred.pack(expand=1)368```369370### Опции упаковщика371372За более подробной информацией об упаковщике и его опциях обращайтесь к man-страницам и странице 183 книги Джона Оустерхаута.373374**привязка**375376Тип привязки. Указывает, где упаковщик должен размещать каждое содержимое в своём участке.377378**расширение**379380логическое значение, `0` или `1`.381382**заполнение**383384Допустимые значения: `'x'`, `'y'`, `'both'`, `'none'`.385386**ipadx и ipady**387388Расстояние, обозначающее внутренний отступ с каждой стороны содержимого.389390**padx и pady**391392Расстояние, обозначающее внешний отступ с каждой стороны содержимого.393394**сторона**395396Допустимые значения: `'left'`, `'right'`, `'top'`, `'bottom'`.397398### Связывание переменных виджетов399400Текущее значение некоторых виджетов (например, виджетов ввода текста) может быть напрямую связано с переменными приложения с помощью специальных опций. Эти опции: `variable`, `textvariable`, `onvalue`, `offvalue` и `value`. Такая связь работает в обе стороны: если переменная изменяется по какой-либо причине, связанный с ней виджет обновится, отображая новое значение.401402К сожалению, в текущей реализации `tkinter` невозможно передать виджету произвольную переменную Python через опцию `variable` или `textvariable`. Единственные переменные, с которыми это работает, – это переменные, являющиеся подклассами класса Variable, определённого в `tkinter`.403404Уже определено множество полезных подклассов Variable: [`StringVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.StringVar), [`IntVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.IntVar), [`DoubleVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.DoubleVar) и [`BooleanVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.BooleanVar). Чтобы прочитать текущее значение такой переменной, вызовите у неё метод [`get()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable.get), а чтобы изменить значение – метод `set()`. Если следовать этому протоколу, виджет будет всегда отслеживать значение переменной без дополнительных действий с вашей стороны.405406Сохраняйте ссылку на переменную всё время, пока виджет её использует, например, храня её в виде атрибута (см. [`Variable`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable)).407408Например:409410```python411import tkinter as tk412413class App(tk.Frame):414    def __init__(self, master):415        super().__init__(master)416        self.pack()417418        self.entrythingy = tk.Entry()419        self.entrythingy.pack()420421        # Создайте переменную приложения.422        self.contents = tk.StringVar()423        # Установите её в некоторое значение.424        self.contents.set("this is a variable")425        # Укажите виджету ввода отслеживать эту переменную.426        self.entrythingy["textvariable"] = self.contents427428        # Определите колбэк для события нажатия Return.429        # Он выводит текущее значение переменной.430        self.entrythingy.bind('<Key-Return>',431                             self.print_contents)432433    def print_contents(self, event):434        print("Hi. The current entry content is:",435              self.contents.get())436437root = tk.Tk()438myapp = App(root)439myapp.mainloop()440```441442### Менеджер окон443444В Tk есть служебная команда `wm` для взаимодействия с менеджером окон. Опции команды `wm` позволяют управлять такими вещами, как заголовки, расположение, значки и тому подобное. В `tkinter` эти команды реализованы как методы класса [`Wm`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm). Виджеты верхнего уровня являются подклассами класса `Wm`, поэтому могут напрямую вызывать методы `Wm`.445446Чтобы получить окно верхнего уровня, содержащее данный виджет, можно просто обратиться к [`master`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk.master) виджета. Конечно, если виджет был упакован внутри рамки, `master` не будет представлять окно верхнего уровня. Чтобы получить окно верхнего уровня, содержащее произвольный виджет, можно вызвать метод [`winfo_toplevel()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_toplevel). Также существует метод `_root()`; его имя начинается с подчёркивания, чтобы показать, что эта функция является частью реализации, а не интерфейсом к функциональности Tk. Он возвращает корневое окно приложения, а не ближайшее охватывающее окно верхнего уровня.447448Вот несколько примеров типичного использования:449450```python451import tkinter as tk452453class App(tk.Frame):454    def __init__(self, master=None):455        super().__init__(master)456        self.pack()457458# создайте приложение459myapp = App()460461#462# здесь вызовы методов класса оконного менеджера463#464myapp.master.title("My Do-Nothing Application")465myapp.master.maxsize(1000, 400)466467# запустите программу468myapp.mainloop()469```470471### Типы данных опций Tk472473**привязка**474475Допустимые значения – направления компаса: `"n"`, `"ne"`, `"e"`, `"se"`, `"s"`, `"sw"`, `"w"`, `"nw"`, а также `"center"`.476477**битовая карта**478479Существует десять встроенных именованных растровых изображений: `'error'`, `'gray12'`, `'gray25'`, `'gray50'`, `'gray75'`, `'hourglass'`, `'info'`, `'questhead'`, `'question'`, `'warning'`. Чтобы указать имя файла X bitmap, укажите полный путь к файлу с префиксом `@`, как в `"@/usr/contrib/bitmap/gumby.bit"`.480481**булевый**482483Можно передать целые числа 0 или 1 или строки `"yes"` или `"no"`.484485**колбэк**486487Это любая функция Python, которая не принимает аргументов. Например:488489```python490def print_it():491    print("hi there")492fred["command"] = print_it493```494495**цвет**496497Цвета можно задавать именами цветов X из файла rgb.txt или строками, представляющими значения RGB в 4-битном: `"#RGB"`, 8-битном: `"#RRGGBB"`, 12-битном: `"#RRRGGGBBB"` или 16-битном: `"#RRRRGGGGBBBB"` диапазонах, где R,G,B обозначают любую допустимую шестнадцатеричную цифру. Подробнее см. на стр. 160 книги Оустерхаута.498499**курсор**500501Имя курсора мыши, отображаемого при наведении указателя на виджет. Tk предоставляет портативный набор имён курсоров, доступных на всех платформах (например, `"arrow"`, `"watch"`, `"cross"` или `"hand2"`); также можно использовать стандартные имена X-курсоров из `cursorfont.h`, без префикса `XC_` (так `XC_hand2` становится `"hand2"`). Полный список имён, включая платформозависимые, приведён на странице *[cursors(3tk)](https://python-all.ru/3.13/library/tkinter.html)* руководства. Можно также указать собственные файлы растрового изображения и маски. В Windows можно напрямую использовать файл курсора (`.cur` или `.ani`), указав его путь с префиксом `@`, как в `"@C:/cursors/bart.ani"`.502503**расстояние**504505Экранные расстояния можно указывать в пикселях или абсолютных единицах. Пиксели задаются числами, а абсолютные расстояния – строками, где последний символ обозначает единицы: `c` для сантиметров, `i` для дюймов, `m` для миллиметров, `p` для типографских пунктов. Например, 3,5 дюйма записывается как `"3.5i"`.506507**шрифт**508509Tk использует описание шрифта, например `{courier 10 bold}`; в `tkinter` это наиболее естественно передавать как кортеж из `(family, size, *styles)` (или как эквивалентную строку `"Courier 10 bold"`). Положительные размеры шрифта измеряются в пунктах; отрицательные – в пикселях.510511**геометрия**512513Это строка вида `widthxheight`, где ширина и высота задаются в пикселях для большинства виджетов (в символах для виджетов, отображающих текст). Например: `fred["geometry"] = "200x100"`.514515**выравнивание**516517Допустимые значения – строки: `"left"`, `"center"` и `"right"`.518519**регион**520521Это строка из четырёх разделённых пробелами элементов, каждый из которых является допустимым расстоянием (см. выше). Например: `"2 3 4 5"`, `"3i 2i 4.5i 2i"` и `"3c 2c 4c 10.43c"` – все являются допустимыми областями.522523**рельеф**524525Определяет стиль рамки виджета. Допустимые значения: `"raised"`, `"sunken"`, `"flat"`, `"groove"`, `"ridge"` и `"solid"`.526527**команда прокрутки**528529Это почти всегда метод `set()` какого-либо виджета полосы прокрутки, но может быть любым методом виджета, принимающим один аргумент.530531**перенос**532533Должно быть одним из: `"none"`, `"char"` или `"word"`.534535### Привязки и события536537Метод bind из команды виджета позволяет отслеживать определённые события и вызывать функцию обратного вызова при наступлении события такого типа. Формат метода bind:538539```python540def bind(self, sequence, func, add=''):541```542543где:544545**последовательность**546547– это строка, обозначающая целевой тип события. Физические события используют форму `<modifier-modifier-type-detail>` (например, `"<Enter>"` или `"<Control-Button-1>"`); определённые приложением виртуальные события используют двойные угловые скобки, как в `"<<Paste>>"`. (Подробнее см. на странице *[bind(3tk)](https://python-all.ru/3.13/library/tkinter.html)* руководства и на стр. 201 книги Джона Оустерхаута *Tcl and the Tk Toolkit (2nd edition)*.)548549**функция**550551– это функция Python, принимающая один аргумент, которая вызывается при наступлении события. В качестве аргумента будет передан экземпляр Event. (Функции, используемые таким образом, обычно называются *колбэками*.)552553**добавить**554555является необязательным, может быть `''` или `'+'`. Передача пустой строки означает, что эта привязка заменяет любые другие привязки, связанные с этим событием. Передача `'+'` означает, что эта функция добавляется в список функций, привязанных к данному типу события.556557Например:558559```python560def turn_red(self, event):561    event.widget["activeforeground"] = "red"562563self.button.bind("<Enter>", self.turn_red)564```565566Обратите внимание, как поле widget объекта события используется в `turn_red()` колбэке. Это поле содержит виджет, который перехватил событие X. В следующей таблице перечислены другие поля событий, к которым можно обратиться, и как они обозначаются в Tk; это может пригодиться при обращении к страницам руководства Tk.567568| Tk | Поле события Tkinter | Tk | Поле события Tkinter |569| --- | --- | --- | --- |570| %f | фокус | %A | char |571| %h | рост | %E | send\_event |572| %k | keycode | %K | keysym |573| %s | состояние | %N | keysym\_num |574| %t | time | %T | type |575| %w | width | %W | widget |576| %x | x | %X | x\_root |577| %y | y | %Y | y\_root |578| %# | serial | %b | num |579| %d | detail | %D | delta |580581Параметр `add` выше влияет только на привязки, задаваемые вами. Каждый виджет также наследует *привязки класса*, реализующие его стандартное поведение – например, виджет [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text) привязывает `Control`-`t` для транспозиции двух символов. Они описаны в разделе привязок страницы руководства Tk для данного виджета (например, *[text(3tk)](https://python-all.ru/3.13/library/tkinter.html)* или *[entry(3tk)](https://python-all.ru/3.13/library/tkinter.html)*).582583Привязки класса обрабатываются отдельно от ваших собственных, поэтому привязка события самостоятельно не заменяет поведение по умолчанию; выполняются обе. Чтобы подавить нежелательную привязку по умолчанию, привяжите событие к виджету и верните строку `"break"` из вашего колбэка.584585### Параметр index586587Ряд виджетов требует передачи параметров «index». Они используются для указания на конкретное место в виджете Text, на определённые символы в виджете Entry или на конкретные пункты меню в виджете Menu.588589**Индексы виджета Entry (index, view index и т.д.)**590591Виджеты Entry имеют опции, относящиеся к позициям символов в отображаемом тексте. Для доступа к этим специальным точкам в текстовых виджетах можно использовать следующие функции `tkinter`:592593**Индексы виджета Text**594595Обозначение индексов для виджетов Text очень богатое и лучше всего описано на страницах руководства Tk.596597**Индексы меню (menu.invoke(), menu.entryconfig() и т.д.)**598599Некоторые опции и методы для меню работают с конкретными пунктами меню. Всякий раз, когда для опции или параметра требуется индекс меню, можно передать:600601- целое число, которое указывает на числовую позицию пункта в виджете, считая сверху, начиная с 0;602- строку `"active"`, которая указывает на позицию меню, находящуюся в данный момент под курсором;603- строку `"last"`, которая указывает на последний пункт меню;604- Целое число, перед которым стоит `@`, например `@6`, где целое число интерпретируется как координата y в пикселях в системе координат меню;605- строку `"none"`, которая указывает на отсутствие какого-либо пункта меню, чаще всего используется с menu.activate() для деактивации всех пунктов, и наконец,606- текстовую строку, которая сопоставляется с образцом с меткой пункта меню при сканировании сверху вниз. Обратите внимание, что этот тип индекса рассматривается после всех остальных, что означает, что совпадения для пунктов меню с метками `last`, `active` или `none` могут быть интерпретированы как указанные выше литералы.607608### Изображения609610Изображения разных форматов можно создать через соответствующий подкласс [`tkinter.Image`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Image):611612- [`BitmapImage`](https://python-all.ru/3.13/library/tkinter.html#tkinter.BitmapImage) для изображений в формате XBM.613- [`PhotoImage`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PhotoImage) для изображений в форматах PGM, PPM, GIF и PNG. Последний поддерживается начиная с Tk 8.6.614615Оба типа изображений создаются с помощью опции `file` или `data` (доступны и другие опции).616617Изменено в версии 3.13: Добавлен метод `PhotoImage` `copy_replace()` для копирования области из одного изображения в другое, возможно с масштабированием пикселей и/или субдискретизацией. Добавлен параметр *from\_coords* в методы `PhotoImage` `copy()`, `zoom()` и `subsample()`. Добавлены параметры *zoom* и *subsample* в метод `PhotoImage` `copy()`.618619Затем объект изображения можно использовать везде, где какой-либо виджет поддерживает опцию `image` (например, метки, кнопки, меню). В таких случаях Tk не хранит ссылку на изображение. Когда последняя ссылка Python на объект изображения удаляется, данные изображения также удаляются, и Tk будет отображать пустой прямоугольник там, где использовалось изображение.620621> **См. также**622>623> Пакет [Pillow](https://python-all.ru/3.13/library/tkinter.html) добавляет поддержку форматов BMP, JPEG, TIFF, WebP и других.624625## Ссылка626627В этом разделе описаны классы, методы, функции и константы модуля `tkinter`. Большинство из них являются обёртками команд Tcl/Tk; обращайтесь к официальной документации Tcl/Tk для полного списка опций виджетов и дополнительных сведений.628629#### `exception tkinter.TclError`630631Исключение, возникающее при сбое вызова интерпретатора Tcl, например, когда виджету передана неизвестная опция или недопустимое значение.632633### Базовые и примесные классы634635#### `class tkinter.Misc`636637Класс `Misc` – это примесь, наследуемая классом [`Tk`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk) и, через [`BaseWidget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.BaseWidget), каждым виджетом. Он предоставляет обширный набор методов, общих для всех объектов Tk: запрос информации об окне, управление привязками событий и циклом событий, управление фокусом клавиатуры и захватом указателя, доступ к выделению, буферу обмена и базе данных опций, а также различные служебные и интроспекционные сервисы. Поскольку они наследуются, эти методы доступны на каждом виджете и на объекте приложения `Tk`, и документированы здесь один раз, а не повторяются для каждого виджета.638639#### `cget(key)`640641Возвращает текущее значение опции конфигурации с именем *key* для данного виджета в виде строки. Выражение `widget[key]` эквивалентно и может использоваться вместо этого.642643#### `configure(cnf=None, **kw)`644645Запрашивает или изменяет опции конфигурации виджета. Без аргументов возвращает словарь, сопоставляющий каждому доступному имени опции кортеж с её описанием (имя, X ресурсное имя, X ресурсный класс, значение по умолчанию и текущее значение). Если указано одно имя опции в виде строки, возвращает кортеж только для этой опции. Если указаны одно или несколько ключевых аргументов, или передан словарь в качестве *cnf*, устанавливает каждую именованную опцию в соответствующее значение; выражение `widget[key] = value` устанавливает одну опцию таким же образом.646647[`config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.config) является псевдонимом `configure()`.648649#### `keys()`650651Возвращает список имён всех опций конфигурации данного виджета.652653#### `getboolean(s)`654655Интерпретирует строку *s* как логическое значение Tcl и возвращает соответствующее [`bool`](https://python-all.ru/3.13/library/functions.html#bool). Tcl принимает такие значения, как `'1'`, `'0'`, `'yes'`, `'no'`, `'true'` и `'false'`. Вызывает [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError), если *s* не является допустимым логическим значением.656657#### `getdouble(s)`658659Интерпретирует строку *s* как число с плавающей запятой Tcl и возвращает его в виде [`float`](https://python-all.ru/3.13/library/functions.html#float). Вызывает [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError), если *s* не является допустимым числом.660661Добавлено в версии 3.5.662663#### `getint(s)`664665Интерпретирует строку *s* как целое число Tcl и возвращает его как [`int`](https://python-all.ru/3.13/library/functions.html#int). Вызывает [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError), если *s* не является допустимым целым числом.666667#### `getvar(name)`668669Возвращает значение глобальной переменной Tcl с именем *name*.670671#### `setvar(name, value)`672673Устанавливает глобальную переменную Tcl с именем *name* в значение *value*.674675Методы `getvar()` и `setvar()` предоставляют прямой доступ к переменным Tcl. В большинстве кода вместо них используется подкласс [`Variable`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable), такой как [`StringVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.StringVar) или [`IntVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.IntVar), который оборачивает переменную Tcl и преобразует её значение в тип Python и обратно.676677#### `register(func, subst=None, needcleanup=1)`678679Регистрирует вызываемый объект Python *func* как команду Tcl и возвращает имя новой команды в виде строки. Всякий раз, когда Tcl вызывает эту команду, вызывается *func*; если указан *subst*, он сначала применяется к аргументам команды. Это механизм, используемый внутри для преобразования обратных вызовов Python в имена команд, передаваемые опциям Tk, таким как *command*. Если *needcleanup* не равно false, команда автоматически удаляется при уничтожении виджета.680681Изменено в версии 3.13: Аргументы, передаваемые в *func*, больше не преобразуются в строки.682683#### `deletecommand(name)`684685Удаляет Tcl-команду с именем *name*, например ту, что была возвращена ранее вызовом [`register()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.register).686687#### `nametowidget(name)`688689Возвращает экземпляр виджета, соответствующий Tk-пути *name*.690691#### `send(interp, cmd, *args)`692693Отправляет Tcl-команду *cmd* с переданными аргументами *args* интерпретатору Tcl, зарегистрированному под именем *interp*, и возвращает результат. Доступно не на всех платформах.694695#### `destroy()`696697Уничтожает данный виджет и все его дочерние виджеты, удаляя связанные с ними Tcl-команды.698699#### `tkraise(aboveThis=None)`700701Поднимает данный виджет в стеке порядка, чтобы он отображался поверх своих соседей. Если указан *aboveThis*, виджет перемещается непосредственно над этим элементом в стеке порядка.702703[`lift()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.lift) является псевдонимом `tkraise()`.704705#### `lower(belowThis=None)`706707Опускает данный виджет в стеке порядка, чтобы он отображался под своими соседями. Если указан *belowThis*, виджет перемещается непосредственно под этим элементом в стеке порядка.708709[`tkraise()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.tkraise)/[`lift()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.lift) и `lower()` переопределяются в виджете [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas), где они вместо этого переупорядочивают элементы canvas.710711#### `image_names()`712713Возвращает имена всех изображений, которые на данный момент существуют в интерпретаторе Tcl.714715Это переопределяется в виджете [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text), где `image_names()` вместо этого возвращает имена его встроенных изображений.716717#### `image_types()`718719Возвращает доступные типы изображений, такие как `'photo'` и `'bitmap'`.720721#### `grid_anchor(anchor=None)`722723Устанавливает привязку (anchor), которая определяет положение сетки внутри контейнера, когда контейнер больше сетки и ни одна строка или столбец не имеют ненулевого веса. *anchor* – одна из стандартных строк привязки, например `'nw'` (по умолчанию) или `'center'`. Вызов без аргументов не даёт эффекта.724725[`anchor()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.anchor) является псевдонимом `grid_anchor()`.726727Добавлено в версии 3.3.728729#### `grid_bbox(column=None, row=None, col2=None, row2=None)`730731Возвращает ограничивающий прямоугольник (в пикселях) области сетки, размещённой внутри данного контейнера, в виде кортежа из 4 элементов `(xoffset, yoffset, width, height)`. Без аргументов возвращается ограничивающий прямоугольник всей сетки. Если указаны *column* и *row*, прямоугольник охватывает ячейку с номером строки и столбца 0 до этой ячейки; если также указаны *col2* и *row2*, то он охватывает область от ячейки (*column*, *row*) до ячейки (*col2*, *row2*).732733[`bbox()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bbox) – это псевдоним `grid_bbox()`, за исключением [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox), [`Spinbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox), [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text), [`ttk.Entry`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Entry) и [`ttk.Treeview`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Treeview), которые предоставляют собственный метод `bbox()`.734735#### `grid_columnconfigure(index, cnf={}, **kw)`736737Запрашивает или задаёт свойства столбца (или столбцов) *index* сетки, управляемой этим контейнером. *index* может быть номером столбца; при задании параметров это также может быть список номеров столбцов, строка `'all'` для воздействия на каждый столбец, или дочерний виджет, у которого затрагиваются занимаемые столбцы. Поддерживаемые параметры:738739***minsize***740741Минимальный размер столбца в пикселях.742743***weight***744745Целое число, определяющее, какая доля дополнительного пространства выделяется столбцу. Вес `0` оставляет столбец запрошенного размера, а столбец с весом два увеличивается вдвое быстрее столбца с весом один.746747***uniform***748749Имя единой группы. Столбцы с одинаковым непустым именем группы сохраняют размеры, строго пропорциональные их весам.750751***pad***752753Дополнительное пространство в пикселях, добавляемое к наибольшему виджету в столбце при вычислении размера столбца.754755С одним именем опции возвращает её значение; без аргументов возвращает словарь всех опций.756757[`columnconfigure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.columnconfigure) является псевдонимом `grid_columnconfigure()`.758759#### `grid_rowconfigure(index, cnf={}, **kw)`760761Запрашивает или задаёт свойства строки (или строк) *index* сетки, управляемой этим контейнером. *index* интерпретируется так же, как для [`grid_columnconfigure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_columnconfigure), а поддерживаемые опции (*minsize*, *weight*, *uniform* и *pad*) те же, но применяются к строке, а не к столбцу.762763[`rowconfigure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.rowconfigure) является псевдонимом `grid_rowconfigure()`.764765#### `grid_location(x, y)`766767Возвращает `(column, row)` ячейки сетки, содержащей пиксель в позиции (*x*, *y*), заданной в пикселях относительно этого контейнера. Для позиций выше или левее сетки возвращается `-1` для соответствующей координаты.768769#### `grid_propagate()`770771#### `grid_propagate(flag)`772773Включает или отключает распространение геометрии для этого контейнера, когда он управляет своими дочерними элементами с помощью менеджера геометрии grid. Когда *flag* равен true, контейнер изменяет свой размер, чтобы соответствовать запрошенным размерам дочерних элементов; когда false, его размер остаётся под вашим контролем. При вызове без аргументов возвращает текущую настройку в виде булева значения.774775#### `grid_size()`776777Возвращает размер сетки, управляемой этим контейнером, в виде кортежа `(columns, rows)`.778779[`size()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.size) – это псевдоним `grid_size()`, за исключением виджета [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox), который предоставляет собственный метод `size()`.780781#### `grid_slaves(row=None, column=None)`782783Возвращает список дочерних виджетов, управляемых в сетке этого контейнера, начиная с последнего добавленного. Если указаны *row* или *column*, возвращаются только дочерние элементы в этой строке или столбце.784785#### `pack_propagate()`786787#### `pack_propagate(flag)`788789Включает или отключает распространение геометрии для этого контейнера, когда он управляет своими дочерними элементами с помощью менеджера геометрии pack. Когда *flag* равен true, контейнер изменяет свой размер, чтобы соответствовать запрошенным размерам дочерних элементов; когда false, его размер остаётся под вашим контролем. При вызове без аргументов возвращает текущую настройку в виде булева значения.790791[`propagate()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.propagate) является псевдонимом `pack_propagate()`.792793#### `pack_slaves()`794795Возвращает список дочерних виджетов, управляемых этим контейнером с помощью менеджера геометрии pack, в порядке упаковки.796797[`slaves()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.slaves) является псевдонимом `pack_slaves()`.798799#### `place_slaves()`800801Возвращает список дочерних виджетов, управляемых этим контейнером с помощью менеджера геометрии place.802803Методы с префиксами `bind` и `unbind` связывают шаблоны событий с колбэками и удаляют эти связи.804805#### `bind(sequence=None, func=None, add=None)`806807Привязывает шаблон события *sequence* на этом виджете к вызываемому объекту *func*.808809*sequence* – это шаблон события, например `'<Button-1>'` (щелчок мыши) или `'<KeyPress-a>'`, и, возможно, объединение нескольких таких шаблонов, которые должны произойти один за другим. При наступлении события *func* вызывается с экземпляром [`Event`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Event), описывающим его, в качестве единственного аргумента; если *func* возвращает строку `'break'`, дальнейшие привязки для этого события не вызываются.810811Если *add* равен true, *func* добавляется к любым функциям, уже привязанным к *sequence*; в противном случае он заменяет их. Привязка применяется только к этому виджету.812813`bind()` возвращает строковый идентификатор (*funcid*), который впоследствии можно передать в [`unbind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.unbind), чтобы удалить привязку без утечки связанной команды Tcl.814815Если *func* опущен, вернуть привязку, связанную с *sequence*; если также опущен *sequence*, вернуть список всех последовательностей, для которых существуют привязки на этом виджете.816817#### `bind_class(className, sequence=None, func=None, add=None)`818819Как [`bind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind), но привязывает *func* к тегу привязки *className*, а не к отдельному виджету, так что привязка применяется к каждому виджету, имеющему этот тег. *className* обычно является именем класса виджета, например `'Button'`, в этом случае привязка влияет на все виджеты этого класса. Набор тегов привязки для виджета можно просмотреть и изменить с помощью [`bindtags()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bindtags).820821Остальные аргументы и возвращаемое значение такие же, как для [`bind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind).822823#### `bind_all(sequence=None, func=None, add=None)`824825Как [`bind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind), но привязывает *func* к специальному тегу привязки `'all'`, так что привязка применяется к каждому виджету в приложении.826827Остальные аргументы и возвращаемое значение такие же, как для [`bind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind).828829#### `unbind(sequence, funcid=None)`830831Удаляет привязки для шаблона события *sequence* на этом виджете.832833Если указан *funcid*, удаляется только функция, идентифицируемая им (значение, возвращённое предыдущим вызовом [`bind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind)), а связанная с ней команда Tcl удаляется. В противном случае уничтожаются все привязки для *sequence*, и он остаётся непривязанным.834835Изменено в версии 3.13: Если указан *funcid*, отвязывается только этот колбэк; остальные колбэки, привязанные к *sequence*, сохраняются.836837#### `unbind_class(className, sequence)`838839Удаляет все привязки для шаблона события *sequence* из тега привязки *className*. См. [`bind_class()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind_class).840841#### `unbind_all(sequence)`842843Удаляет все привязки для шаблона события *sequence* из специального тега привязки `'all'`. См. [`bind_all()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind_all).844845#### `bindtags(tagList=None)`846847Если *tagList* опущен, возвращает кортеж тегов привязки, связанных с этим виджетом. Когда в виджете происходит событие, оно применяется к каждому из тегов привязки виджета по порядку, и для каждого тега выполняется наиболее подходящая привязка. По умолчанию виджет имеет четыре тега привязки: собственное имя пути, его класс виджета, имя пути ближайшего предка верхнего уровня и `'all'`, именно в таком порядке.848849Если указан *tagList*, он должен быть последовательностью строк; теги привязки виджета устанавливаются равными его элементам, что определяет порядок, в котором вычисляются привязки.850851Методы с префиксом `event_` определяют виртуальные события и генерируют события программно.852853#### `event_add(virtual, *sequences)`854855Связывает виртуальное событие *virtual*, имя которого имеет форму `'<<Paste>>'`, с каждым из физических шаблонов событий, заданных *sequences*, так что виртуальное событие срабатывает всякий раз, когда происходит любое из них. Если *virtual* уже определён, новые последовательности добавляются к уже существующим.856857#### `event_delete(virtual, *sequences)`858859Удаляет каждую из *sequences* из тех, что связаны с виртуальным событием *virtual*. Последовательности, которые в данный момент не связаны с *virtual*, игнорируются. Если *sequences* не указаны, удаляются все физические последовательности событий, так что *virtual* больше не срабатывает.860861#### `event_generate(sequence, **kw)`862863Генерирует событие *sequence* на этом виджете и обеспечивает его обработку так, как если бы оно поступило от оконной системы. *sequence* должен быть одиночным шаблоном события, например `'<Button-1>'` или `'<<Paste>>'`, а не объединением нескольких. Именованные аргументы задают дополнительные поля события, например *x* и *y* для положения указателя, или *when* для управления моментом обработки события; полный список приведён на странице руководства Tk `event`.864865#### `event_info(virtual=None)`866867Если *virtual* опущен, возвращает кортеж всех виртуальных событий, которые в настоящее время определены. Если указан *virtual*, возвращает кортеж физических последовательностей событий, связанных с ним в настоящее время, или пустой кортеж, если он не определён.868869Методы с префиксом `after` планируют выполнение колбэков после задержки или когда приложение находится в состоянии простоя.870871#### `after(ms, func=None, *args)`872873Планирует вызов вызываемого объекта *func* через *ms* миллисекунд, передавая ему *args* в качестве позиционных аргументов. Возвращает идентификатор, который можно передать в [`after_cancel()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.after_cancel) для отмены вызова.874875Если *func* опущен, вместо этого приостановить выполнение на *ms* миллисекунд, не обрабатывая события в течение этого времени, и вернуть `None`.876877Изменено в версии 3.10: *func* теперь может быть любым вызываемым объектом, а не только функцией.878879#### `after_cancel(id)`880881Отменяет колбэк, ранее запланированный с помощью [`after()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.after) или [`after_idle()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.after_idle). *id* должен быть идентификатором, возвращённым одним из этих методов; передача значения, не являющегося таким идентификатором, вызывает [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError). Если колбэк уже выполнен или отменён, это не оказывает эффекта.882883Изменено в версии 3.7: Передача `None` (или любого ложного значения) в качестве *id* теперь вызывает [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError).884885#### `after_idle(func, *args)`886887Планирует вызов вызываемого объекта *func* с передачей ему *args* в тот момент, когда основной цикл Tk в следующий раз перейдёт в состояние бездействия, то есть когда у него не будет других событий для обработки. Возвращает идентификатор, который можно передать в [`after_cancel()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.after_cancel) для отмены вызова.888889#### `after_info(id=None)`890891Если *id* опущен, возвращает кортеж идентификаторов всех колбэков, текущих запланированных с помощью [`after()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.after) и [`after_idle()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.after_idle) для данного интерпретатора.892893Если *id* указан, он должен идентифицировать колбэк, который ещё не выполнен или не отменён, и возвращаемое значение представляет собой кортеж `(script, type)`, где *script* ссылается на вызываемую функцию, а *type* – это либо `'idle'`, либо `'timer'`. Вызывается [`TclError`](https://python-all.ru/3.13/library/tkinter.html#tkinter.TclError), если *id* не существует.894895Добавлено в версии 3.13.896897#### `mainloop(n=0)`898899Входит в цикл событий Tk, который обрабатывает события до тех пор, пока все окна не будут уничтожены. Обычно вызывается один раз, на корневом окне, для запуска приложения.900901#### `quit()`902903Завершает интерпретатор Tcl, в результате чего [`mainloop()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.mainloop) возвращает управление.904905#### `update()`906907Входит в цикл событий до тех пор, пока все ожидающие события, включая бездействующие колбэки, не будут обработаны. Это обновляет отображение и обрабатывает любые события, которые уже находятся в очереди, после чего возвращает управление.908909#### `update_idletasks()`910911Входит в цикл событий до тех пор, пока не будут вызваны все ожидающие бездействующие колбэки. Это обновляет отображение окон, например после изменения геометрии, но не обрабатывает события, вызванные пользователем.912913#### `wait_variable(name)`914915Ожидает, пока переменная Tcl *name* не будет изменена, продолжая при этом обрабатывать события, чтобы приложение оставалось отзывчивым. *name* обычно является экземпляром [`Variable`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable), таким как [`IntVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.IntVar) или [`StringVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.StringVar).916917[`waitvar()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.waitvar) является псевдонимом `wait_variable()`.918919#### `wait_window(window=None)`920921Ожидает, пока *window* не будет уничтожено, продолжая при этом обрабатывать события. Если *window* опущен, используется данный виджет. Обычно используется для ожидания завершения взаимодействия пользователя с диалоговым окном.922923#### `wait_visibility(window=None)`924925Ожидает, пока состояние видимости *window* не изменится, например, когда оно впервые появляется на экране, продолжая при этом обрабатывать события. Если *window* опущен, используется данный виджет. Обычно используется для ожидания, пока новое окно не станет видимым, прежде чем выполнять с ним какие-либо действия.926927Методы с префиксом `focus_` управляют фокусом ввода с клавиатуры.928929#### `focus()`930931Направляет фокус ввода с клавиатуры для дисплея данного виджета на этот виджет. Если приложение в данный момент не имеет фокуса ввода на дисплее этого виджета, виджет запоминается как окно фокуса для своего верхнего уровня, и фокус будет перенаправлен на него в следующий раз, когда оконный менеджер передаст фокус верхнему уровню. `focus()` – это псевдоним `focus_set()`, за исключением виджетов [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas) и [`ttk.Treeview`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Treeview), которые предоставляют собственный метод `focus()`.932933#### `focus_force()`934935Направляет фокус ввода с клавиатуры на этот виджет, даже если приложение в данный момент не имеет фокуса ввода для дисплея виджета. Этот метод следует использовать с осторожностью, если вообще использовать; обычно приложению следует дожидаться, пока оконный менеджер сам передаст ему фокус, а не захватывать его.936937#### `focus_get()`938939Возвращает виджет, который в данный момент имеет фокус клавиатуры в приложении, или `None`, если ни один виджет в приложении не имеет фокуса. Используйте [`focus_displayof()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.focus_displayof) для корректной работы с несколькими дисплеями.940941#### `focus_displayof()`942943Возвращает виджет, который в данный момент имеет фокус клавиатуры на дисплее, где расположен этот виджет, или `None`, если ни один виджет в приложении не имеет фокуса на этом дисплее.944945#### `focus_lastfor()`946947Возвращает последний виджет, который имел фокус клавиатуры среди всех виджетов на том же верхнем уровне, что и этот виджет; это виджет, который получит фокус в следующий раз, когда оконный менеджер передаст фокус этому верхнему уровню. Если ни один виджет на этом верхнем уровне никогда не имел фокуса, или если последний виджет с фокусом был удалён, возвращается сам верхний уровень.948949#### `tk_focusFollowsMouse()`950951Перенастраивает Tk на использование неявной модели фокуса, в которой фокус устанавливается на виджет при входе в него указателя мыши. После включения эту модель непросто отключить.952953#### `tk_focusNext()`954955Возвращает следующий виджет после данного в порядке обхода клавиатуры, или `None`, если такого нет. Порядок обхода: сначала следующий дочерний элемент, затем рекурсивно дочерние элементы этого дочернего элемента, а затем следующий родственный элемент, расположенный выше в порядке наложения. Виджет пропускается, если его опция `takefocus` имеет значение `0`. Этот метод используется в привязках по умолчанию для клавиши `Tab`.956957#### `tk_focusPrev()`958959Возвращает предыдущий виджет перед данным в порядке обхода клавиатуры, или `None`, если такого нет. См. [`tk_focusNext()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.tk_focusNext) для описания порядка. Этот метод используется в привязках по умолчанию для клавиши `Shift`-`Tab`.960961Методы с префиксом `grab_` устанавливают и запрашивают захват ввода, который направляет все события ввода на один виджет.962963#### `grab_set()`964965Устанавливает локальный захват на этот виджет. Захват ограничивает события указателя этим виджетом и его потомками: пока указатель находится вне поддерева виджета, нажатия и отпускания кнопок, а также перемещения указателя передаются виджету захвата, а окна за пределами поддерева становятся нечувствительными до освобождения захвата. Локальный захват влияет только на приложение, которое его установило. Любой предыдущий захват, установленный этим приложением на дисплее виджета, автоматически освобождается. Установка захвата – обычный способ сделать диалог модальным: пока захват активен, пользователь не может взаимодействовать с другими окнами приложения.966967#### `grab_set_global()`968969Устанавливает глобальный захват на этот виджет. Глобальный захват подобен локальному захвату, устанавливаемому методом [`grab_set()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grab_set), но он блокирует все остальные приложения на экране, так что только поддерево этого виджета чувствительно к событиям указателя, а также захватывает клавиатуру. Следует соблюдать осторожность: глобальный захват может легко сделать дисплей неработоспособным, поскольку другие приложения перестают получать события до его освобождения.970971#### `grab_release()`972973Освобождает захват на этот виджет, если он установлен; в противном случае ничего не делает.974975#### `grab_current()`976977Возвращает виджет, который в данный момент удерживает захват в этом приложении для дисплея данного виджета, или `None`, если такого виджета нет.978979#### `grab_status()`980981Возвращает `None`, если на данный момент на этом виджете не установлен захват, `"local"`, если установлен локальный захват, или `"global"`, если установлен глобальный захват.982983Методы с префиксом `selection_` извлекают и управляют X-выделением.984985#### `selection_clear(**kw)`986987Очищает X-выделение, так чтобы ни одно окно больше не владело им. Очищаемое выделение задаётся именованным аргументом *selection*, именем атома, таким как `'PRIMARY'` или `'CLIPBOARD'`; по умолчанию используется `PRIMARY`. Именованный аргумент *displayof* задаёт виджет, определяющий дисплей, на котором следует выполнять операцию; по умолчанию используется этот виджет.988989Это переопределяется виджетами [`Entry`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry), [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox) и [`Spinbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox), где `selection_clear()` вместо этого очищает собственное выделение виджета.990991#### `selection_get(**kw)`992993Возвращает содержимое текущего X-выделения. Именованный аргумент *selection* задаёт имя выделения; по умолчанию используется `PRIMARY`. Именованный аргумент *type* указывает форму, в которой должны быть возвращены данные (нужный целевой тип преобразования) – имя атома, такое как `'STRING'` или `'FILE_NAME'`; по умолчанию используется `STRING`, за исключением X11, где сначала пробуется `UTF8_STRING`, а в качестве запасного варианта применяется `STRING`. Именованный аргумент *displayof* задаёт виджет, определяющий дисплей, с которого следует получить выделение; по умолчанию используется этот виджет.994995#### `selection_handle(command, **kw)`996997Регистрирует *command* как обработчик для предоставления X-выделения, которым владеет этот виджет, когда другое приложение запрашивает его. При извлечении выделения *command* вызывается с двумя аргументами: начальным смещением символа и максимальным количеством возвращаемых символов; он должен вернуть не более этого количества символов выделения, начиная с указанного смещения; для очень длинных выделений он вызывается многократно с увеличивающимися смещениями. Именованный аргумент *selection* задаёт имя выделения (по умолчанию `PRIMARY`), а именованный аргумент *type* указывает форму выделения, которую предоставляет обработчик (например, `'STRING'` или `'FILE_NAME'`, по умолчанию `STRING`).998999#### `selection_own(**kw)`10001001Делает этот виджет владельцем X-выделения на его дисплее. Предыдущий владелец, если он был, уведомляется о потере выделения. Именованный аргумент *selection* задаёт имя выделения; по умолчанию используется `PRIMARY`.10021003#### `selection_own_get(**kw)`10041005Возвращает виджет в этом приложении, которому принадлежит выделение X на дисплее, содержащем этот виджет, или `None`, если ни один виджет в этом приложении не владеет выделением. Именованный аргумент *selection* задаёт название выделения; значение по умолчанию – `PRIMARY`. Именованный аргумент *displayof* задаёт виджет, определяющий запрашиваемый дисплей; значение по умолчанию – этот виджет.10061007Методы с префиксом `clipboard_` управляют буфером обмена.10081009#### `clipboard_append(string, **kw)`10101011Добавляет *string* в буфер обмена Tk и заявляет права владения буфером обмена на дисплее этого виджета. Перед добавлением буфер обмена следует очистить с помощью [`clipboard_clear()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.clipboard_clear); все добавления должны быть завершены до возврата в цикл событий, чтобы буфер обмена обновился атомарно. Именованный аргумент *type* задаёт форму данных – имя атома, например `'STRING'` или `'FILE_NAME'` (по умолчанию `STRING`), а именованный аргумент *format* задаёт представление, используемое для передачи (по умолчанию `STRING`). Именованный аргумент *displayof* задаёт виджет, определяющий целевой дисплей; значение по умолчанию – этот виджет. Содержимое можно получить с помощью [`clipboard_get()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.clipboard_get) или [`selection_get()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.selection_get).10121013#### `clipboard_clear(**kw)`10141015Заявляет права владения буфером обмена на дисплее этого виджета и удаляет предыдущее содержимое. Именованный аргумент *displayof* задаёт виджет, определяющий целевой дисплей; значение по умолчанию – этот виджет.10161017#### `clipboard_get(**kw)`10181019Извлекает данные из буфера обмена на дисплее этого виджета. Именованный аргумент *type* задаёт форму, в которой должны быть возвращены данные – имя атома, например `'STRING'` или `'FILE_NAME'`; по умолчанию `STRING`, за исключением X11, где сначала пробуется `UTF8_STRING`, а `STRING` используется как запасной вариант. Именованный аргумент *displayof* задаёт виджет, определяющий дисплей; значение по умолчанию – корневое окно приложения. Это эквивалентно `selection_get(selection='CLIPBOARD')`.10201021Методы с префиксом `option_` запрашивают и изменяют базу данных опций Tk.10221023#### `option_add(pattern, value, priority=None)`10241025Добавляет опцию в базу данных опций Tk, связывающую *value* с *pattern*. *pattern* состоит из имён и/или классов, разделённых звёздочками или точками, в обычном формате X. *priority* – целое число от 0 до 100 или одно из символических имён `'widgetDefault'` (20), `'startupFile'` (40), `'userDefault'` (60) или `'interactive'` (80); по умолчанию `interactive`.10261027#### `option_clear()`10281029Очищает базу данных опций Tk. Опции по умолчанию из свойства `RESOURCE_MANAGER` или файла `.Xdefaults` автоматически перезагружаются при следующем добавлении или удалении опции из базы.10301031#### `option_get(name, className)`10321033Возвращает значение опции из базы данных опций Tk, соответствующей этому виджету по *name* и *className*, или пустую строку, если соответствующей записи нет. Если совпадает несколько записей, возвращается та, у которой наивысший приоритет, а среди записей с равным приоритетом – добавленная последней.10341035#### `option_readfile(fileName, priority=None)`10361037Читает файл с именем *fileName*, который должен иметь стандартный формат базы данных ресурсов X, например `.Xdefaults`, и добавляет все указанные в нём опции в базу данных опций Tk. *priority* интерпретируется так же, как для [`option_add()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.option_add), и по умолчанию равен `interactive`.10381039#### `bell(displayof=0)`10401041Воспроизводит звонок на дисплее этого виджета, используя текущие настройки звонка дисплея, и сбрасывает хранитель экрана для экрана. Если *displayof* задан как виджет, звонок воспроизводится на дисплее этого виджета.10421043#### `tk_setPalette(background, /)`10441045#### `tk_setPalette(*args, **kw)`10461047Устанавливает новую цветовую схему для всех элементов виджетов Tk. Существующие виджеты обновляются, а база данных опций изменяется так, чтобы будущие виджеты использовали новые цвета. Если передан один цветовой аргумент, он считается обычным цветом фона, на основе которого вычисляется полная палитра. В качестве альтернативы аргументы могут быть заданы как пары *name*/*value*, задающие отдельные опции в базе данных опций. Распознаваемые имена опций: `activeBackground`, `activeForeground`, `background`, `disabledForeground`, `foreground`, `highlightBackground`, `highlightColor`, `insertBackground`, `selectColor`, `selectBackground`, `selectForeground` и `troughColor`; для любых неуказанных опций вычисляются разумные значения по умолчанию.10481049#### `tk_bisque()`10501051Восстанавливает цвета приложения к светлой коричневой (bisque) цветовой схеме, использовавшейся в Tk 3.6 и более ранних версиях. Предусмотрено для обратной совместимости.10521053#### `tk_strictMotif(boolean=None)`10541055Запрашивает или устанавливает, должен ли внешний вид Tk строго соответствовать Motif. Значение *boolean*, равное true, включает строгое соответствие Motif (например, отсутствие изменения цвета при наведении мыши на ползунок). Возвращает результирующую настройку.10561057Методы с префиксом `busy_` управляют состоянием занятости окна, при котором отображается курсор занятости и игнорируется пользовательский ввод.10581059#### `tk_busy_hold(**kw)`10601061Делает этот виджет занятым. Перед виджетом помещается прозрачное окно, так что он и все его потомки в иерархии виджетов блокируются от событий указателя и отображают курсор занятости. Обычно сразу после этого следует вызвать [`update()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.update), чтобы операция удержания вступила в силу до того, как приложение начнёт обработку.10621063Единственная поддерживаемая опция конфигурации – *cursor*, курсор, отображаемый пока виджет занят; он может принимать любое из значений, принимаемых `configure()`.10641065[`busy_hold()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.busy_hold), [`busy()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.busy) и [`tk_busy()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.tk_busy) являются псевдонимами `tk_busy_hold()`.10661067Добавлено в версии 3.13.10681069#### `tk_busy_configure(cnf=None, **kw)`10701071Запрос или изменение параметров конфигурации занятого окна. Виджет должен быть предварительно переведён в состояние «занят» с помощью [`tk_busy_hold()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.tk_busy_hold). Без аргументов возвращает словарь со всеми доступными опциями; если *cnf* – имя опции, возвращает кортеж с её описанием. В противном случае устанавливает указанные опции в заданные значения. Опции могут принимать любые значения, поддерживаемые `tk_busy_hold()`.10721073База данных опций обращается по имени или классу виджета. Например, если виджет [`Frame`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Frame) с именем `frame` должен быть сделан занятым, для него можно указать курсор ожидания с помощью любого из вызовов:10741075```python1076w.option_add('*frame.busyCursor', 'gumby')1077w.option_add('*Frame.BusyCursor', 'gumby')1078```10791080[`busy_configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.busy_configure), [`busy_config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.busy_config) и [`tk_busy_config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.tk_busy_config) – это псевдонимы `tk_busy_configure()`.10811082Добавлено в версии 3.13.10831084#### `tk_busy_cget(option)`10851086Возвращает текущее значение *опции* конфигурации занятого виджета. Виджет должен быть предварительно переведён в состояние «занят» с помощью [`tk_busy_hold()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.tk_busy_hold), а *опция* может принимать любые значения, поддерживаемые этим методом.10871088[`busy_cget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.busy_cget) является псевдонимом `tk_busy_cget()`.10891090Добавлено в версии 3.13.10911092#### `tk_busy_forget()`10931094Переводит виджет из состояния «занят» обратно, освобождая ресурсы (включая прозрачное окно), выделенные при его занятости. Виджет снова начнёт получать события пользователя. Эти ресурсы также освобождаются при уничтожении виджета.10951096[`busy_forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.busy_forget) является псевдонимом `tk_busy_forget()`.10971098Добавлено в версии 3.13.10991100#### `tk_busy_status()`11011102Возвращает `True`, если виджет в данный момент занят, иначе `False`.11031104[`busy_status()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.busy_status) является псевдонимом `tk_busy_status()`.11051106Добавлено в версии 3.13.11071108#### `tk_busy_current(pattern=None)`11091110Возвращает список виджетов, которые в данный момент заняты. Если указан *pattern*, возвращаются только занятые виджеты, чьи имена путей соответствуют шаблону.11111112[`busy_current()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.busy_current) является псевдонимом `tk_busy_current()`.11131114Добавлено в версии 3.13.11151116Методы с префиксом `winfo_` получают информацию об окнах, управляемых Tk.11171118#### `winfo_atom(name, displayof=0)`11191120Возвращает целочисленный идентификатор атома с именем *name*, создавая новый атом, если такого не существует. Если указан *displayof*, атом ищется на экране этого окна; в противном случае – на экране главного окна приложения.11211122#### `winfo_atomname(id, displayof=0)`11231124Возвращает текстовое имя атома с целочисленным идентификатором *id*. Это обратная операция к [`winfo_atom()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_atom). Если указан *displayof*, идентификатор ищется на экране этого окна; в противном случае – на экране главного окна приложения.11251126#### `winfo_cells()`11271128Возвращает количество ячеек в цветовой карте (colormap) виджета.11291130#### `winfo_children()`11311132Возвращает список виджетов, являющихся дочерними по отношению к данному виджету, в порядке стека от нижнего к верхнему. Окна верхнего уровня возвращаются как дочерние своих логических родителей.11331134#### `winfo_class()`11351136Возвращает имя класса виджета.11371138#### `winfo_colormapfull()`11391140Возвращает `True`, если известно, что цветовая карта виджета заполнена, иначе `False`.11411142#### `winfo_containing(rootX, rootY, displayof=0)`11431144Возвращает виджет, содержащий точку с координатами *rootX* и *rootY*, или `None`, если ни одно окно в приложении не содержит эту точку. Координаты задаются в экранных единицах в системе координат корневого окна. Если указан *displayof*, координаты относятся к экрану, содержащему это окно; в противном случае – к экрану главного окна приложения.11451146#### `winfo_depth()`11471148Возвращает глубину цвета виджета, то есть количество бит на пиксель.11491150#### `winfo_exists()`11511152Возвращает `1`, если виджет существует, и `0` в противном случае.11531154#### `winfo_fpixels(number)`11551156Возвращает число с плавающей запятой, показывающее количество пикселей в виджете, соответствующее экранному расстоянию *number* (например, `"2.0c"` или `"1i"`). Результат может быть дробным; для округлённого целого значения используйте [`winfo_pixels()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_pixels).11571158#### `winfo_geometry()`11591160Возвращает геометрию виджета в формате `widthxheight+x+y`. Все размеры указаны в пикселях. Смещение может быть отрицательным; см. [`geometry()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.geometry).11611162#### `winfo_height()`11631164Возвращает высоту виджета в пикселях. При первом создании окна его высота равна 1 пикселю; впоследствии она изменяется менеджером геометрии. См. также [`winfo_reqheight()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_reqheight).11651166#### `winfo_id()`11671168Возвращает низкоуровневый платформенно-зависимый идентификатор виджета. В Unix это идентификатор X-окна, а в Windows – дескриптор окна.11691170#### `winfo_interps(displayof=0)`11711172Возвращает кортеж имён всех интерпретаторов Tcl, зарегистрированных в данный момент для конкретного дисплея. Если указан *displayof*, возвращаемое значение относится к дисплею этого окна; в противном случае – к дисплею главного окна приложения.11731174#### `winfo_ismapped()`11751176Возвращает `1`, если виджет в данный момент отображён, и `0` в противном случае.11771178#### `winfo_manager()`11791180Возвращает имя менеджера геометрии, который в данный момент управляет виджетом, или пустую строку, если он не управляется ни одним менеджером геометрии.11811182#### `winfo_name()`11831184Возвращает имя виджета внутри его родительского элемента, в отличие от полного путевого имени.11851186#### `winfo_parent()`11871188Возвращает путевое имя родительского элемента виджета или пустую строку, если виджет является главным окном приложения.11891190#### `winfo_pathname(id, displayof=0)`11911192Возвращает путевое имя окна, идентификатор которого равен *id*. Если указан *displayof*, идентификатор ищется на дисплее этого окна; в противном случае – на дисплее главного окна приложения.11931194#### `winfo_pixels(number)`11951196Возвращает количество пикселей в виджете, соответствующее экранному расстоянию *number* (например, `"2.0c"` или `"1i"`). Результат округляется до ближайшего целого; для получения дробного результата используйте [`winfo_fpixels()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_fpixels).11971198#### `winfo_pointerx()`11991200Возвращает координату *x* указателя в пикселях относительно корневого окна экрана (или виртуального корня, если он используется). Возвращает `-1`, если указатель находится не на том же экране, что и виджет.12011202#### `winfo_pointerxy()`12031204Возвращает координаты указателя в виде кортежа `(x, y)` в пикселях относительно корневого окна экрана (или виртуального корня, если он используется). Обе координаты равны `-1`, если указатель находится не на том же экране, что и виджет.12051206#### `winfo_pointery()`12071208Возвращает координату *y* указателя в пикселях относительно корневого окна экрана (или виртуального корня, если он используется). Возвращает `-1`, если указатель находится не на том же экране, что и виджет.12091210#### `winfo_reqheight()`12111212Возвращает запрошенную высоту виджета в пикселях. Это значение используется менеджером геометрии виджета для вычисления его геометрии.12131214#### `winfo_reqwidth()`12151216Возвращает запрошенную ширину виджета в пикселях. Это значение используется менеджером геометрии виджета для вычисления его геометрии.12171218#### `winfo_rgb(color)`12191220Возвращает кортеж `(r, g, b)` из интенсивностей красного, зелёного и синего в диапазоне от 0 до 65535, соответствующих *color* в виджете. *color* может быть задан в любой форме, допустимой для параметра цвета.12211222#### `winfo_rootx()`12231224Возвращает координату *x* в корневом окне экрана для верхнего левого угла границы виджета (или самого виджета, если у него нет границы).12251226#### `winfo_rooty()`12271228Возвращает координату *y* в корневом окне экрана для верхнего левого угла границы виджета (или самого виджета, если у него нет границы).12291230#### `winfo_screen()`12311232Возвращает имя экрана, связанного с виджетом, в форме `displayName.screenIndex`.12331234#### `winfo_screencells()`12351236Возвращает количество ячеек в цветовой карте по умолчанию для экрана виджета.12371238#### `winfo_screendepth()`12391240Возвращает глубину корневого окна экрана виджета, то есть количество бит на пиксель.12411242#### `winfo_screenheight()`12431244Возвращает высоту экрана виджета в пикселях.12451246#### `winfo_screenmmheight()`12471248Возвращает высоту экрана виджета в миллиметрах.12491250#### `winfo_screenmmwidth()`12511252Возвращает ширину экрана виджета в миллиметрах.12531254#### `winfo_screenvisual()`12551256Возвращает класс визуализации по умолчанию для экрана виджета: `"directcolor"`, `"grayscale"`, `"pseudocolor"`, `"staticcolor"`, `"staticgray"`, или `"truecolor"`.12571258#### `winfo_screenwidth()`12591260Возвращает ширину экрана виджета в пикселях.12611262#### `winfo_server()`12631264Возвращает строку с информацией о сервере дисплея виджета. Точный формат этой строки может различаться в зависимости от платформы.12651266#### `winfo_toplevel()`12671268Возвращает окно верхнего уровня иерархии, содержащее виджет. В стандартном Tk это всегда виджет [`Toplevel`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Toplevel).12691270#### `winfo_viewable()`12711272Возвращает `1`, если виджет и все его предки вплоть до ближайшего окна верхнего уровня отображены, и `0` в противном случае.12731274#### `winfo_visual()`12751276Возвращает класс визуализации для виджета: `"directcolor"`, `"grayscale"`, `"pseudocolor"`, `"staticcolor"`, `"staticgray"`, или `"truecolor"`.12771278#### `winfo_visualid()`12791280Возвращает X-идентификатор визуального представления виджета.12811282#### `winfo_visualsavailable(includeids=False)`12831284Возвращает список доступных для экрана виджета визуальных представлений. Каждый элемент состоит из класса визуального представления (см. [`winfo_visual()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_visual)) и целочисленной глубины. Если *includeids* равно true, также включается X-идентификатор визуального представления.12851286#### `winfo_vrootheight()`12871288Возвращает высоту виртуального корневого окна, связанного с виджетом, если таковое существует; в противном случае возвращает высоту экрана виджета.12891290#### `winfo_vrootwidth()`12911292Возвращает ширину виртуального корневого окна, связанного с виджетом, если таковое существует; в противном случае возвращает ширину экрана виджета.12931294#### `winfo_vrootx()`12951296Возвращает смещение *x* виртуального корневого окна, связанного с виджетом, относительно корневого окна его экрана. Обычно равно нулю или отрицательное, и равно `0`, если виртуальное корневое окно отсутствует.12971298#### `winfo_vrooty()`12991300Возвращает смещение *y* виртуального корневого окна, связанного с виджетом, относительно корневого окна его экрана. Обычно равно нулю или отрицательное, и равно `0`, если виртуальное корневое окно отсутствует.13011302#### `winfo_width()`13031304Возвращает ширину виджета в пикселях. При первом создании окна его ширина равна 1 пикселю; впоследствии она изменяется менеджером геометрии. См. также [`winfo_reqwidth()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_reqwidth).13051306#### `winfo_x()`13071308Возвращает *x*-координату верхнего левого угла рамки виджета (или самого виджета, если у него нет рамки) в родительском контейнере.13091310#### `winfo_y()`13111312Возвращает *y*-координату верхнего левого угла рамки виджета (или самого виджета, если у него нет рамки) в родительском контейнере.13131314#### `info_patchlevel()`13151316Возвращает уровень патча Tcl/Tk в виде именованного кортежа с теми же пятью полями, что и [`sys.version_info`](https://python-all.ru/3.13/library/sys.html#sys.version_info): *major*, *minor*, *micro*, *releaselevel* и *serial*. *releaselevel* принимает значения `'alpha'`, `'beta'` или `'final'`. При преобразовании в строку получается версия в обычной записи Tcl/Tk, например `'9.0.3'` для финального релиза или `'9.1b2'` для предварительной версии.13171318Добавлено в версии 3.12.13191320#### `class tkinter.Wm`13211322Миксин `Wm` предоставляет доступ к оконному менеджеру, позволяя приложению управлять такими вещами, как заголовок, геометрия и значок окна верхнего уровня, способ его изменения размера, а также реакция на протоколы оконного менеджера. Он встраивается в [`Tk`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk) и [`Toplevel`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Toplevel), поэтому его методы доступны для любого окна верхнего уровня. Каждый метод имеет два эквивалентных написания: короткое имя и имя с префиксом `wm_` (например, [`title()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.title) и [`wm_title()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_title)).13231324#### `aspect(minNumer=None, minDenom=None, maxNumer=None, maxDenom=None)`13251326Ограничивает соотношение сторон (отношение ширины к высоте) окна. Если указаны все четыре аргумента, оконный менеджер поддерживает соотношение между `minNumer/minDenom` и `maxNumer/maxDenom`; передача пустых строк снимает все существующие ограничения. Без аргументов возвращает кортеж из четырёх текущих значений или пустую строку, если ограничение соотношения не действует. [`wm_aspect()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_aspect) – это псевдоним `aspect()`.13271328#### `attributes(*args, return_python_dict=False, **kwargs)`13291330Запрашивает или задаёт платформо-зависимые атрибуты окна. Без аргументов возвращает платформо-зависимые флаги и их значения; передайте *return\_python\_dict* равным true, чтобы получить их в виде словаря. Одно имя опции, например `'alpha'`, возвращает значение этой опции, а опции задаются с помощью именованных аргументов (`alpha=0.5`).13311332Доступные атрибуты различаются в зависимости от платформы. Все платформы поддерживают:13331334***alpha***13351336Непрозрачность окна от `0.0` (полностью прозрачно) до `1.0` (непрозрачно). Если прозрачность не поддерживается, значение остаётся `1.0`.13371338***внешний вид***13391340Определяет, отображается ли окно в тёмном режиме в Windows и macOS: `'auto'`, `'light'` или `'dark'` (не действует на X11).13411342***полноэкранный***13431344Определяет, развёрнуто ли окно на весь экран и не имеет ли границ.13451346***поверх всех окон***13471348Определяет, отображается ли окно поверх всех остальных окон.13491350Windows также поддерживает:13511352***отключён***13531354Определяет, находится ли окно в отключённом состоянии.13551356***окно инструментов***13571358Определяет, использует ли окно стиль инструментального окна.13591360***прозрачный цвет***13611362Цвет, который становится полностью прозрачным, или пустая строка для отсутствия прозрачности.13631364macOS также поддерживает:13651366***класс***13671368Определяет, является ли базовое окно Aqua `nswindow` или `nspanel`; это можно установить только до создания окна.13691370***изменён***13711372Состояние изменения, отображаемое кнопкой закрытия окна и значком-заместителем.13731374***уведомить***13751376Определяет, подпрыгивает ли значок приложения в доке, чтобы привлечь внимание.13771378***маска стиля***13791380Маска стиля базового окна Aqua, задаваемая в виде списка имён битов, таких как `titled` или `resizable`.13811382***идентификатор вкладок***13831384Идентификатор группы вкладок, к которой принадлежит окно.13851386***режим вкладок***13871388Определяет, может ли окно быть открыто как вкладка: `'auto'`, `'preferred'` или `'disallowed'`.13891390***путь заголовка***13911392Путь к файлу, представленному значком-заместителем окна.13931394***прозрачный***13951396Определяет, является ли область содержимого прозрачной и отключена ли тень окна.13971398X11 также поддерживает:13991400***тип***14011402Тип окна или список типов в порядке предпочтения, который менеджер окон должен использовать для интерпретации окна, например `'dialog'` или `'splash'`.14031404***увеличен***14051406Определяет, развёрнуто ли окно на весь экран.14071408> **Примечание**1409>1410> Tk 8.6 добавил атрибут *type*, а Tk 9.0 добавил атрибуты *appearance*, *class*, *stylemask*, *tabbingid* и *tabbingmode*.14111412В X11 изменения применяются асинхронно, поэтому запрошенное значение может ещё не отражать самый последний запрос. [`wm_attributes()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_attributes) является псевдонимом `attributes()`.14131414Изменено в версии 3.13: Теперь отдельный атрибут можно запросить по имени без начального `-`, а атрибуты можно задавать с помощью именованных аргументов. Был добавлен параметр *return\_python\_dict*.14151416Устарело с версии 3.13: Установка атрибута путём передачи имени опции (с начальным `-`) и её значения в виде двух позиционных аргументов, как в `w.attributes('-alpha', 0.5)`, устарела; вместо этого используйте именованные аргументы.14171418#### `client(name=None)`14191420Сохраняет *name* (должно быть именем хоста, на котором выполняется приложение) в свойстве `WM_CLIENT_MACHINE` окна для использования оконным менеджером или менеджером сессий. Пустая строка удаляет это свойство. Без аргументов возвращает последнее установленное имя или пустую строку. [`wm_client()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_client) – это псевдоним `client()`.14211422#### `colormapwindows(*wlist)`14231424Управляет свойством `WM_COLORMAP_WINDOWS`, которое сообщает оконному менеджеру об окнах, имеющих частные цветовые карты. Если задан *wlist*, перезаписывает свойство этими окнами (их порядок – это приоритет для установки цветовых карт). Без аргументов возвращает список окон, указанных в данный момент в свойстве. [`wm_colormapwindows()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_colormapwindows) – это псевдоним `colormapwindows()`.14251426#### `command(value=None)`14271428Сохраняет *value* в свойстве `WM_COMMAND` окна для использования оконным менеджером или менеджером сессий; это должен быть список слов команды, использованной для запуска приложения. Пустая строка удаляет свойство. Без аргументов возвращает последнее установленное значение или пустую строку. [`wm_command()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_command) – это псевдоним `command()`.14291430#### `deiconify()`14311432Отображает окно в обычной (не свёрнутой) форме, отображая его на экране. Если окно ещё ни разу не отображалось, это гарантирует, что при первом отображении оно появится уже развёрнутым. В Windows окно также поднимается и получает фокус. [`wm_deiconify()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_deiconify) – это псевдоним `deiconify()`.14331434#### `focusmodel(model=None)`14351436Устанавливает или запрашивает модель фокуса для окна. *model* может быть `'active'` (окно заявляет о получении фокуса ввода для себя или своих потомков, даже когда фокус находится в другом приложении) или `'passive'` (окно полагается на оконный менеджер, чтобы тот дал ему фокус). Без аргумента возвращает текущую модель. По умолчанию используется `'passive'`, что предполагает команда `focus()`. [`wm_focusmodel()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_focusmodel) – это псевдоним `focusmodel()`.14371438#### `forget(window)`14391440Скрывает *window* с экрана, так что оно больше не управляется оконным менеджером. Затем [`Toplevel`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Toplevel) обрабатывается как [`Frame`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Frame), хотя его конфигурация `-menu` запоминается, и меню снова появляется, если виджет снова становится управляемым. [`wm_forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_forget) – это псевдоним `forget()`.14411442Не путать с [`Pack.forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.forget).14431444Добавлено в версии 3.3.14451446#### `frame()`14471448Возвращает платформенно-зависимый идентификатор окна для самого внешнего декоративного фрейма, содержащего окно, если оконный менеджер поместил его в такой фрейм; в противном случае возвращает идентификатор самого окна. [`wm_frame()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_frame) – это псевдоним `frame()`.14491450#### `geometry(newGeometry=None)`14511452Устанавливает или запрашивает геометрию окна. *newGeometry* имеет форму `=widthxheight+x+y`, где любая из `=`, `widthxheight` и позиция `+x+y` может быть опущена. *width* и *height* задаются в пикселях (или в единицах сетки для окна с сеткой); позиция, перед которой стоит `+`, отсчитывается от левого или верхнего края экрана, а позиция, перед которой стоит `-`, – от правого или нижнего края. Смещение может быть отрицательным, как в `'200x100+-9+-8'`, когда край окна выходит за соответствующий край экрана. Пустая строка отменяет любую заданную пользователем геометрию, позволяя окну вернуться к своему естественному размеру. Без аргумента возвращает текущую геометрию в виде строки вида `'200x200+10+10'`. [`wm_geometry()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_geometry) – это псевдоним `geometry()`.14531454#### `grid(baseWidth=None, baseHeight=None, widthInc=None, heightInc=None)`14551456Управляет окном как окном с сеткой и определяет соотношение между единицами сетки и пикселями. *baseWidth* и *baseHeight* – это количество единиц сетки для внутреннего запрошенного размера окна, а *widthInc* и *heightInc* – это размеры в пикселях горизонтальной и вертикальной единицы сетки. Пустые строки отключают управление сеткой. Без аргументов возвращает кортеж из четырёх текущих значений или пустую строку, если окно не использует сетку. [`wm_grid()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_grid) – это псевдоним `grid()`.14571458Не путать с менеджером геометрии grid [`Grid.grid()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.grid).14591460#### `group(pathName=None)`14611462Устанавливает или запрашивает лидера группы связанных окон. *pathName* задаёт путь к лидеру группы; оконный менеджер может, например, скрыть все окна в группе, когда лидер сворачивается. Пустая строка удаляет окно из любой группы. Без аргумента возвращает путь к текущему лидеру группы или пустую строку. [`wm_group()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_group) – это псевдоним `group()`.14631464#### `iconbitmap(bitmap=None, default=None)`14651466Устанавливает или запрашивает битовую карту, используемую оконным менеджером для значка окна. *bitmap* задаёт битовую карту в одной из стандартных форм, принимаемых Tk; пустая строка отменяет текущую битовую карту значка. Без аргумента возвращает имя текущей битовой карты значка или пустую строку. В Windows аргумент *default* задаёт значок (например, файл `.ico`), применяемый ко всем окнам верхнего уровня, у которых нет собственного значка. [`wm_iconbitmap()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_iconbitmap) – это псевдоним `iconbitmap()`.14671468#### `iconify()`14691470Сворачивает окно. Если окно ещё не было отображено в первый раз, обеспечивает его отображение в свёрнутом состоянии при последующем отображении. [`wm_iconify()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_iconify) – это псевдоним `iconify()`.14711472#### `iconmask(bitmap=None)`14731474Устанавливает или запрашивает битовую карту, используемую в качестве маски для значка (см. [`iconbitmap()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.iconbitmap)). Если маска равна нулю, значок не отображается; если единице, показываются соответствующие биты битовой карты значка. Пустая строка отменяет текущую маску. Без аргумента возвращает имя текущей маски значка или пустую строку. [`wm_iconmask()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_iconmask) – это псевдоним `iconmask()`.14751476#### `iconname(newName=None)`14771478Устанавливает или запрашивает имя, отображаемое оконным менеджером внутри значка окна. Без аргумента возвращает текущее имя значка или пустую строку, если ничего не было установлено (в этом случае оконный менеджер обычно отображает заголовок окна). [`wm_iconname()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_iconname) – это псевдоним `iconname()`.14791480#### `iconphoto(default=False, *images)`14811482Устанавливает значок заголовка окна из одного или нескольких объектов [`PhotoImage`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PhotoImage), переданных в *images*. Можно передать несколько изображений разных размеров (например, 16×16 и 32×32), чтобы оконный менеджер мог выбрать подходящее. Данные изображения берутся как снимок на момент вызова; последующие изменения изображений не учитываются. Если *default* равно true, значок также применяется ко всем будущим окнам верхнего уровня. В macOS используется только первое изображение. [`wm_iconphoto()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_iconphoto) – псевдоним `iconphoto()`.14831484Добавлено в версии 3.3.14851486#### `iconposition(x=None, y=None)`14871488Устанавливает или запрашивает подсказку оконному менеджеру о том, где должен располагаться значок окна. Пустые строки отменяют имеющуюся подсказку. Без аргументов возвращает кортеж из двух текущих значений или пустую строку, если подсказка не задана. [`wm_iconposition()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_iconposition) – псевдоним `iconposition()`.14891490#### `iconwindow(pathName=None)`14911492Устанавливает или запрашивает окно, используемое в качестве значка окна. Когда окно свёрнуто, *pathName* отображается как его значок и снова скрывается при восстановлении. Пустая строка отменяет привязку. Без аргументов возвращает путь текущего окна-значка или пустую строку. Не все оконные менеджеры поддерживают окна-значки, и эта концепция бессмысленна на платформах, отличных от X11. [`wm_iconwindow()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_iconwindow) – псевдоним `iconwindow()`.14931494#### `manage(widget)`14951496Делает *widget* самостоятельным окном верхнего уровня, оформленным оконным менеджером с заголовком и т.д. Могут использоваться только виджеты [`Frame`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Frame), [`LabelFrame`](https://python-all.ru/3.13/library/tkinter.html#tkinter.LabelFrame) и [`Toplevel`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Toplevel) (версии из [`tkinter.ttk`](https://python-all.ru/3.13/library/tkinter.ttk.html#module-tkinter.ttk) **не** принимаются); передача любого другого типа виджета вызывает ошибку. [`wm_manage()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_manage) – псевдоним `manage()`.14971498Добавлено в версии 3.3.14991500#### `maxsize(width=None, height=None)`15011502Устанавливает или запрашивает максимально допустимые размеры окна в пикселях (или в единицах сетки для окна с сеткой). Оконный менеджер ограничивает окно размерами не больше *width* и *height*. Без аргументов возвращает кортеж текущих максимальной ширины и высоты. Максимальный размер по умолчанию равен размеру экрана. [`wm_maxsize()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_maxsize) – псевдоним `maxsize()`.15031504#### `minsize(width=None, height=None)`15051506Устанавливает или запрашивает минимально допустимые размеры окна в пикселях (или в единицах сетки для окна с сеткой). Оконный менеджер ограничивает окно размерами не меньше *width* и *height*. Без аргументов возвращает кортеж текущих минимальной ширины и высоты. Минимальный размер по умолчанию – один пиксель по каждому измерению. [`wm_minsize()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_minsize) – псевдоним `minsize()`.15071508#### `overrideredirect(boolean=None)`15091510Устанавливает или запрашивает флаг override-redirect для окна. Когда этот флаг установлен, оконный менеджер игнорирует окно: оно не помещается в декоративную рамку, и пользователь не может управлять им через обычные элементы управления оконного менеджера. Без аргументов возвращает булево значение, указывающее, установлен ли флаг. Флаг надёжно соблюдается только при первом отображении окна или при повторном отображении из состояния withdrawn. [`wm_overrideredirect()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_overrideredirect) – псевдоним `overrideredirect()`.15111512#### `positionfrom(who=None)`15131514Устанавливает или запрашивает источник текущего положения окна. *who* может быть `'program'` или `'user'`, указывает, было ли положение запрошено программой или пользователем; пустая строка отменяет текущий источник. Без аргументов возвращает текущий источник или пустую строку, если источник не установлен. Tk автоматически устанавливает источник в `'user'` при вызове [`geometry()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.geometry), если только явно не установлен `'program'`. [`wm_positionfrom()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_positionfrom) – псевдоним `positionfrom()`.15151516#### `protocol(name=None, func=None)`15171518Регистрирует *func* в качестве обработчика протокола оконного менеджера *name*, атома, такого как `'WM_DELETE_WINDOW'`, `'WM_SAVE_YOURSELF'` или `'WM_TAKE_FOCUS'`; после этого *func* вызывается при каждом получении сообщения этого протокола от оконного менеджера. Tk устанавливает обработчик по умолчанию для `WM_DELETE_WINDOW`, который уничтожает окно; этот метод может его заменить. Если *func* – пустая строка, обработчик удаляется. Только с *name* возвращает имя зарегистрированной команды-обработчика или пустую строку, если обработчик не установлен (обработчик по умолчанию для `WM_DELETE_WINDOW` не сообщается); без аргументов возвращает кортеж протоколов, для которых в данный момент есть обработчики. [`wm_protocol()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_protocol) – псевдоним `protocol()`.15191520#### `resizable(width=None, height=None)`15211522Управляет возможностью интерактивного изменения размера окна пользователем. *width* и *height* – булевы значения, определяющие, можно ли изменять ширину и высоту окна. Без аргументов возвращает кортеж из двух значений `0`/`1`, указывающих, можно ли изменять каждый размер в данный момент. По умолчанию размер окна можно изменять по обоим измерениям. [`wm_resizable()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_resizable) – псевдоним `resizable()`.15231524#### `sizefrom(who=None)`15251526Устанавливает или запрашивает источник текущего размера окна. *who* может быть `'program'` или `'user'`, указывает, был ли размер запрошен программой или пользователем; пустая строка отменяет текущий источник. Без аргументов возвращает текущий источник или пустую строку, если источник не установлен. [`wm_sizefrom()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_sizefrom) – псевдоним `sizefrom()`.15271528#### `state(newstate=None)`15291530Устанавливает или запрашивает состояние окна. Без аргументов возвращает текущее состояние: одно из `'normal'`, `'iconic'`, `'withdrawn'`, `'icon'` или, только в Windows и macOS, `'zoomed'`. `'iconic'` относится к свёрнутому окну, тогда как `'icon'` – к окну, служащему значком для другого окна (см. [`iconwindow()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.iconwindow)); состояние `'icon'` не может быть установлено. [`wm_state()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_state) – псевдоним `state()`.15311532Не путать с [`ttk.Widget.state`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Widget.state).15331534#### `title(string=None)`15351536Устанавливает или запрашивает заголовок окна, который оконный менеджер должен отображать в строке заголовка. Без аргументов возвращает текущий заголовок. По умолчанию заголовок равен имени окна. [`wm_title()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_title) – псевдоним `title()`.15371538#### `transient(master=None)`15391540Помечает окно как временное (например, выпадающее меню или диалог), работающее от имени *master*, пути к другому окну верхнего уровня. Пустая строка снимает статус временного окна. Без аргументов возвращает путь текущего владельца или пустую строку. Временное окно отражает изменения состояния своего владельца и может оформляться оконным менеджером иначе; ошибка – сделать окно временным для самого себя. [`wm_transient()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_transient) – псевдоним `transient()`.15411542#### `withdraw()`15431544Убирает окно с экрана, скрывая его и заставляя оконный менеджер забыть о нём. Если окно никогда не отображалось, оно отображается в состоянии withdrawn. Иногда необходимо скрыть окно и снова отобразить его (например, с помощью [`deiconify()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.deiconify)), чтобы некоторые оконные менеджеры заметили изменения атрибутов окна. [`wm_withdraw()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.wm_withdraw) – псевдоним `withdraw()`.15451546#### `class tkinter.Pack`15471548Менеджер геометрии, который размещает виджеты, прижимая их к сторонам контейнера. Миксин `Pack` наследуется всеми виджетами (через [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget)) и предоставляет методы для управления виджетом с помощью менеджера геометрии *pack*. См. также [паковщик](https://python-all.ru/3.13/library/tkinter.html#pack-the-packer).15491550> **Примечание**1551>1552> `Pack`, [`Place`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Place) и [`Grid`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid) определяют короткие имена методов `forget()`, `info()`, `slaves()`, `content()` и `propagate()`. Для виджета эти простые имена разрешаются в версии менеджера *pack*, поскольку `Pack` и [`Misc`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc) предшествуют `Place` и `Grid` в порядке разрешения методов, независимо от того, какой менеджер фактически управляет виджетом; а `configure()`/`config()` настраивают параметры виджета, а не его геометрию. Используйте явные методы `pack_*`, `grid_*` и `place_*` (и `pack`, `grid`, `place` для настройки геометрии), чтобы воздействовать на конкретный менеджер геометрии.15531554#### `pack_configure(cnf={}, **kw)`15551556#### `pack(cnf={}, **kw)`15571558Упаковывает виджет внутри его контейнера, позиционируя его относительно уже упакованных там соседних виджетов. Поддерживаемые параметры:15591560***side***15611562К какой стороне контейнера прижимать виджет: `'top'` (по умолчанию), `'bottom'`, `'left'` или `'right'`.15631564***fill***15651566Следует ли растягивать виджет, чтобы заполнить его участок: `'none'` (по умолчанию), `'x'`, `'y'` или `'both'`.15671568***expand***15691570Следует ли виджету расширяться, чтобы занять лишнее пространство в его контейнере (логическое значение, по умолчанию false).15711572***anchor***15731574Где позиционировать виджет в его участке, когда участок больше виджета: привязка, например `'n'` или `'sw'` (по умолчанию `'center'`).15751576***ipadx*, *ipady***15771578Внутренний отступ, добавляемый слева и справа (*ipadx*) или сверху и снизу (*ipady*) от виджета, задаётся в экранных единицах (по умолчанию `0`).15791580***padx*, *pady***15811582Внешний отступ, оставляемый слева и справа (*padx*) или сверху и снизу (*pady*) от виджета, задаётся в экранных единицах или как пара значений для каждой из двух сторон (по умолчанию `0`).15831584***after***15851586Упаковывает виджет после указанного виджета в порядке упаковки, используя тот же контейнер.15871588***before***15891590Упаковывает виджет перед указанным виджетом в порядке упаковки, используя тот же контейнер.15911592***in\_***15931594Контейнер, в который упаковывать виджет; по умолчанию – родительский виджет.15951596`pack()`, [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.configure) и [`config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.config) являются псевдонимами `pack_configure()`.15971598#### `pack_forget()`15991600Убирает виджет и удаляет его из порядка упаковки, забывая его параметры упаковки. Позже его можно снова упаковать с помощью [`pack_configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.pack_configure). [`forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.forget) является псевдонимом `pack_forget()`, за исключением [`PanedWindow`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow), [`ttk.Notebook`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Notebook) и [`ttk.PanedWindow`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.PanedWindow), которые предоставляют собственный метод `forget()`.16011602Не путать с [`Wm.forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.forget).16031604#### `pack_info()`16051606Возвращает словарь текущих параметров упаковки виджета. [`info()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.info) является псевдонимом `pack_info()`.16071608#### `pack_propagate()`16091610#### `pack_propagate(flag)`16111612То же, что и [`Misc.pack_propagate()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.pack_propagate), рассматривая этот виджет как контейнер: включить или отключить распространение геометрии. [`propagate()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.propagate) является псевдонимом `pack_propagate()`.16131614#### `pack_slaves()`16151616То же, что и [`Misc.pack_slaves()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.pack_slaves): возвращает список виджетов, упакованных в этот виджет. [`slaves()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.slaves) – псевдоним `pack_slaves()`.16171618#### `class tkinter.Place`16191620Менеджер геометрии, размещающий виджеты в явных позициях и размерах внутри их контейнера. Примесь `Place` наследуется всеми виджетами (через [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget)).16211622#### `place_configure(cnf={}, **kw)`16231624#### `place(cnf={}, **kw)`16251626Размещает виджет внутри его контейнера в абсолютной или относительной позиции. Поддерживаемые опции:16271628***x*, *y***16291630Абсолютные горизонтальная и вертикальная позиции опорной точки виджета как экранное расстояние (по умолчанию `0`).16311632***relx*, *rely***16331634Горизонтальная и вертикальная позиции опорной точки виджета как доля ширины и высоты контейнера, где `0.0` – это левый или верхний край, а `1.0` – правый или нижний край. Если указаны как абсолютная, так и относительная опции, их значения суммируются.16351636***anchor***16371638Какая точка виджета размещается в заданной позиции: опорная точка, например `'n'` или `'se'` (по умолчанию `'nw'`).16391640***width*, *height***16411642Абсолютные ширина и высота виджета как экранное расстояние. По умолчанию используется запрошенный размер виджета.16431644***relwidth*, *relheight***16451646Ширина и высота виджета как доля ширины и высоты контейнера. Если указаны как абсолютная, так и относительная опции, их значения суммируются.16471648***bordermode***16491650Как граница контейнера влияет на размещение: `'inside'` (по умолчанию) измеряет область внутри границы, `'outside'` измеряет область, включая границу, а `'ignore'` использует официальную область X.16511652***in\_***16531654Контейнер, относительно которого размещается виджет; он должен быть родителем виджета или потомком родителя, по умолчанию – родитель.16551656`place()`, [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Place.configure) и [`config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Place.config) являются псевдонимами `place_configure()`.16571658#### `place_forget()`16591660Скрыть виджет и удалить его из размещения, забыв его опции размещения.16611662#### `place_info()`16631664Возвращает словарь текущих опций размещения виджета.16651666#### `place_slaves()`16671668То же, что и [`Misc.place_slaves()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.place_slaves): возвращает список виджетов, размещённых в этом виджете.16691670#### `class tkinter.Grid`16711672Менеджер геометрии, располагающий виджеты в двумерной сетке строк и столбцов внутри их контейнера. Примесь `Grid` наследуется всеми виджетами (через [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget)).16731674#### `grid_configure(cnf={}, **kw)`16751676#### `grid(cnf={}, **kw)`16771678Помещает виджет в ячейку сетки его контейнера.16791680Не путать с [`Wm.grid()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm.grid).16811682Поддерживаемые параметры:16831684***строка*, *столбец***16851686Строка и столбец ячейки, в которую помещается виджет, с отсчётом от `0`. *Столбец* по умолчанию равен столбцу, следующему за последним виджетом, помещённым в том же вызове `grid_configure()` (или `0`), а *строка* по умолчанию равна следующей пустой строке.16871688***rowspan*, *columnspan***16891690Количество строк и столбцов, которое должен охватывать виджет (по умолчанию `1`).16911692***sticky***16931694Определяет расположение или растяжение виджета, когда его ячейка больше самого виджета: строка, содержащая ноль или более символов из `'n'`, `'s'`, `'e'` и `'w'`, указывающих стороны ячейки, к которым прикрепляется виджет. Указание одновременно `'n'` и `'s'` (или `'e'` и `'w'`) растягивает виджет на всю высоту (или ширину) ячейки. По умолчанию `''` – виджет центрируется в ячейке с сохранением запрошенного размера.16951696***ipadx*, *ipady***16971698Внутренний отступ, добавляемый слева и справа (*ipadx*) или сверху и снизу (*ipady*) от виджета, задаётся в экранных единицах (по умолчанию `0`).16991700***padx*, *pady***17011702Внешний отступ, оставляемый слева и справа (*padx*) или сверху и снизу (*pady*) от виджета, задаётся в экранных единицах или как пара значений для каждой из двух сторон (по умолчанию `0`).17031704***in\_***17051706Контейнер, в сетку которого помещается виджет; по умолчанию – родительский виджет.17071708`grid()`, [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.configure) и [`config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.config) являются псевдонимами `grid_configure()`.17091710#### `grid_forget()`17111712Скрывает виджет и удаляет его из сетки, забывая его параметры сетки.17131714#### `grid_remove()`17151716Скрывает виджет и удаляет его из сетки, но запоминает его параметры сетки, чтобы при повторном размещении он был восстановлен в той же ячейке.17171718#### `grid_info()`17191720Возвращает словарь текущих параметров сетки виджета.17211722#### `grid_bbox(column=None, row=None, col2=None, row2=None)`17231724То же, что и [`Misc.grid_bbox()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_bbox). [`bbox()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.bbox) – псевдоним `grid_bbox()`, за исключением [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox), [`Spinbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox), [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text), [`ttk.Entry`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Entry) и [`ttk.Treeview`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Treeview), которые предоставляют собственный метод `bbox()`.17251726#### `grid_columnconfigure(index, cnf={}, **kw)`17271728То же, что [`Misc.grid_columnconfigure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_columnconfigure): запрашивает или задаёт параметры столбца сетки (такие как *weight*, *minsize*, *pad* и *uniform*). [`columnconfigure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.columnconfigure) – псевдоним `grid_columnconfigure()`.17291730#### `grid_rowconfigure(index, cnf={}, **kw)`17311732То же, что [`Misc.grid_rowconfigure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_rowconfigure): запрашивает или задаёт параметры строки сетки. [`rowconfigure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.rowconfigure) – псевдоним `grid_rowconfigure()`.17331734#### `grid_location(x, y)`17351736То же, что [`Misc.grid_location()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_location): возвращает `(column, row)` ячейки, которая содержит пиксель с координатами *x*, *y*. [`location()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.location) – псевдоним `grid_location()`.17371738#### `grid_size()`17391740То же, что [`Misc.grid_size()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_size): возвращает кортеж `(columns, rows)`, содержащий размеры сетки. [`size()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.size) – псевдоним `grid_size()`, за исключением виджета [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox), который предоставляет собственный метод `size()`.17411742#### `grid_propagate()`17431744#### `grid_propagate(flag)`17451746То же, что и [`Misc.grid_propagate()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_propagate).17471748#### `grid_slaves(row=None, column=None)`17491750То же, что и [`Misc.grid_slaves()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_slaves): возвращает виджеты, управляемые сеткой, с возможностью ограничения по *строке* и/или *столбцу*.17511752#### `class tkinter.XView`17531754Примесь, предоставляющая интерфейс горизонтальной прокрутки, общий для виджетов, таких как [`Entry`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry), [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox), [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text) и [`Spinbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox). Метод [`xview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview) виджета регистрируется как *команда* горизонтального [`Scrollbar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Scrollbar).17551756#### `xview(*args)`17571758Запрашивает или изменяет горизонтальное положение вида. Без аргументов возвращает кортеж `(first, last)` из двух дробей от 0 до 1, указывающих долю документа, которая в данный момент видна. В противном случае аргументы передаются команде виджета Tk `xview` и обычно генерируются полосой прокрутки; [`xview_moveto()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview_moveto) и [`xview_scroll()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview_scroll) предоставляют более удобный интерфейс.17591760#### `xview_moveto(fraction)`17611762Настраивает вид так, чтобы *fraction* от общей ширины документа находилось слева за экраном. *fraction* – число от 0 до 1.17631764#### `xview_scroll(number, what)`17651766Сдвигает вид влево или вправо на *число* единиц. *what* может быть `'units'` или `'pages'`; отрицательное *число* прокручивает влево, положительное – вправо.17671768#### `class tkinter.YView`17691770Примесь, предоставляющая интерфейс вертикальной прокрутки, общий для виджетов, таких как [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox) и [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text). Метод [`yview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView.yview) виджета регистрируется как *команда* вертикального [`Scrollbar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Scrollbar).17711772#### `yview(*args)`17731774Запрашивает или изменяет вертикальное положение вида. Без аргументов возвращает кортеж `(first, last)` из двух дробей от 0 до 1, указывающих долю документа, которая в данный момент видна. В противном случае аргументы передаются команде виджета Tk `yview`, обычно генерируемой полосой прокрутки; [`yview_moveto()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView.yview_moveto) и [`yview_scroll()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView.yview_scroll) предоставляют более удобный интерфейс.17751776#### `yview_moveto(fraction)`17771778Настраивает вид так, чтобы *fraction* от общей высоты документа находилось над верхней границей экрана. *fraction* – число от 0 до 1.17791780#### `yview_scroll(number, what)`17811782Сдвигает вид вверх или вниз на *число* единиц. *what* может быть `'units'` или `'pages'`; отрицательное *число* прокручивает вверх, положительное – вниз.17831784#### `class tkinter.BaseWidget(master, widgetName, cnf={}, kw={}, extra=())`17851786Внутренний базовый класс для всех виджетов. Наследует от [`Misc`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc) и добавляет механизм, который создаёт нижележащий Tk-виджет; прикладной код обычно использует [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget) или конкретный класс виджета, а не создаёт экземпляр `BaseWidget` напрямую.17871788#### `destroy()`17891790Уничтожает этот виджет и все его дочерние элементы, удаляя соответствующие Tk-виджеты и связанные команды Tcl.17911792#### `class tkinter.Widget(master, widgetName, cnf={}, kw={}, extra=())`17931794Внутренний базовый класс для стандартных виджетов. Объединяет [`BaseWidget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.BaseWidget) с примесями менеджеров геометрии [`Pack`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack), [`Place`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Place) и [`Grid`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid), так что любой виджет может управляться любым из трёх менеджеров геометрии. Конкретные классы виджетов ([`Button`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Button), [`Label`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Label) и так далее) наследуют от `Widget`.17951796### Виджеты верхнего уровня17971798#### `class tkinter.Tk(screenName=None, baseName=None, className='Tk', useTk=True, sync=False, use=None)`17991800Создаёт виджет верхнего уровня Tk, который обычно является главным окном приложения, и инициализирует для него интерпретатор Tcl. Каждый экземпляр имеет свой собственный связанный интерпретатор Tcl. Наследует от [`Misc`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc) и [`Wm`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm).18011802Чтобы создать интерпретатор Tcl без инициализации подсистемы Tk, используйте фабричную функцию [`Tcl()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tcl).18031804Класс `Tk` обычно создаётся со значениями по умолчанию. Однако в настоящее время распознаются следующие именованные аргументы:18051806***screenName***18071808При указании (в виде строки) устанавливает переменную окружения `DISPLAY`. (только X11)18091810***baseName***18111812Имя файла профиля. По умолчанию *baseName* берётся из имени программы (`sys.argv[0]`).18131814***className***18151816Имя класса виджета. Используется как файл профиля, а также как имя, с которым вызывается Tcl (*argv0* в *interp*).18171818***useTk***18191820Если `True`, инициализировать подсистему Tk. Функция [`tkinter.Tcl()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tcl) устанавливает это в `False`.18211822***sync***18231824Если `True`, выполнять все команды X-сервера синхронно, чтобы ошибки сообщались немедленно. Может использоваться для отладки. (только X11)18251826***use***18271828Задаёт *id* окна, в которое встраивается приложение, вместо того чтобы создавать его как независимое окно верхнего уровня. *id* должен быть указан так же, как значение опции -use для виджетов верхнего уровня (то есть иметь форму, подобную возвращаемой [`winfo_id()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_id)).18291830Обратите внимание, что на некоторых платформах это будет работать корректно только если *id* ссылается на Tk-фрейм или окно верхнего уровня, у которых включена опция -container.18311832`Tk` читает и интерпретирует файлы профилей с именами `.className.tcl` и `.baseName.tcl` в интерпретатор Tcl и вызывает [`exec()`](https://python-all.ru/3.13/library/functions.html#exec) для содержимого `.className.py` и `.baseName.py`. Путь к файлам профилей задаётся переменной окружения `HOME` или, если она не определена, то [`os.curdir`](https://python-all.ru/3.13/library/os.html#os.curdir).18331834> **Примечание**1835>1836> В Windows создание интерпретатора Tcl (путём создания экземпляра `Tk` или вызова [`Tcl()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tcl)) устанавливает переменную окружения `HOME` для процесса, если она ещё не установлена, в `%HOMEDRIVE%%HOMEPATH%` (или `USERPROFILE`, или `c:\`). Это делается Tcl и может повлиять на другой код, который читает `HOME`.18371838#### `tk`18391840Объект приложения Tk, созданный созданием экземпляра `Tk`. Он предоставляет доступ к интерпретатору Tcl. Каждый виджет, прикреплённый к тому же экземпляру `Tk`, имеет одинаковое значение для своего атрибута [`tk`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk.tk).18411842#### `master`18431844Объект виджета, содержащий данный виджет. Для `Tk` `master` является [`None`](https://python-all.ru/3.13/library/constants.html#None), потому что это главное окно. Термины *master* и *parent* похожи и иногда используются как взаимозаменяемые имена аргументов; однако вызов [`winfo_parent()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.winfo_parent) возвращает строку с именем виджета, тогда как `master` возвращает объект. *parent*/*child* отражает древовидную связь, а *master* (или *container*)/*content* отражает структуру контейнера.18451846#### `children`18471848Непосредственные потомки этого виджета в виде [`dict`](https://python-all.ru/3.13/library/stdtypes.html#dict) с именами дочерних виджетов в качестве ключей и объектами экземпляров потомков в качестве значений.18491850#### `destroy()`18511852Уничтожить этот виджет и все дочерние виджеты, а для главного окна – завершить соединение с нижележащим интерпретатором Tcl.18531854#### `loadtk()`18551856Завершить загрузку и инициализацию подсистемы Tk. Это необходимо только в том случае, если интерпретатор был создан без Tk (например, через [`Tcl()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tcl)); он вызывается автоматически, когда *useTk* равно true.18571858#### `readprofile(baseName, className)`18591860Прочитать и выполнить (source) пользовательские файлы профилей `.className.tcl` и `.baseName.tcl` в интерпретатор Tcl, и выполнить соответствующие файлы `.className.py` и `.baseName.py`. Это вызывается во время инициализации; см. описание конструктора выше.18611862#### `report_callback_exception(exc, val, tb)`18631864Сообщить об исключении в колбэке. Вызывается, когда исключение распространяется из колбэка Tkinter; *exc*, *val* и *tb* – это тип исключения, значение и трассировка, возвращаемые [`sys.exc_info()`](https://python-all.ru/3.13/library/sys.html#sys.exc_info). Реализация по умолчанию выводит трассировку в [`sys.stderr`](https://python-all.ru/3.13/library/sys.html#sys.stderr). Может быть переопределена для настройки обработки ошибок, например для отображения трассировки в диалоговом окне.18651866#### `class tkinter.Toplevel(master=None, cnf={}, **kw)`18671868Виджет `Toplevel` – это окно верхнего уровня, похожее на [`Frame`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Frame), за исключением того, что его X-родителем является корневое окно экрана, а не его логический родитель. Его основное назначение – служить контейнером для диалоговых окон и других наборов виджетов; его видимые особенности – это только фон и необязательная 3D-рамка. Из заметных опций: *menu*, которая устанавливает [`Menu`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu) в качестве строки меню окна. Наследуется от [`BaseWidget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.BaseWidget) и [`Wm`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Wm), поэтому окно верхнего уровня управляется оконным менеджером. Полный список опций см. в руководстве по Tk `toplevel`.18691870### Классы виджетов18711872#### `class tkinter.Button(master=None, cnf={}, **kw)`18731874Виджет `Button` отображает текстовую строку, растровое изображение или картинку и вызывает команду при нажатии (по клику кнопкой мыши 1 на кнопке или, когда кнопка в фокусе, по нажатию пробела). Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget). В дополнение к стандартным опциям виджета, кнопка принимает опции, описанные на странице руководства Tk `button`, такие как *command* (колбэк, вызываемый при нажатии кнопки), *textvariable*, *state* и *default*.18751876#### `invoke()`18771878Вызывает команду, связанную с кнопкой, если она есть, и возвращает её результат, или пустую строку, если команда не задана. Игнорируется, если состояние кнопки `disabled`.18791880#### `flash()`18811882Мигает кнопкой, перерисовывая её несколько раз, чередуя активный и нормальный цвета. После мигания кнопка остаётся в том же нормальном или активном состоянии, что и при вызове метода. Игнорируется, если состояние кнопки `disabled`.18831884#### `class tkinter.Canvas(master=None, cnf={}, **kw)`18851886Виджет `Canvas` реализует структурированную графику. Он отображает любое количество *элементов*, таких как дуги, линии, овалы, многоугольники, прямоугольники, текст, растровые изображения, картинки и встроенные окна, которые можно рисовать, перемещать, менять их цвет и привязывать к событиям. Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget), [`XView`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView) и [`YView`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView), поэтому представление можно прокручивать по горизонтали и вертикали с помощью [`xview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview) и [`yview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView.yview). Обратитесь к странице руководства Tk `canvas` для полного списка опций виджета и элементов.18871888Каждый элемент имеет уникальный целочисленный *id*, присваиваемый при создании, и ноль или более строковых *тегов*. Тег – это произвольная строка, которая не должна иметь вид целого числа; один и тот же тег могут разделять несколько элементов, что делает теги удобными для группировки элементов. Специальный тег `'all'` соответствует каждому элементу на холсте, а `'current'` – верхнему элементу под указателем мыши. Большинство методов принимают аргумент *tagOrId*, который может быть целочисленным id, именующим один элемент, или тегом, именующим ноль или более элементов; как описано на странице руководства Tk `canvas`, тег также может быть логическим выражением из тегов, объединённых операторами `&&`, `||`, `^`, `!` и скобками. Когда метод, работающий с одним элементом, получает *tagOrId*, соответствующий нескольким элементам, он обычно использует самый нижний подходящий элемент в списке отображения.18891890Элементы хранятся в *списке отображения*, который определяет порядок рисования: элементы, расположенные позже в списке, рисуются поверх более ранних. Новый элемент помещается в начало списка; порядок можно изменить с помощью [`tag_raise()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.tag_raise) и [`tag_lower()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.tag_lower).18911892#### `create_arc(*args, **kw)`18931894#### `create_bitmap(*args, **kw)`18951896#### `create_image(*args, **kw)`18971898#### `create_line(*args, **kw)`18991900#### `create_oval(*args, **kw)`19011902#### `create_polygon(*args, **kw)`19031904#### `create_rectangle(*args, **kw)`19051906#### `create_text(*args, **kw)`19071908#### `create_window(*args, **kw)`19091910Создаёт новый элемент соответствующего типа и возвращает его целочисленный id. Каждый метод вызывается как `create_TYPE(coord..., **options)`: первые позиционные аргументы задают координаты, определяющие элемент (отдельные числа, единая последовательность чисел или пары координат), а ключевые аргументы устанавливают специфичные для элемента опции. Координаты и расстояния на экране могут быть заданы числами (интерпретируются как пиксели) или строками с суффиксом единицы измерения (`'m'`, `'c'`, `'i'` или `'p'` для миллиметров, сантиметров, дюймов или типографских пунктов), но всегда хранятся и возвращаются в пикселях.19111912Типы элементов: `arc` (область в форме дуги, являющаяся частью овала, задаваемая двумя диагонально противоположными углами `x1, y1, x2, y2` ограничивающего прямоугольника); `bitmap` (двухцветное растровое изображение, расположенное в точке `x, y`); `image` (изображение Tk, расположенное в точке `x, y`); `line` (линия или кривая через точки `x1, y1, ..., xn, yn`); `oval` (окружность или эллипс, вписанный в прямоугольник `x1, y1, x2, y2`); `polygon` (замкнутый многоугольник через точки `x1, y1, ..., xn, yn`); `rectangle` (прямоугольник с углами `x1, y1, x2, y2`); `text` (текстовая строка, расположенная в точке `x, y`); и `window` (дочерний виджет, встроенный в холст в точке `x, y`, задаваемый опцией *window*).19131914Большинство типов элементов принимают общий набор *стандартных опций элементов*, а также несколько опций, специфичных для каждого типа. Имена опций передаются как ключевые аргументы, без ведущего дефиса.19151916Стандартные опции элементов:19171918***fill***19191920Цвет, используемый для заливки внутренней части элемента, или для рисования элемента *line* или символов элемента *text*. Пустая строка (значение по умолчанию для всех типов, кроме *line* и *text*) оставляет элемент незаполненным.19211922***outline***19231924Цвет, используемый для рисования контура элемента. Пустая строка означает отсутствие контура.19251926***width***19271928Ширина контура, по умолчанию `1.0`. Не действует, если *outline* пусто.19291930***dash***19311932Штриховой узор для контура, задаваемый либо как последовательность длин сегментов в пикселях, либо как строка из символов `'.'`, `','`, `'-'`, `'_'` и пробела. Пустой узор (по умолчанию) рисует сплошной контур.19331934***dashoffset***19351936Начальное смещение в пикселях в узоре *dash*. Игнорируется, если узор *dash* отсутствует.19371938***stipple***19391940Битовая карта, используемая как трафаретный узор при заливке элемента. Полноценно поддерживается только на X11.19411942***outlinestipple***19431944Битовая карта, используемая как трафаретный узор при рисовании контура. Не действует, если *outline* пуст.19451946***offset*, *outlineoffset***19471948Смещение узоров заливки и контура, задаваемое как `'x,y'` или как сторона, например `'n'`, `'se'` или `'center'`. Смещения трафарета поддерживаются только на X11.19491950***state***19511952Переопределяет состояние холста для этого элемента; одно из `'normal'`, `'disabled'` или `'hidden'`.19531954***tags***19551956Один тег или последовательность тегов для привязки к элементу, заменяя все существующие теги.19571958У многих из этих опций есть варианты *active…* и *disabled…* (например, *activefill*, *disabledfill*, *activewidth*, *disableddash*, *activeoutline*, *disabledstipple*), которые переопределяют основную опцию, когда элемент является активным (под указателем мыши) или находится в отключённом состоянии.19591960Следующие типы элементов поддерживают дополнительные опции.19611962Для элементов `arc`:19631964***start***19651966Начало углового диапазона дуги, в градусах, измеряемое против часовой стрелки от положения «3 часа».19671968***extent***19691970Размер углового диапазона, в градусах против часовой стрелки от *start*.19711972***стиль***19731974Как рисуется дуга: `'pieslice'` (по умолчанию), `'chord'` или `'arc'`.19751976Для элементов `line`:19771978***arrow***19791980Где рисовать наконечники стрелок: `'none'` (по умолчанию), `'first'`, `'last'` или `'both'`.19811982***arrowshape***19831984Последовательность из трёх расстояний, описывающих форму наконечников стрелок.19851986***capstyle***19871988Как рисуются концы линий: `'butt'` (по умолчанию), `'projecting'` или `'round'`.19891990***joinstyle***19911992Как рисуются вершины линий: `'round'` (по умолчанию), `'bevel'` или `'miter'`.19931994***smooth***19951996Метод сглаживания: ложное значение (по умолчанию) без сглаживания, или `'true'`/`'bezier'` или `'raw'` для рисования линии в виде кривой.19971998***splinesteps***19992000Количество отрезков, аппроксимирующих каждый сплайн, когда *smooth* включён.20012002Для элементов `polygon`:20032004***joinstyle*, *smooth*, *splinesteps***20052006Как и для элементов `line`, применяется к контуру многоугольника.20072008Для элементов `text`:20092010***text***20112012Отображаемая строка; символы новой строки начинают новые строки.20132014***font***20152016Шрифт, используемый для текста.20172018***выравнивание***20192020Способ выравнивания строк: `'left'` (по умолчанию), `'right'` или `'center'`.20212022***anchor***20232024Как текст позиционируется относительно своей точки; по умолчанию `'center'`.20252026***width***20272028Максимальная длина строки; если не равна нулю, строки переносятся по пробелам.20292030***angle***20312032На сколько градусов поворачивать текст против часовой стрелки относительно точки позиционирования, от `0.0` до `360.0` (по умолчанию `0.0`).20332034***underline***20352036Индекс символа для подчёркивания или `-1`, если подчёркивание не требуется.20372038Для элементов `bitmap`:20392040***bitmap***20412042Отображаемое растровое изображение.20432044***anchor***20452046Как растровое изображение позиционируется относительно своей точки.20472048***background*, *foreground***20492050Цвета для пикселей `0` и `1` растрового изображения; пустой *background* делает пиксели `0` прозрачными. Для обоих есть варианты *active…* и *disabled…*, а для *bitmap* – варианты *activebitmap* и *disabledbitmap*.20512052Для элементов `image`:20532054***image***20552056Изображение Tk для отображения, предварительно созданное с помощью протоколов изображений.20572058***anchor***20592060Как изображение позиционируется относительно своей точки.20612062Для обоих параметров существуют варианты *active…* и *disabled…* (*activeimage*, *disabledimage*), используемые в активном и отключённом состояниях.20632064Для элементов `window`:20652066***window***20672068Встраиваемый виджет; он должен быть дочерним элементом холста или одного из его предков и не может быть окном верхнего уровня.20692070***anchor***20712072Как окно позиционируется относительно своей точки.20732074***width*, *height***20752076Размер, назначаемый окну; если ноль (по умолчанию), окну присваивается его запрошенный размер.20772078Элементы `oval` и `rectangle` не имеют опций, специфичных для типа; они используют только стандартные опции элементов.20792080> **Примечание**2081>2082> Tk 8.6 добавил опцию *angle*, а Tk 9.0 добавил опцию *underline* для элементов `text`.20832084#### `coords(tagOrId)`20852086#### `coords(tagOrId, coordList, /)`20872088#### `coords(tagOrId, /, *coordList)`20892090Запрос или изменение координат элемента. С одним только *tagOrId* возвращает список координат с плавающей запятой элемента, заданного *tagOrId* (первый подходящий, если соответствует нескольким). При указании новых координат заменяет координаты этого элемента на указанные; как и методы `create_*`, координаты могут быть заданы отдельными числами, одной последовательностью или парами координат. Возвращаемые координаты всегда в пикселях, независимо от единиц, использованных при задании; для прямоугольников, овалов и дуг они упорядочены как лево, верх, право, низ.20912092Изменено в версии 3.12: Аргументы теперь уплощаются: координаты могут быть заданы отдельными аргументами, одной последовательностью или сгруппированы парами, как в методах `create_*`.20932094#### `move(tagOrId, xAmount, yAmount, /)`20952096Перемещает каждый из элементов, заданных *tagOrId*, в координатном пространстве холста, добавляя *xAmount* к каждой координате x и *yAmount* к каждой координате y элемента.20972098#### `moveto(tagOrId, x='', y='')`20992100Перемещает элементы, заданные *tagOrId*, так, чтобы первая пара координат (левый верхний угол ограничивающей рамки) наименьшего подходящего элемента находилась в позиции (*x*, *y*). *x* или *y* могут быть пустой строкой, в этом случае соответствующая координата не изменяется. Все подходящие элементы сохраняют свои позиции относительно друг друга.21012102Добавлено в версии 3.8.21032104#### `scale(tagOrId, xOrigin, yOrigin, xScale, yScale, /)`21052106Масштабирует координаты всех элементов, заданных *tagOrId*, в координатном пространстве холста. Каждая координата x корректируется так, чтобы её расстояние от *xOrigin* изменилось в *xScale* раз, а каждая координата y – чтобы её расстояние от *yOrigin* изменилось в *yScale* раз (коэффициент `1.0` оставляет координату без изменений).21072108#### `delete(*tagOrIds)`21092110Удаляет каждый из элементов, заданных аргументами *tagOrIds*.21112112#### `dchars(tagOrId, first, /)`21132114#### `dchars(tagOrId, first, last, /)`21152116Удаляет из каждого элемента, заданного *tagOrId*, символы (для текстовых элементов) или координаты (для элементов-линий и многоугольников) в диапазоне от *first* до *last* включительно; *last* по умолчанию равен *first*. Элементы, не поддерживающие индексацию, игнорируют эту операцию.21172118#### `insert(tagOrId, beforeThis, string, /)`21192120Вставляет *string* в каждый из элементов, заданных *tagOrId*, непосредственно перед символом или координатой, индекс которой равен *beforeThis*. Для элементов-линий и многоугольников *string* должна быть допустимой последовательностью координат.21212122#### `itemcget(tagOrId, option)`21232124Возвращает текущее значение опции конфигурации *option* для элемента, заданного *tagOrId* (наименьший подходящий элемент, если соответствует нескольким). Это похоже на [`cget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.cget), но применяется к отдельному элементу.21252126#### `itemconfigure(tagOrId, cnf=None, **kw)`21272128Запрос или изменение опций конфигурации элементов, заданных *tagOrId*. Это отражает [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.configure), но применяется к отдельным элементам, а не ко всему холсту. Без опций возвращает словарь, описывающий текущие опции первого подходящего элемента; в противном случае устанавливает указанные опции для каждого подходящего элемента. Допустимые опции – это те, которые принимает соответствующий метод `create_*`. [`itemconfig()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.itemconfig) является псевдонимом `itemconfigure()`.21292130#### `type(tagOrId)`21312132Возвращает тип элемента, заданного *tagOrId* (первый подходящий, если соответствует нескольким), например `'rectangle'` или `'text'`, или `None`, если *tagOrId* не соответствует ни одному элементу.21332134#### `gettags(tagOrId, /)`21352136Возвращает кортеж тегов, связанных с элементом, заданным параметром *tagOrId* (первый подходящий элемент в порядке отображения, если подходит несколько). Возвращает пустой кортеж, если ни один элемент не подходит или у элемента нет тегов.21372138#### `dtag(tagOrId, /)`21392140#### `dtag(tagOrId, tagToDelete, /)`21412142Удаляет тег *tagToDelete* (по умолчанию равный *tagOrId*) из каждого элемента, заданного параметром *tagOrId*. Элементы, у которых нет этого тега, остаются без изменений.21432144#### `addtag(newtag, searchSpec, /, *args)`21452146Добавляет тег *newtag* каждому элементу, выбранному по спецификации поиска *searchSpec* (и любым дополнительным параметрам *args*). *searchSpec* – одно из значений: `'above'`, `'all'`, `'below'`, `'closest'`, `'enclosed'`, `'overlapping'` или `'withtag'`; приведённые ниже методы `addtag_*` – это удобные обёртки, предоставляющие каждую из этих форм.21472148#### `addtag_above(newtag, tagOrId)`21492150Добавляет тег *newtag* элементу, расположенному непосредственно над (после) *tagOrId* в списке отображения.21512152#### `addtag_all(newtag)`21532154Добавляет тег *newtag* всем элементам на холсте.21552156#### `addtag_below(newtag, tagOrId)`21572158Добавляет тег *newtag* элементу, расположенному непосредственно под (перед) *tagOrId* в списке отображения.21592160#### `addtag_closest(newtag, x, y, halo=None, start=None)`21612162Добавляет тег *newtag* элементу, ближайшему к точке (*x*, *y*). Если задан *halo*, любой элемент в пределах этого расстояния от точки считается перекрывающим её. Если задан *start* (тег или id), выбирается самый верхний ближайший элемент, который находится ниже *start* в списке отображения. Это можно использовать для последовательного перебора всех ближайших элементов.21632164#### `addtag_enclosed(newtag, x1, y1, x2, y2)`21652166Добавляет тег *newtag* каждому элементу, полностью находящемуся внутри прямоугольника (*x1*, *y1*, *x2*, *y2*), где *x1* \<= *x2* и *y1* \<= *y2*.21672168#### `addtag_overlapping(newtag, x1, y1, x2, y2)`21692170Добавляет тег *newtag* каждому элементу, который перекрывает прямоугольник (*x1*, *y1*, *x2*, *y2*) или находится внутри него, где *x1* \<= *x2* и *y1* \<= *y2*.21712172#### `addtag_withtag(newtag, tagOrId)`21732174Добавляет тег *newtag* каждому элементу, заданному параметром *tagOrId*.21752176#### `find(searchSpec, /, *args)`21772178Возвращает кортеж идентификаторов всех элементов, выбранных по спецификации поиска *searchSpec* (и любым дополнительным параметрам *args*), в порядке наложения, начиная с самого нижнего элемента. Спецификация поиска может быть любой из форм, принимаемых методом [`addtag()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.addtag). Приведённые ниже методы `find_*` являются более удобными обёртками для него.21792180#### `find_above(tagOrId)`21812182Возвращает кортеж, содержащий идентификатор элемента, расположенного непосредственно над *tagOrId* в списке отображения.21832184#### `find_all()`21852186Возвращает кортеж идентификаторов всех элементов на холсте в порядке наложения.21872188#### `find_below(tagOrId)`21892190Возвращает кортеж, содержащий идентификатор элемента, расположенного непосредственно под *tagOrId* в списке отображения.21912192#### `find_closest(x, y, halo=None, start=None)`21932194Возвращает кортеж, содержащий идентификатор элемента, ближайшего к точке (*x*, *y*). Параметры *halo* и *start* интерпретируются так же, как в [`addtag_closest()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.addtag_closest).21952196#### `find_enclosed(x1, y1, x2, y2)`21972198Возвращает кортеж идентификаторов всех элементов, полностью находящихся внутри прямоугольника (*x1*, *y1*, *x2*, *y2*).21992200#### `find_overlapping(x1, y1, x2, y2)`22012202Возвращает кортеж идентификаторов всех элементов, которые перекрываются или находятся внутри прямоугольника (*x1*, *y1*, *x2*, *y2*).22032204#### `find_withtag(tagOrId)`22052206Возвращает кортеж идентификаторов всех элементов, заданных *tagOrId*.22072208#### `tag_raise(tagOrId, aboveThis=None, /)`22092210Перемещает все элементы, заданные *tagOrId*, на новую позицию в списке отображения сразу над элементом, заданным *aboveThis*, или в верхнюю часть списка отображения, если *aboveThis* опущен. При перемещении нескольких элементов их относительный порядок сохраняется. Это не влияет на встроенные оконные элементы, порядок наложения которых вместо этого управляется [`Misc.tkraise()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.tkraise) и [`Misc.lower()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.lower). [`lift()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.lift) и [`tkraise()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.tkraise) – псевдонимы `tag_raise()`.22112212#### `tag_lower(tagOrId, belowThis=None, /)`22132214Перемещает все элементы, заданные *tagOrId*, на новую позицию в списке отображения сразу под элементом, заданным *belowThis*, или в нижнюю часть списка отображения, если *belowThis* опущен. При перемещении нескольких элементов их относительный порядок сохраняется. Это не влияет на встроенные оконные элементы. [`lower()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.lower) – псевдоним `tag_lower()`.22152216> **Примечание**2217>2218> В классе `Canvas` методы [`tkraise()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.tkraise)/[`lift()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.lift) и [`lower()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.lower) изменяют порядок наложения элементов canvas, переопределяя унаследованные методы [`Misc.tkraise()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.tkraise)/[`Misc.lift()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.lift) и [`Misc.lower()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.lower), которые изменяют порядок самого виджета; поэтому эти унаследованные методы недоступны.22192220#### `tag_bind(tagOrId, sequence=None, func=None, add=None)`22212222Привязывает колбэк *func* к событию *sequence* для всех элементов, заданных *tagOrId*, так что *func* вызывается всякий раз, когда это событие происходит для одного из этих элементов. Это похоже на [`Widget.bind`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind), но работает с элементами canvas, а не с целыми виджетами; можно привязывать только события мыши, клавиатуры и виртуальные. События мыши направляются текущему элементу, а события клавиатуры – элементу с фокусом (см. [`focus()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.focus)). Если *add* истинно, новая привязка добавляется к уже существующим привязкам для того же события, а не заменяет их. Возвращает идентификатор привязанной функции, который можно передать [`tag_unbind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.tag_unbind).22232224#### `tag_unbind(tagOrId, sequence, funcid=None)`22252226Удаляет для всех элементов, заданных *tagOrId*, привязку к событию *sequence*. Если задан *funcid*, отвязывается и удаляется только этот колбэк (возвращённый [`tag_bind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.tag_bind)).22272228Изменено в версии 3.13: Если указан *funcid*, отвязывается только этот колбэк.22292230#### `bbox(tagOrId, /, *tagOrIds)`22312232Возвращает 4-кортеж `(x1, y1, x2, y2)`, задающий приблизительный ограничивающий прямоугольник в пикселях, который охватывает все элементы, заданные *tagOrId* и любыми дополнительными *tagOrIds*. Результат может превышать истинный ограничивающий прямоугольник на несколько пикселей. Возвращает `None`, если ни один элемент не соответствует или соответствующие элементы нечего отображать.22332234Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.22352236#### `canvasx(screenx, gridspacing=None)`22372238По заданной x-координате окна *screenx* возвращает x-координату canvas, отображаемую в этой позиции. Если задан *gridspacing*, результат округляется до ближайшего кратного *gridspacing* единицам.22392240#### `canvasy(screeny, gridspacing=None)`22412242По заданной y-координате окна *screeny* возвращает y-координату canvas, отображаемую в этой позиции. Если задан *gridspacing*, результат округляется до ближайшего кратного *gridspacing* единицам.22432244#### `focus()`22452246#### `focus(tagOrId, /)`22472248С параметром *tagOrId* устанавливает фокус клавиатуры canvas на первый элемент, заданный *tagOrId*, который поддерживает курсор вставки; если такого элемента нет, фокус остаётся без изменений. Если *tagOrId* – пустая строка, сбрасывает фокус так, что ни один элемент не имеет фокуса. Без аргументов возвращает идентификатор элемента, который в данный момент имеет фокус, или пустую строку, если такого нет. Элемент отображает курсор вставки только когда он сам является элементом с фокусом и его canvas имеет фокус ввода.22492250Этот метод затеняет унаследованный `Misc.focus()`; используйте [`focus_set()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.focus_set) для фокусировки самого виджета.22512252#### `icursor(tagOrId, index, /)`22532254Устанавливает курсор вставки элементов, заданных *tagOrId*, непосредственно перед символом, заданным *index*. Элементы, не поддерживающие курсор вставки, не затрагиваются. Курсор отображается только когда элемент имеет фокус, но его положение можно установить в любое время.22552256#### `index(tagOrId, index, /)`22572258Возвращает в виде целого числа числовой индекс внутри *tagOrId*, соответствующий *index*, который представляет собой текстовое описание позиции (для текстовых элементов – индекс символа, для отрезков и многоугольников – индекс в координатах). Если *tagOrId* соответствует нескольким элементам, используется первый из них, поддерживающий индексацию.22592260#### `select_adjust(tagOrId, index)`22612262Настраивает конец выделения в *tagOrId*, ближайший к *index*, так чтобы он находился на *index*, и делает другой конец якорной точкой для будущих вызовов [`select_to()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.select_to). Если выделение в данный момент не находится в *tagOrId*, это действует как `select_to()`.22632264#### `select_clear()`22652266Очищает выделение, если оно есть на этом холсте; в противном случае ничего не делает.22672268#### `select_from(tagOrId, index)`22692270Устанавливает точку привязки выделения непосредственно перед символом, заданным *index* в элементе, заданном *tagOrId*. Это не изменяет само выделение; оно устанавливает фиксированный конец для будущих вызовов [`select_to()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.select_to).22712272#### `select_item()`22732274Возвращает идентификатор элемента, содержащего выделение, или `None`, если выделение отсутствует на этом холсте. В отличие от методов [`find()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.find) и `find_*`, этот метод возвращает идентификатор в виде строки, а не целого числа.22752276#### `select_to(tagOrId, index)`22772278Устанавливает выделение на символы элемента *tagOrId* между точкой привязки выделения и *index*, включительно по *index*. Точкой привязки является та, что установлена последним вызовом [`select_adjust()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.select_adjust) или [`select_from()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.select_from).22792280#### `scan_mark(x, y)`22812282Запоминает *x*, *y* и текущий вид для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.scan_dragto). Обычно привязывается к нажатию кнопки мыши в виджете.22832284#### `scan_dragto(x, y, gain=10)`22852286Прокручивает холст на величину, равную *gain*, умноженному на разницу между *x*, *y* и координатами, переданными последнему вызову [`scan_mark()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas.scan_mark). Обычно это привязывается к событиям движения мыши на виджете, создавая эффект перетаскивания холста с высокой скоростью в его окне.22872288#### `postscript(cnf={}, **kw)`22892290Генерирует представление части или всего холста в формате PostScript (Encapsulated PostScript, версия 3.0). Если задан параметр *file* или *channel*, PostScript записывается туда и возвращается пустая строка; в противном случае он возвращается в виде строки. По умолчанию генерируется только область, видимая в данный момент в окне, поэтому обычно необходимо либо сначала вызвать [`update()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.update), либо использовать параметры *width* и *height*. Поддерживаемые параметры включают *colormap*, *colormode*, *file*, *fontmap*, *height*, *pageanchor*, *pageheight*, *pagewidth*, *pagex*, *pagey*, *rotate*, *width*, *x* и *y*.22912292#### `class tkinter.Checkbutton(master=None, cnf={}, **kw)`22932294Виджет `Checkbutton` отображает текстовую строку, растровое изображение или картинку вместе с квадратным индикатором и переключает логическое выделение при нажатии. Он обладает всем поведением простой кнопки и, кроме того, может быть выбран: при выборе индикатор рисуется с галочкой, а связанная переменная устанавливается в значение `onvalue`, а при отмене выбора индикатор рисуется пустым, а переменная устанавливается в значение `offvalue`. Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget). В дополнение к стандартным опциям виджета, флажок принимает опции, описанные на странице руководства Tk `checkbutton`, такие как *variable*, *onvalue*, *offvalue* и *command*.22952296#### `invoke()`22972298Делает то же самое, что произошло бы при нажатии пользователем на флажок мышью: переключает состояние выделения кнопки и вызывает связанную команду, если она есть. Возвращает результат команды или пустую строку, если с флажком не связана ни одна команда. Это игнорируется, если состояние флажка равно `disabled`.22992300#### `select()`23012302Выбирает флажок и устанавливает связанную переменную в его значение `onvalue`.23032304#### `deselect()`23052306Отменяет выбор флажка и устанавливает связанную переменную в его значение `offvalue`.23072308#### `toggle()`23092310Переключает состояние выделения кнопки, перерисовывая её и изменяя связанную переменную, чтобы отразить новое состояние.23112312#### `flash()`23132314Мигает флажком, перерисовывая его несколько раз, чередуя активный и обычный цвета. По окончании мигания флажок остаётся в том же обычном или активном состоянии, в котором он был при вызове метода. Это игнорируется, если состояние флажка равно `disabled`.23152316#### `class tkinter.Entry(master=None, cnf={}, **kw)`23172318Виджет `Entry` отображает одну строку текста и позволяет пользователю редактировать её. Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget) и [`XView`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView); поскольку поля ввода могут содержать слишком длинные строки, не помещающиеся в окно, они поддерживают горизонтальную прокрутку через [`xview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview).23192320В дополнение к стандартным опциям виджета, поле ввода принимает опции, описанные на странице руководства Tk `entry`. Примечательными являются *textvariable* (имя переменной, синхронизируемой с содержимым поля ввода), *show* (если установлено, каждый символ отображается как заданный символ, а не его истинное значение, полезно для ввода пароля), *validate* и *validatecommand* (которые вместе позволяют колбэку принять или отклонить правки), а также *state* (одно из значений `'normal'`, `'disabled'` или `'readonly'`).23212322Многие из приведенных ниже методов принимают аргумент *index*, который выбирает символ в строке поля ввода. Как описано на странице руководства Tk `entry`, *index* может быть числом (начиная с 0), `'insert'` (символ сразу после курсора вставки), `'end'` (сразу после последнего символа), `'anchor'` (точка привязки выделения), `'sel.first'` и `'sel.last'` (концы выделения), или `@x` (символ, соответствующий пиксельной координате x *x* в окне). Индексы вне диапазона округляются до ближайшего допустимого значения.23232324#### `delete(first, last=None)`23252326Удаляет символы от индекса *first* до индекса *last*, не включая его. Если *last* опущен, удаляется только один символ на позиции *first*.23272328#### `get()`23292330Возвращает текущую строку виджета Entry.23312332#### `insert(indexstring)`23332334Вставляет *string* непосредственно перед символом, заданным *index*.23352336#### `icursor(index)`23372338Устанавливает отображение курсора вставки непосредственно перед символом, заданным *index*.23392340#### `index(index)`23412342Возвращает числовой индекс, соответствующий *index*.23432344#### `selection_adjust(index)`23452346Находит конец выделения, ближайший к символу, заданному *index*, и перемещает этот конец на *index* (включительно, но не дальше); другой конец становится якорной точкой для последующих вызовов [`selection_to()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.selection_to). Если в поле ввода нет выделения, создаётся новое между *index* и последней якорной точкой включительно. [`select_adjust()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.select_adjust) – это псевдоним `selection_adjust()`.23472348#### `selection_clear()`23492350Очищает выделение, если оно находится в данном виджете. Если выделение не в этом виджете, метод не даёт эффекта. [`select_clear()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.select_clear) – это псевдоним `selection_clear()`.23512352> **Примечание**2353>2354> Этот метод переопределяет унаследованный [`Misc.selection_clear()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.selection_clear), который очищает X-выделение; этот метод недоступен для виджета `Entry`.23552356#### `selection_from(index)`23572358Устанавливает якорную точку выделения непосредственно перед символом, заданным *index*, не изменяя выделения. [`select_from()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.select_from) – это псевдоним `selection_from()`.23592360#### `selection_present()`23612362Возвращает `True`, если в поле ввода есть выделенные символы, иначе `False`. [`select_present()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.select_present) – это псевдоним `selection_present()`.23632364#### `selection_range(start, end)`23652366Устанавливает выделение, включающее символы, начиная с символа, индексированного *start*, и заканчивая символом, непосредственно предшествующим *end*. Если *end* ссылается на тот же символ, что и *start*, или более ранний, то выделение очищается. [`select_range()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.select_range) – это псевдоним `selection_range()`.23672368#### `selection_to(index)`23692370Устанавливает выделение между якорной точкой и *index*: если *index* находится до якорной точки, выделение идёт от *index* до якорной точки, не включая её; если *index* находится после неё, от якорной точки до *index*, не включая; если они совпадают, ничего не происходит. Якорная точка – это точка, установленная последним вызовом [`selection_from()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.selection_from) или [`selection_adjust()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.selection_adjust). Если в поле ввода нет выделения, создаётся новое с использованием последней якорной точки. [`select_to()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.select_to) – это псевдоним `selection_to()`.23712372#### `scan_mark(x)`23732374Запоминает *x* и текущий вид в окне поля ввода для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.scan_dragto). Обычно связано с нажатием кнопки мыши в виджете.23752376#### `scan_dragto(x)`23772378Вычисляет разницу между *x* и *x*, переданным в последний вызов [`scan_mark()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry.scan_mark), и смещает вид влево или вправо на 10-кратную величину этой разницы. Обычно используется с событиями движения мыши, чтобы создать эффект перетаскивания поля ввода с высокой скоростью по окну.23792380#### `class tkinter.Frame(master=None, cnf={}, **kw)`23812382Виджет `Frame` – это простой контейнер. Его основное назначение – служить разделителем или контейнером для сложных макетов окон; его единственные возможности – это фон и необязательная трёхмерная рамка, чтобы рамка выглядела приподнятой или утопленной. Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget). Обратитесь к странице руководства Tk `frame` для полного списка параметров.23832384#### `class tkinter.Label(master=None, cnf={}, **kw)`23852386Виджет `Label` отображает неинтерактивную текстовую строку, растровое изображение или картинку. Отображаемый текст задаётся параметром *text* или связывается с переменной через *textvariable*, а изображение можно показать с помощью параметра *image*. Весь текст должен быть одного шрифта, но может занимать несколько строк, и один символ может быть подчёркнут с помощью параметра *underline*. Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget). Обратитесь к странице руководства Tk `label` для полного списка параметров.23872388#### `class tkinter.LabelFrame(master=None, cnf={}, **kw)`23892390Виджет `LabelFrame` – это контейнер, который обладает возможностями [`Frame`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Frame) плюс возможность отображать метку. Текст метки задаётся параметром *text* и позиционируется с помощью *labelanchor*, или в качестве метки можно использовать произвольный виджет, передав его в параметре *labelwidget*. Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget). Обратитесь к странице руководства Tk `labelframe` для полного списка параметров.23912392#### `class tkinter.Listbox(master=None, cnf={}, **kw)`23932394Виджет `Listbox` отображает список однострочных текстовых элементов, по одному на строку, из которых пользователь может выбрать один или несколько. Поведение выделения определяется параметром *selectmode*, который может быть одним из: `browse` (по умолчанию; не более одного элемента, который можно перетаскивать мышью), `single` (не более одного элемента), `multiple` (любое количество элементов, переключаются индивидуально) или `extended` (любое количество элементов, включая несмежные диапазоны, выбираются щелчком и перетаскиванием). Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget), [`XView`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView) и [`YView`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView), поэтому представление можно прокручивать по горизонтали и вертикали с помощью [`xview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview) и [`yview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView.yview). Обратитесь к странице руководства Tk `listbox` для полного списка параметров.23952396Многие из методов принимают аргумент *индекс*, идентифицирующий конкретный элемент. Как описано на странице руководства Tk `listbox`, *индекс* может быть числовым индексом (начиная с 0 сверху), `'active'` (элемент в позиции курсора, задаётся с помощью [`activate()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.activate)), `'anchor'` (якорь выделения, задаётся с помощью [`selection_anchor()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.selection_anchor)), `'end'` (последний элемент, или для [`index()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.index) и [`insert()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.insert) позиция сразу после него), или `@x,y` (элемент, покрывающий пиксельные координаты *x*, *y* в окне listbox). Аргументы с именами *first* и *last* являются индексами тех же форм.23972398#### `insert(index, *elements)`23992400Вставляет заданные *элементы* как новые элементы непосредственно перед элементом, заданным *индексом*. Если *индекс* равен `'end'`, новые элементы добавляются в конец списка.24012402#### `delete(first, last=None)`24032404Удаляет элементы в диапазоне от *first* до *last* включительно. Если *last* опущен, по умолчанию используется *first*, так что удаляется один элемент.24052406#### `get(first, last=None)`24072408Если *last* опущен, возвращает содержимое элемента, заданного *first*, или пустую строку, если *first* ссылается на несуществующий элемент. Если *last* задан, возвращает кортеж всех элементов в диапазоне от *first* до *last* включительно.24092410#### `size()`24112412Возвращает общее количество элементов в listbox.24132414Этот метод затеняет унаследованный `Misc.size()`; используйте [`grid_size()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_size) для размера сетки.24152416#### `index(index)`24172418Возвращает целочисленное значение индекса, соответствующее *индексу*, или `None`, если *индекс* выходит за пределы диапазона. Если *индекс* равен `'end'`, результатом является количество элементов в listbox (не индекс последнего элемента).24192420#### `bbox(index)`24212422Возвращает кортеж `(x, y, width, height)`, описывающий ограничивающий прямоугольник (в пикселях относительно виджета) текста элемента, заданного *индексом*. Возвращает `None`, если ни одна часть этого элемента не видна на экране, или если *индекс* ссылается на несуществующий элемент; если элемент виден лишь частично, результат всё равно даёт полную область элемента, включая невидимые части.24232424Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.24252426#### `nearest(y)`24272428По заданной y-координате в окне listbox возвращает индекс видимого элемента, ближайшего к этой y-координате.24292430#### `see(index)`24312432Настраивает отображение так, чтобы элемент, заданный *индексом*, стал видимым. Если элемент уже видим, метод не даёт эффекта; если он находится у края окна, listbox прокручивается ровно настолько, чтобы показать его у этого края; в противном случае listbox прокручивается, чтобы центрировать элемент.24332434#### `activate(index)`24352436Устанавливает активный элемент равным элементу, заданному *индексом*. Если *индекс* находится вне диапазона элементов, вместо него активируется ближайший элемент. Активный элемент отображается в соответствии с опцией *activestyle*, когда виджет имеет фокус ввода; его индекс можно получить с помощью индекса `'active'`.24372438#### `curselection()`24392440Возвращает кортеж, содержащий числовые индексы всех элементов, которые в данный момент выбраны, или пустой кортеж, если ни один элемент не выбран.24412442#### `selection_anchor(index)`24432444Устанавливает якорь выделения на элемент, заданный *индексом*. Если *индекс* ссылается на несуществующий элемент, используется ближайший элемент. Якорь выделения – это конец выделения, который остаётся фиксированным при расширении выделения мышью; впоследствии на него можно ссылаться с помощью индекса `'anchor'`. [`select_anchor()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.select_anchor) является псевдонимом `selection_anchor()`.24452446#### `selection_clear(first, last=None)`24472448Снимает выделение с любых элементов в диапазоне от *first* до *last* включительно, которые выделены. Состояние выделения элементов вне этого диапазона не изменяется. [`select_clear()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.select_clear) является псевдонимом `selection_clear()`.24492450> **Примечание**2451>2452> Этот метод переопределяет унаследованный [`Misc.selection_clear()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.selection_clear), который очищает X-выделение; этот метод недоступен в `Listbox`.24532454#### `selection_includes(index)`24552456Возвращает `True`, если элемент, заданный *индексом*, в данный момент выбран, иначе `False`. [`select_includes()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.select_includes) является псевдонимом `selection_includes()`.24572458#### `selection_set(first, last=None)`24592460Выделяет все элементы в диапазоне от *first* до *last* включительно, не затрагивая состояние выделения элементов вне этого диапазона. [`select_set()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.select_set) является псевдонимом `selection_set()`.24612462#### `itemcget(index, option)`24632464Возвращает текущее значение конфигурационного параметра *option* для элемента, заданного *index*.24652466#### `itemconfigure(index, cnf=None, **kw)`24672468Запрашивает или изменяет параметры конфигурации элемента, заданного *index*. Это зеркально отражает [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.configure), но применяется к отдельному элементу, а не ко всему списковому полю. Без параметров возвращает словарь с описанием текущих параметров элемента; иначе устанавливает переданные параметры. Поддерживаемые параметры элемента: *background*, *foreground*, *selectbackground* и *selectforeground*. [`itemconfig()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.itemconfig) – это псевдоним `itemconfigure()`.24692470#### `scan_mark(x, y)`24712472Запоминает *x*, *y* и текущий вид для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.scan_dragto). Обычно привязывается к нажатию кнопки мыши в виджете.24732474#### `scan_dragto(x, y)`24752476Прокручивает список на величину, равную разнице между *x*, *y* и координатами, переданными последнему вызову [`scan_mark()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox.scan_mark), умноженную на 10. Обычно привязывается к событиям движения мыши в виджете, создавая эффект быстрого перетаскивания списка по окну.24772478#### `class tkinter.Menu(master=None, cnf={}, **kw)`24792480Виджет `Menu` отображает столбец записей, каждая из которых может быть командой, флажком, радиокнопкой, каскадом (который открывает связанное подменю) или разделителем. Меню используются как строка меню главного окна, как выпадающие меню, открываемые из каскадной записи или кнопки меню, а также как контекстные меню. Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget).24812482Многие методы записей принимают аргумент *index*, определяющий, с какой записью работать. Как описано на странице руководства Tk `menu`, *index* может быть числовым индексом (начиная с 0 сверху), `'active'` (текущая активная запись), `'end'` или `'last'` (самая нижняя запись), `'none'` (нет записи, в Tcl записывается как `{}`), `@y` (запись, покрывающая пиксельную координату y *y* в окне меню) или шаблоном, который сопоставляется с метками записей сверху вниз.24832484#### `add(itemType, cnf={}, **kw)`24852486Добавляет новую запись в конец меню. *itemType* – одно из значений `'command'`, `'cascade'`, `'checkbutton'`, `'radiobutton'` или `'separator'` и определяет тип новой записи; остальные параметры настраивают её. Методы-сокращения `add_command()`, `add_cascade()`, `add_checkbutton()`, `add_radiobutton()` и `add_separator()` вызывают этот метод с соответствующим *itemType*.24872488Запись настраивается следующими параметрами, хотя не каждый параметр применим ко всем типам записей (разделитель не принимает ни одного из них):24892490***label***24912492Текст, отображаемый в записи.24932494***command***24952496Функция, вызываемая при активации записи (для записей типа command, checkbutton и radiobutton).24972498***accelerator***24992500Строка, отображаемая справа от записи для указания клавиш быстрого вызова; сама она не создаёт привязку.25012502***underline***25032504Индекс символа в метке, который будет подчёркнут для навигации с клавиатуры.25052506***state***25072508Одно из `'normal'`, `'active'` или `'disabled'`.25092510***image***25112512Изображение, отображаемое вместо текстовой метки или вместе с ней.25132514***составной***25152516Где показывать изображение относительно текста: `'none'` (по умолчанию), `'text'`, `'image'`, `'top'`, `'bottom'`, `'left'` или `'right'`.25172518***bitmap***25192520Растровое изображение, отображаемое вместо текстовой метки.25212522***font***25232524Шрифт, используемый для текста.25252526***background*, *foreground***25272528Цвета фона и текста элемента в обычном состоянии (игнорируется на macOS).25292530***activebackground*, *activeforeground***25312532Цвета фона и текста, используемые, когда элемент активен (игнорируется на macOS).25332534***columnbreak***25352536Если true, элемент начинает новую колонку вместо того, чтобы располагаться под предыдущим элементом.25372538***hidemargin***25392540Если true, стандартный отступ вокруг элемента убирается; это полезно, когда меню используется как палитра.25412542***menu***25432544Подменю, открываемое каскадным элементом; оно должно быть дочерним по отношению к данному меню.25452546***переменная***25472548Переменная, связанная с элементом флажка или переключателя.25492550***onvalue*, *offvalue***25512552Значения, сохраняемые в *variable*, когда элемент флажка выбран или сброшен.25532554***значение***25552556Значение, сохраняемое в *variable*, когда элемент переключателя выбран.25572558***indicatoron***25592560Определяет, отображать ли индикатор элемента флажка или переключателя.25612562***selectcolor***25632564Цвет индикатора элемента флажка или переключателя, когда он выбран.25652566***selectimage***25672568Изображение, отображаемое, когда элемент флажка или переключателя выбран и также задано *image*.25692570#### `add_cascade(cnf={}, **kw)`25712572Добавляет новый каскадный элемент в нижнюю часть меню. Каскадный элемент имеет связанное подменю, задаваемое его опцией *menu*, которая должна быть дочерним меню по отношению к данному меню; при открытии элемента подменю отображается рядом с ним.25732574#### `add_checkbutton(cnf={}, **kw)`25752576Добавляет новый элемент флажка в нижнюю часть меню. При вызове элемент флажка переключается между значениями *onvalue* и *offvalue*, сохраняя результат в связанной *variable*, и отображает индикатор, показывающий, выбран ли он.25772578#### `add_command(cnf={}, **kw)`25792580Добавляет новый командный элемент в нижнюю часть меню. Командный элемент ведёт себя как кнопка: при его вызове выполняется колбэк, заданный опцией *command*.25812582#### `add_radiobutton(cnf={}, **kw)`25832584Добавляет новый элемент переключателя в нижнюю часть меню. Элементы переключателей, использующие одну и ту же *variable*, образуют группу, в которой в любой момент может быть выбран только один; при выборе элемента его *value* сохраняется в переменной.25852586#### `add_separator(cnf={}, **kw)`25872588Добавляет разделитель в нижнюю часть меню. Разделитель отображается в виде горизонтальной линии и не может быть активирован или вызван.25892590#### `insert(index, itemType, cnf={}, **kw)`25912592То же, что и [`add()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.add), за исключением того, что новый элемент вставляется непосредственно перед элементом с индексом *index*, а не добавляется в конец меню. *itemType* – одно из `'command'`, `'cascade'`, `'checkbutton'`, `'radiobutton'` или `'separator'`. Вспомогательные методы `insert_command()`, `insert_cascade()`, `insert_checkbutton()`, `insert_radiobutton()` и `insert_separator()` вызывают этот метод с соответствующим *itemType*.25932594#### `insert_cascade(index, cnf={}, **kw)`25952596Вставить новый каскадный элемент перед элементом, заданным *index* (см. [`add_cascade()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.add_cascade)).25972598#### `insert_checkbutton(index, cnf={}, **kw)`25992600Вставить новый элемент-флажок перед элементом, заданным *index* (см. [`add_checkbutton()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.add_checkbutton)).26012602#### `insert_command(index, cnf={}, **kw)`26032604Вставить новый элемент-команду перед элементом, заданным *index* (см. [`add_command()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.add_command)).26052606#### `insert_radiobutton(index, cnf={}, **kw)`26072608Вставить новый элемент-переключатель перед элементом, заданным *index* (см. [`add_radiobutton()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.add_radiobutton)).26092610#### `insert_separator(index, cnf={}, **kw)`26112612Вставить разделитель перед элементом, заданным *index* (см. [`add_separator()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.add_separator)).26132614#### `delete(index1, index2=None)`26152616Удаляет все пункты меню между *index1* и *index2* включительно. Если *index2* опущен, по умолчанию используется *index1*, так что удаляется один элемент. Попытки удалить отрывной элемент игнорируются; удалите его, изменив параметр *tearoff*.26172618#### `entrycget(index, option)`26192620Возвращает текущее значение параметра конфигурации *option* для элемента, заданного *index*.26212622#### `entryconfigure(index, cnf=None, **kw)`26232624Запрашивает или изменяет параметры конфигурации элемента, заданного *index*. Это работает как [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.configure), но применяется к отдельному элементу, а не ко всему меню. Без аргументов возвращает словарь с текущими параметрами элемента; иначе устанавливает указанные параметры. Поддерживаются те же параметры, что принимает [`add()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.add) для данного типа элемента. [`entryconfig()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.entryconfig) является псевдонимом `entryconfigure()`.26252626#### `index(index)`26272628Возвращает числовой индекс, соответствующий *index*, или `None`, если *index* не указывает ни на один элемент.26292630#### `type(index)`26312632Возвращает тип элемента, заданного *index*: одно из значений `'command'`, `'cascade'`, `'checkbutton'`, `'radiobutton'`, `'separator'` или `'tearoff'` (для отрывного элемента).26332634#### `activate(index)`26352636Делает элемент, заданный *index*, активным, перерисовывая его активными цветами, и деактивирует ранее активный элемент. Если *index* не указывает ни на один элемент или выбранный элемент отключён, в меню не будет активного элемента.26372638#### `invoke(index)`26392640Вызывает действие элемента, заданного *index*, как если бы на нём щёлкнули. Если элемент отключён, ничего не происходит. Если с элементом связана *command*, возвращается результат выполнения этой команды; в противном случае возвращается пустая строка.26412642#### `post(x, y)`26432644Отображает меню на экране в координатах корневого окна *x* и *y*, при необходимости корректируя их, чтобы всё меню было видимо. Если указан параметр *postcommand*, он вычисляется перед отображением меню.26452646#### `tk_popup(x, y, entry='')`26472648Отображает меню как всплывающее в координатах корневого окна *x* и *y*. Если указан *entry*, меню позиционируется так, чтобы этот элемент отображался под указателем.26492650#### `unpost()`26512652Скрывает меню, чтобы оно больше не отображалось, также скрывая любые отображённые каскадные подменю нижнего уровня. Не действует в Windows и macOS, которые управляют скрытием меню самостоятельно.26532654#### `xposition(index)`26552656Возвращает x-координату (в окне меню) самого левого пикселя элемента, заданного *index*.26572658Добавлено в версии 3.3.26592660#### `yposition(index)`26612662Возвращает координату y самого верхнего пикселя записи, заданной *index*, в окне меню.26632664#### `class tkinter.Menubutton(master=None, cnf={}, **kw)`26652666Виджет `Menubutton` отображает текстовую строку, растровое изображение или картинку и при нажатии показывает связанное [`Menu`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu), заданное параметром *menu*. Как и [`Label`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Label), он может показывать *text*, *textvariable* или *image*, а параметр *direction* управляет тем, где появится меню относительно кнопки. Наследуется от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget). Полный список параметров приведен на странице руководства Tk `menubutton`.26672668#### `class tkinter.Message(master=None, cnf={}, **kw)`26692670Виджет `Message` отображает неинтерактивную текстовую строку, заданную параметром *text* или связанную с переменной через *textvariable*. В отличие от [`Label`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Label), он разбивает строку на несколько строк для получения заданного соотношения сторон, выбирая разрывы строк на границах слов, и может выравнивать текст по левому краю, по центру или по правому. Наследуется от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget). Полный список параметров приведен на странице руководства Tk `message`.26712672#### `class tkinter.OptionMenu(master, variable, value, *values, **kwargs)`26732674Вспомогательный подкласс [`Menubutton`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menubutton), отображающий всплывающее меню взаимно исключающих вариантов. *variable* – это [`Variable`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable), синхронизируемый с выбором; *value* – начальный выбор, а *values* – остальные пункты меню. Ключевой аргумент *command* может принимать колбэк, который вызывается с выбранным значением.26752676#### `destroy()`26772678Уничтожает виджет, а также очищает связанное всплывающее меню.26792680#### `class tkinter.PanedWindow(master=None, cnf={}, **kw)`26812682`PanedWindow` – это виджет-менеджер геометрии, который размещает любое количество дочерних *панелей* в ряд (если *orient* равен `'horizontal'`) или в колонку (если *orient* равен `'vertical'`). Каждая панель содержит один виджет, и каждая пара соседних панелей разделена подвижным *разделителем*, который пользователь может перетаскивать мышью для изменения размеров виджетов по обе стороны от него. Наследуется от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget).26832684Параметр *orient* выбирает направление расположения, *sashwidth* задаёт ширину каждого разделителя, а *sashrelief* – его рельеф. Если *showhandle* равен true, на каждом разделителе рисуется небольшая ручка, за которую пользователь может ухватиться, чтобы перетащить его. Полный список параметров приведен на странице руководства Tk `panedwindow`.26852686#### `add(child, **kw)`26872688Добавляет *child* в panedwindow в качестве новой панели, размещая её после всех существующих панелей. Именованные аргументы задают параметры управления для *child*; это могут быть любые параметры, принимаемые [`paneconfigure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.paneconfigure).26892690#### `remove(child)`26912692Удаляет панель, содержащую *child*, из panedwindow. Все параметры управления геометрией для *child* забываются. [`forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.forget) – это псевдоним `remove()`. Этот метод скрывает унаследованный `forget()`; используйте [`pack_forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.pack_forget), [`grid_forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Grid.grid_forget) или [`place_forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Place.place_forget), чтобы удалить сам виджет из его менеджера.26932694#### `panes()`26952696Возвращает кортеж виджетов, управляемых panedwindow, по одному на панель, в порядке их расположения.26972698#### `panecget(child, option)`26992700Возвращает текущее значение параметра управления *option* для панели, содержащей *child*. *option* может быть любым значением, допустимым для [`paneconfigure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.paneconfigure).27012702#### `paneconfigure(tagOrId, cnf=None, **kw)`27032704Запрашивает или изменяет параметры управления панели, содержащей виджет *tagOrId*. Без указания параметров возвращает словарь со всеми доступными параметрами панели; если передана единственная строка – имя параметра, возвращает описание этого параметра; в противном случае устанавливает заданные параметры. Поддерживаемые параметры включают *after* и *before* (вставка панели после или до другого управляемого окна), *height* и *width* (внешние размеры окна, включая границу), *minsize* (минимальный размер в направлении панели), *padx* и *pady* (дополнительное пространство с каждой стороны окна), *sticky* (позиционирование или растяжение окна внутри увеличенной панели с помощью строки из символов `n`, `s`, `e` и `w`), *hide* (скрыть панель, оставив её в списке панелей) и *stretch* (как распределяется дополнительное пространство между панелями: одно из `'always'`, `'first'`, `'last'`, `'middle'` или `'never'`). [`paneconfig()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.paneconfig) – это псевдоним `paneconfigure()`.27052706#### `identify(x, y)`27072708Определяет компонент panedwindow под точкой с координатами *x* и *y* в оконных координатах. Если точка находится над разделителем или ручкой разделителя, результатом будет кортеж из двух элементов: индекс разделителя или ручки и слово, указывающее, находится ли точка над разделителем или ручкой, например `(0, 'sash')` или `(2, 'handle')`. Если точка находится над любой другой частью panedwindow, результатом будет пустая строка.27092710#### `sash(*args)`27112712Запрашивает или изменяет положение разделителей в panedwindow. Это тонкая обёртка вокруг подкоманды Tk `sash`; обычно вместо неё следует использовать удобные методы [`sash_coord()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.sash_coord), [`sash_mark()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.sash_mark) и [`sash_place()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.sash_place).27132714#### `sash_coord(index)`27152716Возвращает пару координат x и y для разделителя с индексом *index*, который должен быть целым числом от 0 до (количество панелей в panedwindow минус 1). Возвращаемые координаты – это координаты левого верхнего угла области, содержащей разделитель.27172718#### `sash_mark(index)`27192720Запоминает текущее положение мыши для разделителя с индексом *index* для последующего перемещения разделителя операциями перетаскивания.27212722#### `sash_place(index, x, y)`27232724Поместите sash, заданный через *index*, в координаты *x* и *y*.27252726#### `proxy(*args)`27272728Запрос или изменение позиции прокси-разделителя (sash proxy), «призрачного» разделителя, отображаемого во время перетаскивания разделителя при непрозрачном изменении размера. Это тонкая обёртка вокруг подкоманды Tk `proxy`; вместо неё обычно следует использовать удобные методы [`proxy_coord()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.proxy_coord), [`proxy_forget()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.proxy_forget) и [`proxy_place()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow.proxy_place).27292730#### `proxy_coord()`27312732Возвращает кортеж, содержащий координаты x и y последнего местоположения прокси.27332734#### `proxy_forget()`27352736Удаляет прокси с экрана.27372738#### `proxy_place(x, y)`27392740Помещает прокси в координаты *x* и *y*.27412742#### `class tkinter.Radiobutton(master=None, cnf={}, **kw)`27432744Виджет `Radiobutton` отображает текстовую строку, растровое изображение или картинку вместе с ромбовидным или круглым индикатором и позволяет выбрать один вариант из нескольких. Он обладает всем поведением простой кнопки и, кроме того, может быть выбран: обычно несколько радиокнопок используют одну *variable*, и выбор одной устанавливает эту переменную в *value* радиокнопки; каждая радиокнопка также отслеживает переменную и автоматически выбирает или снимает выбор при изменении переменной. Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget). В дополнение к стандартным опциям виджета, радиокнопка принимает опции, описанные на странице руководства Tk `radiobutton`, такие как *variable*, *value* и *command*.27452746#### `invoke()`27472748Делает то же самое, что произошло бы при нажатии пользователем на радиокнопку мышью: выбирает кнопку и вызывает связанную команду, если таковая имеется. Возвращает результат команды или пустую строку, если с радиокнопкой не связана ни одна команда. Игнорируется, если состояние радиокнопки `disabled`.27492750#### `select()`27512752Выбирает радиокнопку и устанавливает связанную переменную в значение, соответствующее этому виджету.27532754#### `deselect()`27552756Снимает выбор с радиокнопки и устанавливает связанную переменную в пустую строку. Если эта радиокнопка не была выбрана, действие не выполняется.27572758#### `flash()`27592760Мигает радиокнопкой, перерисовывая её несколько раз с чередованием активного и обычного цветов. По завершении мигания радиокнопка остаётся в том же обычном или активном состоянии, что и в момент вызова метода. Игнорируется, если состояние радиокнопки `disabled`.27612762#### `class tkinter.Scale(master=None, cnf={}, **kw)`27632764Виджет `Scale` позволяет пользователю выбрать числовое значение путём перемещения ползунка вдоль дорожки. Он может быть ориентирован вертикально или горизонтально и при желании отображать метку и текущее значение. Наследует от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget).27652766В дополнение к стандартным опциям виджета, шкала (scale) принимает опции, описанные на странице руководства Tk `scale`, такие как *from\_*, *to*, *resolution*, *orient*, *tickinterval*, *variable* и *command*. Как и везде в `tkinter`, ведущий `-` имени опции Tk опускается; *from* записывается как `from_`, потому что [`from`](https://python-all.ru/3.13/reference/simple_stmts.html#from) является ключевым словом Python.27672768При нецелом *resolution* см. [числовые значения и локаль](https://python-all.ru/3.13/library/tkinter.html#tkinter-numeric-locale).27692770#### `get()`27712772Возвращает текущее значение шкалы. Результат является целым числом, если *resolution* шкалы даёт целые числа, и числом с плавающей запятой в противном случае.27732774#### `set(value)`27752776Устанавливает шкалу в значение *value*, соответственно перемещая ползунок. Не действует, если шкала отключена.27772778#### `coords(value=None)`27792780Возвращает кортеж `(x, y)`, содержащий пиксельные координаты относительно виджета точки на центральной линии дорожки, соответствующей *value*. Если *value* опущен, используется текущее значение шкалы.27812782#### `identify(x, y)`27832784Возвращает строку, описывающую часть шкалы в пиксельных координатах *x*, *y*: `'slider'`, `'trough1'` (часть дорожки выше или левее ползунка), `'trough2'` (ниже или правее ползунка), или пустую строку, если точка не находится ни над одним из этих элементов.27852786#### `class tkinter.Scrollbar(master=None, cnf={}, **kw)`27872788Виджет `Scrollbar` отображает ползунок и две стрелки, позволяющие пользователю прокручивать связанный виджет, например [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox), [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text), [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas) или [`Entry`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry). Он соединяется с прокручиваемым виджетом путём установки опции *xscrollcommand* или *yscrollcommand* этого виджета на метод [`set()`](https://python-all.ru/3.13/library/stdtypes.html#set) полосы прокрутки, а опции *command* полосы прокрутки – на метод [`xview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview) или [`yview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView.yview) прокручиваемого виджета. Наследуется от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget).27892790#### `get()`27912792Возвращает текущие настройки полосы прокрутки в виде кортежа `(first, last)` из двух дробей от 0 до 1, описывающих часть документа, которая в данный момент видна, как было последний раз передано в [`set()`](https://python-all.ru/3.13/library/stdtypes.html#set).27932794#### `set(first, last)`27952796Устанавливает полосу прокрутки. *first* и *last* – это дроби от 0 до 1, задающие позиции начала и конца видимой части связанного документа. Этот метод обычно регистрируется как *xscrollcommand* или *yscrollcommand* прокручиваемого виджета и вызывается этим виджетом.27972798#### `activate(index=None)`27992800Помечает элемент *index* (один из `'arrow1'`, `'slider'` или `'arrow2'`) как активный, отображая его в соответствии с опциями *activebackground* и *activerelief*. Если *index* опущен, возвращает имя текущего активного элемента или `None`, если ни один элемент не активен.28012802Изменено в версии 3.5: Аргумент *index* теперь необязателен.28032804#### `delta(deltax, deltay)`28052806Возвращает число с плавающей точкой, указывающее дробное изменение настройки полосы прокрутки, соответствующее перемещению ползунка на *deltax* пикселей по горизонтали (для горизонтальных полос прокрутки) или на *deltay* пикселей по вертикали (для вертикальных полос прокрутки).28072808#### `fraction(x, y)`28092810Возвращает число с плавающей точкой от 0 до 1, указывающее, где находится точка с пиксельными координатами *x*, *y* в желобе: 0 соответствует верхнему или левому краю желоба, а 1 – нижнему или правому.28112812#### `identify(x, y)`28132814Возвращает имя элемента под пиксельными координатами *x*, *y* (например, `'arrow1'`) или пустую строку, если точка не находится ни в одном элементе полосы прокрутки.28152816#### `class tkinter.Spinbox(master=None, cnf={}, **kw)`28172818Виджет `Spinbox` – это виджет, похожий на [`Entry`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry), с парой кнопок со стрелками вверх/вниз, позволяющих пользователю перебирать диапазон значений, а также редактировать значение напрямую. Набор значений может быть числовым диапазоном, задаваемым опциями *from\_*, *to* и *increment*, или явным списком строк, задаваемым опцией *values* (которая имеет приоритет над диапазоном). Каждый раз при нажатии на стрелку вызывается колбэк *command*, если он задан; опция *wrap* управляет тем, будет ли переход за пределы диапазона зацикливаться на другой стороне; опция *format* определяет форматирование числовых значений; а опция *validate* включает проверку введённого текста. Наследуется от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget) и [`XView`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView).28192820При нецелом *increment* см. [числовые значения и локаль](https://python-all.ru/3.13/library/tkinter.html#tkinter-numeric-locale).28212822Многие методы принимают аргумент *index*, идентифицирующий символ в строке spinbox. Как описано на странице руководства Tk `spinbox`, *index* может быть числовым индексом (начиная с 0), `'anchor'` (якорная точка выделения), `'end'` (сразу после последнего символа), `'insert'` (символ сразу после курсора вставки), `'sel.first'` или `'sel.last'` (концы выделения) или `@x` (символ, покрывающий пиксельную координату x *x* в окне).28232824#### `get()`28252826Возвращает строку spinbox.28272828#### `insert(index, s)`28292830Вставляет символы строки *s* непосредственно перед символом, заданным *index*.28312832#### `delete(first, last=None)`28332834Удаляет один или несколько символов spinbox. *first* – это индекс первого удаляемого символа, а *last* – индекс символа, следующего за последним удаляемым. Если *last* опущен, удаляется один символ по индексу *first*.28352836#### `icursor(index)`28372838Устанавливает отображение курсора вставки непосредственно перед символом, заданным *index*.28392840#### `index(index)`28412842Возвращает числовой индекс, соответствующий *index*, в виде строки.28432844#### `bbox(index)`28452846Возвращает кортеж из четырёх целых чисел `(x, y, width, height)`, описывающих ограничивающий прямоугольник символа, заданного *index*. *x* и *y* – это пиксельные координаты левого верхнего угла символа относительно виджета, а *width* и *height* – его размер в пикселях. Ограничивающий прямоугольник может относиться к области за пределами видимой части окна.28472848Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.28492850#### `identify(x, y)`28512852Возвращает имя элемента окна по координатам пикселей *x*, *y*: одно из `'buttondown'`, `'buttonup'`, `'entry'` или `'none'`.28532854#### `invoke(element)`28552856Вызывает кнопку вращения, заданную *элементом*, либо `'buttonup'`, либо `'buttondown'`, запуская связанное с ней действие.28572858#### `scan(*args)`28592860Тонкая обёртка вокруг подкоманды виджета Tk `scan`, используемая для быстрого перетаскивания представления: `scan('mark', x)` записывает *x* и текущее представление, а `scan('dragto', x)` корректирует представление относительно этой метки. Методы [`scan_mark()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.scan_mark) и [`scan_dragto()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.scan_dragto) оборачивают две формы.28612862#### `scan_mark(x)`28632864Записывает *x* и текущее представление в окне spinbox для последующего вызова [`scan_dragto()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.scan_dragto). Обычно это связано с нажатием кнопки мыши на виджете.28652866#### `scan_dragto(x)`28672868Корректирует представление на величину, равную 10-кратной разности между *x* и *x*, переданным последнему вызову [`scan_mark()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.scan_mark). Обычно это связано с событиями движения мыши, создавая эффект перетаскивания spinbox с высокой скоростью по окну.28692870#### `selection(*args)`28712872Тонкая обёртка вокруг подкоманды виджета Tk `selection`, используемая для настройки выделения внутри spinbox. Имеет несколько форм в зависимости от первого аргумента, такие как `selection('adjust', index)`, `selection('clear')`, `selection('element', ?elem?)`, `selection('from', index)`, `selection('present')`, `selection('range', start, end)` и `selection('to', index)`. Методы [`selection_adjust()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_adjust), [`selection_clear()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_clear), [`selection_element()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_element), [`selection_from()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_from), [`selection_present()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_present), [`selection_range()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_range) и [`selection_to()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_to) оборачивают эти формы.28732874#### `selection_adjust(index)`28752876Находит конец выделения, ближайший к символу, заданному *index*, и корректирует этот конец, чтобы он находился на *index* (включая *index*, но не выходя за него). Другой конец становится якорной точкой для будущих вызовов [`selection_to()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_to). Если выделение в данный момент отсутствует в spinbox, создаётся новое выделение, включающее символы между *index* и последней якорной точкой включительно.28772878#### `selection_clear()`28792880Очищает выделение, если оно находится в этом виджете. Если выделения нет в этом виджете, метод не даёт эффекта.28812882> **Примечание**2883>2884> Этот метод переопределяет унаследованный [`Misc.selection_clear()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.selection_clear), который очищает X-выделение; этот метод недоступен в `Spinbox`.28852886#### `selection_element(element=None)`28872888Устанавливает или возвращает текущий выбранный элемент. Если передан *элемент* (один из `'buttonup'`, `'buttondown'` или `'none'`), эта кнопка вращения выбирается и отображается нажатой; в противном случае возвращается имя текущего выбранного элемента.28892890#### `selection_from(index)`28912892Устанавливает якорную точку выделения непосредственно перед символом, заданным *index*, не изменяя само выделение.28932894Добавлено в версии 3.8.28952896#### `selection_present()`28972898Возвращает `True`, если в spinbox выбраны какие-либо символы, и `False` в противном случае.28992900Добавлено в версии 3.8.29012902#### `selection_range(start, end)`29032904Устанавливает выделение, включающее символы, начиная с символа с индексом *start* и заканчивая символом непосредственно перед *end*. Если *end* указывает на тот же символ, что и *start*, или на более ранний, выделение очищается.29052906Добавлено в версии 3.8.29072908#### `selection_to(index)`29092910Устанавливает выделение между *index* и якорной точкой. Если *index* находится до якорной точки, выделение идёт от *index* до якорной точки, не включая её; если после – выделение идёт от якорной точки до *index*, не включая его; если совпадает, ничего не происходит. Якорная точка задаётся последним вызовом [`selection_from()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_from) или [`selection_adjust()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox.selection_adjust). Если выделение отсутствует в этом виджете, создаётся новое выделение с использованием последней якорной точки.29112912Добавлено в версии 3.8.29132914#### `class tkinter.Text(master=None, cnf={}, **kw)`29152916Виджет `Text` отображает и редактирует многострочный текст. Части текста могут быть стилизованы с помощью **тегов**, отдельные позиции могут быть помечены плавающими **метками**, а в текст могут быть встроены произвольные изображения и другие виджеты. Виджет также предоставляет неограниченный механизм отмены/повтора и поддерживает равноправные виджеты (peer widgets), использующие те же базовые данные. Наследуется от [`Widget`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Widget), [`XView`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView) и [`YView`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView), поэтому представление можно прокручивать по горизонтали и вертикали с помощью [`xview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview) и [`yview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView.yview). Полный список опций см. на странице руководства Tk `text`.29172918Большинство методов принимают один или несколько аргументов *index*, которые идентифицируют позицию в тексте. Как описано на странице руководства Tk `text`, индекс – это строка, состоящая из основы, за которой необязательно следуют один или несколько модификаторов. Основой может быть `'line.char'` (строка *line*, символ *char*, где строки нумеруются с 1, а символы в строке с 0; `'line.end'` относится к символу новой строки, завершающему строку), `'end'` (позиция сразу после последней новой строки), имя метки, `'tag.first'` или `'tag.last'` (первый символ, помеченный *tag*, или позиция сразу после последнего такого символа), имя встроенного изображения или окна, или `@x,y` (символ, покрывающий координаты пикселей *x*, *y* в виджете). Модификатор, такой как `'+5 chars'`, `'-3 lines'`, `'linestart'`, `'lineend'`, `'wordstart'` или `'wordend'`, корректирует индекс относительно основы; несколько модификаторов могут быть объединены и применяются слева направо, например `'insert wordstart - 1 c'`.29192920#### `insert(index, chars, *args)`29212922Вставляет строку *chars* непосредственно перед символом на *index* (если *index* равен `'end'`, то непосредственно перед последним символом новой строки). По умолчанию новый текст наследует любые теги, присутствующие с обеих сторон точки вставки. Если задан *args*, он состоит из чередующихся значений *tagList*, *chars*: предыдущий *chars* получает именно перечисленные теги (список тегов может быть именем одного тега или последовательностью имён), переопределяя окружающие теги.29232924#### `delete(index1, index2=None)`29252926Удаляет диапазон символов от *index1* включительно до *index2* не включительно. Если *index2* опущен, удаляется единственный символ в *index1*. Виджет всегда сохраняет символ новой строки в качестве последнего символа, поэтому удаление, которое могло бы его удалить, корректируется соответствующим образом.29272928#### `replace(index1, index2, chars, *args)`29292930Заменяет диапазон символов от *index1* включительно до *index2* не включительно на *chars*. Это эквивалентно [`delete()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text.delete), за которым следует [`insert()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text.insert) в позиции *index1*; *args* интерпретируется так же, как для `insert()`.29312932Добавлено в версии 3.3.29332934#### `get(index1, index2=None)`29352936Возвращает текст от *index1* до *index2* (не включая) в виде строки. Если *index2* опущен, возвращает единственный символ по индексу *index1*. Встроенные изображения и окна не включаются в результат.29372938#### `index(index)`29392940Возвращает позицию, соответствующую *index*, в канонической форме `'line.char'`.29412942#### `compare(index1, op, index2)`29432944Сравнивает позиции *index1* и *index2* с помощью оператора отношения *op*, который должен быть одним из `'<'`, `'<='`, `'=='`, `'>='`, `'>'` или `'!='`, и возвращает логический результат.29452946#### `count(index1, index2, *options, return_ints=False)`29472948Подсчитывает количество элементов запрошенных типов между *index1* и *index2*; результат отрицательный, если *index1* находится после *index2*. Каждый из *options* задаёт тип подсчитываемого элемента: `'chars'`, `'displaychars'`, `'displayindices'`, `'displaylines'`, `'indices'`, `'lines'`, `'xpixels'` или `'ypixels'` (по умолчанию, если ни один параметр не указан, используется `'indices'`). Псевдо-параметр `'update'` принудительно пересчитывает устаревшую информацию о расположении до обработки последующих параметров. Если *return\_ints* равен true и указан только один параметр подсчёта, возвращается простое целое число; в противном случае возвращается кортеж с одним целым числом для каждого параметра подсчёта (или `None`, если результат пуст).29492950Добавлено в версии 3.3.29512952Изменено в версии 3.13: Добавлен параметр *return\_ints*.29532954#### `see(index)`29552956Настраивает отображение так, чтобы символ, заданный *index*, был видимым. Если он уже видим, метод не производит никакого эффекта; если он находится на небольшом расстоянии за пределами видимости, виджет прокручивает ровно настолько, чтобы подвести его к ближайшему краю; в противном случае прокручивает так, чтобы *index* оказался в центре окна.29572958#### `bbox(index)`29592960Возвращает кортеж `(x, y, width, height)`, задающий ограничивающий прямоугольник (в пикселях) видимой части символа по индексу *index*, или `None`, если этот символ не видим на экране.29612962Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.29632964#### `dlineinfo(index)`29652966Возвращает кортеж `(x, y, width, height, baseline)`, описывающий строку отображения, содержащую *index*: первые четыре значения задают ограничивающий прямоугольник строки в пикселях, а *baseline* задаёт смещение базовой линии вниз от верхней границы области. Возвращает `None`, если эта строка отображения не видна на экране.29672968#### `mark_set(markName, index)`29692970Устанавливает метку с именем *markName* в позицию непосредственно перед символом по индексу *index*, создавая метку, если её ещё не существует. Метка, созданная таким образом, по умолчанию имеет правую гравитацию.29712972#### `mark_unset(*markNames)`29732974Удаляет каждую из меток, имена которых указаны в *markNames*. Специальные метки `insert` и `current` не могут быть удалены.29752976#### `mark_names()`29772978Возвращает кортеж имён всех меток, установленных в данный момент в виджете.29792980#### `mark_gravity(markName, direction=None)`29812982Если *direction* опущен, возвращает гравитацию метки *markName*: либо `'left'`, либо `'right'`. В противном случае устанавливает её гравитацию равной *direction*. Гравитация определяет, с какой стороны от метки появляется текст, вставленный в позицию метки: метка с правой гравитацией (по умолчанию) остаётся справа от такого текста.29832984#### `mark_next(index)`29852986Возвращает имя первой метки, находящейся в позиции *index* или после неё, или `None`, если такой метки нет. Если *index* является именем метки, поиск начинается сразу после этой метки.29872988#### `mark_previous(index)`29892990Возвращает имя последней метки, находящейся в позиции *index* или перед ней, или `None`, если такой метки нет. Если *index* является именем метки, поиск начинается непосредственно перед этой меткой.29912992#### `tag_add(tagName, index1, *args)`29932994Добавляет тег *tagName* к диапазону символов от *index1* включительно до следующего индекса в *args* (не включая его). Дополнительные пары индексов можно передать в *args*, чтобы пометить ещё несколько диапазонов; одиночный индекс в конце помечает только символ по этому индексу.29952996#### `tag_remove(tagName, index1, index2=None)`29972998Удаляет тег *tagName* у символов от *index1* включительно до *index2* (не включая его) (или у одного символа по *index1*, если *index2* не указан). Сам тег продолжает существовать, даже если ни один символ его не содержит.29993000#### `tag_delete(*tagNames)`30013002Удаляет каждый из тегов, перечисленных в *tagNames*, убирая их со всех символов и отбрасывая их параметры и привязки.30033004#### `tag_configure(tagName, cnf=None, **kw)`30053006Запрашивает или изменяет параметры конфигурации тега *tagName*. Это отражает [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.configure), за исключением того, что применяется к тегу, а не к виджету в целом: без параметров возвращает словарь, описывающий текущие параметры, иначе устанавливает переданные параметры. Определение тега таким образом также даёт ему приоритет выше, чем у любого существующего тега.30073008Поддерживаемые параметры тега, все управляющие внешним видом размеченного текста:30093010***font***30113012Шрифт, используемый для текста.30133014***foreground***30153016Цвет текста.30173018***background***30193020Цвет фона за текстом.30213022***fgstipple*, *bgstipple***30233024Растровые изображения для точечной заливки переднего плана (текста) и фона; хорошо поддерживаются только в X11.30253026***borderwidth***30273028Ширина границы, рисуемой вокруг текста в соответствии с *relief* (по умолчанию `0`).30293030***relief***30313032Трёхмерный вид границы текста: `'flat'` (по умолчанию), `'raised'`, `'sunken'`, `'ridge'`, `'groove'` или `'solid'`.30333034***offset***30353036Насколько текст поднимается над (или, если отрицательное, опускается под) базовую линию для верхних и нижних индексов.30373038***underline***30393040Указывает, подчёркивается ли текст.30413042***underlinefg***30433044Цвет подчёркивания; по умолчанию равен цвету текста.30453046***overstrike***30473048Указывает, рисуется ли линия через середину текста.30493050***overstrikefg***30513052Цвет линии зачёркивания; по умолчанию равен цвету текста.30533054***elide***30553056Скрыт ли текст.30573058***выравнивание***30593060Как выравнивать первый символ отображаемой строки: `'left'` (по умолчанию), `'right'` или `'center'`.30613062***перенос***30633064Как переносить слишком длинные строки: `'char'`, `'word'` или `'none'`.30653066***lmargin1*, *lmargin2***30673068Отступ в пикселях первой отображаемой строки логической строки и остальных отображаемых строк.30693070***lmargincolor***30713072Цвет левой области поля.30733074***rmargin***30753076Правое поле, в пикселях.30773078***rmargincolor***30793080Цвет правой области поля.30813082***spacing1*, *spacing2*, *spacing3***30833084Дополнительное пространство в пикселях над первой отображаемой строкой логической строки, между её отображаемыми строками и под её последней отображаемой строкой.30853086***tabs***30873088Набор позиций табуляции в той же форме, что и опция *tabs* виджета.30893090***tabstyle***30913092Как интерпретируются позиции табуляции: `'tabular'` или `'wordprocessor'`.30933094***selectbackground*, *selectforeground***30953096Цвет фона и текста, используемые для текста, когда он выделен.30973098> **Примечание**3099>3100> Tk 8.6 добавил опции *lmargincolor*, *overstrikefg*, *rmargincolor*, *selectbackground*, *selectforeground* и *underlinefg*.31013102[`tag_config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text.tag_config) является псевдонимом `tag_configure()`.31033104#### `tag_cget(tagName, option)`31053106Возвращает текущее значение опции конфигурации *option* для тега *tagName*.31073108#### `tag_names(index=None)`31093110Если *index* опущен, возвращает кортеж имён всех тегов, определённых в виджете; в противном случае возвращает только имена тегов, применённых к символу по *index*. Имена упорядочены от наименьшего приоритета к наибольшему.31113112#### `tag_ranges(tagName)`31133114Возвращает кортеж индексов, описывающих все диапазоны текста, помеченные тегом *tagName*. Результат чередует начальные и конечные индексы, так что элементы `2*i` и `2*i+1` ограничивают *i*-й диапазон.31153116#### `tag_nextrange(tagName, index1, index2=None)`31173118Ищет от *index1* (до *index2*, если задан) первый диапазон символов, помеченный тегом *tagName*, и возвращает кортеж из двух элементов с начальным и конечным индексами, или пустой кортеж, если такого диапазона нет.31193120#### `tag_prevrange(tagName, index1, index2=None)`31213122Ищет назад от *index1* (до *index2*, если задан) ближайший предшествующий диапазон символов, помеченный тегом *tagName*, и возвращает кортеж из двух элементов с начальным и конечным индексами, или пустой кортеж, если такого диапазона нет.31233124#### `tag_raise(tagName, aboveThis=None)`31253126Повышает приоритет тега *tagName* так, чтобы он был сразу над приоритетом *aboveThis*, или до наивысшего приоритета среди всех тегов, если *aboveThis* не указан. Если параметры отображения перекрывающихся тегов конфликтуют, побеждает тег с более высоким приоритетом.31273128#### `tag_lower(tagName, belowThis=None)`31293130Понижает приоритет тега *tagName* так, чтобы он был сразу под приоритетом *belowThis*, или до наинизшего приоритета среди всех тегов, если *belowThis* не указан.31313132#### `tag_bind(tagName, sequence, func, add=None)`31333134Привязывает событие *sequence* для символов, помеченных тегом *tagName*, к колбэку *func*, так что *func* вызывается, когда это событие происходит над таким символом. Если *add* равен true, привязка добавляется вместе с любыми существующими привязками для *sequence*; в противном случае она заменяет их. Работает как [`bind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind) и возвращает идентификатор новой привязки.31353136#### `tag_unbind(tagName, sequence, funcid=None)`31373138Удаляет привязки события *sequence* для символов, помеченных *tagName*. Если указан *funcid*, удаляется только та привязка (возвращённая [`tag_bind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text.tag_bind)) и её колбэк отменяется.31393140Изменено в версии 3.13: Если указан *funcid*, отвязывается только этот колбэк.31413142#### `image_create(index, cnf={}, **kw)`31433144Встраивает изображение в позиции *index* и возвращает имя, назначенное этому экземпляру изображения, которое затем можно использовать как индекс или передавать другим методам `image_*`. Параметры, задаваемые в *cnf* и *kw*, включают *image* (изображение Tk для отображения), *name* (базовое имя экземпляра), *align*, *padx* и *pady*.31453146#### `image_cget(index, option)`31473148Возвращает текущее значение параметра конфигурации *option* для встроенного изображения в позиции *index*.31493150#### `image_configure(index, cnf=None, **kw)`31513152Запрашивает или изменяет параметры конфигурации встроенного изображения в позиции *index*, как [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.configure), но применяется к этому изображению.31533154#### `image_names()`31553156Возвращает кортеж имён всех изображений, встроенных в виджет.31573158> **Примечание**3159>3160> Этот метод переопределяет унаследованный [`Misc.image_names()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.image_names), который возвращает имена всех изображений в интерпретаторе Tcl; этот метод недоступен для `Text`.31613162#### `window_create(index, cnf={}, **kw)`31633164Встраивает окно (любой виджет) в позиции *index*. Параметры, задаваемые в *cnf* и *kw*, включают *window* (виджет для встраивания), *create* (колбэк, создающий виджет по требованию), *align*, *stretch*, *padx* и *pady*. Встраиваемый виджет должен быть потомком родителя текстового виджета.31653166#### `window_cget(index, option)`31673168Возвращает текущее значение параметра конфигурации *option* для встроенного окна в позиции *index*.31693170#### `window_configure(index, cnf=None, **kw)`31713172Запрашивает или изменяет параметры конфигурации встроенного окна в позиции *index*, как [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.configure), но применяется к этому окну.31733174[`window_config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text.window_config) является псевдонимом `window_configure()`.31753176#### `window_names()`31773178Возвращает кортеж имён всех окон, встроенных в виджет.31793180#### `edit(*args)`31813182Низкоуровневая обёртка над виджет-командой Tk `edit`, управляющей механизмом undo/redo и флагом изменений; *args* – это подкоманда `edit` и её аргументы. Методы `edit_*()` ниже являются тонкими обёртками над ним и обычно более удобны.31833184#### `edit_modified(arg=None)`31853186Если *arg* опущен, возвращает текущее состояние флага изменений как `0` или `1`; флаг устанавливается автоматически при любой вставке или удалении текста. В противном случае устанавливает флаг в булево значение *arg*.31873188#### `edit_undo()`31893190Отменяет последнее действие редактирования, то есть все вставки и удаления, записанные в стек отмены после предыдущего разделителя, и переносит его в стек повтора. Вызывает [`TclError`](https://python-all.ru/3.13/library/tkinter.html#tkinter.TclError), если стек отмены пуст. Не действует, если параметр *undo* не равен true. Начиная с Tk 9.0, возвращает кортеж индексов, ограничивающих диапазоны текста, которые были изменены.31913192#### `edit_redo()`31933194Повторно применяет последнее отменённое действие редактирования, при условии, что после этого не было внесено изменений, и переносит его обратно в стек отмены. Вызывает [`TclError`](https://python-all.ru/3.13/library/tkinter.html#tkinter.TclError), если стек повтора пуст. Не действует, если параметр *undo* не равен true. Начиная с Tk 9.0, возвращает кортеж индексов, ограничивающих диапазоны текста, которые были изменены.31953196#### `edit_reset()`31973198Очищает стеки отмены и повтора.31993200#### `edit_separator()`32013202Добавляет разделитель в стек отмены, обозначая границу между действиями редактирования для отмены и повтора. Не действует, если параметр *undo* не равен true. Разделители вставляются автоматически, если параметр *autoseparators* равен true.32033204#### `search(pattern, index, stopindex=None, forwards=None, backwards=None, exact=None, regexp=None, nocase=None, count=None, elide=None)`32053206Ищет *pattern*, начиная с *index*, и возвращает индекс первого символа первого совпадения или пустую строку, если совпадений нет. Поиск останавливается на *stopindex*, если он задан; в противном случае он переходит через конец текста, пока снова не будет достигнута начальная позиция. Следующие логические флаги управляют поиском: *forwards* или *backwards* выбирают направление (по умолчанию – вперёд); *exact* (по умолчанию) или *regexp* выбирают литеральное или регулярное выражение; *nocase* делает поиск нечувствительным к регистру; а *elide* также включает скрытый текст. Если *count* является [`Variable`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable), в него сохраняется количество позиций индекса в совпадении.32073208#### `scan_mark(x, y)`32093210Запоминает *x*, *y* и текущий вид для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text.scan_dragto). Обычно привязывается к нажатию кнопки мыши в виджете.32113212#### `scan_dragto(x, y)`32133214Прокручивает виджет на разницу в 10 раз между *x*, *y* и координатами, переданными последнему вызову [`scan_mark()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text.scan_mark). Обычно привязывается к событиям движения мыши, создавая эффект перетаскивания текста на высокой скорости по окну.32153216#### `debug(boolean=None)`32173218Если *boolean* опущен, возвращает, включены ли проверки внутренней целостности B-дерева. В противном случае включает или отключает их. Эта настройка общая для всех текстовых виджетов и может заметно замедлить виджеты, содержащие большие объёмы текста.32193220#### `dump(index1, index2=None, command=None, **kw)`32213222Возвращает содержимое виджета от *index1* включительно до *index2* не включительно (или только сегмент на *index1*, если *index2* опущен), включая текст и информацию о метках, тегах, изображениях и окнах. Результат – список троек `(key, value, index)`, где *key* – одно из значений `'text'`, `'mark'`, `'tagon'`, `'tagoff'`, `'image'` или `'window'`. По умолчанию сообщаются все типы; передача любого из ключевых аргументов *all*, *text*, *mark*, *tag*, *image* или *window* со значением true ограничивает дамп выбранными типами. Если передан *command*, он вызывается один раз на каждую тройку с тремя значениями в качестве аргументов, и ничего не возвращается.32233224#### `peer_create(newPathName, cnf={}, **kw)`32253226Создаёт равноправный текстовый виджет с путём *newPathName*, который разделяет базовые данные этого виджета (текст, метки, теги, изображения и стек отмены). Изменения, сделанные через любой из равноправных виджетов, отражаются во всех них. По умолчанию равноправный виджет охватывает те же строки, что и данный виджет; могут быть заданы стандартные текстовые параметры, включая *startline* и *endline*, чтобы переопределить это.32273228Добавлено в версии 3.3.32293230#### `peer_names()`32313232Возвращает кортеж путей равноправных виджетов этого виджета, не включая сам виджет.32333234Добавлено в версии 3.3.32353236#### `yview_pickplace(*what)`32373238Настраивает вид так, чтобы местоположение, заданное *what*, стало видимым. Это устаревший эквивалент [`see()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text.see), который следует использовать вместо него.32393240### Классы переменных32413242#### `class tkinter.Variable(master=None, value=None, name=None)`32433244Базовый класс для обёрток переменных Tk. Переменная Tk – это значение, хранящееся в интерпретаторе Tcl, которое может быть связано с виджетами через их параметры *variable* или *textvariable* (см. [Связывание переменных виджетов](https://python-all.ru/3.13/library/tkinter.html#coupling-widget-variables)), так что изменения распространяются в обоих направлениях: обновление переменной обновляет все виджеты, привязанные к ней, а редактирование такого виджета пользователем обновляет переменную.32453246*master* – это виджет, интерпретатору Tcl которого принадлежит переменная; если опущен, используется корневое окно по умолчанию. *value* – начальное значение; если опущено, используется значение по умолчанию для данного типа. *name* – имя переменной в интерпретаторе Tcl; если опущено, генерируется уникальное имя вида `'PY_VARnum'`. Если *name* совпадает с существующей переменной, а *value* опущено, существующее значение сохраняется.32473248В большинстве случаев следует использовать один из типизированных подклассов ниже – [`StringVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.StringVar), [`IntVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.IntVar), [`DoubleVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.DoubleVar) или [`BooleanVar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.BooleanVar) – вместо `Variable` напрямую.32493250> **Примечание**3251>3252> Когда `Variable` удаляется сборщиком мусора, его переменная Tcl сбрасывается. Сохраняйте ссылку на неё до тех пор, пока виджет связан с ней, например, храня её как атрибут, а не в локальной переменной. В противном случае Tk воссоздаёт переменную Tcl для поддержания работы виджета, но она больше никогда не сбрасывается, что приводит к утечке одной переменной Tcl на каждую отброшенную обёртку.32533254Изменено в версии 3.10: Теперь две переменные сравниваются равными (`==`), только если они имеют одинаковое имя, принадлежат одному классу и одному интерпретатору Tcl.32553256#### `get()`32573258Возвращает текущее значение переменной. Для базового класса значение возвращается в виде строки; типизированные подклассы преобразуют его в соответствующий тип Python.32593260#### `set(value)`32613262Устанавливает переменную в *value*. [`initialize()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable.initialize) – это псевдоним `set()`.32633264Добавлено в версии 3.3: Написание *initialize*.32653266#### `trace_add(mode, callback)`32673268Регистрирует *колбэк*, который вызывается при доступе к переменной в соответствии с *mode*. *mode* – одна из строк `'array'`, `'read'`, `'write'` или `'unset'`, либо список или кортеж таких строк.32693270При срабатывании *колбэк* вызывается с тремя аргументами: имя переменной Tcl, индекс (или пустая строка, если переменная не является элементом массива) и *mode*, вызвавший срабатывание.32713272Возвращает внутреннее имя зарегистрированного колбэка, которое можно передать в [`trace_remove()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable.trace_remove).32733274Добавлено в версии 3.6.32753276#### `trace_remove(mode, cbname)`32773278Удаляет колбэк трассировки из переменной. *mode* должен совпадать с *mode*, переданным в [`trace_add()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable.trace_add), а *cbname* – это имя колбэка, возвращённое `trace_add()`.32793280Добавлено в версии 3.6.32813282#### `trace_info()`32833284Возвращает список пар `(modes, cbname)`, описывающих все трассировки, установленные на переменной, где *modes* – кортеж строк режимов, а *cbname* – внутреннее имя колбэка.32853286Добавлено в версии 3.6.32873288#### `trace_variable(mode, callback)`32893290Регистрирует *колбэк*, который вызывается при доступе к переменной в соответствии с *mode*. *mode* – одна из строк `'r'`, `'w'` или `'u'` для чтения, записи или удаления. Возвращает внутреннее имя зарегистрированного колбэка. [`trace()`](https://python-all.ru/3.13/library/trace.html#module-trace) – это псевдоним `trace_variable()`.32913292Устарело с версии 3.6: Вместо этого используйте [`trace_add()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable.trace_add). Этот метод оборачивает возможность Tcl, которая была удалена в Tcl 9.0.32933294#### `trace_vdelete(mode, cbname)`32953296Удаляет колбэк трассировки с именем *cbname*, зарегистрированный для *mode* с помощью [`trace_variable()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable.trace_variable).32973298Устарело с версии 3.6: Вместо этого используйте [`trace_remove()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable.trace_remove). Этот метод оборачивает возможность Tcl, которая была удалена в Tcl 9.0.32993300#### `trace_vinfo()`33013302Возвращает список пар `(mode, cbname)` для всех трассировок, установленных на переменной с помощью [`trace_variable()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable.trace_variable).33033304Устарело с версии 3.6: Вместо этого используйте [`trace_info()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable.trace_info). Этот метод оборачивает возможность Tcl, которая была удалена в Tcl 9.0.33053306#### `class tkinter.StringVar(master=None, value=None, name=None)`33073308Подкласс [`Variable`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable), хранящий строку. Значение по умолчанию – `''`.33093310#### `get()`33113312Возвращает значение переменной в виде [`str`](https://python-all.ru/3.13/library/stdtypes.html#str).33133314#### `class tkinter.IntVar(master=None, value=None, name=None)`33153316Подкласс [`Variable`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable), хранящий целое число. Значение по умолчанию – `0`.33173318#### `get()`33193320Возвращает значение переменной в виде [`int`](https://python-all.ru/3.13/library/functions.html#int).33213322#### `class tkinter.DoubleVar(master=None, value=None, name=None)`33233324Подкласс [`Variable`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable), хранящий число с плавающей точкой. Значение по умолчанию – `0.0`.33253326#### `get()`33273328Возвращает значение переменной в виде [`float`](https://python-all.ru/3.13/library/functions.html#float).33293330> **Примечание**3331>3332> Значение с плавающей точкой всегда разбирается с точкой (`.`) в качестве десятичного разделителя, но [`Spinbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Spinbox), [`Scale`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Scale) и [`ttk.Spinbox`](https://python-all.ru/3.13/library/tkinter.ttk.html#tkinter.ttk.Spinbox) форматируют его в соответствии с локалью `LC_NUMERIC`. В локали, использующей запятую, они выдают значение, которое [`get()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.DoubleVar.get) не может прочитать, вызывая [`TclError`](https://python-all.ru/3.13/library/tkinter.html#tkinter.TclError). Установите `LC_NUMERIC` на локаль, использующую точку (например, `'C'`), чтобы избежать этого.33333334#### `class tkinter.BooleanVar(master=None, value=None, name=None)`33353336Подкласс [`Variable`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Variable), который хранит булево значение. Значение по умолчанию – `False`.33373338#### `get()`33393340Возвращает значение переменной как [`bool`](https://python-all.ru/3.13/library/functions.html#bool). Вызывает [`ValueError`](https://python-all.ru/3.13/library/exceptions.html#ValueError), если значение не может быть интерпретировано как булево.33413342#### `set(value)`33433344Устанавливает переменную в *value*, преобразуя его в булево значение. [`initialize()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.BooleanVar.initialize) – псевдоним `set()`.33453346Добавлено в версии 3.3: Написание *initialize*.33473348### Классы изображений33493350#### `class tkinter.Image(imgtype, name=None, cnf={}, master=None, **kw)`33513352Базовый класс для изображений Tk. *imgtype* – это тип изображения Tk, один из `'photo'` или `'bitmap'`. Изображение – именованный объект, который может отображаться виджетами через их опцию *image*; удаление всех ссылок на объект `Image` удаляет базовое изображение Tk. Обычно создают [`PhotoImage`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PhotoImage) или [`BitmapImage`](https://python-all.ru/3.13/library/tkinter.html#tkinter.BitmapImage), а не напрямую `Image`.33533354Параметры конфигурации изображения задаются *cnf* и *kw* и могут быть запрошены и изменены позднее с помощью протокола отображения (используя `image[key]`) или метода [`configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Image.configure).33553356#### `configure(**kw)`33573358Изменяет один или несколько параметров конфигурации изображения. Допустимые параметры зависят от типа изображения; см. [`PhotoImage`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PhotoImage) и [`BitmapImage`](https://python-all.ru/3.13/library/tkinter.html#tkinter.BitmapImage). [`config()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Image.config) – псевдоним `configure()`.33593360#### `height()`33613362Возвращает высоту изображения в пикселях.33633364#### `width()`33653366Возвращает ширину изображения в пикселях.33673368#### `type()`33693370Возвращает тип изображения, то есть значение *imgtype*, с которым оно было создано (например, `'photo'` или `'bitmap'`).33713372#### `class tkinter.PhotoImage(name=None, cnf={}, master=None, **kw)`33733374Полноцветное изображение (тип изображения Tk `photo`), хранящееся внутри с различной степенью прозрачности для каждого пикселя. Может читать и записывать файлы GIF, PPM/PGM и (в Tk 8.6 и новее) PNG, читать файлы SVG (в Tk 9.0 и новее) и отображаться в виджетах. Наследует от [`Image`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Image).33753376Параметры конфигурации включают *data* (содержимое изображения в виде строки), *file* (имя файла для чтения содержимого), *format* (имя обработчика формата файла), *width* и *height* (размер изображения, используется при построении по частям), *gamma* и *palette*.33773378#### `blank()`33793380Очищает изображение; то есть устанавливает всё изображение без данных, так что оно отображается прозрачным, и фон окна, в котором оно отображается, просвечивает.33813382#### `cget(option)`33833384Возвращает текущее значение параметра конфигурации *option*.33853386#### `copy(*, from_coords=None, zoom=None, subsample=None)`33873388Возвращает новый `PhotoImage` с копией этого изображения.33893390*from\_coords* задаёт прямоугольную подобласть исходного изображения для копирования. Она должна быть кортежем или списком из 1–4 целых чисел `(x1, y1, x2, y2)`. `(x1, y1)` и `(x2, y2)` задают диагонально противоположные углы прямоугольника. Если *x2* и *y2* не указаны, они по умолчанию равны правому нижнему углу исходного изображения. Копируемые пиксели включают левый и верхний края прямоугольника, но не нижний или правый. Если *from\_coords* не задан, копируется всё исходное изображение.33913392Если указаны *zoom* или *subsample*, изображение преобразуется как в методах [`zoom()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PhotoImage.zoom) и [`subsample()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PhotoImage.subsample). Значением должно быть одно целое число или пара целых чисел.33933394Изменено в версии 3.13: Добавлены параметры *from\_coords*, *zoom* и *subsample*.33953396#### `copy_replace(sourceImage, *, from_coords=None, to=None, shrink=False, zoom=None, subsample=None, compositingrule=None)`33973398Копирует область из *sourceImage* (который должен быть `PhotoImage`) в это изображение, возможно с масштабированием пикселей и/или субдискретизацией. Если параметры не указаны, *sourceImage* копируется целиком в это изображение, начиная с координат `(0, 0)`.33993400Параметр *from\_coords* задаёт прямоугольную подобласть исходного изображения, которая будет скопирована, как в методе [`copy()`](https://python-all.ru/3.13/library/copy.html#module-copy).34013402*to* задаёт прямоугольную подобласть целевого изображения, которая будет затронута. Это должен быть кортеж или список из 1–4 целых чисел `(x1, y1, x2, y2)`. Если *x2* и *y2* не указаны, по умолчанию они равны `(x1, y1)` плюс размер исходной области (после субдискретизации и масштабирования, если они заданы). Если *x2* и *y2* указаны, исходная область при необходимости дублируется мозаичным способом для заполнения целевой области.34033404Если *shrink* истинно, размер целевого изображения при необходимости уменьшается так, чтобы копируемая область оказалась в правом нижнем углу изображения.34053406Если указаны *zoom* или *subsample*, изображение преобразуется как в методах [`zoom()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PhotoImage.zoom) и [`subsample()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PhotoImage.subsample). Значением должно быть одно целое число или пара целых чисел.34073408*compositingrule* определяет, как прозрачные пиксели исходного изображения объединяются с целевым изображением. При `'overlay'` (по умолчанию) старое содержимое целевого изображения остаётся видимым, как если бы исходное изображение было напечатано на прозрачной плёнке и наложено поверх целевого. При `'set'` старое содержимое целевого изображения отбрасывается, а исходное изображение используется как есть.34093410Добавлено в версии 3.13.34113412#### `data(format=None, *, from_coords=None, background=None, grayscale=False)`34133414Возвращает данные изображения.34153416*format* задаёт имя обработчика формата файла изображения. Если он не указан, данные возвращаются в виде кортежа (по одному элементу на строку) строк, содержащих разделённые пробелами (по одному элементу на пиксель/столбец) цвета в формате `#RRGGBB`.34173418*from\_coords* задаёт прямоугольную область изображения, которую нужно вернуть. Это должен быть кортеж или список из 1–4 целых чисел `(x1, y1, x2, y2)`. Если указаны только *x1* и *y1*, область простирается от `(x1, y1)` до правого нижнего угла изображения. Если заданы все четыре координаты, они определяют противоположные углы области по диагонали, включая `(x1, y1)` и исключая `(x2, y2)`. Если *from\_coords* не задан, возвращается всё изображение.34193420Если указан *background*, данные не содержат информации о прозрачности; во всех прозрачных пикселях цвет заменяется на указанный.34213422Если *grayscale* равен true, данные не содержат информации о цвете; все данные пикселей преобразуются в оттенки серого.34233424Добавлено в версии 3.13.34253426#### `get(x, y)`34273428Возвращает цвет пикселя по координатам (*x*, *y*) в виде `(r, g, b)` кортежа из трёх целых чисел от 0 до 255, представляющих красный, зелёный и синий компоненты соответственно.34293430#### `put(data, to=None)`34313432Устанавливает пиксели изображения в цвета, заданные в *data*, который должен быть строкой или вложенной последовательностью горизонтальных строк цветов пикселей (например, `"{red green} {blue yellow}"`).34333434*to* задаёт координаты области изображения, в которую копируются данные. Это должен быть кортеж или список из 2 или 4 целых чисел `(x1, y1)` или `(x1, y1, x2, y2)`, задающих левый верхний угол и, опционально, правый нижний угол области. Положение по умолчанию – `(0, 0)`.34353436#### `read(filename, format=None, *, from_coords=None, to=None, shrink=False)`34373438Читает данные изображения из файла с именем *filename* в изображение.34393440*format* задаёт формат данных изображения в файле.34413442*from\_coords* задаёт прямоугольную подобласть данных изображения из файла, которая будет скопирована в целевое изображение. Это должен быть кортеж или список из 1–4 целых чисел `(x1, y1, x2, y2)`. Если указаны только *x1* и *y1*, область простирается от `(x1, y1)` до правого нижнего угла изображения в файле. Если заданы все четыре координаты, они определяют противоположные углы области по диагонали. Если *from\_coords* не задан, читается всё изображение из файла.34433444*to* задаёт координаты левого верхнего угла области изображения, в которую читаются данные. По умолчанию – `(0, 0)`.34453446Если *shrink* истинно, размер изображения при необходимости уменьшается так, чтобы область, в которую читаются данные из файла, оказалась в правом нижнем углу изображения.34473448Добавлено в версии 3.13.34493450#### `subsample(x, y='', *, from_coords=None)`34513452Возвращает новый `PhotoImage` на основе данного изображения, но использующий только каждый *x*-й пиксель по оси X и каждый *y*-й пиксель по оси Y. Если *y* не указан, по умолчанию он равен *x*.34533454Параметр *from\_coords* задаёт прямоугольную подобласть исходного изображения, которая будет скопирована, как в методе [`copy()`](https://python-all.ru/3.13/library/copy.html#module-copy).34553456Изменено в версии 3.13: Добавлен параметр *from\_coords*.34573458#### `transparency_get(x, y)`34593460Возвращает `True`, если пиксель по координатам (*x*, *y*) полностью прозрачен, иначе `False`.34613462Добавлено в версии 3.8.34633464#### `transparency_set(x, y, boolean)`34653466Делает пиксель по координатам (*x*, *y*) полностью прозрачным, если *boolean* истинно, и полностью непрозрачным в противном случае.34673468Добавлено в версии 3.8.34693470#### `write(filename, format=None, from_coords=None, *, background=None, grayscale=False)`34713472Записывает данные изображения из изображения в файл с именем *filename*.34733474Параметр *format* задаёт имя обработчика формата файла изображения. Если он не указан, формат определяется по расширению файла.34753476Параметр *from\_coords* задаёт прямоугольную область изображения, которую нужно записать. Он должен быть кортежем или списком из 1–4 целых чисел `(x1, y1, x2, y2)`. Если указаны только *x1* и *y1*, область простирается от `(x1, y1)` до правого нижнего угла изображения. Если заданы все четыре координаты, они задают диагонально противоположные углы области. Если *from\_coords* не указан, записывается всё изображение.34773478Если указан *background*, данные не содержат информации о прозрачности; во всех прозрачных пикселях цвет заменяется на указанный.34793480Если *grayscale* равен true, данные не содержат информации о цвете; все данные пикселей преобразуются в оттенки серого.34813482Изменено в версии 3.13: Добавлены параметры *background* и *grayscale*.34833484#### `zoom(x, y='', *, from_coords=None)`34853486Возвращает новый `PhotoImage` с этим изображением, увеличенным в *x* раз по оси X и в *y* раз по оси Y. Если *y* не указан, по умолчанию используется то же значение, что и *x*.34873488Параметр *from\_coords* задаёт прямоугольную подобласть исходного изображения, которая будет скопирована, как в методе [`copy()`](https://python-all.ru/3.13/library/copy.html#module-copy).34893490Изменено в версии 3.13: Добавлен параметр *from\_coords*.34913492#### `class tkinter.BitmapImage(name=None, cnf={}, master=None, **kw)`34933494Двухцветное изображение (тип изображения Tk `bitmap`), созданное из X11-битовой карты. Каждый пиксель отображает цвет переднего плана, цвет фона или ничего (создавая эффект прозрачности). Наследует от [`Image`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Image).34953496Параметрами конфигурации являются *data* или *file* (исходная битовая карта, задаваемая строкой в формате X11 или именем файла в этом формате), *maskdata* или *maskfile* (маска битовой карты в тех же форматах), а также *foreground* и *background* (два цвета). Для пикселей, где маска равна нулю, изображение ничего не отображает; для остальных пикселей отображается цвет переднего плана, где исходный бит равен единице, и цвет фона, где он равен нулю. Если *background* установлен в пустую строку, фоновые пиксели становятся прозрачными.34973498`BitmapImage` не имеет собственных методов, кроме тех, что унаследованы от [`Image`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Image).34993500### Другие классы35013502#### `class tkinter.Event`35033504Контейнер для атрибутов события, передаваемого в колбэк, привязанный с помощью [`Misc.bind()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.bind). Экземпляр `Event` имеет следующие атрибуты, каждый из которых соответствует полю базового события Tk; в зависимости от типа события некоторые атрибуты могут быть установлены в строку `'??'`, чтобы указать, что они не имеют смысла. См. [Привязки и события](https://python-all.ru/3.13/library/tkinter.html#bindings-and-events).35053506#### `serial`35073508Серийный номер события.35093510#### `num`35113512Кнопка мыши, которая была нажата или отпущена (для событий кнопок).35133514#### `focus`35153516Указывает, имеет ли окно фокус (для событий `Enter` и `Leave`).35173518#### `height`35193520#### `width`35213522Новая высота и ширина окна (для событий `Configure` и `Expose`).35233524#### `keycode`35253526Код клавиши, которая была нажата или отпущена.35273528#### `state`35293530Состояние события в виде числа (для большинства событий) или строки (для событий `Visibility`).35313532#### `time`35333534Временная метка события в миллисекундах.35353536#### `x`35373538#### `y`35393540Положение указателя относительно виджета в пикселях.35413542#### `x_root`35433544#### `y_root`35453546Положение указателя относительно верхнего левого угла экрана, в пикселях.35473548#### `char`35493550Введённый символ в виде строки (для событий клавиш).35513552#### `send_event`35533554`True`, если событие было отправлено другим приложением.35553556#### `keysym`35573558Символическое имя клавиши, которая была нажата или отпущена.35593560#### `keysym_num`35613562Числовое значение [`keysym`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Event.keysym).35633564#### `type`35653566[`EventType`](https://python-all.ru/3.13/library/tkinter.html#tkinter.EventType) события.35673568#### `widget`35693570Виджет, на котором произошло событие.35713572#### `delta`35733574Величина, на которую было повёрнуто колесо мыши (для событий `MouseWheel`).35753576#### `class tkinter.EventType(*values)`35773578Перечисление [`enum.StrEnum`](https://python-all.ru/3.13/library/enum.html#enum.StrEnum), содержащее типы событий Tk, используемое в качестве значения [`Event.type`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Event.type). Его члены включают, среди прочего, `KeyPress`, `KeyRelease`, `ButtonPress`, `ButtonRelease`, `Motion`, `Enter`, `Leave`, `FocusIn`, `FocusOut`, `Configure`, `Map`, `Unmap`, `Expose`, `Destroy` и `MouseWheel`.35793580Добавлено в версии 3.6.35813582#### `class tkinter.CallWrapper(func, subst, widget)`35833584Внутренний вспомогательный класс, который оборачивает Python-колбэк, чтобы его можно было вызвать из Tcl. *func* – это Python-функция, *subst* – необязательная функция, которая предварительно обрабатывает аргументы Tcl, а *widget* – виджет, используемый для сообщения об ошибках. Экземпляры создаются автоматически с помощью [`Misc.register()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.register); этот класс обычно не используется напрямую.35853586### Функции уровня модуля35873588#### `tkinter.Tcl(screenName=None, baseName=None, className='Tk', useTk=False)`35893590Функция `Tcl()` – это фабричная функция, которая создаёт объект, очень похожий на тот, что создаётся классом [`Tk`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk), за исключением того, что она не инициализирует подсистему Tk. Она чаще всего полезна при работе с интерпретатором Tcl в среде, где не требуется создавать лишние окна верхнего уровня или где это невозможно (например, в системах Unix/Linux без X-сервера). Объект, созданный объектом `Tcl()`, может иметь окно Toplevel (и инициализированную подсистему Tk) при вызове его метода [`loadtk()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Tk.loadtk).35913592#### `tkinter.NoDefaultRoot()`35933594Подавляет создание неявного корневого окна по умолчанию. После этого `tkinter` больше не создаёт автоматически общий корневой элемент, а операции, которые от него зависят – например, создание виджета без явного *master* – вызывают исключение [`RuntimeError`](https://python-all.ru/3.13/library/exceptions.html#RuntimeError). Вызывайте эту функцию на раннем этапе в крупных приложениях, чтобы сделать корневое окно явным.35953596#### `tkinter.mainloop(n=0)`35973598Запускает главный цикл событий Tk на корневом окне по умолчанию, пока все окна не будут уничтожены. Эквивалентно вызову [`Misc.mainloop()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.mainloop) для корневого окна по умолчанию.35993600#### `tkinter.getboolean(s)`36013602Преобразует Tcl-строку логического типа *s* (одно из значений `'1'`, `'true'`, `'yes'`, `'on'` и подобных, или их ложные аналоги) в Python-объект [`bool`](https://python-all.ru/3.13/library/functions.html#bool). Вызывает [`TclError`](https://python-all.ru/3.13/library/tkinter.html#tkinter.TclError) для недопустимого значения.36033604#### `tkinter.getdouble(s)`36053606Преобразует *s* в число с плавающей запятой. Это встроенная функция [`float`](https://python-all.ru/3.13/library/functions.html#float).36073608#### `tkinter.getint(s)`36093610Преобразует *s* в целое число. Это встроенная функция [`int`](https://python-all.ru/3.13/library/functions.html#int).36113612#### `tkinter.image_names()`36133614Возвращает имена всех существующих изображений в интерпретаторе корневого окна по умолчанию.36153616#### `tkinter.image_types()`36173618Возвращает доступные типы изображений (например, `'photo'` и `'bitmap'`) в интерпретаторе корневого окна по умолчанию.36193620### Обработчики файлов36213622Tk позволяет регистрировать и удалять функцию обратного вызова, которая будет вызываться из главного цикла Tk, когда возможен ввод-вывод на файловом дескрипторе. Для каждого файлового дескриптора можно зарегистрировать только один обработчик. Пример кода:36233624```python3625import tkinter3626widget = tkinter.Tk()3627mask = tkinter.READABLE | tkinter.WRITABLE3628widget.tk.createfilehandler(file, mask, callback)3629...3630widget.tk.deletefilehandler(file)3631```36323633Эта функция недоступна в Windows.36343635Поскольку неизвестно, сколько байт доступно для чтения, не рекомендуется использовать методы [`BufferedIOBase`](https://python-all.ru/3.13/library/io.html#io.BufferedIOBase) или [`TextIOBase`](https://python-all.ru/3.13/library/io.html#io.TextIOBase) [`read()`](https://python-all.ru/3.13/library/io.html#io.BufferedIOBase.read) или [`readline()`](https://python-all.ru/3.13/library/io.html#io.IOBase.readline), так как они будут читать строго заданное количество байт. Для сокетов подойдут методы [`recv()`](https://python-all.ru/3.13/library/socket.html#socket.socket.recv) или [`recvfrom()`](https://python-all.ru/3.13/library/socket.html#socket.socket.recvfrom); для других файлов используйте необработанное чтение или `os.read(file.fileno(), maxbytecount)`.36363637#### `Widget.tk.createfilehandler(file, mask, func)`36383639Регистрирует функцию обратного вызова обработчика файла *func*. Аргумент *file* может быть объектом с методом [`fileno()`](https://python-all.ru/3.13/library/io.html#io.IOBase.fileno) (например, файлом или сокетом), либо целочисленным файловым дескриптором. Аргумент *mask* представляет собой комбинацию (побитовое ИЛИ) любых из трёх констант ниже. Колбэк вызывается следующим образом:36403641```python3642callback(file, mask)3643```36443645#### `Widget.tk.deletefilehandler(file)`36463647Удаляет обработчик файла.36483649#### `tkinter.READABLE`36503651#### `tkinter.WRITABLE`36523653#### `tkinter.EXCEPTION`36543655Константы, используемые в аргументе *mask*.36563657### Константы36583659Следующие символьные константы доступны в пространствах имён `tkinter` и `tkinter.constants`.36603661#### `tkinter.TRUE`36623663#### `tkinter.YES`36643665#### `tkinter.ON`36663667Истинные значения, все равны целому числу `1`.36683669#### `tkinter.FALSE`36703671#### `tkinter.NO`36723673#### `tkinter.OFF`36743675Ложные значения, все равны целому числу `0`.36763677#### `tkinter.N`36783679#### `tkinter.S`36803681#### `tkinter.E`36823683#### `tkinter.W`36843685#### `tkinter.NE`36863687#### `tkinter.NW`36883689#### `tkinter.SE`36903691#### `tkinter.SW`36923693#### `tkinter.NS`36943695#### `tkinter.EW`36963697#### `tkinter.NSEW`36983699#### `tkinter.CENTER`37003701Направления компаса (`'n'`, `'s'`, `'e'`, `'w'`, а также диагонали и грани) плюс `CENTER` (`'center'`), используются в качестве значений для опций *anchor* и *sticky*, а также методами, такими как [`Misc.grid_anchor()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Misc.grid_anchor).37023703#### `tkinter.LEFT`37043705#### `tkinter.RIGHT`37063707#### `tkinter.TOP`37083709#### `tkinter.BOTTOM`37103711Границы для опции *side* модуля packer (см. [`Pack.pack_configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Pack.pack_configure)).37123713#### `tkinter.X`37143715#### `tkinter.Y`37163717#### `tkinter.BOTH`37183719#### `tkinter.NONE`37203721Значения для опции *fill* модуля packer: `'x'`, `'y'`, `'both'` или `'none'`.37223723#### `tkinter.RAISED`37243725#### `tkinter.SUNKEN`37263727#### `tkinter.FLAT`37283729#### `tkinter.RIDGE`37303731#### `tkinter.GROOVE`37323733#### `tkinter.SOLID`37343735Значения для опции *relief*, управляющей трёхмерной границей виджета.37363737#### `tkinter.HORIZONTAL`37383739#### `tkinter.VERTICAL`37403741Значения для опции *orient* виджетов, таких как [`Scale`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Scale), [`Scrollbar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Scrollbar) и [`PanedWindow`](https://python-all.ru/3.13/library/tkinter.html#tkinter.PanedWindow).37423743#### `tkinter.CHAR`37443745#### `tkinter.WORD`37463747Значения для опции *wrap* виджета [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text), определяющей перенос строк по границам символов или слов.37483749#### `tkinter.BASELINE`37503751Значение выравнивания текста `'baseline'`.37523753#### `tkinter.INSIDE`37543755#### `tkinter.OUTSIDE`37563757Значения для параметра *bordermode* менеджера размещения (см. [`Place.place_configure()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Place.place_configure)).37583759#### `tkinter.INSERT`37603761#### `tkinter.CURRENT`37623763#### `tkinter.END`37643765#### `tkinter.ANCHOR`37663767#### `tkinter.SEL`37683769#### `tkinter.SEL_FIRST`37703771#### `tkinter.SEL_LAST`37723773Символические индексы, используемые виджетами [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text), [`Entry`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Entry), [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox) и [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas), такие как `'insert'` (курсор вставки), `'current'`, `'end'`, `'anchor'` и границы выделения (`'sel.first'` и `'sel.last'`).37743775#### `tkinter.ALL`37763777Специальный тег `'all'`, который соответствует каждому элементу [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas) или каждому символу [`Text`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Text) (например, `canvas.delete(ALL)`).37783779#### `tkinter.NORMAL`37803781#### `tkinter.DISABLED`37823783#### `tkinter.ACTIVE`37843785#### `tkinter.HIDDEN`37863787Значения для параметра *state* различных виджетов и элементов.37883789#### `tkinter.CASCADE`37903791#### `tkinter.CHECKBUTTON`37923793#### `tkinter.COMMAND`37943795#### `tkinter.RADIOBUTTON`37963797#### `tkinter.SEPARATOR`37983799Типы записей меню, используемые как аргумент *itemType* для [`Menu.add()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.add) и [`Menu.insert()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Menu.insert).38003801#### `tkinter.SINGLE`38023803#### `tkinter.BROWSE`38043805#### `tkinter.MULTIPLE`38063807#### `tkinter.EXTENDED`38083809Значения для параметра *selectmode* виджета [`Listbox`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Listbox).38103811#### `tkinter.PIESLICE`38123813#### `tkinter.CHORD`38143815#### `tkinter.ARC`38163817Значения для параметра *style* элемента [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas) arc.38183819#### `tkinter.BUTT`38203821#### `tkinter.PROJECTING`38223823#### `tkinter.ROUND`38243825#### `tkinter.BEVEL`38263827#### `tkinter.MITER`38283829Значения для параметров *capstyle* (`'butt'`, `'projecting'`, `'round'`) и *joinstyle* (`'round'`, `'bevel'`, `'miter'`) элементов линии [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas).38303831#### `tkinter.FIRST`38323833#### `tkinter.LAST`38343835Значения для параметра *arrow* элементов линии [`Canvas`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Canvas), указывающие, на каких концах установлены наконечники.38363837#### `tkinter.MOVETO`38383839#### `tkinter.SCROLL`38403841Первый аргумент, передаваемый [`Scrollbar`](https://python-all.ru/3.13/library/tkinter.html#tkinter.Scrollbar) в метод [`XView.xview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview) или [`YView.yview()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView.yview) прокручиваемого виджета.38423843#### `tkinter.UNITS`38443845#### `tkinter.PAGES`38463847Значения для аргумента *what* методов [`XView.xview_scroll()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.XView.xview_scroll) и [`YView.yview_scroll()`](https://python-all.ru/3.13/library/tkinter.html#tkinter.YView.yview_scroll).38483849#### `tkinter.UNDERLINE`38503851#### `tkinter.NUMERIC`38523853#### `tkinter.DOTBOX`38543855Другие значения параметров: `'underline'`, `'numeric'` и `'dotbox'`.3856