tkinter.md

1> **Источник:** https://python-all.ru/3.14/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.14/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.14/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Это [опциональный модуль](https://python-all.ru/3.14/glossary.html#term-optional-module). Если его нет в вашей копии CPython, обратитесь к документации от вашего дистрибьютора (то есть того, кто предоставил вам Python). Если вы дистрибьютор, обратитесь к [требованиям к опциональным модулям](https://python-all.ru/3.14/using/configure.html#optional-module-requirements).2829> **См. также**30>31> - **[TkDocs](https://python-all.ru/3.14/library/tkinter.html)**32>33>   Обширное руководство по созданию пользовательских интерфейсов с помощью Tkinter. Объясняет ключевые концепции и иллюстрирует рекомендуемые подходы с использованием современного API.34> - **[Справочник по Tkinter 8.5: GUI для Python](https://python-all.ru/3.14/library/tkinter.html)**35>36>   Справочная документация по Tkinter 8.5 с подробным описанием доступных классов, методов и опций.37>38> Ресурсы по Tcl/Tk:39>40> - **[Команды Tk](https://python-all.ru/3.14/library/tkinter.html)**41>42>   Исчерпывающий справочник по каждой из базовых команд Tcl/Tk, используемых Tkinter.43> - **[Домашняя страница Tcl/Tk](https://python-all.ru/3.14/library/tkinter.html)**44>45>   Дополнительная документация и ссылки на разработку ядра Tcl/Tk.46>47> Книги:48>49> - **[Современный Tkinter для занятых разработчиков Python](https://python-all.ru/3.14/library/tkinter.html)**50>51>   Автор: Mark Roseman. (ISBN 978-1999149567)52> - **[Программирование GUI на Python с помощью Tkinter](https://python-all.ru/3.14/library/tkinter.html)**53>54>   Автор: Alan D. Moore. (ISBN 978-1788835886)55> - **[Программирование на Python](https://python-all.ru/3.14/library/tkinter.html)**56>57>   Автор: Mark Lutz; отличное освещение Tkinter. (ISBN 978-0596158101)58> - **[Tcl и инструментарий Tk (2-е издание)](https://python-all.ru/3.14/library/tkinter.html)**59>60>   Авторы: John Ousterhout, изобретатель Tcl/Tk, и Ken Jones; Tkinter не рассматривается. (ISBN 978-0321336330)6162## Архитектура6364Tcl/Tk – это не одна библиотека, а набор из нескольких отдельных модулей, каждый со своей функциональностью и собственной официальной документацией. Бинарные дистрибутивы Python также включают дополнительный модуль.6566**Tcl**6768Tcl – это динамический интерпретируемый язык программирования, так же как Python. Хотя его можно использовать самостоятельно как язык общего назначения, чаще всего он встраивается в C-приложения в качестве скриптового движка или интерфейса к набору инструментов Tk. Библиотека Tcl имеет C-интерфейс для создания и управления одним или несколькими экземплярами интерпретатора Tcl, выполнения команд и сценариев Tcl в этих экземплярах, а также добавления пользовательских команд, реализованных на Tcl или C. Каждый интерпретатор имеет очередь событий, и существуют средства для отправки событий в неё и их обработки. В отличие от Python, модель выполнения Tcl построена на кооперативной многозадачности, и Tkinter устраняет это различие (подробнее см. [модель потоков](https://python-all.ru/3.14/library/tkinter.html#threading-model)).6970**Tk**7172Tk – это [пакет Tcl](https://python-all.ru/3.14/library/tkinter.html), реализованный на C, который добавляет пользовательские команды для создания и управления GUI-виджетами. Каждый объект [`Tk`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk) содержит собственный экземпляр интерпретатора Tcl с загруженным Tk. Виджеты Tk очень настраиваемы, хотя и ценой устаревшего внешнего вида. Tk использует очередь событий Tcl для генерации и обработки событий GUI.7374**Ttk**7576Themed Tk (Ttk) – это новое семейство виджетов Tk, которое обеспечивает гораздо лучший внешний вид на разных платформах по сравнению со многими классическими виджетами Tk. Ttk распространяется как часть Tk, начиная с версии Tk 8.5. Привязки для Python предоставляются в отдельном модуле [`tkinter.ttk`](https://python-all.ru/3.14/library/tkinter.ttk.html#module-tkinter.ttk).7778Внутри Tk и Ttk используют возможности нижележащей операционной системы: Xlib на Unix/X11, Cocoa на macOS, GDI на Windows.7980Когда ваше Python-приложение использует класс в Tkinter, например, для создания виджета, модуль `tkinter` сначала собирает строку команды Tcl/Tk. Он передаёт эту строку команды Tcl внутреннему двоичному модулю [`_tkinter`](https://python-all.ru/3.14/library/tkinter.html#module-_tkinter), который затем вызывает интерпретатор Tcl для её выполнения. Интерпретатор Tcl, в свою очередь, обращается к пакетам Tk и/или Ttk, которые затем вызывают Xlib, Cocoa или GDI.8182## Модули Tkinter8384Поддержка Tkinter распределена по нескольким модулям. Большинству приложений понадобится основной модуль `tkinter`, а также модуль [`tkinter.ttk`](https://python-all.ru/3.14/library/tkinter.ttk.html#module-tkinter.ttk), предоставляющий современный набор тематических виджетов и API:8586```python87from tkinter import *88from tkinter import ttk89```9091Модули, обеспечивающие поддержку Tk, включают:9293**`tkinter`**9495Основной модуль Tkinter.9697**[`tkinter.colorchooser`](https://python-all.ru/3.14/library/tkinter.colorchooser.html#module-tkinter.colorchooser)**9899Диалоговое окно для выбора цвета пользователем.100101**[`tkinter.commondialog`](https://python-all.ru/3.14/library/dialog.html#module-tkinter.commondialog)**102103Базовый класс для диалогов, определённых в других перечисленных здесь модулях.104105**[`tkinter.filedialog`](https://python-all.ru/3.14/library/dialog.html#module-tkinter.filedialog)**106107Стандартные диалоги для указания файла для открытия или сохранения.108109**[`tkinter.font`](https://python-all.ru/3.14/library/tkinter.font.html#module-tkinter.font)**110111Утилиты для работы со шрифтами.112113**[`tkinter.messagebox`](https://python-all.ru/3.14/library/tkinter.messagebox.html#module-tkinter.messagebox)**114115Доступ к стандартным диалоговым окнам Tk.116117**[`tkinter.scrolledtext`](https://python-all.ru/3.14/library/tkinter.scrolledtext.html#module-tkinter.scrolledtext)**118119Текстовый виджет со встроенной вертикальной полосой прокрутки.120121**[`tkinter.simpledialog`](https://python-all.ru/3.14/library/dialog.html#module-tkinter.simpledialog)**122123Базовые диалоги и вспомогательные функции.124125**[`tkinter.ttk`](https://python-all.ru/3.14/library/tkinter.ttk.html#module-tkinter.ttk)**126127Набор тематических виджетов, представленный в Tk 8.5, предоставляющий современные альтернативы многим классическим виджетам из основного модуля `tkinter`.128129Дополнительные модули:130131**[`_tkinter`](https://python-all.ru/3.14/library/tkinter.html#module-_tkinter)**132133Двоичный модуль, содержащий низкоуровневый интерфейс к Tcl/Tk. Он автоматически импортируется основным модулем `tkinter` и никогда не должен использоваться напрямую программистами приложений. Обычно это разделяемая библиотека (или DLL), но в некоторых случаях может быть статически слинкована с интерпретатором Python.134135**[`idlelib`](https://python-all.ru/3.14/library/idle.html#module-idlelib)**136137Интегрированная среда разработки и обучения Python (IDLE). Основана на `tkinter`.138139**`tkinter.constants`**140141Символические константы, которые можно использовать вместо строк при передаче различных параметров вызовам Tkinter. Автоматически импортируются основным модулем `tkinter`.142143**[`tkinter.dnd`](https://python-all.ru/3.14/library/tkinter.dnd.html#module-tkinter.dnd)**144145(экспериментально) Поддержка перетаскивания для `tkinter`. Станет устаревшим, когда будет заменён на Tk DND.146147**[`turtle`](https://python-all.ru/3.14/library/turtle.html#module-turtle)**148149Черепашья графика в окне Tk.150151## Краткое руководство по Tkinter152153Этот раздел не задумывался как исчерпывающее руководство по Tk или Tkinter. Для этого обратитесь к одному из внешних ресурсов, упомянутых ранее. Вместо этого данный раздел даёт очень краткое представление о том, как выглядит приложение Tkinter, знакомит с основными концепциями Tk и объясняет структуру обёртки Tkinter.154155Оставшаяся часть этого раздела поможет вам определить классы, методы и параметры, которые понадобятся в вашем приложении Tkinter, а также где найти более подробную документацию по ним, включая официальное справочное руководство Tcl/Tk.156157### Программа «Hello World»158159Начнём с разбора приложения «Hello World» на Tkinter. Это не самая минимальная версия, которую можно написать, но в ней достаточно деталей, чтобы проиллюстрировать некоторые ключевые концепции, которые необходимо знать.160161```python162from tkinter import *163from tkinter import ttk164root = Tk()165frm = ttk.Frame(root, padding=10)166frm.grid()167ttk.Label(frm, text="Hello World!").grid(column=0, row=0)168ttk.Button(frm, text="Quit", command=root.destroy).grid(column=1, row=0)169root.mainloop()170```171172После импортов следующая строка создаёт экземпляр класса [`Tk`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk), который инициализирует Tk и создаёт связанный с ним интерпретатор Tcl. Она также создаёт главное окно, известное как корневое окно, которое служит основным окном приложения.173174Следующая строка создаёт виджет Frame, который в данном случае будет содержать метку и кнопку, которые мы создадим далее. Frame помещается внутрь корневого окна.175176Следующая строка создаёт виджет Label с текстовой строкой. Метод [`grid()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.grid) используется для указания относительного расположения (позиции) метки внутри содержащего её виджета Frame, аналогично тому, как работают таблицы в HTML.177178Затем создаётся виджет Button, который размещается справа от метки. При нажатии он вызывает метод [`destroy()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.destroy) корневого окна.179180Наконец, метод [`mainloop()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.mainloop) выводит всё на экран и реагирует на ввод пользователя до завершения программы.181182### Важные концепции Tk183184Даже эта простая программа иллюстрирует следующие ключевые концепции Tk:185186**виджеты**187188Пользовательский интерфейс Tkinter состоит из отдельных *виджетов*. Каждый виджет представлен объектом Python, создаваемым из классов, таких как [`ttk.Frame`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Frame), [`ttk.Label`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Label) и [`ttk.Button`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Button).189190**иерархия виджетов**191192Виджеты организованы в *иерархию*. Метка и кнопка были размещены внутри фрейма, который, в свою очередь, находился внутри корневого окна. При создании каждого *дочернего* виджета его *родительский* виджет передаётся первым аргументом конструктору виджета.193194**параметры конфигурации**195196Виджеты имеют *параметры конфигурации*, которые изменяют их внешний вид и поведение, например текст, отображаемый в метке или кнопке. Разные классы виджетов имеют разные наборы параметров.197198**управление геометрией**199200Виджеты не добавляются в интерфейс автоматически при их создании. *Менеджер геометрии*, такой как `grid`, управляет тем, где они размещаются в интерфейсе.201202**цикл событий**203204Tkinter реагирует на ввод пользователя, изменения в программе и даже обновляет экран только при активном выполнении *цикла событий*. Если программа не выполняет цикл событий, интерфейс не будет обновляться.205206### Понимание того, как Tkinter оборачивает Tcl/Tk207208Когда ваше приложение использует классы и методы Tkinter, внутри Tkinter собирает строки, представляющие команды Tcl/Tk, и выполняет их в интерпретаторе Tcl, прикреплённом к экземпляру [`Tk`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk) вашего приложения.209210Будь то попытка разобраться в справочной документации, поиск нужного метода или параметра, адаптация существующего кода или отладка приложения Tkinter, бывают моменты, когда полезно понимать, как выглядят эти базовые команды Tcl/Tk.211212Для иллюстрации ниже приведён эквивалент на Tcl/Tk основной части скрипта Tkinter, показанного выше.213214```python215ttk::frame .frm -padding 10216grid .frm217grid [ttk::label .frm.lbl -text "Hello World!"] -column 0 -row 0218grid [ttk::button .frm.btn -text "Quit" -command "destroy ."] -column 1 -row 0219```220221Синтаксис Tcl похож на многие оболочки: первое слово – это команда, за которой следуют её аргументы, разделённые пробелами. Не вдаваясь в подробности, обратите внимание на следующее:222223- Команды для создания виджетов (например, `ttk::frame`) соответствуют классам виджетов в Tkinter.224- Параметры виджетов Tcl (например, `-text`) соответствуют именованным аргументам в Tkinter.225- В Tcl виджеты идентифицируются по *пути* (например, `.frm.btn`), тогда как Tkinter использует не имена, а ссылки на объекты.226- Положение виджета в иерархии закодировано в его (иерархическом) пути, который использует `.` (точку) в качестве разделителя. Путь корневого окна – это просто `.` (точка). В Tkinter иерархия определяется не путём, а указанием родительского виджета при создании каждого дочернего виджета.227- Операции, которые реализованы как отдельные *команды* в Tcl (например, `grid` или `destroy`), представлены как *методы* объектов виджетов Tkinter. Как вы скоро увидите, в других случаях Tcl использует то, что выглядит как вызовы методов объектов виджетов, что более точно отражает подход Tkinter.228229### Как сделать…? Какой параметр…?230231Если вы не уверены, как сделать что-то в Tkinter, и не можете сразу найти это в используемом учебнике или справочной документации, есть несколько стратегий, которые могут помочь.232233Во-первых, помните, что детали работы отдельных виджетов могут различаться в разных версиях как Tkinter, так и Tcl/Tk. При поиске документации убедитесь, что она соответствует версиям Python и Tcl/Tk, установленным в вашей системе.234235При поиске способа использования API полезно знать точное имя класса, параметра или метода, которые вы используете. Интроспекция, будь то в интерактивной оболочке Python или с помощью [`print()`](https://python-all.ru/3.14/library/functions.html#print), может помочь определить, что вам нужно.236237Чтобы узнать, какие параметры конфигурации доступны для любого виджета, вызовите его метод [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.configure), который возвращает словарь с различной информацией о каждом объекте, включая его значения по умолчанию и текущие значения. Используйте [`keys()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.keys), чтобы получить только имена каждого параметра.238239```python240btn = ttk.Button(frm, ...)241print(btn.configure().keys())242```243244Поскольку большинство виджетов имеют много общих параметров конфигурации, может быть полезно выяснить, какие из них специфичны для конкретного класса виджетов. Один из способов – сравнить список параметров с аналогичным списком более простого виджета, например фрейма.245246```python247print(set(btn.configure().keys()) - set(frm.configure().keys()))248```249250Аналогично, можно найти доступные методы объекта виджета с помощью стандартной функции [`dir()`](https://python-all.ru/3.14/library/functions.html#dir). Если попробовать, окажется, что существует более 200 общих методов виджетов, поэтому снова полезно определить методы, специфичные для класса виджета.251252```python253print(dir(btn))254print(set(dir(btn)) - set(dir(frm)))255```256257### Навигация по справочному руководству Tcl/Tk258259Как уже отмечалось, официальное справочное руководство по [командам Tk](https://python-all.ru/3.14/library/tkinter.html) (страницы man) часто является наиболее точным описанием того, что делают конкретные операции с виджетами. Даже если вы знаете имя нужного параметра или метода, вам всё равно может потребоваться поискать в нескольких местах.260261Хотя все операции в Tkinter реализованы как вызовы методов объектов виджетов, многие операции Tcl/Tk представлены в виде команд, которые принимают путь к виджету в качестве первого параметра, за которым следуют необязательные параметры, например262263```python264destroy .265grid .frm.btn -column 0 -row 0266```267268Другие же больше похожи на методы, вызываемые для объекта виджета (на самом деле, при создании виджета в Tcl/Tk создаётся команда Tcl с именем пути к виджету, первым параметром которой является имя вызываемого метода).269270```python271.frm.btn invoke272.frm.lbl configure -text "Goodbye"273```274275В официальной справочной документации Tcl/Tk большинство операций, похожих на вызовы методов, можно найти на man-странице конкретного виджета (например, метод [`invoke()`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Button.invoke) есть на man-странице [ttk::button](https://python-all.ru/3.14/library/tkinter.html)), тогда как функции, принимающие виджет в качестве параметра, часто имеют собственную man-страницу (например, [grid](https://python-all.ru/3.14/library/tkinter.html)).276277Многие общие параметры и методы можно найти на man-страницах [options](https://python-all.ru/3.14/library/tkinter.html) или [ttk::widget](https://python-all.ru/3.14/library/tkinter.html), тогда как остальные находятся на man-странице конкретного класса виджета.278279Многие методы Tkinter имеют составные имена, например, [`winfo_x()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_x), [`winfo_height()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_height), [`winfo_viewable()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_viewable). Документацию по всем ним можно найти на man-странице [winfo](https://python-all.ru/3.14/library/tkinter.html).280281> **Примечание**282>283> Несколько сбивает с толку то, что у всех виджетов Tkinter есть методы, которые на самом деле не работают с виджетом, а действуют на глобальном уровне, независимо от какого-либо виджета. Примерами являются методы для доступа к буферу обмена или системному звонку. (Они реализованы как методы в базовом классе [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget), от которого наследуют все виджеты Tkinter).284285## Модель многопоточности286287Python и Tcl/Tk имеют очень разные модели многопоточности, которые `tkinter` пытается согласовать. При использовании потоков следует учитывать это.288289Интерпретатор Python может иметь множество связанных с ним потоков. В Tcl можно создавать несколько потоков, но каждый поток имеет отдельный экземпляр интерпретатора Tcl. Потоки также могут создавать более одного экземпляра интерпретатора, но каждый экземпляр может использоваться только тем потоком, который его создал.290291Каждый объект [`Tk`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk), созданный `tkinter`, содержит интерпретатор Tcl. Он также отслеживает, какой поток создал этот интерпретатор. Вызовы `tkinter` могут производиться из любого потока Python. Внутренне, если вызов поступает из потока, отличного от создавшего объект `Tk`, в очередь событий интерпретатора помещается событие, и при его выполнении результат возвращается вызывающему потоку Python.292293Приложения Tcl/Tk обычно управляются событиями, то есть после инициализации интерпретатор запускает цикл событий (то есть [`Tk.mainloop`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.mainloop)) и реагирует на события. Поскольку он однопоточный, обработчики событий должны отвечать быстро, иначе они заблокируют обработку других событий. Чтобы избежать этого, длительные вычисления не должны выполняться в обработчике событий; их либо разбивают на более мелкие части с помощью таймеров, либо запускают в другом потоке. Это отличается от многих наборов инструментов для графического интерфейса, где графический интерфейс работает в полностью отдельном потоке от всего кода приложения, включая обработчики событий.294295Если интерпретатор Tcl не выполняет цикл событий и не обрабатывает события, любые вызовы `tkinter` из потоков, отличных от того, в котором работает интерпретатор Tcl, завершатся ошибкой.296297Существует ряд особых случаев:298299- Библиотеки Tcl/Tk, собранные без поддержки потоков, сейчас редки: встроенный Tcl/Tk 8.6 собран с поддержкой потоков, поэтому этот случай возникает только с некоторыми старыми сборками без поддержки потоков. Когда библиотека не учитывает потоки, `tkinter` вызывает библиотеку из исходного потока Python, даже если он отличается от потока, создавшего интерпретатор Tcl. Глобальная блокировка гарантирует, что за один раз происходит только один вызов.300- Хотя `tkinter` позволяет создать более одного экземпляра объекта [`Tk`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk) (с собственным интерпретатором), все интерпретаторы, принадлежащие одному и тому же потоку, используют общую очередь событий, что быстро приводит к проблемам. На практике не следует создавать более одного экземпляра `Tk` одновременно. В противном случае лучше создавать их в отдельных потоках и убедиться, что используется сборка Tcl/Tk с поддержкой потоков.301- Блокирующие обработчики событий – не единственный способ помешать интерпретатору Tcl снова войти в цикл событий. Можно даже запускать несколько вложенных циклов событий или полностью отказаться от цикла событий. Если выполняются какие-либо нетривиальные действия с событиями или потоками, следует учитывать эти возможности.302- Существует несколько отдельных функций `tkinter`, которые в настоящее время работают только при вызове из потока, создавшего интерпретатор Tcl.303304## Удобный справочник305306### Настройка параметров307308Параметры управляют такими вещами, как цвет и ширина границы виджета. Параметры можно задать тремя способами:309310**При создании объекта – с помощью именованных аргументов**311312```python313fred = Button(self, fg="red", bg="blue")314```315316**После создания объекта – используя имя параметра как индекс словаря**317318```python319fred["fg"] = "red"320fred["bg"] = "blue"321```322323**Использовать метод config() для обновления нескольких атрибутов после создания объекта**324325```python326fred.config(fg="red", bg="blue")327```328329Полное объяснение конкретного параметра и его поведения можно найти на man-страницах Tk для соответствующего виджета.330331Обратите внимание, что man-страницы перечисляют «СТАНДАРТНЫЕ ПАРАМЕТРЫ» и «ПАРАМЕТРЫ, СПЕЦИФИЧНЫЕ ДЛЯ ВИДЖЕТА» для каждого виджета. Первое – список параметров, общих для многих виджетов, второе – параметры, свойственные конкретному виджету. Стандартные параметры задокументированы на man-странице *[options(3)](https://python-all.ru/3.14/library/tkinter.html)*.332333В этом документе не делается различий между стандартными и специфичными для виджета параметрами. Некоторые параметры не применимы к некоторым типам виджетов. Реагирует ли данный виджет на определённый параметр, зависит от класса виджета: кнопки имеют параметр `command`, а метки – нет.334335Параметры, поддерживаемые данным виджетом, перечислены на его man-странице, или их можно запросить во время выполнения, вызвав метод [`config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.config) без аргументов, или вызвав метод [`keys()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.keys) для этого виджета. Возвращаемое значение этих вызовов – словарь, ключом которого является имя параметра в виде строки (например, `'relief'`), а значениями – 5-кортежи.336337Некоторые параметры, например `bg`, являются синонимами распространённых параметров с длинными именами (`bg` – сокращение для «background»). При передаче методу `config()` имени сокращённого параметра будет возвращён 2-кортеж, а не 5-кортеж. Возвращаемый 2-кортеж содержит имя синонима и «реальный» параметр (например, `('bg', 'background')`).338339| Индекс | Значение | Пример |340| --- | --- | --- |341| 0 | имя параметра | `'relief'` |342| 1 | имя параметра для поиска в базе данных | `'relief'` |343| 2 | класс параметра для поиска в базе данных | `'Relief'` |344| 3 | значение по умолчанию | `'raised'` |345| 4 | текущее значение | `'groove'` |346347Пример:348349```python350>>> print(fred.config())351{'relief': ('relief', 'relief', 'Relief', 'raised', 'groove')}352```353354Разумеется, выведенный словарь будет содержать все доступные опции и их значения. Это приведено только в качестве примера.355356### Упаковщик357358Упаковщик – один из механизмов управления геометрией в Tk. Менеджеры геометрии используются для указания относительного расположения виджетов внутри их контейнера. В отличие от более громоздкого *разместителя* (который используется реже и не рассматривается здесь), упаковщик принимает качественные спецификации отношений – *выше*, *слева от*, *заполнение* и т. д. – и самостоятельно вычисляет точные координаты размещения.359360Размер любого контейнерного виджета определяется размером «дочерних виджетов» внутри него. Упаковщик используется для управления тем, где дочерние виджеты появляются внутри контейнера, в который они упаковываются. Виджеты можно упаковывать в рамки, а рамки – в другие рамки, чтобы добиться желаемого расположения. Кроме того, после упаковки расположение динамически корректируется при постепенных изменениях конфигурации.361362Обратите внимание, что виджеты не появляются, пока для них не будет указана геометрия с помощью менеджера геометрии. Распространённая ошибка новичков – пропустить указание геометрии, а затем удивляться, что виджет создан, но ничего не отображается. Виджет появится только после того, как к нему будет применён, например, метод [`pack()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.pack) упаковщика.363364Метод pack() можно вызывать с парами «ключевая опция/значение», которые управляют тем, где виджет будет располагаться внутри контейнера и как он будет вести себя при изменении размера главного окна приложения. Вот несколько примеров:365366```python367fred.pack()                     # по умолчанию side = "top"368fred.pack(side="left")369fred.pack(expand=1)370```371372### Опции упаковщика373374За более подробной информацией об упаковщике и его опциях обращайтесь к man-страницам и странице 183 книги Джона Оустерхаута.375376**привязка**377378Тип привязки. Указывает, где упаковщик должен размещать каждое содержимое в своём участке.379380**расширение**381382логическое значение, `0` или `1`.383384**заполнение**385386Допустимые значения: `'x'`, `'y'`, `'both'`, `'none'`.387388**ipadx и ipady**389390Расстояние, обозначающее внутренний отступ с каждой стороны содержимого.391392**padx и pady**393394Расстояние, обозначающее внешний отступ с каждой стороны содержимого.395396**сторона**397398Допустимые значения: `'left'`, `'right'`, `'top'`, `'bottom'`.399400### Связывание переменных виджетов401402Текущее значение некоторых виджетов (например, виджетов ввода текста) может быть напрямую связано с переменными приложения с помощью специальных опций. Эти опции: `variable`, `textvariable`, `onvalue`, `offvalue` и `value`. Такая связь работает в обе стороны: если переменная изменяется по какой-либо причине, связанный с ней виджет обновится, отображая новое значение.403404К сожалению, в текущей реализации `tkinter` невозможно передать виджету произвольную переменную Python через опцию `variable` или `textvariable`. Единственные переменные, с которыми это работает, – это переменные, являющиеся подклассами класса Variable, определённого в `tkinter`.405406Уже определено множество полезных подклассов Variable: [`StringVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.StringVar), [`IntVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.IntVar), [`DoubleVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.DoubleVar) и [`BooleanVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.BooleanVar). Чтобы прочитать текущее значение такой переменной, вызовите у неё метод [`get()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable.get), а чтобы изменить значение – метод `set()`. Если следовать этому протоколу, виджет будет всегда отслеживать значение переменной без дополнительных действий с вашей стороны.407408Сохраняйте ссылку на переменную всё время, пока виджет её использует, например, храня её в виде атрибута (см. [`Variable`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable)).409410Например:411412```python413import tkinter as tk414415class App(tk.Frame):416    def __init__(self, master):417        super().__init__(master)418        self.pack()419420        self.entrythingy = tk.Entry()421        self.entrythingy.pack()422423        # Создайте переменную приложения.424        self.contents = tk.StringVar()425        # Установите её в некоторое значение.426        self.contents.set("this is a variable")427        # Укажите виджету ввода отслеживать эту переменную.428        self.entrythingy["textvariable"] = self.contents429430        # Определите колбэк для события нажатия Return.431        # Он выводит текущее значение переменной.432        self.entrythingy.bind('<Key-Return>',433                             self.print_contents)434435    def print_contents(self, event):436        print("Hi. The current entry content is:",437              self.contents.get())438439root = tk.Tk()440myapp = App(root)441myapp.mainloop()442```443444### Менеджер окон445446В Tk есть служебная команда `wm` для взаимодействия с менеджером окон. Опции команды `wm` позволяют управлять такими вещами, как заголовки, расположение, значки и тому подобное. В `tkinter` эти команды реализованы как методы класса [`Wm`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm). Виджеты верхнего уровня являются подклассами класса `Wm`, поэтому могут напрямую вызывать методы `Wm`.447448Чтобы получить окно верхнего уровня, содержащее данный виджет, можно просто обратиться к [`master`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk.master) виджета. Конечно, если виджет был упакован внутри рамки, `master` не будет представлять окно верхнего уровня. Чтобы получить окно верхнего уровня, содержащее произвольный виджет, можно вызвать метод [`winfo_toplevel()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_toplevel). Также существует метод `_root()`; его имя начинается с подчёркивания, чтобы показать, что эта функция является частью реализации, а не интерфейсом к функциональности Tk. Он возвращает корневое окно приложения, а не ближайшее охватывающее окно верхнего уровня.449450Вот несколько примеров типичного использования:451452```python453import tkinter as tk454455class App(tk.Frame):456    def __init__(self, master=None):457        super().__init__(master)458        self.pack()459460# создайте приложение461myapp = App()462463#464# здесь вызовы методов класса оконного менеджера465#466myapp.master.title("My Do-Nothing Application")467myapp.master.maxsize(1000, 400)468469# запустите программу470myapp.mainloop()471```472473### Типы данных опций Tk474475**привязка**476477Допустимые значения – направления компаса: `"n"`, `"ne"`, `"e"`, `"se"`, `"s"`, `"sw"`, `"w"`, `"nw"`, а также `"center"`.478479**битовая карта**480481Существует десять встроенных именованных растровых изображений: `'error'`, `'gray12'`, `'gray25'`, `'gray50'`, `'gray75'`, `'hourglass'`, `'info'`, `'questhead'`, `'question'`, `'warning'`. Чтобы указать имя файла X bitmap, укажите полный путь к файлу с префиксом `@`, как в `"@/usr/contrib/bitmap/gumby.bit"`.482483**булевый**484485Можно передать целые числа 0 или 1 или строки `"yes"` или `"no"`.486487**колбэк**488489Это любая функция Python, которая не принимает аргументов. Например:490491```python492def print_it():493    print("hi there")494fred["command"] = print_it495```496497**цвет**498499Цвета можно задавать именами цветов X из файла rgb.txt или строками, представляющими значения RGB в 4-битном: `"#RGB"`, 8-битном: `"#RRGGBB"`, 12-битном: `"#RRRGGGBBB"` или 16-битном: `"#RRRRGGGGBBBB"` диапазонах, где R,G,B обозначают любую допустимую шестнадцатеричную цифру. Подробнее см. на стр. 160 книги Оустерхаута.500501**курсор**502503Имя курсора мыши, отображаемого при наведении указателя на виджет. Tk предоставляет портативный набор имён курсоров, доступных на всех платформах (например, `"arrow"`, `"watch"`, `"cross"` или `"hand2"`); также можно использовать стандартные имена X-курсоров из `cursorfont.h`, без префикса `XC_` (так `XC_hand2` становится `"hand2"`). Полный список имён, включая платформозависимые, приведён на странице *[cursors(3tk)](https://python-all.ru/3.14/library/tkinter.html)* руководства. Можно также указать собственные файлы растрового изображения и маски. В Windows можно напрямую использовать файл курсора (`.cur` или `.ani`), указав его путь с префиксом `@`, как в `"@C:/cursors/bart.ani"`.504505**расстояние**506507Экранные расстояния можно указывать в пикселях или абсолютных единицах. Пиксели задаются числами, а абсолютные расстояния – строками, где последний символ обозначает единицы: `c` для сантиметров, `i` для дюймов, `m` для миллиметров, `p` для типографских пунктов. Например, 3,5 дюйма записывается как `"3.5i"`.508509**шрифт**510511Tk использует описание шрифта, например `{courier 10 bold}`; в `tkinter` это наиболее естественно передавать как кортеж из `(family, size, *styles)` (или как эквивалентную строку `"Courier 10 bold"`). Положительные размеры шрифта измеряются в пунктах; отрицательные – в пикселях.512513**геометрия**514515Это строка вида `widthxheight`, где ширина и высота задаются в пикселях для большинства виджетов (в символах для виджетов, отображающих текст). Например: `fred["geometry"] = "200x100"`.516517**выравнивание**518519Допустимые значения – строки: `"left"`, `"center"` и `"right"`.520521**регион**522523Это строка из четырёх разделённых пробелами элементов, каждый из которых является допустимым расстоянием (см. выше). Например: `"2 3 4 5"`, `"3i 2i 4.5i 2i"` и `"3c 2c 4c 10.43c"` – все являются допустимыми областями.524525**рельеф**526527Определяет стиль рамки виджета. Допустимые значения: `"raised"`, `"sunken"`, `"flat"`, `"groove"`, `"ridge"` и `"solid"`.528529**команда прокрутки**530531Это почти всегда метод `set()` какого-либо виджета полосы прокрутки, но может быть любым методом виджета, принимающим один аргумент.532533**перенос**534535Должно быть одним из: `"none"`, `"char"` или `"word"`.536537### Привязки и события538539Метод bind из команды виджета позволяет отслеживать определённые события и вызывать функцию обратного вызова при наступлении события такого типа. Формат метода bind:540541```python542def bind(self, sequence, func, add=''):543```544545где:546547**последовательность**548549– это строка, обозначающая целевой тип события. Физические события используют форму `<modifier-modifier-type-detail>` (например, `"<Enter>"` или `"<Control-Button-1>"`); определённые приложением виртуальные события используют двойные угловые скобки, как в `"<<Paste>>"`. (Подробнее см. на странице *[bind(3tk)](https://python-all.ru/3.14/library/tkinter.html)* руководства и на стр. 201 книги Джона Оустерхаута *Tcl and the Tk Toolkit (2nd edition)*.)550551**функция**552553– это функция Python, принимающая один аргумент, которая вызывается при наступлении события. В качестве аргумента будет передан экземпляр Event. (Функции, используемые таким образом, обычно называются *колбэками*.)554555**добавить**556557является необязательным, может быть `''` или `'+'`. Передача пустой строки означает, что эта привязка заменяет любые другие привязки, связанные с этим событием. Передача `'+'` означает, что эта функция добавляется в список функций, привязанных к данному типу события.558559Например:560561```python562def turn_red(self, event):563    event.widget["activeforeground"] = "red"564565self.button.bind("<Enter>", self.turn_red)566```567568Обратите внимание, как поле widget объекта события используется в `turn_red()` колбэке. Это поле содержит виджет, который перехватил событие X. В следующей таблице перечислены другие поля событий, к которым можно обратиться, и как они обозначаются в Tk; это может пригодиться при обращении к страницам руководства Tk.569570| Tk | Поле события Tkinter | Tk | Поле события Tkinter |571| --- | --- | --- | --- |572| %f | фокус | %A | char |573| %h | рост | %E | send\_event |574| %k | keycode | %K | keysym |575| %s | состояние | %N | keysym\_num |576| %t | time | %T | type |577| %w | width | %W | widget |578| %x | x | %X | x\_root |579| %y | y | %Y | y\_root |580| %# | serial | %b | num |581| %d | detail | %D | delta |582583Параметр `add` выше влияет только на привязки, задаваемые вами. Каждый виджет также наследует *привязки класса*, реализующие его стандартное поведение – например, виджет [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text) привязывает `Control`-`t` для транспозиции двух символов. Они описаны в разделе привязок страницы руководства Tk для данного виджета (например, *[text(3tk)](https://python-all.ru/3.14/library/tkinter.html)* или *[entry(3tk)](https://python-all.ru/3.14/library/tkinter.html)*).584585Привязки класса обрабатываются отдельно от ваших собственных, поэтому привязка события самостоятельно не заменяет поведение по умолчанию; выполняются обе. Чтобы подавить нежелательную привязку по умолчанию, привяжите событие к виджету и верните строку `"break"` из вашего колбэка.586587### Параметр index588589Ряд виджетов требует передачи параметров «index». Они используются для указания на конкретное место в виджете Text, на определённые символы в виджете Entry или на конкретные пункты меню в виджете Menu.590591**Индексы виджета Entry (index, view index и т.д.)**592593Виджеты Entry имеют опции, относящиеся к позициям символов в отображаемом тексте. Для доступа к этим специальным точкам в текстовых виджетах можно использовать следующие функции `tkinter`:594595**Индексы виджета Text**596597Обозначение индексов для виджетов Text очень богатое и лучше всего описано на страницах руководства Tk.598599**Индексы меню (menu.invoke(), menu.entryconfig() и т.д.)**600601Некоторые опции и методы для меню работают с конкретными пунктами меню. Всякий раз, когда для опции или параметра требуется индекс меню, можно передать:602603- целое число, которое указывает на числовую позицию пункта в виджете, считая сверху, начиная с 0;604- строку `"active"`, которая указывает на позицию меню, находящуюся в данный момент под курсором;605- строку `"last"`, которая указывает на последний пункт меню;606- Целое число, перед которым стоит `@`, например `@6`, где целое число интерпретируется как координата y в пикселях в системе координат меню;607- строку `"none"`, которая указывает на отсутствие какого-либо пункта меню, чаще всего используется с menu.activate() для деактивации всех пунктов, и наконец,608- текстовую строку, которая сопоставляется с образцом с меткой пункта меню при сканировании сверху вниз. Обратите внимание, что этот тип индекса рассматривается после всех остальных, что означает, что совпадения для пунктов меню с метками `last`, `active` или `none` могут быть интерпретированы как указанные выше литералы.609610### Изображения611612Изображения разных форматов можно создать через соответствующий подкласс [`tkinter.Image`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Image):613614- [`BitmapImage`](https://python-all.ru/3.14/library/tkinter.html#tkinter.BitmapImage) для изображений в формате XBM.615- [`PhotoImage`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PhotoImage) для изображений в форматах PGM, PPM, GIF и PNG. Последний поддерживается начиная с Tk 8.6.616617Оба типа изображений создаются с помощью опции `file` или `data` (доступны и другие опции).618619Изменено в версии 3.13: Добавлен метод `PhotoImage` `copy_replace()` для копирования области из одного изображения в другое, возможно с масштабированием пикселей и/или субдискретизацией. Добавлен параметр *from\_coords* в методы `PhotoImage` `copy()`, `zoom()` и `subsample()`. Добавлены параметры *zoom* и *subsample* в метод `PhotoImage` `copy()`.620621Затем объект изображения можно использовать везде, где какой-либо виджет поддерживает опцию `image` (например, метки, кнопки, меню). В таких случаях Tk не хранит ссылку на изображение. Когда последняя ссылка Python на объект изображения удаляется, данные изображения также удаляются, и Tk будет отображать пустой прямоугольник там, где использовалось изображение.622623> **См. также**624>625> Пакет [Pillow](https://python-all.ru/3.14/library/tkinter.html) добавляет поддержку форматов BMP, JPEG, TIFF, WebP и других.626627## Ссылка628629В этом разделе описаны классы, методы, функции и константы модуля `tkinter`. Большинство из них являются обёртками команд Tcl/Tk; обращайтесь к официальной документации Tcl/Tk для полного списка опций виджетов и дополнительных сведений.630631#### `exception tkinter.TclError`632633Исключение, возникающее при сбое вызова интерпретатора Tcl, например, когда виджету передана неизвестная опция или недопустимое значение.634635### Базовые и примесные классы636637#### `class tkinter.Misc`638639Класс `Misc` – это примесь, наследуемая классом [`Tk`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk) и, через [`BaseWidget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.BaseWidget), каждым виджетом. Он предоставляет обширный набор методов, общих для всех объектов Tk: запрос информации об окне, управление привязками событий и циклом событий, управление фокусом клавиатуры и захватом указателя, доступ к выделению, буферу обмена и базе данных опций, а также различные служебные и интроспекционные сервисы. Поскольку они наследуются, эти методы доступны на каждом виджете и на объекте приложения `Tk`, и документированы здесь один раз, а не повторяются для каждого виджета.640641#### `cget(key)`642643Возвращает текущее значение опции конфигурации с именем *key* для данного виджета в виде строки. Выражение `widget[key]` эквивалентно и может использоваться вместо этого.644645#### `configure(cnf=None, **kw)`646647Запрашивает или изменяет опции конфигурации виджета. Без аргументов возвращает словарь, сопоставляющий каждому доступному имени опции кортеж с её описанием (имя, X ресурсное имя, X ресурсный класс, значение по умолчанию и текущее значение). Если указано одно имя опции в виде строки, возвращает кортеж только для этой опции. Если указаны одно или несколько ключевых аргументов, или передан словарь в качестве *cnf*, устанавливает каждую именованную опцию в соответствующее значение; выражение `widget[key] = value` устанавливает одну опцию таким же образом.648649[`config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.config) является псевдонимом `configure()`.650651#### `keys()`652653Возвращает список имён всех опций конфигурации данного виджета.654655#### `getboolean(s)`656657Интерпретирует строку *s* как логическое значение Tcl и возвращает соответствующее [`bool`](https://python-all.ru/3.14/library/functions.html#bool). Tcl принимает такие значения, как `'1'`, `'0'`, `'yes'`, `'no'`, `'true'` и `'false'`. Вызывает [`ValueError`](https://python-all.ru/3.14/library/exceptions.html#ValueError), если *s* не является допустимым логическим значением.658659#### `getdouble(s)`660661Интерпретирует строку *s* как число с плавающей запятой Tcl и возвращает его в виде [`float`](https://python-all.ru/3.14/library/functions.html#float). Вызывает [`ValueError`](https://python-all.ru/3.14/library/exceptions.html#ValueError), если *s* не является допустимым числом.662663Добавлено в версии 3.5.664665#### `getint(s)`666667Интерпретирует строку *s* как целое число Tcl и возвращает его как [`int`](https://python-all.ru/3.14/library/functions.html#int). Вызывает [`ValueError`](https://python-all.ru/3.14/library/exceptions.html#ValueError), если *s* не является допустимым целым числом.668669#### `getvar(name)`670671Возвращает значение глобальной переменной Tcl с именем *name*.672673#### `setvar(name, value)`674675Устанавливает глобальную переменную Tcl с именем *name* в значение *value*.676677Методы `getvar()` и `setvar()` предоставляют прямой доступ к переменным Tcl. В большинстве кода вместо них используется подкласс [`Variable`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable), такой как [`StringVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.StringVar) или [`IntVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.IntVar), который оборачивает переменную Tcl и преобразует её значение в тип Python и обратно.678679#### `register(func, subst=None, needcleanup=1)`680681Регистрирует вызываемый объект Python *func* как команду Tcl и возвращает имя новой команды в виде строки. Всякий раз, когда Tcl вызывает эту команду, вызывается *func*; если указан *subst*, он сначала применяется к аргументам команды. Это механизм, используемый внутри для преобразования обратных вызовов Python в имена команд, передаваемые опциям Tk, таким как *command*. Если *needcleanup* не равно false, команда автоматически удаляется при уничтожении виджета.682683Изменено в версии 3.13: Аргументы, передаваемые в *func*, больше не преобразуются в строки.684685#### `deletecommand(name)`686687Удаляет Tcl-команду с именем *name*, например ту, что была возвращена ранее вызовом [`register()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.register).688689#### `nametowidget(name)`690691Возвращает экземпляр виджета, соответствующий Tk-пути *name*.692693#### `send(interp, cmd, *args)`694695Отправляет Tcl-команду *cmd* с переданными аргументами *args* интерпретатору Tcl, зарегистрированному под именем *interp*, и возвращает результат. Доступно не на всех платформах.696697#### `destroy()`698699Уничтожает данный виджет и все его дочерние виджеты, удаляя связанные с ними Tcl-команды.700701#### `tkraise(aboveThis=None)`702703Поднимает данный виджет в стеке порядка, чтобы он отображался поверх своих соседей. Если указан *aboveThis*, виджет перемещается непосредственно над этим элементом в стеке порядка.704705[`lift()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.lift) является псевдонимом `tkraise()`.706707#### `lower(belowThis=None)`708709Опускает данный виджет в стеке порядка, чтобы он отображался под своими соседями. Если указан *belowThis*, виджет перемещается непосредственно под этим элементом в стеке порядка.710711[`tkraise()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.tkraise)/[`lift()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.lift) и `lower()` переопределяются в виджете [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas), где они вместо этого переупорядочивают элементы canvas.712713#### `image_names()`714715Возвращает имена всех изображений, которые на данный момент существуют в интерпретаторе Tcl.716717Это переопределяется в виджете [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text), где `image_names()` вместо этого возвращает имена его встроенных изображений.718719#### `image_types()`720721Возвращает доступные типы изображений, такие как `'photo'` и `'bitmap'`.722723#### `grid_anchor(anchor=None)`724725Устанавливает привязку (anchor), которая определяет положение сетки внутри контейнера, когда контейнер больше сетки и ни одна строка или столбец не имеют ненулевого веса. *anchor* – одна из стандартных строк привязки, например `'nw'` (по умолчанию) или `'center'`. Вызов без аргументов не даёт эффекта.726727[`anchor()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.anchor) является псевдонимом `grid_anchor()`.728729Добавлено в версии 3.3.730731#### `grid_bbox(column=None, row=None, col2=None, row2=None)`732733Возвращает ограничивающий прямоугольник (в пикселях) области сетки, размещённой внутри данного контейнера, в виде кортежа из 4 элементов `(xoffset, yoffset, width, height)`. Без аргументов возвращается ограничивающий прямоугольник всей сетки. Если указаны *column* и *row*, прямоугольник охватывает ячейку с номером строки и столбца 0 до этой ячейки; если также указаны *col2* и *row2*, то он охватывает область от ячейки (*column*, *row*) до ячейки (*col2*, *row2*).734735[`bbox()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.bbox) – это псевдоним `grid_bbox()`, за исключением [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox), [`Spinbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox), [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text), [`ttk.Entry`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Entry) и [`ttk.Treeview`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Treeview), которые предоставляют собственный метод `bbox()`.736737#### `grid_columnconfigure(index, cnf={}, **kw)`738739Запрашивает или задаёт свойства столбца (или столбцов) *index* сетки, управляемой этим контейнером. *index* может быть номером столбца; при задании параметров это также может быть список номеров столбцов, строка `'all'` для воздействия на каждый столбец, или дочерний виджет, у которого затрагиваются занимаемые столбцы. Поддерживаемые параметры:740741***minsize***742743Минимальный размер столбца в пикселях.744745***weight***746747Целое число, определяющее, какая доля дополнительного пространства выделяется столбцу. Вес `0` оставляет столбец запрошенного размера, а столбец с весом два увеличивается вдвое быстрее столбца с весом один.748749***uniform***750751Имя единой группы. Столбцы с одинаковым непустым именем группы сохраняют размеры, строго пропорциональные их весам.752753***pad***754755Дополнительное пространство в пикселях, добавляемое к наибольшему виджету в столбце при вычислении размера столбца.756757С одним именем опции возвращает её значение; без аргументов возвращает словарь всех опций.758759[`columnconfigure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.columnconfigure) является псевдонимом `grid_columnconfigure()`.760761#### `grid_rowconfigure(index, cnf={}, **kw)`762763Запрашивает или задаёт свойства строки (или строк) *index* сетки, управляемой этим контейнером. *index* интерпретируется так же, как для [`grid_columnconfigure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_columnconfigure), а поддерживаемые опции (*minsize*, *weight*, *uniform* и *pad*) те же, но применяются к строке, а не к столбцу.764765[`rowconfigure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.rowconfigure) является псевдонимом `grid_rowconfigure()`.766767#### `grid_location(x, y)`768769Возвращает `(column, row)` ячейки сетки, содержащей пиксель в позиции (*x*, *y*), заданной в пикселях относительно этого контейнера. Для позиций выше или левее сетки возвращается `-1` для соответствующей координаты.770771#### `grid_propagate()`772773#### `grid_propagate(flag)`774775Включает или отключает распространение геометрии для этого контейнера, когда он управляет своими дочерними элементами с помощью менеджера геометрии grid. Когда *flag* равен true, контейнер изменяет свой размер, чтобы соответствовать запрошенным размерам дочерних элементов; когда false, его размер остаётся под вашим контролем. При вызове без аргументов возвращает текущую настройку в виде булева значения.776777#### `grid_size()`778779Возвращает размер сетки, управляемой этим контейнером, в виде кортежа `(columns, rows)`.780781[`size()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.size) – это псевдоним `grid_size()`, за исключением виджета [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox), который предоставляет собственный метод `size()`.782783#### `grid_slaves(row=None, column=None)`784785Возвращает список дочерних виджетов, управляемых в сетке этого контейнера, начиная с последнего добавленного. Если указаны *row* или *column*, возвращаются только дочерние элементы в этой строке или столбце.786787#### `pack_propagate()`788789#### `pack_propagate(flag)`790791Включает или отключает распространение геометрии для этого контейнера, когда он управляет своими дочерними элементами с помощью менеджера геометрии pack. Когда *flag* равен true, контейнер изменяет свой размер, чтобы соответствовать запрошенным размерам дочерних элементов; когда false, его размер остаётся под вашим контролем. При вызове без аргументов возвращает текущую настройку в виде булева значения.792793[`propagate()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.propagate) является псевдонимом `pack_propagate()`.794795#### `pack_slaves()`796797Возвращает список дочерних виджетов, управляемых этим контейнером с помощью менеджера геометрии pack, в порядке упаковки.798799[`slaves()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.slaves) является псевдонимом `pack_slaves()`.800801#### `place_slaves()`802803Возвращает список дочерних виджетов, управляемых этим контейнером с помощью менеджера геометрии place.804805#### `bind(sequence=None, func=None, add=None)`806807Привязывает шаблон события *sequence* на этом виджете к вызываемому объекту *func*.808809*sequence* – это шаблон события, например `'<Button-1>'` (щелчок мыши) или `'<KeyPress-a>'`, и, возможно, объединение нескольких таких шаблонов, которые должны произойти один за другим. При наступлении события *func* вызывается с экземпляром [`Event`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Event), описывающим его, в качестве единственного аргумента; если *func* возвращает строку `'break'`, дальнейшие привязки для этого события не вызываются.810811Если *add* равен true, *func* добавляется к любым функциям, уже привязанным к *sequence*; в противном случае он заменяет их. Привязка применяется только к этому виджету.812813`bind()` возвращает строковый идентификатор (*funcid*), который впоследствии можно передать в [`unbind()`](https://python-all.ru/3.14/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.14/library/tkinter.html#tkinter.Misc.bind), но привязывает *func* к тегу привязки *className*, а не к отдельному виджету, так что привязка применяется к каждому виджету, имеющему этот тег. *className* обычно является именем класса виджета, например `'Button'`, в этом случае привязка влияет на все виджеты этого класса. Набор тегов привязки для виджета можно просмотреть и изменить с помощью [`bindtags()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.bindtags).820821Остальные аргументы и возвращаемое значение такие же, как для [`bind()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.bind).822823#### `bind_all(sequence=None, func=None, add=None)`824825Как [`bind()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.bind), но привязывает *func* к специальному тегу привязки `'all'`, так что привязка применяется к каждому виджету в приложении.826827Остальные аргументы и возвращаемое значение такие же, как для [`bind()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.bind).828829#### `unbind(sequence, funcid=None)`830831Удаляет привязки для шаблона события *sequence* на этом виджете.832833Если указан *funcid*, удаляется только функция, идентифицируемая им (значение, возвращённое предыдущим вызовом [`bind()`](https://python-all.ru/3.14/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.14/library/tkinter.html#tkinter.Misc.bind_class).840841#### `unbind_all(sequence)`842843Удаляет все привязки для шаблона события *sequence* из специального тега привязки `'all'`. См. [`bind_all()`](https://python-all.ru/3.14/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, **kw)`872873Планирует вызов вызываемого объекта *func* через *ms* миллисекунд с передачей ему *args* и *kw* в качестве позиционных и именованных аргументов. Возвращает идентификатор, который можно передать в [`after_cancel()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.after_cancel) для отмены вызова.874875Если *func* опущен, вместо этого приостановить выполнение на *ms* миллисекунд, не обрабатывая события в течение этого времени, и вернуть `None`.876877Изменено в версии 3.10: *func* теперь может быть любым вызываемым объектом, а не только функцией.878879Изменено в версии 3.14: Именованные аргументы теперь передаются в *func*.880881#### `after_cancel(id)`882883Отменяет колбэк, ранее запланированный с помощью [`after()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.after) или [`after_idle()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.after_idle). *id* должен быть идентификатором, возвращённым одним из этих методов; передача значения, не являющегося таким идентификатором, вызывает [`ValueError`](https://python-all.ru/3.14/library/exceptions.html#ValueError). Если колбэк уже выполнен или отменён, это не оказывает эффекта.884885Изменено в версии 3.7: Передача `None` (или любого ложного значения) в качестве *id* теперь вызывает [`ValueError`](https://python-all.ru/3.14/library/exceptions.html#ValueError).886887#### `after_idle(func, *args, **kw)`888889Планирует вызов вызываемого объекта *func* с передачей ему *args* и *kw*, когда главный цикл Tk в следующий раз станет бездействующим, то есть когда у него не будет других событий для обработки. Возвращает идентификатор, который можно передать в [`after_cancel()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.after_cancel) для отмены вызова.890891Изменено в версии 3.14: Именованные аргументы теперь передаются в *func*.892893#### `after_info(id=None)`894895Если *id* опущен, возвращает кортеж идентификаторов всех колбэков, текущих запланированных с помощью [`after()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.after) и [`after_idle()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.after_idle) для данного интерпретатора.896897Если *id* указан, он должен идентифицировать колбэк, который ещё не выполнен или не отменён, и возвращаемое значение представляет собой кортеж `(script, type)`, где *script* ссылается на вызываемую функцию, а *type* – это либо `'idle'`, либо `'timer'`. Вызывается [`TclError`](https://python-all.ru/3.14/library/tkinter.html#tkinter.TclError), если *id* не существует.898899Добавлено в версии 3.13.900901#### `mainloop(n=0)`902903Входит в цикл событий Tk, который обрабатывает события до тех пор, пока все окна не будут уничтожены. Обычно вызывается один раз, на корневом окне, для запуска приложения.904905#### `quit()`906907Завершает интерпретатор Tcl, в результате чего [`mainloop()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.mainloop) возвращает управление.908909#### `update()`910911Входит в цикл событий до тех пор, пока все ожидающие события, включая бездействующие колбэки, не будут обработаны. Это обновляет отображение и обрабатывает любые события, которые уже находятся в очереди, после чего возвращает управление.912913#### `update_idletasks()`914915Входит в цикл событий до тех пор, пока не будут вызваны все ожидающие бездействующие колбэки. Это обновляет отображение окон, например после изменения геометрии, но не обрабатывает события, вызванные пользователем.916917#### `wait_variable(name)`918919Ожидает, пока переменная Tcl *name* не будет изменена, продолжая при этом обрабатывать события, чтобы приложение оставалось отзывчивым. *name* обычно является экземпляром [`Variable`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable), таким как [`IntVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.IntVar) или [`StringVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.StringVar).920921[`waitvar()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.waitvar) является псевдонимом `wait_variable()`.922923#### `wait_window(window=None)`924925Ожидает, пока *window* не будет уничтожено, продолжая при этом обрабатывать события. Если *window* опущен, используется данный виджет. Обычно используется для ожидания завершения взаимодействия пользователя с диалоговым окном.926927#### `wait_visibility(window=None)`928929Ожидает, пока состояние видимости *window* не изменится, например, когда оно впервые появляется на экране, продолжая при этом обрабатывать события. Если *window* опущен, используется данный виджет. Обычно используется для ожидания, пока новое окно не станет видимым, прежде чем выполнять с ним какие-либо действия.930931Методы с префиксом `focus_` управляют фокусом ввода с клавиатуры.932933#### `focus()`934935Направляет фокус ввода с клавиатуры для дисплея данного виджета на этот виджет. Если приложение в данный момент не имеет фокуса ввода на дисплее этого виджета, виджет запоминается как окно фокуса для своего верхнего уровня, и фокус будет перенаправлен на него в следующий раз, когда оконный менеджер передаст фокус верхнему уровню. `focus()` – это псевдоним `focus_set()`, за исключением виджетов [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas) и [`ttk.Treeview`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Treeview), которые предоставляют собственный метод `focus()`.936937#### `focus_force()`938939Направляет фокус ввода с клавиатуры на этот виджет, даже если приложение в данный момент не имеет фокуса ввода для дисплея виджета. Этот метод следует использовать с осторожностью, если вообще использовать; обычно приложению следует дожидаться, пока оконный менеджер сам передаст ему фокус, а не захватывать его.940941#### `focus_get()`942943Возвращает виджет, который в данный момент имеет фокус клавиатуры в приложении, или `None`, если ни один виджет в приложении не имеет фокуса. Используйте [`focus_displayof()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.focus_displayof) для корректной работы с несколькими дисплеями.944945#### `focus_displayof()`946947Возвращает виджет, который в данный момент имеет фокус клавиатуры на дисплее, где расположен этот виджет, или `None`, если ни один виджет в приложении не имеет фокуса на этом дисплее.948949#### `focus_lastfor()`950951Возвращает последний виджет, который имел фокус клавиатуры среди всех виджетов на том же верхнем уровне, что и этот виджет; это виджет, который получит фокус в следующий раз, когда оконный менеджер передаст фокус этому верхнему уровню. Если ни один виджет на этом верхнем уровне никогда не имел фокуса, или если последний виджет с фокусом был удалён, возвращается сам верхний уровень.952953#### `tk_focusFollowsMouse()`954955Перенастраивает Tk на использование неявной модели фокуса, в которой фокус устанавливается на виджет при входе в него указателя мыши. После включения эту модель непросто отключить.956957#### `tk_focusNext()`958959Возвращает следующий виджет после данного в порядке обхода клавиатуры, или `None`, если такого нет. Порядок обхода: сначала следующий дочерний элемент, затем рекурсивно дочерние элементы этого дочернего элемента, а затем следующий родственный элемент, расположенный выше в порядке наложения. Виджет пропускается, если его опция `takefocus` имеет значение `0`. Этот метод используется в привязках по умолчанию для клавиши `Tab`.960961#### `tk_focusPrev()`962963Возвращает предыдущий виджет перед данным в порядке обхода клавиатуры, или `None`, если такого нет. См. [`tk_focusNext()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.tk_focusNext) для описания порядка. Этот метод используется в привязках по умолчанию для клавиши `Shift`-`Tab`.964965Методы с префиксом `grab_` устанавливают и запрашивают захват ввода, который направляет все события ввода на один виджет.966967#### `grab_set()`968969Устанавливает локальный захват на этот виджет. Захват ограничивает события указателя этим виджетом и его потомками: пока указатель находится вне поддерева виджета, нажатия и отпускания кнопок, а также перемещения указателя передаются виджету захвата, а окна за пределами поддерева становятся нечувствительными до освобождения захвата. Локальный захват влияет только на приложение, которое его установило. Любой предыдущий захват, установленный этим приложением на дисплее виджета, автоматически освобождается. Установка захвата – обычный способ сделать диалог модальным: пока захват активен, пользователь не может взаимодействовать с другими окнами приложения.970971#### `grab_set_global()`972973Устанавливает глобальный захват на этот виджет. Глобальный захват подобен локальному захвату, устанавливаемому методом [`grab_set()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grab_set), но он блокирует все остальные приложения на экране, так что только поддерево этого виджета чувствительно к событиям указателя, а также захватывает клавиатуру. Следует соблюдать осторожность: глобальный захват может легко сделать дисплей неработоспособным, поскольку другие приложения перестают получать события до его освобождения.974975#### `grab_release()`976977Освобождает захват на этот виджет, если он установлен; в противном случае ничего не делает.978979#### `grab_current()`980981Возвращает виджет, который в данный момент удерживает захват в этом приложении для дисплея данного виджета, или `None`, если такого виджета нет.982983#### `grab_status()`984985Возвращает `None`, если на данный момент на этом виджете не установлен захват, `"local"`, если установлен локальный захват, или `"global"`, если установлен глобальный захват.986987Методы с префиксом `selection_` извлекают и управляют X-выделением.988989#### `selection_clear(**kw)`990991Очищает X-выделение, так чтобы ни одно окно больше не владело им. Очищаемое выделение задаётся именованным аргументом *selection*, именем атома, таким как `'PRIMARY'` или `'CLIPBOARD'`; по умолчанию используется `PRIMARY`. Именованный аргумент *displayof* задаёт виджет, определяющий дисплей, на котором следует выполнять операцию; по умолчанию используется этот виджет.992993Это переопределяется виджетами [`Entry`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry), [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox) и [`Spinbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox), где `selection_clear()` вместо этого очищает собственное выделение виджета.994995#### `selection_get(**kw)`996997Возвращает содержимое текущего X-выделения. Именованный аргумент *selection* задаёт имя выделения; по умолчанию используется `PRIMARY`. Именованный аргумент *type* указывает форму, в которой должны быть возвращены данные (нужный целевой тип преобразования) – имя атома, такое как `'STRING'` или `'FILE_NAME'`; по умолчанию используется `STRING`, за исключением X11, где сначала пробуется `UTF8_STRING`, а в качестве запасного варианта применяется `STRING`. Именованный аргумент *displayof* задаёт виджет, определяющий дисплей, с которого следует получить выделение; по умолчанию используется этот виджет.998999#### `selection_handle(command, **kw)`10001001Регистрирует *command* как обработчик для предоставления X-выделения, которым владеет этот виджет, когда другое приложение запрашивает его. При извлечении выделения *command* вызывается с двумя аргументами: начальным смещением символа и максимальным количеством возвращаемых символов; он должен вернуть не более этого количества символов выделения, начиная с указанного смещения; для очень длинных выделений он вызывается многократно с увеличивающимися смещениями. Именованный аргумент *selection* задаёт имя выделения (по умолчанию `PRIMARY`), а именованный аргумент *type* указывает форму выделения, которую предоставляет обработчик (например, `'STRING'` или `'FILE_NAME'`, по умолчанию `STRING`).10021003#### `selection_own(**kw)`10041005Делает этот виджет владельцем X-выделения на его дисплее. Предыдущий владелец, если он был, уведомляется о потере выделения. Именованный аргумент *selection* задаёт имя выделения; по умолчанию используется `PRIMARY`.10061007#### `selection_own_get(**kw)`10081009Возвращает виджет в этом приложении, которому принадлежит выделение X на дисплее, содержащем этот виджет, или `None`, если ни один виджет в этом приложении не владеет выделением. Именованный аргумент *selection* задаёт название выделения; значение по умолчанию – `PRIMARY`. Именованный аргумент *displayof* задаёт виджет, определяющий запрашиваемый дисплей; значение по умолчанию – этот виджет.10101011Методы с префиксом `clipboard_` управляют буфером обмена.10121013#### `clipboard_append(string, **kw)`10141015Добавляет *string* в буфер обмена Tk и заявляет права владения буфером обмена на дисплее этого виджета. Перед добавлением буфер обмена следует очистить с помощью [`clipboard_clear()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.clipboard_clear); все добавления должны быть завершены до возврата в цикл событий, чтобы буфер обмена обновился атомарно. Именованный аргумент *type* задаёт форму данных – имя атома, например `'STRING'` или `'FILE_NAME'` (по умолчанию `STRING`), а именованный аргумент *format* задаёт представление, используемое для передачи (по умолчанию `STRING`). Именованный аргумент *displayof* задаёт виджет, определяющий целевой дисплей; значение по умолчанию – этот виджет. Содержимое можно получить с помощью [`clipboard_get()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.clipboard_get) или [`selection_get()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.selection_get).10161017#### `clipboard_clear(**kw)`10181019Заявляет права владения буфером обмена на дисплее этого виджета и удаляет предыдущее содержимое. Именованный аргумент *displayof* задаёт виджет, определяющий целевой дисплей; значение по умолчанию – этот виджет.10201021#### `clipboard_get(**kw)`10221023Извлекает данные из буфера обмена на дисплее этого виджета. Именованный аргумент *type* задаёт форму, в которой должны быть возвращены данные – имя атома, например `'STRING'` или `'FILE_NAME'`; по умолчанию `STRING`, за исключением X11, где сначала пробуется `UTF8_STRING`, а `STRING` используется как запасной вариант. Именованный аргумент *displayof* задаёт виджет, определяющий дисплей; значение по умолчанию – корневое окно приложения. Это эквивалентно `selection_get(selection='CLIPBOARD')`.10241025Методы с префиксом `option_` запрашивают и изменяют базу данных опций Tk.10261027#### `option_add(pattern, value, priority=None)`10281029Добавляет опцию в базу данных опций Tk, связывающую *value* с *pattern*. *pattern* состоит из имён и/или классов, разделённых звёздочками или точками, в обычном формате X. *priority* – целое число от 0 до 100 или одно из символических имён `'widgetDefault'` (20), `'startupFile'` (40), `'userDefault'` (60) или `'interactive'` (80); по умолчанию `interactive`.10301031#### `option_clear()`10321033Очищает базу данных опций Tk. Опции по умолчанию из свойства `RESOURCE_MANAGER` или файла `.Xdefaults` автоматически перезагружаются при следующем добавлении или удалении опции из базы.10341035#### `option_get(name, className)`10361037Возвращает значение опции из базы данных опций Tk, соответствующей этому виджету по *name* и *className*, или пустую строку, если соответствующей записи нет. Если совпадает несколько записей, возвращается та, у которой наивысший приоритет, а среди записей с равным приоритетом – добавленная последней.10381039#### `option_readfile(fileName, priority=None)`10401041Читает файл с именем *fileName*, который должен иметь стандартный формат базы данных ресурсов X, например `.Xdefaults`, и добавляет все указанные в нём опции в базу данных опций Tk. *priority* интерпретируется так же, как для [`option_add()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.option_add), и по умолчанию равен `interactive`.10421043#### `bell(displayof=0)`10441045Воспроизводит звонок на дисплее этого виджета, используя текущие настройки звонка дисплея, и сбрасывает хранитель экрана для экрана. Если *displayof* задан как виджет, звонок воспроизводится на дисплее этого виджета.10461047#### `tk_setPalette(background, /)`10481049#### `tk_setPalette(*args, **kw)`10501051Устанавливает новую цветовую схему для всех элементов виджетов Tk. Существующие виджеты обновляются, а база данных опций изменяется так, чтобы будущие виджеты использовали новые цвета. Если передан один цветовой аргумент, он считается обычным цветом фона, на основе которого вычисляется полная палитра. В качестве альтернативы аргументы могут быть заданы как пары *name*/*value*, задающие отдельные опции в базе данных опций. Распознаваемые имена опций: `activeBackground`, `activeForeground`, `background`, `disabledForeground`, `foreground`, `highlightBackground`, `highlightColor`, `insertBackground`, `selectColor`, `selectBackground`, `selectForeground` и `troughColor`; для любых неуказанных опций вычисляются разумные значения по умолчанию.10521053#### `tk_bisque()`10541055Восстанавливает цвета приложения к светлой коричневой (bisque) цветовой схеме, использовавшейся в Tk 3.6 и более ранних версиях. Предусмотрено для обратной совместимости.10561057#### `tk_strictMotif(boolean=None)`10581059Запрашивает или устанавливает, должен ли внешний вид Tk строго соответствовать Motif. Значение *boolean*, равное true, включает строгое соответствие Motif (например, отсутствие изменения цвета при наведении мыши на ползунок). Возвращает результирующую настройку.10601061Методы с префиксом `busy_` управляют состоянием занятости окна, при котором отображается курсор занятости и игнорируется пользовательский ввод.10621063#### `tk_busy_hold(**kw)`10641065Делает этот виджет занятым. Перед виджетом помещается прозрачное окно, так что он и все его потомки в иерархии виджетов блокируются от событий указателя и отображают курсор занятости. Обычно сразу после этого следует вызвать [`update()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.update), чтобы операция удержания вступила в силу до того, как приложение начнёт обработку.10661067Единственная поддерживаемая опция конфигурации – *cursor*, курсор, отображаемый пока виджет занят; он может принимать любое из значений, принимаемых `configure()`.10681069[`busy_hold()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.busy_hold), [`busy()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.busy) и [`tk_busy()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.tk_busy) являются псевдонимами `tk_busy_hold()`.10701071Добавлено в версии 3.13.10721073#### `tk_busy_configure(cnf=None, **kw)`10741075Запрос или изменение параметров конфигурации занятого окна. Виджет должен быть предварительно переведён в состояние «занят» с помощью [`tk_busy_hold()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.tk_busy_hold). Без аргументов возвращает словарь со всеми доступными опциями; если *cnf* – имя опции, возвращает кортеж с её описанием. В противном случае устанавливает указанные опции в заданные значения. Опции могут принимать любые значения, поддерживаемые `tk_busy_hold()`.10761077База данных опций обращается по имени или классу виджета. Например, если виджет [`Frame`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Frame) с именем `frame` должен быть сделан занятым, для него можно указать курсор ожидания с помощью любого из вызовов:10781079```python1080w.option_add('*frame.busyCursor', 'gumby')1081w.option_add('*Frame.BusyCursor', 'gumby')1082```10831084[`busy_configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.busy_configure), [`busy_config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.busy_config) и [`tk_busy_config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.tk_busy_config) – это псевдонимы `tk_busy_configure()`.10851086Добавлено в версии 3.13.10871088#### `tk_busy_cget(option)`10891090Возвращает текущее значение *опции* конфигурации занятого виджета. Виджет должен быть предварительно переведён в состояние «занят» с помощью [`tk_busy_hold()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.tk_busy_hold), а *опция* может принимать любые значения, поддерживаемые этим методом.10911092[`busy_cget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.busy_cget) является псевдонимом `tk_busy_cget()`.10931094Добавлено в версии 3.13.10951096#### `tk_busy_forget()`10971098Переводит виджет из состояния «занят» обратно, освобождая ресурсы (включая прозрачное окно), выделенные при его занятости. Виджет снова начнёт получать события пользователя. Эти ресурсы также освобождаются при уничтожении виджета.10991100[`busy_forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.busy_forget) является псевдонимом `tk_busy_forget()`.11011102Добавлено в версии 3.13.11031104#### `tk_busy_status()`11051106Возвращает `True`, если виджет в данный момент занят, иначе `False`.11071108[`busy_status()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.busy_status) является псевдонимом `tk_busy_status()`.11091110Добавлено в версии 3.13.11111112#### `tk_busy_current(pattern=None)`11131114Возвращает список виджетов, которые в данный момент заняты. Если указан *pattern*, возвращаются только занятые виджеты, чьи имена путей соответствуют шаблону.11151116[`busy_current()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.busy_current) является псевдонимом `tk_busy_current()`.11171118Добавлено в версии 3.13.11191120Методы с префиксом `winfo_` получают информацию об окнах, управляемых Tk.11211122#### `winfo_atom(name, displayof=0)`11231124Возвращает целочисленный идентификатор атома с именем *name*, создавая новый атом, если такого не существует. Если указан *displayof*, атом ищется на экране этого окна; в противном случае – на экране главного окна приложения.11251126#### `winfo_atomname(id, displayof=0)`11271128Возвращает текстовое имя атома с целочисленным идентификатором *id*. Это обратная операция к [`winfo_atom()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_atom). Если указан *displayof*, идентификатор ищется на экране этого окна; в противном случае – на экране главного окна приложения.11291130#### `winfo_cells()`11311132Возвращает количество ячеек в цветовой карте (colormap) виджета.11331134#### `winfo_children()`11351136Возвращает список виджетов, являющихся дочерними по отношению к данному виджету, в порядке стека от нижнего к верхнему. Окна верхнего уровня возвращаются как дочерние своих логических родителей.11371138#### `winfo_class()`11391140Возвращает имя класса виджета.11411142#### `winfo_colormapfull()`11431144Возвращает `True`, если известно, что цветовая карта виджета заполнена, иначе `False`.11451146#### `winfo_containing(rootX, rootY, displayof=0)`11471148Возвращает виджет, содержащий точку с координатами *rootX* и *rootY*, или `None`, если ни одно окно в приложении не содержит эту точку. Координаты задаются в экранных единицах в системе координат корневого окна. Если указан *displayof*, координаты относятся к экрану, содержащему это окно; в противном случае – к экрану главного окна приложения.11491150#### `winfo_depth()`11511152Возвращает глубину цвета виджета, то есть количество бит на пиксель.11531154#### `winfo_exists()`11551156Возвращает `1`, если виджет существует, и `0` в противном случае.11571158#### `winfo_fpixels(number)`11591160Возвращает число с плавающей запятой, показывающее количество пикселей в виджете, соответствующее экранному расстоянию *number* (например, `"2.0c"` или `"1i"`). Результат может быть дробным; для округлённого целого значения используйте [`winfo_pixels()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_pixels).11611162#### `winfo_geometry()`11631164Возвращает геометрию виджета в формате `widthxheight+x+y`. Все размеры указаны в пикселях. Смещение может быть отрицательным; см. [`geometry()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.geometry).11651166#### `winfo_height()`11671168Возвращает высоту виджета в пикселях. При первом создании окна его высота равна 1 пикселю; впоследствии она изменяется менеджером геометрии. См. также [`winfo_reqheight()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_reqheight).11691170#### `winfo_id()`11711172Возвращает низкоуровневый платформенно-зависимый идентификатор виджета. В Unix это идентификатор X-окна, а в Windows – дескриптор окна.11731174#### `winfo_interps(displayof=0)`11751176Возвращает кортеж имён всех интерпретаторов Tcl, зарегистрированных в данный момент для конкретного дисплея. Если указан *displayof*, возвращаемое значение относится к дисплею этого окна; в противном случае – к дисплею главного окна приложения.11771178#### `winfo_ismapped()`11791180Возвращает `1`, если виджет в данный момент отображён, и `0` в противном случае.11811182#### `winfo_manager()`11831184Возвращает имя менеджера геометрии, который в данный момент управляет виджетом, или пустую строку, если он не управляется ни одним менеджером геометрии.11851186#### `winfo_name()`11871188Возвращает имя виджета внутри его родительского элемента, в отличие от полного путевого имени.11891190#### `winfo_parent()`11911192Возвращает путевое имя родительского элемента виджета или пустую строку, если виджет является главным окном приложения.11931194#### `winfo_pathname(id, displayof=0)`11951196Возвращает путевое имя окна, идентификатор которого равен *id*. Если указан *displayof*, идентификатор ищется на дисплее этого окна; в противном случае – на дисплее главного окна приложения.11971198#### `winfo_pixels(number)`11991200Возвращает количество пикселей в виджете, соответствующее экранному расстоянию *number* (например, `"2.0c"` или `"1i"`). Результат округляется до ближайшего целого; для получения дробного результата используйте [`winfo_fpixels()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_fpixels).12011202#### `winfo_pointerx()`12031204Возвращает координату *x* указателя в пикселях относительно корневого окна экрана (или виртуального корня, если он используется). Возвращает `-1`, если указатель находится не на том же экране, что и виджет.12051206#### `winfo_pointerxy()`12071208Возвращает координаты указателя в виде кортежа `(x, y)` в пикселях относительно корневого окна экрана (или виртуального корня, если он используется). Обе координаты равны `-1`, если указатель находится не на том же экране, что и виджет.12091210#### `winfo_pointery()`12111212Возвращает координату *y* указателя в пикселях относительно корневого окна экрана (или виртуального корня, если он используется). Возвращает `-1`, если указатель находится не на том же экране, что и виджет.12131214#### `winfo_reqheight()`12151216Возвращает запрошенную высоту виджета в пикселях. Это значение используется менеджером геометрии виджета для вычисления его геометрии.12171218#### `winfo_reqwidth()`12191220Возвращает запрошенную ширину виджета в пикселях. Это значение используется менеджером геометрии виджета для вычисления его геометрии.12211222#### `winfo_rgb(color)`12231224Возвращает кортеж `(r, g, b)` из интенсивностей красного, зелёного и синего в диапазоне от 0 до 65535, соответствующих *color* в виджете. *color* может быть задан в любой форме, допустимой для параметра цвета.12251226#### `winfo_rootx()`12271228Возвращает координату *x* в корневом окне экрана для верхнего левого угла границы виджета (или самого виджета, если у него нет границы).12291230#### `winfo_rooty()`12311232Возвращает координату *y* в корневом окне экрана для верхнего левого угла границы виджета (или самого виджета, если у него нет границы).12331234#### `winfo_screen()`12351236Возвращает имя экрана, связанного с виджетом, в форме `displayName.screenIndex`.12371238#### `winfo_screencells()`12391240Возвращает количество ячеек в цветовой карте по умолчанию для экрана виджета.12411242#### `winfo_screendepth()`12431244Возвращает глубину корневого окна экрана виджета, то есть количество бит на пиксель.12451246#### `winfo_screenheight()`12471248Возвращает высоту экрана виджета в пикселях.12491250#### `winfo_screenmmheight()`12511252Возвращает высоту экрана виджета в миллиметрах.12531254#### `winfo_screenmmwidth()`12551256Возвращает ширину экрана виджета в миллиметрах.12571258#### `winfo_screenvisual()`12591260Возвращает класс визуализации по умолчанию для экрана виджета: `"directcolor"`, `"grayscale"`, `"pseudocolor"`, `"staticcolor"`, `"staticgray"`, или `"truecolor"`.12611262#### `winfo_screenwidth()`12631264Возвращает ширину экрана виджета в пикселях.12651266#### `winfo_server()`12671268Возвращает строку с информацией о сервере дисплея виджета. Точный формат этой строки может различаться в зависимости от платформы.12691270#### `winfo_toplevel()`12711272Возвращает окно верхнего уровня иерархии, содержащее виджет. В стандартном Tk это всегда виджет [`Toplevel`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Toplevel).12731274#### `winfo_viewable()`12751276Возвращает `1`, если виджет и все его предки вплоть до ближайшего окна верхнего уровня отображены, и `0` в противном случае.12771278#### `winfo_visual()`12791280Возвращает класс визуализации для виджета: `"directcolor"`, `"grayscale"`, `"pseudocolor"`, `"staticcolor"`, `"staticgray"`, или `"truecolor"`.12811282#### `winfo_visualid()`12831284Возвращает X-идентификатор визуального представления виджета.12851286#### `winfo_visualsavailable(includeids=False)`12871288Возвращает список доступных для экрана виджета визуальных представлений. Каждый элемент состоит из класса визуального представления (см. [`winfo_visual()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_visual)) и целочисленной глубины. Если *includeids* равно true, также включается X-идентификатор визуального представления.12891290#### `winfo_vrootheight()`12911292Возвращает высоту виртуального корневого окна, связанного с виджетом, если таковое существует; в противном случае возвращает высоту экрана виджета.12931294#### `winfo_vrootwidth()`12951296Возвращает ширину виртуального корневого окна, связанного с виджетом, если таковое существует; в противном случае возвращает ширину экрана виджета.12971298#### `winfo_vrootx()`12991300Возвращает смещение *x* виртуального корневого окна, связанного с виджетом, относительно корневого окна его экрана. Обычно равно нулю или отрицательное, и равно `0`, если виртуальное корневое окно отсутствует.13011302#### `winfo_vrooty()`13031304Возвращает смещение *y* виртуального корневого окна, связанного с виджетом, относительно корневого окна его экрана. Обычно равно нулю или отрицательное, и равно `0`, если виртуальное корневое окно отсутствует.13051306#### `winfo_width()`13071308Возвращает ширину виджета в пикселях. При первом создании окна его ширина равна 1 пикселю; впоследствии она изменяется менеджером геометрии. См. также [`winfo_reqwidth()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_reqwidth).13091310#### `winfo_x()`13111312Возвращает *x*-координату верхнего левого угла рамки виджета (или самого виджета, если у него нет рамки) в родительском контейнере.13131314#### `winfo_y()`13151316Возвращает *y*-координату верхнего левого угла рамки виджета (или самого виджета, если у него нет рамки) в родительском контейнере.13171318#### `info_patchlevel()`13191320Возвращает уровень патча Tcl/Tk в виде именованного кортежа с теми же пятью полями, что и [`sys.version_info`](https://python-all.ru/3.14/library/sys.html#sys.version_info): *major*, *minor*, *micro*, *releaselevel* и *serial*. *releaselevel* принимает значения `'alpha'`, `'beta'` или `'final'`. При преобразовании в строку получается версия в обычной записи Tcl/Tk, например `'9.0.3'` для финального релиза или `'9.1b2'` для предварительной версии.13211322Добавлено в версии 3.12.13231324#### `class tkinter.Wm`13251326Миксин `Wm` предоставляет доступ к оконному менеджеру, позволяя приложению управлять такими вещами, как заголовок, геометрия и значок окна верхнего уровня, способ его изменения размера, а также реакция на протоколы оконного менеджера. Он встраивается в [`Tk`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk) и [`Toplevel`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Toplevel), поэтому его методы доступны для любого окна верхнего уровня. Каждый метод имеет два эквивалентных написания: короткое имя и имя с префиксом `wm_` (например, [`title()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.title) и [`wm_title()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_title)).13271328#### `aspect(minNumer=None, minDenom=None, maxNumer=None, maxDenom=None)`13291330Ограничивает соотношение сторон (отношение ширины к высоте) окна. Если указаны все четыре аргумента, оконный менеджер поддерживает соотношение между `minNumer/minDenom` и `maxNumer/maxDenom`; передача пустых строк снимает все существующие ограничения. Без аргументов возвращает кортеж из четырёх текущих значений или пустую строку, если ограничение соотношения не действует. [`wm_aspect()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_aspect) – это псевдоним `aspect()`.13311332#### `attributes(*args, return_python_dict=False, **kwargs)`13331334Запрашивает или задаёт платформо-зависимые атрибуты окна. Без аргументов возвращает платформо-зависимые флаги и их значения; передайте *return\_python\_dict* равным true, чтобы получить их в виде словаря. Одно имя опции, например `'alpha'`, возвращает значение этой опции, а опции задаются с помощью именованных аргументов (`alpha=0.5`).13351336Доступные атрибуты различаются в зависимости от платформы. Все платформы поддерживают:13371338***alpha***13391340Непрозрачность окна от `0.0` (полностью прозрачно) до `1.0` (непрозрачно). Если прозрачность не поддерживается, значение остаётся `1.0`.13411342***внешний вид***13431344Определяет, отображается ли окно в тёмном режиме в Windows и macOS: `'auto'`, `'light'` или `'dark'` (не действует на X11).13451346***полноэкранный***13471348Определяет, развёрнуто ли окно на весь экран и не имеет ли границ.13491350***поверх всех окон***13511352Определяет, отображается ли окно поверх всех остальных окон.13531354Windows также поддерживает:13551356***отключён***13571358Определяет, находится ли окно в отключённом состоянии.13591360***окно инструментов***13611362Определяет, использует ли окно стиль инструментального окна.13631364***прозрачный цвет***13651366Цвет, который становится полностью прозрачным, или пустая строка для отсутствия прозрачности.13671368macOS также поддерживает:13691370***класс***13711372Определяет, является ли базовое окно Aqua `nswindow` или `nspanel`; это можно установить только до создания окна.13731374***изменён***13751376Состояние изменения, отображаемое кнопкой закрытия окна и значком-заместителем.13771378***уведомить***13791380Определяет, подпрыгивает ли значок приложения в доке, чтобы привлечь внимание.13811382***маска стиля***13831384Маска стиля базового окна Aqua, задаваемая в виде списка имён битов, таких как `titled` или `resizable`.13851386***идентификатор вкладок***13871388Идентификатор группы вкладок, к которой принадлежит окно.13891390***режим вкладок***13911392Определяет, может ли окно быть открыто как вкладка: `'auto'`, `'preferred'` или `'disallowed'`.13931394***путь заголовка***13951396Путь к файлу, представленному значком-заместителем окна.13971398***прозрачный***13991400Определяет, является ли область содержимого прозрачной и отключена ли тень окна.14011402X11 также поддерживает:14031404***тип***14051406Тип окна или список типов в порядке предпочтения, который менеджер окон должен использовать для интерпретации окна, например `'dialog'` или `'splash'`.14071408***увеличен***14091410Определяет, развёрнуто ли окно на весь экран.14111412> **Примечание**1413>1414> Tk 8.6 добавил атрибут *type*, а Tk 9.0 добавил атрибуты *appearance*, *class*, *stylemask*, *tabbingid* и *tabbingmode*.14151416В X11 изменения применяются асинхронно, поэтому запрошенное значение может ещё не отражать самый последний запрос. [`wm_attributes()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_attributes) является псевдонимом `attributes()`.14171418Изменено в версии 3.13: Теперь отдельный атрибут можно запросить по имени без начального `-`, а атрибуты можно задавать с помощью именованных аргументов. Был добавлен параметр *return\_python\_dict*.14191420Устарело с версии 3.13: Установка атрибута путём передачи имени опции (с начальным `-`) и её значения в виде двух позиционных аргументов, как в `w.attributes('-alpha', 0.5)`, устарела; вместо этого используйте именованные аргументы.14211422#### `client(name=None)`14231424Сохраняет *name* (должно быть именем хоста, на котором выполняется приложение) в свойстве `WM_CLIENT_MACHINE` окна для использования оконным менеджером или менеджером сессий. Пустая строка удаляет это свойство. Без аргументов возвращает последнее установленное имя или пустую строку. [`wm_client()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_client) – это псевдоним `client()`.14251426#### `colormapwindows(*wlist)`14271428Управляет свойством `WM_COLORMAP_WINDOWS`, которое сообщает оконному менеджеру об окнах, имеющих частные цветовые карты. Если задан *wlist*, перезаписывает свойство этими окнами (их порядок – это приоритет для установки цветовых карт). Без аргументов возвращает список окон, указанных в данный момент в свойстве. [`wm_colormapwindows()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_colormapwindows) – это псевдоним `colormapwindows()`.14291430#### `command(value=None)`14311432Сохраняет *value* в свойстве `WM_COMMAND` окна для использования оконным менеджером или менеджером сессий; это должен быть список слов команды, использованной для запуска приложения. Пустая строка удаляет свойство. Без аргументов возвращает последнее установленное значение или пустую строку. [`wm_command()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_command) – это псевдоним `command()`.14331434#### `deiconify()`14351436Отображает окно в обычной (не свёрнутой) форме, отображая его на экране. Если окно ещё ни разу не отображалось, это гарантирует, что при первом отображении оно появится уже развёрнутым. В Windows окно также поднимается и получает фокус. [`wm_deiconify()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_deiconify) – это псевдоним `deiconify()`.14371438#### `focusmodel(model=None)`14391440Устанавливает или запрашивает модель фокуса для окна. *model* может быть `'active'` (окно заявляет о получении фокуса ввода для себя или своих потомков, даже когда фокус находится в другом приложении) или `'passive'` (окно полагается на оконный менеджер, чтобы тот дал ему фокус). Без аргумента возвращает текущую модель. По умолчанию используется `'passive'`, что предполагает команда `focus()`. [`wm_focusmodel()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_focusmodel) – это псевдоним `focusmodel()`.14411442#### `forget(window)`14431444Скрывает *window* с экрана, так что оно больше не управляется оконным менеджером. Затем [`Toplevel`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Toplevel) обрабатывается как [`Frame`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Frame), хотя его конфигурация `-menu` запоминается, и меню снова появляется, если виджет снова становится управляемым. [`wm_forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_forget) – это псевдоним `forget()`.14451446Не путать с [`Pack.forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.forget).14471448Добавлено в версии 3.3.14491450#### `frame()`14511452Возвращает платформенно-зависимый идентификатор окна для самого внешнего декоративного фрейма, содержащего окно, если оконный менеджер поместил его в такой фрейм; в противном случае возвращает идентификатор самого окна. [`wm_frame()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_frame) – это псевдоним `frame()`.14531454#### `geometry(newGeometry=None)`14551456Устанавливает или запрашивает геометрию окна. *newGeometry* имеет форму `=widthxheight+x+y`, где любая из `=`, `widthxheight` и позиция `+x+y` может быть опущена. *width* и *height* задаются в пикселях (или в единицах сетки для окна с сеткой); позиция, перед которой стоит `+`, отсчитывается от левого или верхнего края экрана, а позиция, перед которой стоит `-`, – от правого или нижнего края. Смещение может быть отрицательным, как в `'200x100+-9+-8'`, когда край окна выходит за соответствующий край экрана. Пустая строка отменяет любую заданную пользователем геометрию, позволяя окну вернуться к своему естественному размеру. Без аргумента возвращает текущую геометрию в виде строки вида `'200x200+10+10'`. [`wm_geometry()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_geometry) – это псевдоним `geometry()`.14571458#### `grid(baseWidth=None, baseHeight=None, widthInc=None, heightInc=None)`14591460Управляет окном как окном с сеткой и определяет соотношение между единицами сетки и пикселями. *baseWidth* и *baseHeight* – это количество единиц сетки для внутреннего запрошенного размера окна, а *widthInc* и *heightInc* – это размеры в пикселях горизонтальной и вертикальной единицы сетки. Пустые строки отключают управление сеткой. Без аргументов возвращает кортеж из четырёх текущих значений или пустую строку, если окно не использует сетку. [`wm_grid()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_grid) – это псевдоним `grid()`.14611462Не путать с менеджером геометрии grid [`Grid.grid()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.grid).14631464#### `group(pathName=None)`14651466Устанавливает или запрашивает лидера группы связанных окон. *pathName* задаёт путь к лидеру группы; оконный менеджер может, например, скрыть все окна в группе, когда лидер сворачивается. Пустая строка удаляет окно из любой группы. Без аргумента возвращает путь к текущему лидеру группы или пустую строку. [`wm_group()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_group) – это псевдоним `group()`.14671468#### `iconbitmap(bitmap=None, default=None)`14691470Устанавливает или запрашивает битовую карту, используемую оконным менеджером для значка окна. *bitmap* задаёт битовую карту в одной из стандартных форм, принимаемых Tk; пустая строка отменяет текущую битовую карту значка. Без аргумента возвращает имя текущей битовой карты значка или пустую строку. В Windows аргумент *default* задаёт значок (например, файл `.ico`), применяемый ко всем окнам верхнего уровня, у которых нет собственного значка. [`wm_iconbitmap()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_iconbitmap) – это псевдоним `iconbitmap()`.14711472#### `iconify()`14731474Сворачивает окно. Если окно ещё не было отображено в первый раз, обеспечивает его отображение в свёрнутом состоянии при последующем отображении. [`wm_iconify()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_iconify) – это псевдоним `iconify()`.14751476#### `iconmask(bitmap=None)`14771478Устанавливает или запрашивает битовую карту, используемую в качестве маски для значка (см. [`iconbitmap()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.iconbitmap)). Если маска равна нулю, значок не отображается; если единице, показываются соответствующие биты битовой карты значка. Пустая строка отменяет текущую маску. Без аргумента возвращает имя текущей маски значка или пустую строку. [`wm_iconmask()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_iconmask) – это псевдоним `iconmask()`.14791480#### `iconname(newName=None)`14811482Устанавливает или запрашивает имя, отображаемое оконным менеджером внутри значка окна. Без аргумента возвращает текущее имя значка или пустую строку, если ничего не было установлено (в этом случае оконный менеджер обычно отображает заголовок окна). [`wm_iconname()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_iconname) – это псевдоним `iconname()`.14831484#### `iconphoto(default=False, *images)`14851486Устанавливает значок заголовка окна из одного или нескольких объектов [`PhotoImage`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PhotoImage), переданных в *images*. Можно передать несколько изображений разных размеров (например, 16×16 и 32×32), чтобы оконный менеджер мог выбрать подходящее. Данные изображения берутся как снимок на момент вызова; последующие изменения изображений не учитываются. Если *default* равно true, значок также применяется ко всем будущим окнам верхнего уровня. В macOS используется только первое изображение. [`wm_iconphoto()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_iconphoto) – псевдоним `iconphoto()`.14871488Добавлено в версии 3.3.14891490#### `iconposition(x=None, y=None)`14911492Устанавливает или запрашивает подсказку оконному менеджеру о том, где должен располагаться значок окна. Пустые строки отменяют имеющуюся подсказку. Без аргументов возвращает кортеж из двух текущих значений или пустую строку, если подсказка не задана. [`wm_iconposition()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_iconposition) – псевдоним `iconposition()`.14931494#### `iconwindow(pathName=None)`14951496Устанавливает или запрашивает окно, используемое в качестве значка окна. Когда окно свёрнуто, *pathName* отображается как его значок и снова скрывается при восстановлении. Пустая строка отменяет привязку. Без аргументов возвращает путь текущего окна-значка или пустую строку. Не все оконные менеджеры поддерживают окна-значки, и эта концепция бессмысленна на платформах, отличных от X11. [`wm_iconwindow()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_iconwindow) – псевдоним `iconwindow()`.14971498#### `manage(widget)`14991500Делает *widget* самостоятельным окном верхнего уровня, оформленным оконным менеджером с заголовком и т.д. Могут использоваться только виджеты [`Frame`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Frame), [`LabelFrame`](https://python-all.ru/3.14/library/tkinter.html#tkinter.LabelFrame) и [`Toplevel`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Toplevel) (версии из [`tkinter.ttk`](https://python-all.ru/3.14/library/tkinter.ttk.html#module-tkinter.ttk) **не** принимаются); передача любого другого типа виджета вызывает ошибку. [`wm_manage()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_manage) – псевдоним `manage()`.15011502Добавлено в версии 3.3.15031504#### `maxsize(width=None, height=None)`15051506Устанавливает или запрашивает максимально допустимые размеры окна в пикселях (или в единицах сетки для окна с сеткой). Оконный менеджер ограничивает окно размерами не больше *width* и *height*. Без аргументов возвращает кортеж текущих максимальной ширины и высоты. Максимальный размер по умолчанию равен размеру экрана. [`wm_maxsize()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_maxsize) – псевдоним `maxsize()`.15071508#### `minsize(width=None, height=None)`15091510Устанавливает или запрашивает минимально допустимые размеры окна в пикселях (или в единицах сетки для окна с сеткой). Оконный менеджер ограничивает окно размерами не меньше *width* и *height*. Без аргументов возвращает кортеж текущих минимальной ширины и высоты. Минимальный размер по умолчанию – один пиксель по каждому измерению. [`wm_minsize()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_minsize) – псевдоним `minsize()`.15111512#### `overrideredirect(boolean=None)`15131514Устанавливает или запрашивает флаг override-redirect для окна. Когда этот флаг установлен, оконный менеджер игнорирует окно: оно не помещается в декоративную рамку, и пользователь не может управлять им через обычные элементы управления оконного менеджера. Без аргументов возвращает булево значение, указывающее, установлен ли флаг. Флаг надёжно соблюдается только при первом отображении окна или при повторном отображении из состояния withdrawn. [`wm_overrideredirect()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_overrideredirect) – псевдоним `overrideredirect()`.15151516#### `positionfrom(who=None)`15171518Устанавливает или запрашивает источник текущего положения окна. *who* может быть `'program'` или `'user'`, указывает, было ли положение запрошено программой или пользователем; пустая строка отменяет текущий источник. Без аргументов возвращает текущий источник или пустую строку, если источник не установлен. Tk автоматически устанавливает источник в `'user'` при вызове [`geometry()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.geometry), если только явно не установлен `'program'`. [`wm_positionfrom()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_positionfrom) – псевдоним `positionfrom()`.15191520#### `protocol(name=None, func=None)`15211522Регистрирует *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.14/library/tkinter.html#tkinter.Wm.wm_protocol) – псевдоним `protocol()`.15231524#### `resizable(width=None, height=None)`15251526Управляет возможностью интерактивного изменения размера окна пользователем. *width* и *height* – булевы значения, определяющие, можно ли изменять ширину и высоту окна. Без аргументов возвращает кортеж из двух значений `0`/`1`, указывающих, можно ли изменять каждый размер в данный момент. По умолчанию размер окна можно изменять по обоим измерениям. [`wm_resizable()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_resizable) – псевдоним `resizable()`.15271528#### `sizefrom(who=None)`15291530Устанавливает или запрашивает источник текущего размера окна. *who* может быть `'program'` или `'user'`, указывает, был ли размер запрошен программой или пользователем; пустая строка отменяет текущий источник. Без аргументов возвращает текущий источник или пустую строку, если источник не установлен. [`wm_sizefrom()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_sizefrom) – псевдоним `sizefrom()`.15311532#### `state(newstate=None)`15331534Устанавливает или запрашивает состояние окна. Без аргументов возвращает текущее состояние: одно из `'normal'`, `'iconic'`, `'withdrawn'`, `'icon'` или, только в Windows и macOS, `'zoomed'`. `'iconic'` относится к свёрнутому окну, тогда как `'icon'` – к окну, служащему значком для другого окна (см. [`iconwindow()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.iconwindow)); состояние `'icon'` не может быть установлено. [`wm_state()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_state) – псевдоним `state()`.15351536Не путать с [`ttk.Widget.state`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Widget.state).15371538#### `title(string=None)`15391540Устанавливает или запрашивает заголовок окна, который оконный менеджер должен отображать в строке заголовка. Без аргументов возвращает текущий заголовок. По умолчанию заголовок равен имени окна. [`wm_title()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_title) – псевдоним `title()`.15411542#### `transient(master=None)`15431544Помечает окно как временное (например, выпадающее меню или диалог), работающее от имени *master*, пути к другому окну верхнего уровня. Пустая строка снимает статус временного окна. Без аргументов возвращает путь текущего владельца или пустую строку. Временное окно отражает изменения состояния своего владельца и может оформляться оконным менеджером иначе; ошибка – сделать окно временным для самого себя. [`wm_transient()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_transient) – псевдоним `transient()`.15451546#### `withdraw()`15471548Убирает окно с экрана, скрывая его и заставляя оконный менеджер забыть о нём. Если окно никогда не отображалось, оно отображается в состоянии withdrawn. Иногда необходимо скрыть окно и снова отобразить его (например, с помощью [`deiconify()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.deiconify)), чтобы некоторые оконные менеджеры заметили изменения атрибутов окна. [`wm_withdraw()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.wm_withdraw) – псевдоним `withdraw()`.15491550#### `class tkinter.Pack`15511552Менеджер геометрии, который размещает виджеты, прижимая их к сторонам контейнера. Миксин `Pack` наследуется всеми виджетами (через [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget)) и предоставляет методы для управления виджетом с помощью менеджера геометрии *pack*. См. также [паковщик](https://python-all.ru/3.14/library/tkinter.html#pack-the-packer).15531554> **Примечание**1555>1556> `Pack`, [`Place`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Place) и [`Grid`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid) определяют короткие имена методов `forget()`, `info()`, `slaves()`, `content()` и `propagate()`. Для виджета эти простые имена разрешаются в версии менеджера *pack*, поскольку `Pack` и [`Misc`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc) предшествуют `Place` и `Grid` в порядке разрешения методов, независимо от того, какой менеджер фактически управляет виджетом; а `configure()`/`config()` настраивают параметры виджета, а не его геометрию. Используйте явные методы `pack_*`, `grid_*` и `place_*` (и `pack`, `grid`, `place` для настройки геометрии), чтобы воздействовать на конкретный менеджер геометрии.15571558#### `pack_configure(cnf={}, **kw)`15591560#### `pack(cnf={}, **kw)`15611562Упаковывает виджет внутри его контейнера, позиционируя его относительно уже упакованных там соседних виджетов. Поддерживаемые параметры:15631564***side***15651566К какой стороне контейнера прижимать виджет: `'top'` (по умолчанию), `'bottom'`, `'left'` или `'right'`.15671568***fill***15691570Следует ли растягивать виджет, чтобы заполнить его участок: `'none'` (по умолчанию), `'x'`, `'y'` или `'both'`.15711572***expand***15731574Следует ли виджету расширяться, чтобы занять лишнее пространство в его контейнере (логическое значение, по умолчанию false).15751576***anchor***15771578Где позиционировать виджет в его участке, когда участок больше виджета: привязка, например `'n'` или `'sw'` (по умолчанию `'center'`).15791580***ipadx*, *ipady***15811582Внутренний отступ, добавляемый слева и справа (*ipadx*) или сверху и снизу (*ipady*) от виджета, задаётся в экранных единицах (по умолчанию `0`).15831584***padx*, *pady***15851586Внешний отступ, оставляемый слева и справа (*padx*) или сверху и снизу (*pady*) от виджета, задаётся в экранных единицах или как пара значений для каждой из двух сторон (по умолчанию `0`).15871588***after***15891590Упаковывает виджет после указанного виджета в порядке упаковки, используя тот же контейнер.15911592***before***15931594Упаковывает виджет перед указанным виджетом в порядке упаковки, используя тот же контейнер.15951596***in\_***15971598Контейнер, в который упаковывать виджет; по умолчанию – родительский виджет.15991600`pack()`, [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.configure) и [`config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.config) являются псевдонимами `pack_configure()`.16011602#### `pack_forget()`16031604Убирает виджет и удаляет его из порядка упаковки, забывая его параметры упаковки. Позже его можно снова упаковать с помощью [`pack_configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.pack_configure). [`forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.forget) является псевдонимом `pack_forget()`, за исключением [`PanedWindow`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow), [`ttk.Notebook`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Notebook) и [`ttk.PanedWindow`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.PanedWindow), которые предоставляют собственный метод `forget()`.16051606Не путать с [`Wm.forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.forget).16071608#### `pack_info()`16091610Возвращает словарь текущих параметров упаковки виджета. [`info()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.info) является псевдонимом `pack_info()`.16111612#### `pack_propagate()`16131614#### `pack_propagate(flag)`16151616То же, что и [`Misc.pack_propagate()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.pack_propagate), рассматривая этот виджет как контейнер: включить или отключить распространение геометрии. [`propagate()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.propagate) является псевдонимом `pack_propagate()`.16171618#### `pack_slaves()`16191620То же, что и [`Misc.pack_slaves()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.pack_slaves): возвращает список виджетов, упакованных в этот виджет. [`slaves()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.slaves) – псевдоним `pack_slaves()`.16211622#### `class tkinter.Place`16231624Менеджер геометрии, размещающий виджеты в явных позициях и размерах внутри их контейнера. Примесь `Place` наследуется всеми виджетами (через [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget)).16251626#### `place_configure(cnf={}, **kw)`16271628#### `place(cnf={}, **kw)`16291630Размещает виджет внутри его контейнера в абсолютной или относительной позиции. Поддерживаемые опции:16311632***x*, *y***16331634Абсолютные горизонтальная и вертикальная позиции опорной точки виджета как экранное расстояние (по умолчанию `0`).16351636***relx*, *rely***16371638Горизонтальная и вертикальная позиции опорной точки виджета как доля ширины и высоты контейнера, где `0.0` – это левый или верхний край, а `1.0` – правый или нижний край. Если указаны как абсолютная, так и относительная опции, их значения суммируются.16391640***anchor***16411642Какая точка виджета размещается в заданной позиции: опорная точка, например `'n'` или `'se'` (по умолчанию `'nw'`).16431644***width*, *height***16451646Абсолютные ширина и высота виджета как экранное расстояние. По умолчанию используется запрошенный размер виджета.16471648***relwidth*, *relheight***16491650Ширина и высота виджета как доля ширины и высоты контейнера. Если указаны как абсолютная, так и относительная опции, их значения суммируются.16511652***bordermode***16531654Как граница контейнера влияет на размещение: `'inside'` (по умолчанию) измеряет область внутри границы, `'outside'` измеряет область, включая границу, а `'ignore'` использует официальную область X.16551656***in\_***16571658Контейнер, относительно которого размещается виджет; он должен быть родителем виджета или потомком родителя, по умолчанию – родитель.16591660`place()`, [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Place.configure) и [`config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Place.config) являются псевдонимами `place_configure()`.16611662#### `place_forget()`16631664Скрыть виджет и удалить его из размещения, забыв его опции размещения.16651666#### `place_info()`16671668Возвращает словарь текущих опций размещения виджета.16691670#### `place_slaves()`16711672То же, что и [`Misc.place_slaves()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.place_slaves): возвращает список виджетов, размещённых в этом виджете.16731674#### `class tkinter.Grid`16751676Менеджер геометрии, располагающий виджеты в двумерной сетке строк и столбцов внутри их контейнера. Примесь `Grid` наследуется всеми виджетами (через [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget)).16771678#### `grid_configure(cnf={}, **kw)`16791680#### `grid(cnf={}, **kw)`16811682Помещает виджет в ячейку сетки его контейнера.16831684Не путать с [`Wm.grid()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm.grid).16851686Поддерживаемые параметры:16871688***строка*, *столбец***16891690Строка и столбец ячейки, в которую помещается виджет, с отсчётом от `0`. *Столбец* по умолчанию равен столбцу, следующему за последним виджетом, помещённым в том же вызове `grid_configure()` (или `0`), а *строка* по умолчанию равна следующей пустой строке.16911692***rowspan*, *columnspan***16931694Количество строк и столбцов, которое должен охватывать виджет (по умолчанию `1`).16951696***sticky***16971698Определяет расположение или растяжение виджета, когда его ячейка больше самого виджета: строка, содержащая ноль или более символов из `'n'`, `'s'`, `'e'` и `'w'`, указывающих стороны ячейки, к которым прикрепляется виджет. Указание одновременно `'n'` и `'s'` (или `'e'` и `'w'`) растягивает виджет на всю высоту (или ширину) ячейки. По умолчанию `''` – виджет центрируется в ячейке с сохранением запрошенного размера.16991700***ipadx*, *ipady***17011702Внутренний отступ, добавляемый слева и справа (*ipadx*) или сверху и снизу (*ipady*) от виджета, задаётся в экранных единицах (по умолчанию `0`).17031704***padx*, *pady***17051706Внешний отступ, оставляемый слева и справа (*padx*) или сверху и снизу (*pady*) от виджета, задаётся в экранных единицах или как пара значений для каждой из двух сторон (по умолчанию `0`).17071708***in\_***17091710Контейнер, в сетку которого помещается виджет; по умолчанию – родительский виджет.17111712`grid()`, [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.configure) и [`config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.config) являются псевдонимами `grid_configure()`.17131714#### `grid_forget()`17151716Скрывает виджет и удаляет его из сетки, забывая его параметры сетки.17171718#### `grid_remove()`17191720Скрывает виджет и удаляет его из сетки, но запоминает его параметры сетки, чтобы при повторном размещении он был восстановлен в той же ячейке.17211722#### `grid_info()`17231724Возвращает словарь текущих параметров сетки виджета.17251726#### `grid_bbox(column=None, row=None, col2=None, row2=None)`17271728То же, что и [`Misc.grid_bbox()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_bbox). [`bbox()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.bbox) – псевдоним `grid_bbox()`, за исключением [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox), [`Spinbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox), [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text), [`ttk.Entry`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Entry) и [`ttk.Treeview`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Treeview), которые предоставляют собственный метод `bbox()`.17291730#### `grid_columnconfigure(index, cnf={}, **kw)`17311732То же, что [`Misc.grid_columnconfigure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_columnconfigure): запрашивает или задаёт параметры столбца сетки (такие как *weight*, *minsize*, *pad* и *uniform*). [`columnconfigure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.columnconfigure) – псевдоним `grid_columnconfigure()`.17331734#### `grid_rowconfigure(index, cnf={}, **kw)`17351736То же, что [`Misc.grid_rowconfigure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_rowconfigure): запрашивает или задаёт параметры строки сетки. [`rowconfigure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.rowconfigure) – псевдоним `grid_rowconfigure()`.17371738#### `grid_location(x, y)`17391740То же, что [`Misc.grid_location()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_location): возвращает `(column, row)` ячейки, которая содержит пиксель с координатами *x*, *y*. [`location()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.location) – псевдоним `grid_location()`.17411742#### `grid_size()`17431744То же, что [`Misc.grid_size()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_size): возвращает кортеж `(columns, rows)`, содержащий размеры сетки. [`size()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.size) – псевдоним `grid_size()`, за исключением виджета [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox), который предоставляет собственный метод `size()`.17451746#### `grid_propagate()`17471748#### `grid_propagate(flag)`17491750То же, что и [`Misc.grid_propagate()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_propagate).17511752#### `grid_slaves(row=None, column=None)`17531754То же, что и [`Misc.grid_slaves()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_slaves): возвращает виджеты, управляемые сеткой, с возможностью ограничения по *строке* и/или *столбцу*.17551756#### `class tkinter.XView`17571758Примесь, предоставляющая интерфейс горизонтальной прокрутки, общий для виджетов, таких как [`Entry`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry), [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox), [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text) и [`Spinbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox). Метод [`xview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview) виджета регистрируется как *команда* горизонтального [`Scrollbar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Scrollbar).17591760#### `xview(*args)`17611762Запрашивает или изменяет горизонтальное положение вида. Без аргументов возвращает кортеж `(first, last)` из двух дробей от 0 до 1, указывающих долю документа, которая в данный момент видна. В противном случае аргументы передаются команде виджета Tk `xview` и обычно генерируются полосой прокрутки; [`xview_moveto()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview_moveto) и [`xview_scroll()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview_scroll) предоставляют более удобный интерфейс.17631764#### `xview_moveto(fraction)`17651766Настраивает вид так, чтобы *fraction* от общей ширины документа находилось слева за экраном. *fraction* – число от 0 до 1.17671768#### `xview_scroll(number, what)`17691770Сдвигает вид влево или вправо на *число* единиц. *what* может быть `'units'` или `'pages'`; отрицательное *число* прокручивает влево, положительное – вправо.17711772#### `class tkinter.YView`17731774Примесь, предоставляющая интерфейс вертикальной прокрутки, общий для виджетов, таких как [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox) и [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text). Метод [`yview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView.yview) виджета регистрируется как *команда* вертикального [`Scrollbar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Scrollbar).17751776#### `yview(*args)`17771778Запрашивает или изменяет вертикальное положение вида. Без аргументов возвращает кортеж `(first, last)` из двух дробей от 0 до 1, указывающих долю документа, которая в данный момент видна. В противном случае аргументы передаются команде виджета Tk `yview`, обычно генерируемой полосой прокрутки; [`yview_moveto()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView.yview_moveto) и [`yview_scroll()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView.yview_scroll) предоставляют более удобный интерфейс.17791780#### `yview_moveto(fraction)`17811782Настраивает вид так, чтобы *fraction* от общей высоты документа находилось над верхней границей экрана. *fraction* – число от 0 до 1.17831784#### `yview_scroll(number, what)`17851786Сдвигает вид вверх или вниз на *число* единиц. *what* может быть `'units'` или `'pages'`; отрицательное *число* прокручивает вверх, положительное – вниз.17871788#### `class tkinter.BaseWidget(master, widgetName, cnf={}, kw={}, extra=())`17891790Внутренний базовый класс для всех виджетов. Наследует от [`Misc`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc) и добавляет механизм, который создаёт нижележащий Tk-виджет; прикладной код обычно использует [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget) или конкретный класс виджета, а не создаёт экземпляр `BaseWidget` напрямую.17911792#### `destroy()`17931794Уничтожает этот виджет и все его дочерние элементы, удаляя соответствующие Tk-виджеты и связанные команды Tcl.17951796#### `class tkinter.Widget(master, widgetName, cnf={}, kw={}, extra=())`17971798Внутренний базовый класс для стандартных виджетов. Объединяет [`BaseWidget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.BaseWidget) с примесями менеджеров геометрии [`Pack`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack), [`Place`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Place) и [`Grid`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid), так что любой виджет может управляться любым из трёх менеджеров геометрии. Конкретные классы виджетов ([`Button`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Button), [`Label`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Label) и так далее) наследуют от `Widget`.17991800### Виджеты верхнего уровня18011802#### `class tkinter.Tk(screenName=None, baseName=None, className='Tk', useTk=True, sync=False, use=None)`18031804Создаёт виджет верхнего уровня Tk, который обычно является главным окном приложения, и инициализирует для него интерпретатор Tcl. Каждый экземпляр имеет свой собственный связанный интерпретатор Tcl. Наследует от [`Misc`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc) и [`Wm`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm).18051806Чтобы создать интерпретатор Tcl без инициализации подсистемы Tk, используйте фабричную функцию [`Tcl()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tcl).18071808Класс `Tk` обычно создаётся со значениями по умолчанию. Однако в настоящее время распознаются следующие именованные аргументы:18091810***screenName***18111812При указании (в виде строки) устанавливает переменную окружения `DISPLAY`. (только X11)18131814***baseName***18151816Имя файла профиля. По умолчанию *baseName* берётся из имени программы (`sys.argv[0]`).18171818***className***18191820Имя класса виджета. Используется как файл профиля, а также как имя, с которым вызывается Tcl (*argv0* в *interp*).18211822***useTk***18231824Если `True`, инициализировать подсистему Tk. Функция [`tkinter.Tcl()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tcl) устанавливает это в `False`.18251826***sync***18271828Если `True`, выполнять все команды X-сервера синхронно, чтобы ошибки сообщались немедленно. Может использоваться для отладки. (только X11)18291830***use***18311832Задаёт *id* окна, в которое встраивается приложение, вместо того чтобы создавать его как независимое окно верхнего уровня. *id* должен быть указан так же, как значение опции -use для виджетов верхнего уровня (то есть иметь форму, подобную возвращаемой [`winfo_id()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_id)).18331834Обратите внимание, что на некоторых платформах это будет работать корректно только если *id* ссылается на Tk-фрейм или окно верхнего уровня, у которых включена опция -container.18351836`Tk` читает и интерпретирует файлы профилей с именами `.className.tcl` и `.baseName.tcl` в интерпретатор Tcl и вызывает [`exec()`](https://python-all.ru/3.14/library/functions.html#exec) для содержимого `.className.py` и `.baseName.py`. Путь к файлам профилей задаётся переменной окружения `HOME` или, если она не определена, то [`os.curdir`](https://python-all.ru/3.14/library/os.html#os.curdir).18371838> **Примечание**1839>1840> В Windows создание интерпретатора Tcl (путём создания экземпляра `Tk` или вызова [`Tcl()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tcl)) устанавливает переменную окружения `HOME` для процесса, если она ещё не установлена, в `%HOMEDRIVE%%HOMEPATH%` (или `USERPROFILE`, или `c:\`). Это делается Tcl и может повлиять на другой код, который читает `HOME`.18411842#### `tk`18431844Объект приложения Tk, созданный созданием экземпляра `Tk`. Он предоставляет доступ к интерпретатору Tcl. Каждый виджет, прикреплённый к тому же экземпляру `Tk`, имеет одинаковое значение для своего атрибута [`tk`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk.tk).18451846#### `master`18471848Объект виджета, содержащий данный виджет. Для `Tk` `master` является [`None`](https://python-all.ru/3.14/library/constants.html#None), потому что это главное окно. Термины *master* и *parent* похожи и иногда используются как взаимозаменяемые имена аргументов; однако вызов [`winfo_parent()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.winfo_parent) возвращает строку с именем виджета, тогда как `master` возвращает объект. *parent*/*child* отражает древовидную связь, а *master* (или *container*)/*content* отражает структуру контейнера.18491850#### `children`18511852Непосредственные потомки этого виджета в виде [`dict`](https://python-all.ru/3.14/library/stdtypes.html#dict) с именами дочерних виджетов в качестве ключей и объектами экземпляров потомков в качестве значений.18531854#### `destroy()`18551856Уничтожить этот виджет и все дочерние виджеты, а для главного окна – завершить соединение с нижележащим интерпретатором Tcl.18571858#### `loadtk()`18591860Завершить загрузку и инициализацию подсистемы Tk. Это необходимо только в том случае, если интерпретатор был создан без Tk (например, через [`Tcl()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tcl)); он вызывается автоматически, когда *useTk* равно true.18611862#### `readprofile(baseName, className)`18631864Прочитать и выполнить (source) пользовательские файлы профилей `.className.tcl` и `.baseName.tcl` в интерпретатор Tcl, и выполнить соответствующие файлы `.className.py` и `.baseName.py`. Это вызывается во время инициализации; см. описание конструктора выше.18651866#### `report_callback_exception(exc, val, tb)`18671868Сообщить об исключении в колбэке. Вызывается, когда исключение распространяется из колбэка Tkinter; *exc*, *val* и *tb* – это тип исключения, значение и трассировка, возвращаемые [`sys.exc_info()`](https://python-all.ru/3.14/library/sys.html#sys.exc_info). Реализация по умолчанию выводит трассировку в [`sys.stderr`](https://python-all.ru/3.14/library/sys.html#sys.stderr). Может быть переопределена для настройки обработки ошибок, например для отображения трассировки в диалоговом окне.18691870#### `class tkinter.Toplevel(master=None, cnf={}, **kw)`18711872Виджет `Toplevel` – это окно верхнего уровня, похожее на [`Frame`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Frame), за исключением того, что его X-родителем является корневое окно экрана, а не его логический родитель. Его основное назначение – служить контейнером для диалоговых окон и других наборов виджетов; его видимые особенности – это только фон и необязательная 3D-рамка. Из заметных опций: *menu*, которая устанавливает [`Menu`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu) в качестве строки меню окна. Наследуется от [`BaseWidget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.BaseWidget) и [`Wm`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Wm), поэтому окно верхнего уровня управляется оконным менеджером. Полный список опций см. в руководстве по Tk `toplevel`.18731874### Классы виджетов18751876#### `class tkinter.Button(master=None, cnf={}, **kw)`18771878Виджет `Button` отображает текстовую строку, растровое изображение или картинку и вызывает команду при нажатии (по клику кнопкой мыши 1 на кнопке или, когда кнопка в фокусе, по нажатию пробела). Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget). В дополнение к стандартным опциям виджета, кнопка принимает опции, описанные на странице руководства Tk `button`, такие как *command* (колбэк, вызываемый при нажатии кнопки), *textvariable*, *state* и *default*.18791880#### `invoke()`18811882Вызывает команду, связанную с кнопкой, если она есть, и возвращает её результат, или пустую строку, если команда не задана. Игнорируется, если состояние кнопки `disabled`.18831884#### `flash()`18851886Мигает кнопкой, перерисовывая её несколько раз, чередуя активный и нормальный цвета. После мигания кнопка остаётся в том же нормальном или активном состоянии, что и при вызове метода. Игнорируется, если состояние кнопки `disabled`.18871888#### `class tkinter.Canvas(master=None, cnf={}, **kw)`18891890Виджет `Canvas` реализует структурированную графику. Он отображает любое количество *элементов*, таких как дуги, линии, овалы, многоугольники, прямоугольники, текст, растровые изображения, картинки и встроенные окна, которые можно рисовать, перемещать, менять их цвет и привязывать к событиям. Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget), [`XView`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView) и [`YView`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView), поэтому представление можно прокручивать по горизонтали и вертикали с помощью [`xview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview) и [`yview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView.yview). Обратитесь к странице руководства Tk `canvas` для полного списка опций виджета и элементов.18911892Каждый элемент имеет уникальный целочисленный *id*, присваиваемый при создании, и ноль или более строковых *тегов*. Тег – это произвольная строка, которая не должна иметь вид целого числа; один и тот же тег могут разделять несколько элементов, что делает теги удобными для группировки элементов. Специальный тег `'all'` соответствует каждому элементу на холсте, а `'current'` – верхнему элементу под указателем мыши. Большинство методов принимают аргумент *tagOrId*, который может быть целочисленным id, именующим один элемент, или тегом, именующим ноль или более элементов; как описано на странице руководства Tk `canvas`, тег также может быть логическим выражением из тегов, объединённых операторами `&&`, `||`, `^`, `!` и скобками. Когда метод, работающий с одним элементом, получает *tagOrId*, соответствующий нескольким элементам, он обычно использует самый нижний подходящий элемент в списке отображения.18931894Элементы хранятся в *списке отображения*, который определяет порядок рисования: элементы, расположенные позже в списке, рисуются поверх более ранних. Новый элемент помещается в начало списка; порядок можно изменить с помощью [`tag_raise()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.tag_raise) и [`tag_lower()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.tag_lower).18951896#### `create_arc(*args, **kw)`18971898#### `create_bitmap(*args, **kw)`18991900#### `create_image(*args, **kw)`19011902#### `create_line(*args, **kw)`19031904#### `create_oval(*args, **kw)`19051906#### `create_polygon(*args, **kw)`19071908#### `create_rectangle(*args, **kw)`19091910#### `create_text(*args, **kw)`19111912#### `create_window(*args, **kw)`19131914Создаёт новый элемент соответствующего типа и возвращает его целочисленный id. Каждый метод вызывается как `create_TYPE(coord..., **options)`: первые позиционные аргументы задают координаты, определяющие элемент (отдельные числа, единая последовательность чисел или пары координат), а ключевые аргументы устанавливают специфичные для элемента опции. Координаты и расстояния на экране могут быть заданы числами (интерпретируются как пиксели) или строками с суффиксом единицы измерения (`'m'`, `'c'`, `'i'` или `'p'` для миллиметров, сантиметров, дюймов или типографских пунктов), но всегда хранятся и возвращаются в пикселях.19151916Типы элементов: `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*).19171918Большинство типов элементов принимают общий набор *стандартных опций элементов*, а также несколько опций, специфичных для каждого типа. Имена опций передаются как ключевые аргументы, без ведущего дефиса.19191920Стандартные опции элементов:19211922***fill***19231924Цвет, используемый для заливки внутренней части элемента, или для рисования элемента *line* или символов элемента *text*. Пустая строка (значение по умолчанию для всех типов, кроме *line* и *text*) оставляет элемент незаполненным.19251926***outline***19271928Цвет, используемый для рисования контура элемента. Пустая строка означает отсутствие контура.19291930***width***19311932Ширина контура, по умолчанию `1.0`. Не действует, если *outline* пусто.19331934***dash***19351936Штриховой узор для контура, задаваемый либо как последовательность длин сегментов в пикселях, либо как строка из символов `'.'`, `','`, `'-'`, `'_'` и пробела. Пустой узор (по умолчанию) рисует сплошной контур.19371938***dashoffset***19391940Начальное смещение в пикселях в узоре *dash*. Игнорируется, если узор *dash* отсутствует.19411942***stipple***19431944Битовая карта, используемая как трафаретный узор при заливке элемента. Полноценно поддерживается только на X11.19451946***outlinestipple***19471948Битовая карта, используемая как трафаретный узор при рисовании контура. Не действует, если *outline* пуст.19491950***offset*, *outlineoffset***19511952Смещение узоров заливки и контура, задаваемое как `'x,y'` или как сторона, например `'n'`, `'se'` или `'center'`. Смещения трафарета поддерживаются только на X11.19531954***state***19551956Переопределяет состояние холста для этого элемента; одно из `'normal'`, `'disabled'` или `'hidden'`.19571958***tags***19591960Один тег или последовательность тегов для привязки к элементу, заменяя все существующие теги.19611962У многих из этих опций есть варианты *active…* и *disabled…* (например, *activefill*, *disabledfill*, *activewidth*, *disableddash*, *activeoutline*, *disabledstipple*), которые переопределяют основную опцию, когда элемент является активным (под указателем мыши) или находится в отключённом состоянии.19631964Следующие типы элементов поддерживают дополнительные опции.19651966Для элементов `arc`:19671968***start***19691970Начало углового диапазона дуги, в градусах, измеряемое против часовой стрелки от положения «3 часа».19711972***extent***19731974Размер углового диапазона, в градусах против часовой стрелки от *start*.19751976***стиль***19771978Как рисуется дуга: `'pieslice'` (по умолчанию), `'chord'` или `'arc'`.19791980Для элементов `line`:19811982***arrow***19831984Где рисовать наконечники стрелок: `'none'` (по умолчанию), `'first'`, `'last'` или `'both'`.19851986***arrowshape***19871988Последовательность из трёх расстояний, описывающих форму наконечников стрелок.19891990***capstyle***19911992Как рисуются концы линий: `'butt'` (по умолчанию), `'projecting'` или `'round'`.19931994***joinstyle***19951996Как рисуются вершины линий: `'round'` (по умолчанию), `'bevel'` или `'miter'`.19971998***smooth***19992000Метод сглаживания: ложное значение (по умолчанию) без сглаживания, или `'true'`/`'bezier'` или `'raw'` для рисования линии в виде кривой.20012002***splinesteps***20032004Количество отрезков, аппроксимирующих каждый сплайн, когда *smooth* включён.20052006Для элементов `polygon`:20072008***joinstyle*, *smooth*, *splinesteps***20092010Как и для элементов `line`, применяется к контуру многоугольника.20112012Для элементов `text`:20132014***text***20152016Отображаемая строка; символы новой строки начинают новые строки.20172018***font***20192020Шрифт, используемый для текста.20212022***выравнивание***20232024Способ выравнивания строк: `'left'` (по умолчанию), `'right'` или `'center'`.20252026***anchor***20272028Как текст позиционируется относительно своей точки; по умолчанию `'center'`.20292030***width***20312032Максимальная длина строки; если не равна нулю, строки переносятся по пробелам.20332034***angle***20352036На сколько градусов поворачивать текст против часовой стрелки относительно точки позиционирования, от `0.0` до `360.0` (по умолчанию `0.0`).20372038***underline***20392040Индекс символа для подчёркивания или `-1`, если подчёркивание не требуется.20412042Для элементов `bitmap`:20432044***bitmap***20452046Отображаемое растровое изображение.20472048***anchor***20492050Как растровое изображение позиционируется относительно своей точки.20512052***background*, *foreground***20532054Цвета для пикселей `0` и `1` растрового изображения; пустой *background* делает пиксели `0` прозрачными. Для обоих есть варианты *active…* и *disabled…*, а для *bitmap* – варианты *activebitmap* и *disabledbitmap*.20552056Для элементов `image`:20572058***image***20592060Изображение Tk для отображения, предварительно созданное с помощью протоколов изображений.20612062***anchor***20632064Как изображение позиционируется относительно своей точки.20652066Для обоих параметров существуют варианты *active…* и *disabled…* (*activeimage*, *disabledimage*), используемые в активном и отключённом состояниях.20672068Для элементов `window`:20692070***window***20712072Встраиваемый виджет; он должен быть дочерним элементом холста или одного из его предков и не может быть окном верхнего уровня.20732074***anchor***20752076Как окно позиционируется относительно своей точки.20772078***width*, *height***20792080Размер, назначаемый окну; если ноль (по умолчанию), окну присваивается его запрошенный размер.20812082Элементы `oval` и `rectangle` не имеют опций, специфичных для типа; они используют только стандартные опции элементов.20832084> **Примечание**2085>2086> Tk 8.6 добавил опцию *angle*, а Tk 9.0 добавил опцию *underline* для элементов `text`.20872088#### `coords(tagOrId)`20892090#### `coords(tagOrId, coordList, /)`20912092#### `coords(tagOrId, /, *coordList)`20932094Запрос или изменение координат элемента. С одним только *tagOrId* возвращает список координат с плавающей запятой элемента, заданного *tagOrId* (первый подходящий, если соответствует нескольким). При указании новых координат заменяет координаты этого элемента на указанные; как и методы `create_*`, координаты могут быть заданы отдельными числами, одной последовательностью или парами координат. Возвращаемые координаты всегда в пикселях, независимо от единиц, использованных при задании; для прямоугольников, овалов и дуг они упорядочены как лево, верх, право, низ.20952096Изменено в версии 3.12: Аргументы теперь уплощаются: координаты могут быть заданы отдельными аргументами, одной последовательностью или сгруппированы парами, как в методах `create_*`.20972098#### `move(tagOrId, xAmount, yAmount, /)`20992100Перемещает каждый из элементов, заданных *tagOrId*, в координатном пространстве холста, добавляя *xAmount* к каждой координате x и *yAmount* к каждой координате y элемента.21012102#### `moveto(tagOrId, x='', y='')`21032104Перемещает элементы, заданные *tagOrId*, так, чтобы первая пара координат (левый верхний угол ограничивающей рамки) наименьшего подходящего элемента находилась в позиции (*x*, *y*). *x* или *y* могут быть пустой строкой, в этом случае соответствующая координата не изменяется. Все подходящие элементы сохраняют свои позиции относительно друг друга.21052106Добавлено в версии 3.8.21072108#### `scale(tagOrId, xOrigin, yOrigin, xScale, yScale, /)`21092110Масштабирует координаты всех элементов, заданных *tagOrId*, в координатном пространстве холста. Каждая координата x корректируется так, чтобы её расстояние от *xOrigin* изменилось в *xScale* раз, а каждая координата y – чтобы её расстояние от *yOrigin* изменилось в *yScale* раз (коэффициент `1.0` оставляет координату без изменений).21112112#### `delete(*tagOrIds)`21132114Удаляет каждый из элементов, заданных аргументами *tagOrIds*.21152116#### `dchars(tagOrId, first, /)`21172118#### `dchars(tagOrId, first, last, /)`21192120Удаляет из каждого элемента, заданного *tagOrId*, символы (для текстовых элементов) или координаты (для элементов-линий и многоугольников) в диапазоне от *first* до *last* включительно; *last* по умолчанию равен *first*. Элементы, не поддерживающие индексацию, игнорируют эту операцию.21212122#### `insert(tagOrId, beforeThis, string, /)`21232124Вставляет *string* в каждый из элементов, заданных *tagOrId*, непосредственно перед символом или координатой, индекс которой равен *beforeThis*. Для элементов-линий и многоугольников *string* должна быть допустимой последовательностью координат.21252126#### `itemcget(tagOrId, option)`21272128Возвращает текущее значение опции конфигурации *option* для элемента, заданного *tagOrId* (наименьший подходящий элемент, если соответствует нескольким). Это похоже на [`cget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.cget), но применяется к отдельному элементу.21292130#### `itemconfigure(tagOrId, cnf=None, **kw)`21312132Запрос или изменение опций конфигурации элементов, заданных *tagOrId*. Это отражает [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.configure), но применяется к отдельным элементам, а не ко всему холсту. Без опций возвращает словарь, описывающий текущие опции первого подходящего элемента; в противном случае устанавливает указанные опции для каждого подходящего элемента. Допустимые опции – это те, которые принимает соответствующий метод `create_*`. [`itemconfig()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.itemconfig) является псевдонимом `itemconfigure()`.21332134#### `type(tagOrId)`21352136Возвращает тип элемента, заданного *tagOrId* (первый подходящий, если соответствует нескольким), например `'rectangle'` или `'text'`, или `None`, если *tagOrId* не соответствует ни одному элементу.21372138#### `gettags(tagOrId, /)`21392140Возвращает кортеж тегов, связанных с элементом, заданным параметром *tagOrId* (первый подходящий элемент в порядке отображения, если подходит несколько). Возвращает пустой кортеж, если ни один элемент не подходит или у элемента нет тегов.21412142#### `dtag(tagOrId, /)`21432144#### `dtag(tagOrId, tagToDelete, /)`21452146Удаляет тег *tagToDelete* (по умолчанию равный *tagOrId*) из каждого элемента, заданного параметром *tagOrId*. Элементы, у которых нет этого тега, остаются без изменений.21472148#### `addtag(newtag, searchSpec, /, *args)`21492150Добавляет тег *newtag* каждому элементу, выбранному по спецификации поиска *searchSpec* (и любым дополнительным параметрам *args*). *searchSpec* – одно из значений: `'above'`, `'all'`, `'below'`, `'closest'`, `'enclosed'`, `'overlapping'` или `'withtag'`; приведённые ниже методы `addtag_*` – это удобные обёртки, предоставляющие каждую из этих форм.21512152#### `addtag_above(newtag, tagOrId)`21532154Добавляет тег *newtag* элементу, расположенному непосредственно над (после) *tagOrId* в списке отображения.21552156#### `addtag_all(newtag)`21572158Добавляет тег *newtag* всем элементам на холсте.21592160#### `addtag_below(newtag, tagOrId)`21612162Добавляет тег *newtag* элементу, расположенному непосредственно под (перед) *tagOrId* в списке отображения.21632164#### `addtag_closest(newtag, x, y, halo=None, start=None)`21652166Добавляет тег *newtag* элементу, ближайшему к точке (*x*, *y*). Если задан *halo*, любой элемент в пределах этого расстояния от точки считается перекрывающим её. Если задан *start* (тег или id), выбирается самый верхний ближайший элемент, который находится ниже *start* в списке отображения. Это можно использовать для последовательного перебора всех ближайших элементов.21672168#### `addtag_enclosed(newtag, x1, y1, x2, y2)`21692170Добавляет тег *newtag* каждому элементу, полностью находящемуся внутри прямоугольника (*x1*, *y1*, *x2*, *y2*), где *x1* \<= *x2* и *y1* \<= *y2*.21712172#### `addtag_overlapping(newtag, x1, y1, x2, y2)`21732174Добавляет тег *newtag* каждому элементу, который перекрывает прямоугольник (*x1*, *y1*, *x2*, *y2*) или находится внутри него, где *x1* \<= *x2* и *y1* \<= *y2*.21752176#### `addtag_withtag(newtag, tagOrId)`21772178Добавляет тег *newtag* каждому элементу, заданному параметром *tagOrId*.21792180#### `find(searchSpec, /, *args)`21812182Возвращает кортеж идентификаторов всех элементов, выбранных по спецификации поиска *searchSpec* (и любым дополнительным параметрам *args*), в порядке наложения, начиная с самого нижнего элемента. Спецификация поиска может быть любой из форм, принимаемых методом [`addtag()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.addtag). Приведённые ниже методы `find_*` являются более удобными обёртками для него.21832184#### `find_above(tagOrId)`21852186Возвращает кортеж, содержащий идентификатор элемента, расположенного непосредственно над *tagOrId* в списке отображения.21872188#### `find_all()`21892190Возвращает кортеж идентификаторов всех элементов на холсте в порядке наложения.21912192#### `find_below(tagOrId)`21932194Возвращает кортеж, содержащий идентификатор элемента, расположенного непосредственно под *tagOrId* в списке отображения.21952196#### `find_closest(x, y, halo=None, start=None)`21972198Возвращает кортеж, содержащий идентификатор элемента, ближайшего к точке (*x*, *y*). Параметры *halo* и *start* интерпретируются так же, как в [`addtag_closest()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.addtag_closest).21992200#### `find_enclosed(x1, y1, x2, y2)`22012202Возвращает кортеж идентификаторов всех элементов, полностью находящихся внутри прямоугольника (*x1*, *y1*, *x2*, *y2*).22032204#### `find_overlapping(x1, y1, x2, y2)`22052206Возвращает кортеж идентификаторов всех элементов, которые перекрываются или находятся внутри прямоугольника (*x1*, *y1*, *x2*, *y2*).22072208#### `find_withtag(tagOrId)`22092210Возвращает кортеж идентификаторов всех элементов, заданных *tagOrId*.22112212#### `tag_raise(tagOrId, aboveThis=None, /)`22132214Перемещает все элементы, заданные *tagOrId*, на новую позицию в списке отображения сразу над элементом, заданным *aboveThis*, или в верхнюю часть списка отображения, если *aboveThis* опущен. При перемещении нескольких элементов их относительный порядок сохраняется. Это не влияет на встроенные оконные элементы, порядок наложения которых вместо этого управляется [`Misc.tkraise()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.tkraise) и [`Misc.lower()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.lower). [`lift()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.lift) и [`tkraise()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.tkraise) – псевдонимы `tag_raise()`.22152216#### `tag_lower(tagOrId, belowThis=None, /)`22172218Перемещает все элементы, заданные *tagOrId*, на новую позицию в списке отображения сразу под элементом, заданным *belowThis*, или в нижнюю часть списка отображения, если *belowThis* опущен. При перемещении нескольких элементов их относительный порядок сохраняется. Это не влияет на встроенные оконные элементы. [`lower()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.lower) – псевдоним `tag_lower()`.22192220> **Примечание**2221>2222> В классе `Canvas` методы [`tkraise()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.tkraise)/[`lift()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.lift) и [`lower()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.lower) изменяют порядок наложения элементов canvas, переопределяя унаследованные методы [`Misc.tkraise()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.tkraise)/[`Misc.lift()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.lift) и [`Misc.lower()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.lower), которые изменяют порядок самого виджета; поэтому эти унаследованные методы недоступны.22232224#### `tag_bind(tagOrId, sequence=None, func=None, add=None)`22252226Привязывает колбэк *func* к событию *sequence* для всех элементов, заданных *tagOrId*, так что *func* вызывается всякий раз, когда это событие происходит для одного из этих элементов. Это похоже на [`Widget.bind`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.bind), но работает с элементами canvas, а не с целыми виджетами; можно привязывать только события мыши, клавиатуры и виртуальные. События мыши направляются текущему элементу, а события клавиатуры – элементу с фокусом (см. [`focus()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.focus)). Если *add* истинно, новая привязка добавляется к уже существующим привязкам для того же события, а не заменяет их. Возвращает идентификатор привязанной функции, который можно передать [`tag_unbind()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.tag_unbind).22272228#### `tag_unbind(tagOrId, sequence, funcid=None)`22292230Удаляет для всех элементов, заданных *tagOrId*, привязку к событию *sequence*. Если задан *funcid*, отвязывается и удаляется только этот колбэк (возвращённый [`tag_bind()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.tag_bind)).22312232Изменено в версии 3.13: Если указан *funcid*, отвязывается только этот колбэк.22332234#### `bbox(tagOrId, /, *tagOrIds)`22352236Возвращает 4-кортеж `(x1, y1, x2, y2)`, задающий приблизительный ограничивающий прямоугольник в пикселях, который охватывает все элементы, заданные *tagOrId* и любыми дополнительными *tagOrIds*. Результат может превышать истинный ограничивающий прямоугольник на несколько пикселей. Возвращает `None`, если ни один элемент не соответствует или соответствующие элементы нечего отображать.22372238Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.22392240#### `canvasx(screenx, gridspacing=None)`22412242По заданной x-координате окна *screenx* возвращает x-координату canvas, отображаемую в этой позиции. Если задан *gridspacing*, результат округляется до ближайшего кратного *gridspacing* единицам.22432244#### `canvasy(screeny, gridspacing=None)`22452246По заданной y-координате окна *screeny* возвращает y-координату canvas, отображаемую в этой позиции. Если задан *gridspacing*, результат округляется до ближайшего кратного *gridspacing* единицам.22472248#### `focus()`22492250#### `focus(tagOrId, /)`22512252С параметром *tagOrId* устанавливает фокус клавиатуры canvas на первый элемент, заданный *tagOrId*, который поддерживает курсор вставки; если такого элемента нет, фокус остаётся без изменений. Если *tagOrId* – пустая строка, сбрасывает фокус так, что ни один элемент не имеет фокуса. Без аргументов возвращает идентификатор элемента, который в данный момент имеет фокус, или пустую строку, если такого нет. Элемент отображает курсор вставки только когда он сам является элементом с фокусом и его canvas имеет фокус ввода.22532254Этот метод затеняет унаследованный `Misc.focus()`; используйте [`focus_set()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.focus_set) для фокусировки самого виджета.22552256#### `icursor(tagOrId, index, /)`22572258Устанавливает курсор вставки элементов, заданных *tagOrId*, непосредственно перед символом, заданным *index*. Элементы, не поддерживающие курсор вставки, не затрагиваются. Курсор отображается только когда элемент имеет фокус, но его положение можно установить в любое время.22592260#### `index(tagOrId, index, /)`22612262Возвращает в виде целого числа числовой индекс внутри *tagOrId*, соответствующий *index*, который представляет собой текстовое описание позиции (для текстовых элементов – индекс символа, для отрезков и многоугольников – индекс в координатах). Если *tagOrId* соответствует нескольким элементам, используется первый из них, поддерживающий индексацию.22632264#### `select_adjust(tagOrId, index)`22652266Настраивает конец выделения в *tagOrId*, ближайший к *index*, так чтобы он находился на *index*, и делает другой конец якорной точкой для будущих вызовов [`select_to()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.select_to). Если выделение в данный момент не находится в *tagOrId*, это действует как `select_to()`.22672268#### `select_clear()`22692270Очищает выделение, если оно есть на этом холсте; в противном случае ничего не делает.22712272#### `select_from(tagOrId, index)`22732274Устанавливает точку привязки выделения непосредственно перед символом, заданным *index* в элементе, заданном *tagOrId*. Это не изменяет само выделение; оно устанавливает фиксированный конец для будущих вызовов [`select_to()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.select_to).22752276#### `select_item()`22772278Возвращает идентификатор элемента, содержащего выделение, или `None`, если выделение отсутствует на этом холсте. В отличие от методов [`find()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.find) и `find_*`, этот метод возвращает идентификатор в виде строки, а не целого числа.22792280#### `select_to(tagOrId, index)`22812282Устанавливает выделение на символы элемента *tagOrId* между точкой привязки выделения и *index*, включительно по *index*. Точкой привязки является та, что установлена последним вызовом [`select_adjust()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.select_adjust) или [`select_from()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.select_from).22832284#### `scan_mark(x, y)`22852286Запоминает *x*, *y* и текущий вид для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.scan_dragto). Обычно привязывается к нажатию кнопки мыши в виджете.22872288#### `scan_dragto(x, y, gain=10)`22892290Прокручивает холст на величину, равную *gain*, умноженному на разницу между *x*, *y* и координатами, переданными последнему вызову [`scan_mark()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas.scan_mark). Обычно это привязывается к событиям движения мыши на виджете, создавая эффект перетаскивания холста с высокой скоростью в его окне.22912292#### `postscript(cnf={}, **kw)`22932294Генерирует представление части или всего холста в формате PostScript (Encapsulated PostScript, версия 3.0). Если задан параметр *file* или *channel*, PostScript записывается туда и возвращается пустая строка; в противном случае он возвращается в виде строки. По умолчанию генерируется только область, видимая в данный момент в окне, поэтому обычно необходимо либо сначала вызвать [`update()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.update), либо использовать параметры *width* и *height*. Поддерживаемые параметры включают *colormap*, *colormode*, *file*, *fontmap*, *height*, *pageanchor*, *pageheight*, *pagewidth*, *pagex*, *pagey*, *rotate*, *width*, *x* и *y*.22952296#### `class tkinter.Checkbutton(master=None, cnf={}, **kw)`22972298Виджет `Checkbutton` отображает текстовую строку, растровое изображение или картинку вместе с квадратным индикатором и переключает логическое выделение при нажатии. Он обладает всем поведением простой кнопки и, кроме того, может быть выбран: при выборе индикатор рисуется с галочкой, а связанная переменная устанавливается в значение `onvalue`, а при отмене выбора индикатор рисуется пустым, а переменная устанавливается в значение `offvalue`. Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget). В дополнение к стандартным опциям виджета, флажок принимает опции, описанные на странице руководства Tk `checkbutton`, такие как *variable*, *onvalue*, *offvalue* и *command*.22992300#### `invoke()`23012302Делает то же самое, что произошло бы при нажатии пользователем на флажок мышью: переключает состояние выделения кнопки и вызывает связанную команду, если она есть. Возвращает результат команды или пустую строку, если с флажком не связана ни одна команда. Это игнорируется, если состояние флажка равно `disabled`.23032304#### `select()`23052306Выбирает флажок и устанавливает связанную переменную в его значение `onvalue`.23072308#### `deselect()`23092310Отменяет выбор флажка и устанавливает связанную переменную в его значение `offvalue`.23112312#### `toggle()`23132314Переключает состояние выделения кнопки, перерисовывая её и изменяя связанную переменную, чтобы отразить новое состояние.23152316#### `flash()`23172318Мигает флажком, перерисовывая его несколько раз, чередуя активный и обычный цвета. По окончании мигания флажок остаётся в том же обычном или активном состоянии, в котором он был при вызове метода. Это игнорируется, если состояние флажка равно `disabled`.23192320#### `class tkinter.Entry(master=None, cnf={}, **kw)`23212322Виджет `Entry` отображает одну строку текста и позволяет пользователю редактировать её. Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget) и [`XView`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView); поскольку поля ввода могут содержать слишком длинные строки, не помещающиеся в окно, они поддерживают горизонтальную прокрутку через [`xview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview).23232324В дополнение к стандартным опциям виджета, поле ввода принимает опции, описанные на странице руководства Tk `entry`. Примечательными являются *textvariable* (имя переменной, синхронизируемой с содержимым поля ввода), *show* (если установлено, каждый символ отображается как заданный символ, а не его истинное значение, полезно для ввода пароля), *validate* и *validatecommand* (которые вместе позволяют колбэку принять или отклонить правки), а также *state* (одно из значений `'normal'`, `'disabled'` или `'readonly'`).23252326Многие из приведенных ниже методов принимают аргумент *index*, который выбирает символ в строке поля ввода. Как описано на странице руководства Tk `entry`, *index* может быть числом (начиная с 0), `'insert'` (символ сразу после курсора вставки), `'end'` (сразу после последнего символа), `'anchor'` (точка привязки выделения), `'sel.first'` и `'sel.last'` (концы выделения), или `@x` (символ, соответствующий пиксельной координате x *x* в окне). Индексы вне диапазона округляются до ближайшего допустимого значения.23272328#### `delete(first, last=None)`23292330Удаляет символы от индекса *first* до индекса *last*, не включая его. Если *last* опущен, удаляется только один символ на позиции *first*.23312332#### `get()`23332334Возвращает текущую строку виджета Entry.23352336#### `insert(indexstring)`23372338Вставляет *string* непосредственно перед символом, заданным *index*.23392340#### `icursor(index)`23412342Устанавливает отображение курсора вставки непосредственно перед символом, заданным *index*.23432344#### `index(index)`23452346Возвращает числовой индекс, соответствующий *index*.23472348#### `selection_adjust(index)`23492350Находит конец выделения, ближайший к символу, заданному *index*, и перемещает этот конец на *index* (включительно, но не дальше); другой конец становится якорной точкой для последующих вызовов [`selection_to()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.selection_to). Если в поле ввода нет выделения, создаётся новое между *index* и последней якорной точкой включительно. [`select_adjust()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.select_adjust) – это псевдоним `selection_adjust()`.23512352#### `selection_clear()`23532354Очищает выделение, если оно находится в данном виджете. Если выделение не в этом виджете, метод не даёт эффекта. [`select_clear()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.select_clear) – это псевдоним `selection_clear()`.23552356> **Примечание**2357>2358> Этот метод переопределяет унаследованный [`Misc.selection_clear()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.selection_clear), который очищает X-выделение; этот метод недоступен для виджета `Entry`.23592360#### `selection_from(index)`23612362Устанавливает якорную точку выделения непосредственно перед символом, заданным *index*, не изменяя выделения. [`select_from()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.select_from) – это псевдоним `selection_from()`.23632364#### `selection_present()`23652366Возвращает `True`, если в поле ввода есть выделенные символы, иначе `False`. [`select_present()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.select_present) – это псевдоним `selection_present()`.23672368#### `selection_range(start, end)`23692370Устанавливает выделение, включающее символы, начиная с символа, индексированного *start*, и заканчивая символом, непосредственно предшествующим *end*. Если *end* ссылается на тот же символ, что и *start*, или более ранний, то выделение очищается. [`select_range()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.select_range) – это псевдоним `selection_range()`.23712372#### `selection_to(index)`23732374Устанавливает выделение между якорной точкой и *index*: если *index* находится до якорной точки, выделение идёт от *index* до якорной точки, не включая её; если *index* находится после неё, от якорной точки до *index*, не включая; если они совпадают, ничего не происходит. Якорная точка – это точка, установленная последним вызовом [`selection_from()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.selection_from) или [`selection_adjust()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.selection_adjust). Если в поле ввода нет выделения, создаётся новое с использованием последней якорной точки. [`select_to()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.select_to) – это псевдоним `selection_to()`.23752376#### `scan_mark(x)`23772378Запоминает *x* и текущий вид в окне поля ввода для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.scan_dragto). Обычно связано с нажатием кнопки мыши в виджете.23792380#### `scan_dragto(x)`23812382Вычисляет разницу между *x* и *x*, переданным в последний вызов [`scan_mark()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry.scan_mark), и смещает вид влево или вправо на 10-кратную величину этой разницы. Обычно используется с событиями движения мыши, чтобы создать эффект перетаскивания поля ввода с высокой скоростью по окну.23832384#### `class tkinter.Frame(master=None, cnf={}, **kw)`23852386Виджет `Frame` – это простой контейнер. Его основное назначение – служить разделителем или контейнером для сложных макетов окон; его единственные возможности – это фон и необязательная трёхмерная рамка, чтобы рамка выглядела приподнятой или утопленной. Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget). Обратитесь к странице руководства Tk `frame` для полного списка параметров.23872388#### `class tkinter.Label(master=None, cnf={}, **kw)`23892390Виджет `Label` отображает неинтерактивную текстовую строку, растровое изображение или картинку. Отображаемый текст задаётся параметром *text* или связывается с переменной через *textvariable*, а изображение можно показать с помощью параметра *image*. Весь текст должен быть одного шрифта, но может занимать несколько строк, и один символ может быть подчёркнут с помощью параметра *underline*. Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget). Обратитесь к странице руководства Tk `label` для полного списка параметров.23912392#### `class tkinter.LabelFrame(master=None, cnf={}, **kw)`23932394Виджет `LabelFrame` – это контейнер, который обладает возможностями [`Frame`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Frame) плюс возможность отображать метку. Текст метки задаётся параметром *text* и позиционируется с помощью *labelanchor*, или в качестве метки можно использовать произвольный виджет, передав его в параметре *labelwidget*. Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget). Обратитесь к странице руководства Tk `labelframe` для полного списка параметров.23952396#### `class tkinter.Listbox(master=None, cnf={}, **kw)`23972398Виджет `Listbox` отображает список однострочных текстовых элементов, по одному на строку, из которых пользователь может выбрать один или несколько. Поведение выделения определяется параметром *selectmode*, который может быть одним из: `browse` (по умолчанию; не более одного элемента, который можно перетаскивать мышью), `single` (не более одного элемента), `multiple` (любое количество элементов, переключаются индивидуально) или `extended` (любое количество элементов, включая несмежные диапазоны, выбираются щелчком и перетаскиванием). Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget), [`XView`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView) и [`YView`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView), поэтому представление можно прокручивать по горизонтали и вертикали с помощью [`xview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview) и [`yview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView.yview). Обратитесь к странице руководства Tk `listbox` для полного списка параметров.23992400Многие из методов принимают аргумент *индекс*, идентифицирующий конкретный элемент. Как описано на странице руководства Tk `listbox`, *индекс* может быть числовым индексом (начиная с 0 сверху), `'active'` (элемент в позиции курсора, задаётся с помощью [`activate()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.activate)), `'anchor'` (якорь выделения, задаётся с помощью [`selection_anchor()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.selection_anchor)), `'end'` (последний элемент, или для [`index()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.index) и [`insert()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.insert) позиция сразу после него), или `@x,y` (элемент, покрывающий пиксельные координаты *x*, *y* в окне listbox). Аргументы с именами *first* и *last* являются индексами тех же форм.24012402#### `insert(index, *elements)`24032404Вставляет заданные *элементы* как новые элементы непосредственно перед элементом, заданным *индексом*. Если *индекс* равен `'end'`, новые элементы добавляются в конец списка.24052406#### `delete(first, last=None)`24072408Удаляет элементы в диапазоне от *first* до *last* включительно. Если *last* опущен, по умолчанию используется *first*, так что удаляется один элемент.24092410#### `get(first, last=None)`24112412Если *last* опущен, возвращает содержимое элемента, заданного *first*, или пустую строку, если *first* ссылается на несуществующий элемент. Если *last* задан, возвращает кортеж всех элементов в диапазоне от *first* до *last* включительно.24132414#### `size()`24152416Возвращает общее количество элементов в listbox.24172418Этот метод затеняет унаследованный `Misc.size()`; используйте [`grid_size()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_size) для размера сетки.24192420#### `index(index)`24212422Возвращает целочисленное значение индекса, соответствующее *индексу*, или `None`, если *индекс* выходит за пределы диапазона. Если *индекс* равен `'end'`, результатом является количество элементов в listbox (не индекс последнего элемента).24232424#### `bbox(index)`24252426Возвращает кортеж `(x, y, width, height)`, описывающий ограничивающий прямоугольник (в пикселях относительно виджета) текста элемента, заданного *индексом*. Возвращает `None`, если ни одна часть этого элемента не видна на экране, или если *индекс* ссылается на несуществующий элемент; если элемент виден лишь частично, результат всё равно даёт полную область элемента, включая невидимые части.24272428Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.24292430#### `nearest(y)`24312432По заданной y-координате в окне listbox возвращает индекс видимого элемента, ближайшего к этой y-координате.24332434#### `see(index)`24352436Настраивает отображение так, чтобы элемент, заданный *индексом*, стал видимым. Если элемент уже видим, метод не даёт эффекта; если он находится у края окна, listbox прокручивается ровно настолько, чтобы показать его у этого края; в противном случае listbox прокручивается, чтобы центрировать элемент.24372438#### `activate(index)`24392440Устанавливает активный элемент равным элементу, заданному *индексом*. Если *индекс* находится вне диапазона элементов, вместо него активируется ближайший элемент. Активный элемент отображается в соответствии с опцией *activestyle*, когда виджет имеет фокус ввода; его индекс можно получить с помощью индекса `'active'`.24412442#### `curselection()`24432444Возвращает кортеж, содержащий числовые индексы всех элементов, которые в данный момент выбраны, или пустой кортеж, если ни один элемент не выбран.24452446#### `selection_anchor(index)`24472448Устанавливает якорь выделения на элемент, заданный *индексом*. Если *индекс* ссылается на несуществующий элемент, используется ближайший элемент. Якорь выделения – это конец выделения, который остаётся фиксированным при расширении выделения мышью; впоследствии на него можно ссылаться с помощью индекса `'anchor'`. [`select_anchor()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.select_anchor) является псевдонимом `selection_anchor()`.24492450#### `selection_clear(first, last=None)`24512452Снимает выделение с любых элементов в диапазоне от *first* до *last* включительно, которые выделены. Состояние выделения элементов вне этого диапазона не изменяется. [`select_clear()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.select_clear) является псевдонимом `selection_clear()`.24532454> **Примечание**2455>2456> Этот метод переопределяет унаследованный [`Misc.selection_clear()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.selection_clear), который очищает X-выделение; этот метод недоступен в `Listbox`.24572458#### `selection_includes(index)`24592460Возвращает `True`, если элемент, заданный *индексом*, в данный момент выбран, иначе `False`. [`select_includes()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.select_includes) является псевдонимом `selection_includes()`.24612462#### `selection_set(first, last=None)`24632464Выделяет все элементы в диапазоне от *first* до *last* включительно, не затрагивая состояние выделения элементов вне этого диапазона. [`select_set()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.select_set) является псевдонимом `selection_set()`.24652466#### `itemcget(index, option)`24672468Возвращает текущее значение конфигурационного параметра *option* для элемента, заданного *index*.24692470#### `itemconfigure(index, cnf=None, **kw)`24712472Запрашивает или изменяет параметры конфигурации элемента, заданного *index*. Это зеркально отражает [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.configure), но применяется к отдельному элементу, а не ко всему списковому полю. Без параметров возвращает словарь с описанием текущих параметров элемента; иначе устанавливает переданные параметры. Поддерживаемые параметры элемента: *background*, *foreground*, *selectbackground* и *selectforeground*. [`itemconfig()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.itemconfig) – это псевдоним `itemconfigure()`.24732474#### `scan_mark(x, y)`24752476Запоминает *x*, *y* и текущий вид для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.scan_dragto). Обычно привязывается к нажатию кнопки мыши в виджете.24772478#### `scan_dragto(x, y)`24792480Прокручивает список на величину, равную разнице между *x*, *y* и координатами, переданными последнему вызову [`scan_mark()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox.scan_mark), умноженную на 10. Обычно привязывается к событиям движения мыши в виджете, создавая эффект быстрого перетаскивания списка по окну.24812482#### `class tkinter.Menu(master=None, cnf={}, **kw)`24832484Виджет `Menu` отображает столбец записей, каждая из которых может быть командой, флажком, радиокнопкой, каскадом (который открывает связанное подменю) или разделителем. Меню используются как строка меню главного окна, как выпадающие меню, открываемые из каскадной записи или кнопки меню, а также как контекстные меню. Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget).24852486Многие методы записей принимают аргумент *index*, определяющий, с какой записью работать. Как описано на странице руководства Tk `menu`, *index* может быть числовым индексом (начиная с 0 сверху), `'active'` (текущая активная запись), `'end'` или `'last'` (самая нижняя запись), `'none'` (нет записи, в Tcl записывается как `{}`), `@y` (запись, покрывающая пиксельную координату y *y* в окне меню) или шаблоном, который сопоставляется с метками записей сверху вниз.24872488#### `add(itemType, cnf={}, **kw)`24892490Добавляет новую запись в конец меню. *itemType* – одно из значений `'command'`, `'cascade'`, `'checkbutton'`, `'radiobutton'` или `'separator'` и определяет тип новой записи; остальные параметры настраивают её. Методы-сокращения `add_command()`, `add_cascade()`, `add_checkbutton()`, `add_radiobutton()` и `add_separator()` вызывают этот метод с соответствующим *itemType*.24912492Запись настраивается следующими параметрами, хотя не каждый параметр применим ко всем типам записей (разделитель не принимает ни одного из них):24932494***label***24952496Текст, отображаемый в записи.24972498***command***24992500Функция, вызываемая при активации записи (для записей типа command, checkbutton и radiobutton).25012502***accelerator***25032504Строка, отображаемая справа от записи для указания клавиш быстрого вызова; сама она не создаёт привязку.25052506***underline***25072508Индекс символа в метке, который будет подчёркнут для навигации с клавиатуры.25092510***state***25112512Одно из `'normal'`, `'active'` или `'disabled'`.25132514***image***25152516Изображение, отображаемое вместо текстовой метки или вместе с ней.25172518***составной***25192520Где показывать изображение относительно текста: `'none'` (по умолчанию), `'text'`, `'image'`, `'top'`, `'bottom'`, `'left'` или `'right'`.25212522***bitmap***25232524Растровое изображение, отображаемое вместо текстовой метки.25252526***font***25272528Шрифт, используемый для текста.25292530***background*, *foreground***25312532Цвета фона и текста элемента в обычном состоянии (игнорируется на macOS).25332534***activebackground*, *activeforeground***25352536Цвета фона и текста, используемые, когда элемент активен (игнорируется на macOS).25372538***columnbreak***25392540Если true, элемент начинает новую колонку вместо того, чтобы располагаться под предыдущим элементом.25412542***hidemargin***25432544Если true, стандартный отступ вокруг элемента убирается; это полезно, когда меню используется как палитра.25452546***menu***25472548Подменю, открываемое каскадным элементом; оно должно быть дочерним по отношению к данному меню.25492550***переменная***25512552Переменная, связанная с элементом флажка или переключателя.25532554***onvalue*, *offvalue***25552556Значения, сохраняемые в *variable*, когда элемент флажка выбран или сброшен.25572558***значение***25592560Значение, сохраняемое в *variable*, когда элемент переключателя выбран.25612562***indicatoron***25632564Определяет, отображать ли индикатор элемента флажка или переключателя.25652566***selectcolor***25672568Цвет индикатора элемента флажка или переключателя, когда он выбран.25692570***selectimage***25712572Изображение, отображаемое, когда элемент флажка или переключателя выбран и также задано *image*.25732574#### `add_cascade(cnf={}, **kw)`25752576Добавляет новый каскадный элемент в нижнюю часть меню. Каскадный элемент имеет связанное подменю, задаваемое его опцией *menu*, которая должна быть дочерним меню по отношению к данному меню; при открытии элемента подменю отображается рядом с ним.25772578#### `add_checkbutton(cnf={}, **kw)`25792580Добавляет новый элемент флажка в нижнюю часть меню. При вызове элемент флажка переключается между значениями *onvalue* и *offvalue*, сохраняя результат в связанной *variable*, и отображает индикатор, показывающий, выбран ли он.25812582#### `add_command(cnf={}, **kw)`25832584Добавляет новый командный элемент в нижнюю часть меню. Командный элемент ведёт себя как кнопка: при его вызове выполняется колбэк, заданный опцией *command*.25852586#### `add_radiobutton(cnf={}, **kw)`25872588Добавляет новый элемент переключателя в нижнюю часть меню. Элементы переключателей, использующие одну и ту же *variable*, образуют группу, в которой в любой момент может быть выбран только один; при выборе элемента его *value* сохраняется в переменной.25892590#### `add_separator(cnf={}, **kw)`25912592Добавляет разделитель в нижнюю часть меню. Разделитель отображается в виде горизонтальной линии и не может быть активирован или вызван.25932594#### `insert(index, itemType, cnf={}, **kw)`25952596То же, что и [`add()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.add), за исключением того, что новый элемент вставляется непосредственно перед элементом с индексом *index*, а не добавляется в конец меню. *itemType* – одно из `'command'`, `'cascade'`, `'checkbutton'`, `'radiobutton'` или `'separator'`. Вспомогательные методы `insert_command()`, `insert_cascade()`, `insert_checkbutton()`, `insert_radiobutton()` и `insert_separator()` вызывают этот метод с соответствующим *itemType*.25972598#### `insert_cascade(index, cnf={}, **kw)`25992600Вставить новый каскадный элемент перед элементом, заданным *index* (см. [`add_cascade()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.add_cascade)).26012602#### `insert_checkbutton(index, cnf={}, **kw)`26032604Вставить новый элемент-флажок перед элементом, заданным *index* (см. [`add_checkbutton()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.add_checkbutton)).26052606#### `insert_command(index, cnf={}, **kw)`26072608Вставить новый элемент-команду перед элементом, заданным *index* (см. [`add_command()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.add_command)).26092610#### `insert_radiobutton(index, cnf={}, **kw)`26112612Вставить новый элемент-переключатель перед элементом, заданным *index* (см. [`add_radiobutton()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.add_radiobutton)).26132614#### `insert_separator(index, cnf={}, **kw)`26152616Вставить разделитель перед элементом, заданным *index* (см. [`add_separator()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.add_separator)).26172618#### `delete(index1, index2=None)`26192620Удаляет все пункты меню между *index1* и *index2* включительно. Если *index2* опущен, по умолчанию используется *index1*, так что удаляется один элемент. Попытки удалить отрывной элемент игнорируются; удалите его, изменив параметр *tearoff*.26212622#### `entrycget(index, option)`26232624Возвращает текущее значение параметра конфигурации *option* для элемента, заданного *index*.26252626#### `entryconfigure(index, cnf=None, **kw)`26272628Запрашивает или изменяет параметры конфигурации элемента, заданного *index*. Это работает как [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.configure), но применяется к отдельному элементу, а не ко всему меню. Без аргументов возвращает словарь с текущими параметрами элемента; иначе устанавливает указанные параметры. Поддерживаются те же параметры, что принимает [`add()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.add) для данного типа элемента. [`entryconfig()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.entryconfig) является псевдонимом `entryconfigure()`.26292630#### `index(index)`26312632Возвращает числовой индекс, соответствующий *index*, или `None`, если *index* не указывает ни на один элемент.26332634#### `type(index)`26352636Возвращает тип элемента, заданного *index*: одно из значений `'command'`, `'cascade'`, `'checkbutton'`, `'radiobutton'`, `'separator'` или `'tearoff'` (для отрывного элемента).26372638#### `activate(index)`26392640Делает элемент, заданный *index*, активным, перерисовывая его активными цветами, и деактивирует ранее активный элемент. Если *index* не указывает ни на один элемент или выбранный элемент отключён, в меню не будет активного элемента.26412642#### `invoke(index)`26432644Вызывает действие элемента, заданного *index*, как если бы на нём щёлкнули. Если элемент отключён, ничего не происходит. Если с элементом связана *command*, возвращается результат выполнения этой команды; в противном случае возвращается пустая строка.26452646#### `post(x, y)`26472648Отображает меню на экране в координатах корневого окна *x* и *y*, при необходимости корректируя их, чтобы всё меню было видимо. Если указан параметр *postcommand*, он вычисляется перед отображением меню.26492650#### `tk_popup(x, y, entry='')`26512652Отображает меню как всплывающее в координатах корневого окна *x* и *y*. Если указан *entry*, меню позиционируется так, чтобы этот элемент отображался под указателем.26532654#### `unpost()`26552656Скрывает меню, чтобы оно больше не отображалось, также скрывая любые отображённые каскадные подменю нижнего уровня. Не действует в Windows и macOS, которые управляют скрытием меню самостоятельно.26572658#### `xposition(index)`26592660Возвращает x-координату (в окне меню) самого левого пикселя элемента, заданного *index*.26612662Добавлено в версии 3.3.26632664#### `yposition(index)`26652666Возвращает координату y самого верхнего пикселя записи, заданной *index*, в окне меню.26672668#### `class tkinter.Menubutton(master=None, cnf={}, **kw)`26692670Виджет `Menubutton` отображает текстовую строку, растровое изображение или картинку и при нажатии показывает связанное [`Menu`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu), заданное параметром *menu*. Как и [`Label`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Label), он может показывать *text*, *textvariable* или *image*, а параметр *direction* управляет тем, где появится меню относительно кнопки. Наследуется от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget). Полный список параметров приведен на странице руководства Tk `menubutton`.26712672#### `class tkinter.Message(master=None, cnf={}, **kw)`26732674Виджет `Message` отображает неинтерактивную текстовую строку, заданную параметром *text* или связанную с переменной через *textvariable*. В отличие от [`Label`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Label), он разбивает строку на несколько строк для получения заданного соотношения сторон, выбирая разрывы строк на границах слов, и может выравнивать текст по левому краю, по центру или по правому. Наследуется от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget). Полный список параметров приведен на странице руководства Tk `message`.26752676#### `class tkinter.OptionMenu(master, variable, value, *values, **kwargs)`26772678Вспомогательный подкласс [`Menubutton`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menubutton), отображающий всплывающее меню с взаимоисключающими вариантами. *variable* – это [`Variable`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable), синхронизируемая с выбором, *value* – начальный выбор, а *values* – остальные пункты меню. Именованный аргумент *command* может задавать колбэк, который вызывается с выбранным значением, а именованный аргумент *name* устанавливает имя виджета Tk.26792680#### `destroy()`26812682Уничтожает виджет, а также очищает связанное всплывающее меню.26832684Изменено в версии 3.14: Добавлена поддержка аргумента-ключевого слова *name*.26852686#### `class tkinter.PanedWindow(master=None, cnf={}, **kw)`26872688`PanedWindow` – это виджет-менеджер геометрии, который размещает любое количество дочерних *панелей* в ряд (если *orient* равен `'horizontal'`) или в колонку (если *orient* равен `'vertical'`). Каждая панель содержит один виджет, и каждая пара соседних панелей разделена подвижным *разделителем*, который пользователь может перетаскивать мышью для изменения размеров виджетов по обе стороны от него. Наследуется от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget).26892690Параметр *orient* выбирает направление расположения, *sashwidth* задаёт ширину каждого разделителя, а *sashrelief* – его рельеф. Если *showhandle* равен true, на каждом разделителе рисуется небольшая ручка, за которую пользователь может ухватиться, чтобы перетащить его. Полный список параметров приведен на странице руководства Tk `panedwindow`.26912692#### `add(child, **kw)`26932694Добавляет *child* в panedwindow в качестве новой панели, размещая её после всех существующих панелей. Именованные аргументы задают параметры управления для *child*; это могут быть любые параметры, принимаемые [`paneconfigure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow.paneconfigure).26952696#### `remove(child)`26972698Удаляет панель, содержащую *child*, из panedwindow. Все параметры управления геометрией для *child* забываются. [`forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow.forget) – это псевдоним `remove()`. Этот метод скрывает унаследованный `forget()`; используйте [`pack_forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.pack_forget), [`grid_forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Grid.grid_forget) или [`place_forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Place.place_forget), чтобы удалить сам виджет из его менеджера.26992700#### `panes()`27012702Возвращает кортеж виджетов, управляемых panedwindow, по одному на панель, в порядке их расположения.27032704#### `panecget(child, option)`27052706Возвращает текущее значение параметра управления *option* для панели, содержащей *child*. *option* может быть любым значением, допустимым для [`paneconfigure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow.paneconfigure).27072708#### `paneconfigure(tagOrId, cnf=None, **kw)`27092710Запрашивает или изменяет параметры управления панели, содержащей виджет *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.14/library/tkinter.html#tkinter.PanedWindow.paneconfig) – это псевдоним `paneconfigure()`.27112712#### `identify(x, y)`27132714Определяет компонент panedwindow под точкой с координатами *x* и *y* в оконных координатах. Если точка находится над разделителем или ручкой разделителя, результатом будет кортеж из двух элементов: индекс разделителя или ручки и слово, указывающее, находится ли точка над разделителем или ручкой, например `(0, 'sash')` или `(2, 'handle')`. Если точка находится над любой другой частью panedwindow, результатом будет пустая строка.27152716#### `sash(*args)`27172718Запрашивает или изменяет положение разделителей в panedwindow. Это тонкая обёртка вокруг подкоманды Tk `sash`; обычно вместо неё следует использовать удобные методы [`sash_coord()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow.sash_coord), [`sash_mark()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow.sash_mark) и [`sash_place()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow.sash_place).27192720#### `sash_coord(index)`27212722Возвращает пару координат x и y для разделителя с индексом *index*, который должен быть целым числом от 0 до (количество панелей в panedwindow минус 1). Возвращаемые координаты – это координаты левого верхнего угла области, содержащей разделитель.27232724#### `sash_mark(index)`27252726Запоминает текущее положение мыши для разделителя с индексом *index* для последующего перемещения разделителя операциями перетаскивания.27272728#### `sash_place(index, x, y)`27292730Поместите sash, заданный через *index*, в координаты *x* и *y*.27312732#### `proxy(*args)`27332734Запрос или изменение позиции прокси-разделителя (sash proxy), «призрачного» разделителя, отображаемого во время перетаскивания разделителя при непрозрачном изменении размера. Это тонкая обёртка вокруг подкоманды Tk `proxy`; вместо неё обычно следует использовать удобные методы [`proxy_coord()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow.proxy_coord), [`proxy_forget()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow.proxy_forget) и [`proxy_place()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow.proxy_place).27352736#### `proxy_coord()`27372738Возвращает кортеж, содержащий координаты x и y последнего местоположения прокси.27392740#### `proxy_forget()`27412742Удаляет прокси с экрана.27432744#### `proxy_place(x, y)`27452746Помещает прокси в координаты *x* и *y*.27472748#### `class tkinter.Radiobutton(master=None, cnf={}, **kw)`27492750Виджет `Radiobutton` отображает текстовую строку, растровое изображение или картинку вместе с ромбовидным или круглым индикатором и позволяет выбрать один вариант из нескольких. Он обладает всем поведением простой кнопки и, кроме того, может быть выбран: обычно несколько радиокнопок используют одну *variable*, и выбор одной устанавливает эту переменную в *value* радиокнопки; каждая радиокнопка также отслеживает переменную и автоматически выбирает или снимает выбор при изменении переменной. Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget). В дополнение к стандартным опциям виджета, радиокнопка принимает опции, описанные на странице руководства Tk `radiobutton`, такие как *variable*, *value* и *command*.27512752#### `invoke()`27532754Делает то же самое, что произошло бы при нажатии пользователем на радиокнопку мышью: выбирает кнопку и вызывает связанную команду, если таковая имеется. Возвращает результат команды или пустую строку, если с радиокнопкой не связана ни одна команда. Игнорируется, если состояние радиокнопки `disabled`.27552756#### `select()`27572758Выбирает радиокнопку и устанавливает связанную переменную в значение, соответствующее этому виджету.27592760#### `deselect()`27612762Снимает выбор с радиокнопки и устанавливает связанную переменную в пустую строку. Если эта радиокнопка не была выбрана, действие не выполняется.27632764#### `flash()`27652766Мигает радиокнопкой, перерисовывая её несколько раз с чередованием активного и обычного цветов. По завершении мигания радиокнопка остаётся в том же обычном или активном состоянии, что и в момент вызова метода. Игнорируется, если состояние радиокнопки `disabled`.27672768#### `class tkinter.Scale(master=None, cnf={}, **kw)`27692770Виджет `Scale` позволяет пользователю выбрать числовое значение путём перемещения ползунка вдоль дорожки. Он может быть ориентирован вертикально или горизонтально и при желании отображать метку и текущее значение. Наследует от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget).27712772В дополнение к стандартным опциям виджета, шкала (scale) принимает опции, описанные на странице руководства Tk `scale`, такие как *from\_*, *to*, *resolution*, *orient*, *tickinterval*, *variable* и *command*. Как и везде в `tkinter`, ведущий `-` имени опции Tk опускается; *from* записывается как `from_`, потому что [`from`](https://python-all.ru/3.14/reference/simple_stmts.html#from) является ключевым словом Python.27732774При нецелом *resolution* см. [числовые значения и локаль](https://python-all.ru/3.14/library/tkinter.html#tkinter-numeric-locale).27752776#### `get()`27772778Возвращает текущее значение шкалы. Результат является целым числом, если *resolution* шкалы даёт целые числа, и числом с плавающей запятой в противном случае.27792780#### `set(value)`27812782Устанавливает шкалу в значение *value*, соответственно перемещая ползунок. Не действует, если шкала отключена.27832784#### `coords(value=None)`27852786Возвращает кортеж `(x, y)`, содержащий пиксельные координаты относительно виджета точки на центральной линии дорожки, соответствующей *value*. Если *value* опущен, используется текущее значение шкалы.27872788#### `identify(x, y)`27892790Возвращает строку, описывающую часть шкалы в пиксельных координатах *x*, *y*: `'slider'`, `'trough1'` (часть дорожки выше или левее ползунка), `'trough2'` (ниже или правее ползунка), или пустую строку, если точка не находится ни над одним из этих элементов.27912792#### `class tkinter.Scrollbar(master=None, cnf={}, **kw)`27932794Виджет `Scrollbar` отображает ползунок и две стрелки, позволяющие пользователю прокручивать связанный виджет, например [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox), [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text), [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas) или [`Entry`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry). Он соединяется с прокручиваемым виджетом путём установки опции *xscrollcommand* или *yscrollcommand* этого виджета на метод [`set()`](https://python-all.ru/3.14/library/stdtypes.html#set) полосы прокрутки, а опции *command* полосы прокрутки – на метод [`xview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview) или [`yview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView.yview) прокручиваемого виджета. Наследуется от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget).27952796#### `get()`27972798Возвращает текущие настройки полосы прокрутки в виде кортежа `(first, last)` из двух дробей от 0 до 1, описывающих часть документа, которая в данный момент видна, как было последний раз передано в [`set()`](https://python-all.ru/3.14/library/stdtypes.html#set).27992800#### `set(first, last)`28012802Устанавливает полосу прокрутки. *first* и *last* – это дроби от 0 до 1, задающие позиции начала и конца видимой части связанного документа. Этот метод обычно регистрируется как *xscrollcommand* или *yscrollcommand* прокручиваемого виджета и вызывается этим виджетом.28032804#### `activate(index=None)`28052806Помечает элемент *index* (один из `'arrow1'`, `'slider'` или `'arrow2'`) как активный, отображая его в соответствии с опциями *activebackground* и *activerelief*. Если *index* опущен, возвращает имя текущего активного элемента или `None`, если ни один элемент не активен.28072808Изменено в версии 3.5: Аргумент *index* теперь необязателен.28092810#### `delta(deltax, deltay)`28112812Возвращает число с плавающей точкой, указывающее дробное изменение настройки полосы прокрутки, соответствующее перемещению ползунка на *deltax* пикселей по горизонтали (для горизонтальных полос прокрутки) или на *deltay* пикселей по вертикали (для вертикальных полос прокрутки).28132814#### `fraction(x, y)`28152816Возвращает число с плавающей точкой от 0 до 1, указывающее, где находится точка с пиксельными координатами *x*, *y* в желобе: 0 соответствует верхнему или левому краю желоба, а 1 – нижнему или правому.28172818#### `identify(x, y)`28192820Возвращает имя элемента под пиксельными координатами *x*, *y* (например, `'arrow1'`) или пустую строку, если точка не находится ни в одном элементе полосы прокрутки.28212822#### `class tkinter.Spinbox(master=None, cnf={}, **kw)`28232824Виджет `Spinbox` – это виджет, похожий на [`Entry`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry), с парой кнопок со стрелками вверх/вниз, позволяющих пользователю перебирать диапазон значений, а также редактировать значение напрямую. Набор значений может быть числовым диапазоном, задаваемым опциями *from\_*, *to* и *increment*, или явным списком строк, задаваемым опцией *values* (которая имеет приоритет над диапазоном). Каждый раз при нажатии на стрелку вызывается колбэк *command*, если он задан; опция *wrap* управляет тем, будет ли переход за пределы диапазона зацикливаться на другой стороне; опция *format* определяет форматирование числовых значений; а опция *validate* включает проверку введённого текста. Наследуется от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget) и [`XView`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView).28252826При нецелом *increment* см. [числовые значения и локаль](https://python-all.ru/3.14/library/tkinter.html#tkinter-numeric-locale).28272828Многие методы принимают аргумент *index*, идентифицирующий символ в строке spinbox. Как описано на странице руководства Tk `spinbox`, *index* может быть числовым индексом (начиная с 0), `'anchor'` (якорная точка выделения), `'end'` (сразу после последнего символа), `'insert'` (символ сразу после курсора вставки), `'sel.first'` или `'sel.last'` (концы выделения) или `@x` (символ, покрывающий пиксельную координату x *x* в окне).28292830#### `get()`28312832Возвращает строку spinbox.28332834#### `insert(index, s)`28352836Вставляет символы строки *s* непосредственно перед символом, заданным *index*.28372838#### `delete(first, last=None)`28392840Удаляет один или несколько символов spinbox. *first* – это индекс первого удаляемого символа, а *last* – индекс символа, следующего за последним удаляемым. Если *last* опущен, удаляется один символ по индексу *first*.28412842#### `icursor(index)`28432844Устанавливает отображение курсора вставки непосредственно перед символом, заданным *index*.28452846#### `index(index)`28472848Возвращает числовой индекс, соответствующий *index*, в виде строки.28492850#### `bbox(index)`28512852Возвращает кортеж из четырёх целых чисел `(x, y, width, height)`, описывающих ограничивающий прямоугольник символа, заданного *index*. *x* и *y* – это пиксельные координаты левого верхнего угла символа относительно виджета, а *width* и *height* – его размер в пикселях. Ограничивающий прямоугольник может относиться к области за пределами видимой части окна.28532854Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.28552856#### `identify(x, y)`28572858Возвращает имя элемента окна по координатам пикселей *x*, *y*: одно из `'buttondown'`, `'buttonup'`, `'entry'` или `'none'`.28592860#### `invoke(element)`28612862Вызывает кнопку вращения, заданную *элементом*, либо `'buttonup'`, либо `'buttondown'`, запуская связанное с ней действие.28632864#### `scan(*args)`28652866Тонкая обёртка вокруг подкоманды виджета Tk `scan`, используемая для быстрого перетаскивания представления: `scan('mark', x)` записывает *x* и текущее представление, а `scan('dragto', x)` корректирует представление относительно этой метки. Методы [`scan_mark()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.scan_mark) и [`scan_dragto()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.scan_dragto) оборачивают две формы.28672868#### `scan_mark(x)`28692870Записывает *x* и текущее представление в окне spinbox для последующего вызова [`scan_dragto()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.scan_dragto). Обычно это связано с нажатием кнопки мыши на виджете.28712872#### `scan_dragto(x)`28732874Корректирует представление на величину, равную 10-кратной разности между *x* и *x*, переданным последнему вызову [`scan_mark()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.scan_mark). Обычно это связано с событиями движения мыши, создавая эффект перетаскивания spinbox с высокой скоростью по окну.28752876#### `selection(*args)`28772878Тонкая обёртка вокруг подкоманды виджета 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.14/library/tkinter.html#tkinter.Spinbox.selection_adjust), [`selection_clear()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.selection_clear), [`selection_element()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.selection_element), [`selection_from()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.selection_from), [`selection_present()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.selection_present), [`selection_range()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.selection_range) и [`selection_to()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.selection_to) оборачивают эти формы.28792880#### `selection_adjust(index)`28812882Находит конец выделения, ближайший к символу, заданному *index*, и корректирует этот конец, чтобы он находился на *index* (включая *index*, но не выходя за него). Другой конец становится якорной точкой для будущих вызовов [`selection_to()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.selection_to). Если выделение в данный момент отсутствует в spinbox, создаётся новое выделение, включающее символы между *index* и последней якорной точкой включительно.28832884#### `selection_clear()`28852886Очищает выделение, если оно находится в этом виджете. Если выделения нет в этом виджете, метод не даёт эффекта.28872888> **Примечание**2889>2890> Этот метод переопределяет унаследованный [`Misc.selection_clear()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.selection_clear), который очищает X-выделение; этот метод недоступен в `Spinbox`.28912892#### `selection_element(element=None)`28932894Устанавливает или возвращает текущий выбранный элемент. Если передан *элемент* (один из `'buttonup'`, `'buttondown'` или `'none'`), эта кнопка вращения выбирается и отображается нажатой; в противном случае возвращается имя текущего выбранного элемента.28952896#### `selection_from(index)`28972898Устанавливает якорную точку выделения непосредственно перед символом, заданным *index*, не изменяя само выделение.28992900Добавлено в версии 3.8.29012902#### `selection_present()`29032904Возвращает `True`, если в spinbox выбраны какие-либо символы, и `False` в противном случае.29052906Добавлено в версии 3.8.29072908#### `selection_range(start, end)`29092910Устанавливает выделение, включающее символы, начиная с символа с индексом *start* и заканчивая символом непосредственно перед *end*. Если *end* указывает на тот же символ, что и *start*, или на более ранний, выделение очищается.29112912Добавлено в версии 3.8.29132914#### `selection_to(index)`29152916Устанавливает выделение между *index* и якорной точкой. Если *index* находится до якорной точки, выделение идёт от *index* до якорной точки, не включая её; если после – выделение идёт от якорной точки до *index*, не включая его; если совпадает, ничего не происходит. Якорная точка задаётся последним вызовом [`selection_from()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.selection_from) или [`selection_adjust()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox.selection_adjust). Если выделение отсутствует в этом виджете, создаётся новое выделение с использованием последней якорной точки.29172918Добавлено в версии 3.8.29192920#### `class tkinter.Text(master=None, cnf={}, **kw)`29212922Виджет `Text` отображает и редактирует многострочный текст. Части текста могут быть стилизованы с помощью **тегов**, отдельные позиции могут быть помечены плавающими **метками**, а в текст могут быть встроены произвольные изображения и другие виджеты. Виджет также предоставляет неограниченный механизм отмены/повтора и поддерживает равноправные виджеты (peer widgets), использующие те же базовые данные. Наследуется от [`Widget`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Widget), [`XView`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView) и [`YView`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView), поэтому представление можно прокручивать по горизонтали и вертикали с помощью [`xview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview) и [`yview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView.yview). Полный список опций см. на странице руководства Tk `text`.29232924Большинство методов принимают один или несколько аргументов *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'`.29252926#### `insert(index, chars, *args)`29272928Вставляет строку *chars* непосредственно перед символом на *index* (если *index* равен `'end'`, то непосредственно перед последним символом новой строки). По умолчанию новый текст наследует любые теги, присутствующие с обеих сторон точки вставки. Если задан *args*, он состоит из чередующихся значений *tagList*, *chars*: предыдущий *chars* получает именно перечисленные теги (список тегов может быть именем одного тега или последовательностью имён), переопределяя окружающие теги.29292930#### `delete(index1, index2=None)`29312932Удаляет диапазон символов от *index1* включительно до *index2* не включительно. Если *index2* опущен, удаляется единственный символ в *index1*. Виджет всегда сохраняет символ новой строки в качестве последнего символа, поэтому удаление, которое могло бы его удалить, корректируется соответствующим образом.29332934#### `replace(index1, index2, chars, *args)`29352936Заменяет диапазон символов от *index1* включительно до *index2* не включительно на *chars*. Это эквивалентно [`delete()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text.delete), за которым следует [`insert()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text.insert) в позиции *index1*; *args* интерпретируется так же, как для `insert()`.29372938Добавлено в версии 3.3.29392940#### `get(index1, index2=None)`29412942Возвращает текст от *index1* до *index2* (не включая) в виде строки. Если *index2* опущен, возвращает единственный символ по индексу *index1*. Встроенные изображения и окна не включаются в результат.29432944#### `index(index)`29452946Возвращает позицию, соответствующую *index*, в канонической форме `'line.char'`.29472948#### `compare(index1, op, index2)`29492950Сравнивает позиции *index1* и *index2* с помощью оператора отношения *op*, который должен быть одним из `'<'`, `'<='`, `'=='`, `'>='`, `'>'` или `'!='`, и возвращает логический результат.29512952#### `count(index1, index2, *options, return_ints=False)`29532954Подсчитывает количество элементов запрошенных типов между *index1* и *index2*; результат отрицательный, если *index1* находится после *index2*. Каждый из *options* задаёт тип подсчитываемого элемента: `'chars'`, `'displaychars'`, `'displayindices'`, `'displaylines'`, `'indices'`, `'lines'`, `'xpixels'` или `'ypixels'` (по умолчанию, если ни один параметр не указан, используется `'indices'`). Псевдо-параметр `'update'` принудительно пересчитывает устаревшую информацию о расположении до обработки последующих параметров. Если *return\_ints* равен true и указан только один параметр подсчёта, возвращается простое целое число; в противном случае возвращается кортеж с одним целым числом для каждого параметра подсчёта (или `None`, если результат пуст).29552956Добавлено в версии 3.3.29572958Изменено в версии 3.13: Добавлен параметр *return\_ints*.29592960#### `see(index)`29612962Настраивает отображение так, чтобы символ, заданный *index*, был видимым. Если он уже видим, метод не производит никакого эффекта; если он находится на небольшом расстоянии за пределами видимости, виджет прокручивает ровно настолько, чтобы подвести его к ближайшему краю; в противном случае прокручивает так, чтобы *index* оказался в центре окна.29632964#### `bbox(index)`29652966Возвращает кортеж `(x, y, width, height)`, задающий ограничивающий прямоугольник (в пикселях) видимой части символа по индексу *index*, или `None`, если этот символ не видим на экране.29672968Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.29692970#### `dlineinfo(index)`29712972Возвращает кортеж `(x, y, width, height, baseline)`, описывающий строку отображения, содержащую *index*: первые четыре значения задают ограничивающий прямоугольник строки в пикселях, а *baseline* задаёт смещение базовой линии вниз от верхней границы области. Возвращает `None`, если эта строка отображения не видна на экране.29732974#### `mark_set(markName, index)`29752976Устанавливает метку с именем *markName* в позицию непосредственно перед символом по индексу *index*, создавая метку, если её ещё не существует. Метка, созданная таким образом, по умолчанию имеет правую гравитацию.29772978#### `mark_unset(*markNames)`29792980Удаляет каждую из меток, имена которых указаны в *markNames*. Специальные метки `insert` и `current` не могут быть удалены.29812982#### `mark_names()`29832984Возвращает кортеж имён всех меток, установленных в данный момент в виджете.29852986#### `mark_gravity(markName, direction=None)`29872988Если *direction* опущен, возвращает гравитацию метки *markName*: либо `'left'`, либо `'right'`. В противном случае устанавливает её гравитацию равной *direction*. Гравитация определяет, с какой стороны от метки появляется текст, вставленный в позицию метки: метка с правой гравитацией (по умолчанию) остаётся справа от такого текста.29892990#### `mark_next(index)`29912992Возвращает имя первой метки, находящейся в позиции *index* или после неё, или `None`, если такой метки нет. Если *index* является именем метки, поиск начинается сразу после этой метки.29932994#### `mark_previous(index)`29952996Возвращает имя последней метки, находящейся в позиции *index* или перед ней, или `None`, если такой метки нет. Если *index* является именем метки, поиск начинается непосредственно перед этой меткой.29972998#### `tag_add(tagName, index1, *args)`29993000Добавляет тег *tagName* к диапазону символов от *index1* включительно до следующего индекса в *args* (не включая его). Дополнительные пары индексов можно передать в *args*, чтобы пометить ещё несколько диапазонов; одиночный индекс в конце помечает только символ по этому индексу.30013002#### `tag_remove(tagName, index1, index2=None)`30033004Удаляет тег *tagName* у символов от *index1* включительно до *index2* (не включая его) (или у одного символа по *index1*, если *index2* не указан). Сам тег продолжает существовать, даже если ни один символ его не содержит.30053006#### `tag_delete(*tagNames)`30073008Удаляет каждый из тегов, перечисленных в *tagNames*, убирая их со всех символов и отбрасывая их параметры и привязки.30093010#### `tag_configure(tagName, cnf=None, **kw)`30113012Запрашивает или изменяет параметры конфигурации тега *tagName*. Это отражает [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.configure), за исключением того, что применяется к тегу, а не к виджету в целом: без параметров возвращает словарь, описывающий текущие параметры, иначе устанавливает переданные параметры. Определение тега таким образом также даёт ему приоритет выше, чем у любого существующего тега.30133014Поддерживаемые параметры тега, все управляющие внешним видом размеченного текста:30153016***font***30173018Шрифт, используемый для текста.30193020***foreground***30213022Цвет текста.30233024***background***30253026Цвет фона за текстом.30273028***fgstipple*, *bgstipple***30293030Растровые изображения для точечной заливки переднего плана (текста) и фона; хорошо поддерживаются только в X11.30313032***borderwidth***30333034Ширина границы, рисуемой вокруг текста в соответствии с *relief* (по умолчанию `0`).30353036***relief***30373038Трёхмерный вид границы текста: `'flat'` (по умолчанию), `'raised'`, `'sunken'`, `'ridge'`, `'groove'` или `'solid'`.30393040***offset***30413042Насколько текст поднимается над (или, если отрицательное, опускается под) базовую линию для верхних и нижних индексов.30433044***underline***30453046Указывает, подчёркивается ли текст.30473048***underlinefg***30493050Цвет подчёркивания; по умолчанию равен цвету текста.30513052***overstrike***30533054Указывает, рисуется ли линия через середину текста.30553056***overstrikefg***30573058Цвет линии зачёркивания; по умолчанию равен цвету текста.30593060***elide***30613062Скрыт ли текст.30633064***выравнивание***30653066Как выравнивать первый символ отображаемой строки: `'left'` (по умолчанию), `'right'` или `'center'`.30673068***перенос***30693070Как переносить слишком длинные строки: `'char'`, `'word'` или `'none'`.30713072***lmargin1*, *lmargin2***30733074Отступ в пикселях первой отображаемой строки логической строки и остальных отображаемых строк.30753076***lmargincolor***30773078Цвет левой области поля.30793080***rmargin***30813082Правое поле, в пикселях.30833084***rmargincolor***30853086Цвет правой области поля.30873088***spacing1*, *spacing2*, *spacing3***30893090Дополнительное пространство в пикселях над первой отображаемой строкой логической строки, между её отображаемыми строками и под её последней отображаемой строкой.30913092***tabs***30933094Набор позиций табуляции в той же форме, что и опция *tabs* виджета.30953096***tabstyle***30973098Как интерпретируются позиции табуляции: `'tabular'` или `'wordprocessor'`.30993100***selectbackground*, *selectforeground***31013102Цвет фона и текста, используемые для текста, когда он выделен.31033104> **Примечание**3105>3106> Tk 8.6 добавил опции *lmargincolor*, *overstrikefg*, *rmargincolor*, *selectbackground*, *selectforeground* и *underlinefg*.31073108[`tag_config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text.tag_config) является псевдонимом `tag_configure()`.31093110#### `tag_cget(tagName, option)`31113112Возвращает текущее значение опции конфигурации *option* для тега *tagName*.31133114#### `tag_names(index=None)`31153116Если *index* опущен, возвращает кортеж имён всех тегов, определённых в виджете; в противном случае возвращает только имена тегов, применённых к символу по *index*. Имена упорядочены от наименьшего приоритета к наибольшему.31173118#### `tag_ranges(tagName)`31193120Возвращает кортеж индексов, описывающих все диапазоны текста, помеченные тегом *tagName*. Результат чередует начальные и конечные индексы, так что элементы `2*i` и `2*i+1` ограничивают *i*-й диапазон.31213122#### `tag_nextrange(tagName, index1, index2=None)`31233124Ищет от *index1* (до *index2*, если задан) первый диапазон символов, помеченный тегом *tagName*, и возвращает кортеж из двух элементов с начальным и конечным индексами, или пустой кортеж, если такого диапазона нет.31253126#### `tag_prevrange(tagName, index1, index2=None)`31273128Ищет назад от *index1* (до *index2*, если задан) ближайший предшествующий диапазон символов, помеченный тегом *tagName*, и возвращает кортеж из двух элементов с начальным и конечным индексами, или пустой кортеж, если такого диапазона нет.31293130#### `tag_raise(tagName, aboveThis=None)`31313132Повышает приоритет тега *tagName* так, чтобы он был сразу над приоритетом *aboveThis*, или до наивысшего приоритета среди всех тегов, если *aboveThis* не указан. Если параметры отображения перекрывающихся тегов конфликтуют, побеждает тег с более высоким приоритетом.31333134#### `tag_lower(tagName, belowThis=None)`31353136Понижает приоритет тега *tagName* так, чтобы он был сразу под приоритетом *belowThis*, или до наинизшего приоритета среди всех тегов, если *belowThis* не указан.31373138#### `tag_bind(tagName, sequence, func, add=None)`31393140Привязывает событие *sequence* для символов, помеченных тегом *tagName*, к колбэку *func*, так что *func* вызывается, когда это событие происходит над таким символом. Если *add* равен true, привязка добавляется вместе с любыми существующими привязками для *sequence*; в противном случае она заменяет их. Работает как [`bind()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.bind) и возвращает идентификатор новой привязки.31413142#### `tag_unbind(tagName, sequence, funcid=None)`31433144Удаляет привязки события *sequence* для символов, помеченных *tagName*. Если указан *funcid*, удаляется только та привязка (возвращённая [`tag_bind()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text.tag_bind)) и её колбэк отменяется.31453146Изменено в версии 3.13: Если указан *funcid*, отвязывается только этот колбэк.31473148#### `image_create(index, cnf={}, **kw)`31493150Встраивает изображение в позиции *index* и возвращает имя, назначенное этому экземпляру изображения, которое затем можно использовать как индекс или передавать другим методам `image_*`. Параметры, задаваемые в *cnf* и *kw*, включают *image* (изображение Tk для отображения), *name* (базовое имя экземпляра), *align*, *padx* и *pady*.31513152#### `image_cget(index, option)`31533154Возвращает текущее значение параметра конфигурации *option* для встроенного изображения в позиции *index*.31553156#### `image_configure(index, cnf=None, **kw)`31573158Запрашивает или изменяет параметры конфигурации встроенного изображения в позиции *index*, как [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.configure), но применяется к этому изображению.31593160#### `image_names()`31613162Возвращает кортеж имён всех изображений, встроенных в виджет.31633164> **Примечание**3165>3166> Этот метод переопределяет унаследованный [`Misc.image_names()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.image_names), который возвращает имена всех изображений в интерпретаторе Tcl; этот метод недоступен для `Text`.31673168#### `window_create(index, cnf={}, **kw)`31693170Встраивает окно (любой виджет) в позиции *index*. Параметры, задаваемые в *cnf* и *kw*, включают *window* (виджет для встраивания), *create* (колбэк, создающий виджет по требованию), *align*, *stretch*, *padx* и *pady*. Встраиваемый виджет должен быть потомком родителя текстового виджета.31713172#### `window_cget(index, option)`31733174Возвращает текущее значение параметра конфигурации *option* для встроенного окна в позиции *index*.31753176#### `window_configure(index, cnf=None, **kw)`31773178Запрашивает или изменяет параметры конфигурации встроенного окна в позиции *index*, как [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.configure), но применяется к этому окну.31793180[`window_config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text.window_config) является псевдонимом `window_configure()`.31813182#### `window_names()`31833184Возвращает кортеж имён всех окон, встроенных в виджет.31853186#### `edit(*args)`31873188Низкоуровневая обёртка над виджет-командой Tk `edit`, управляющей механизмом undo/redo и флагом изменений; *args* – это подкоманда `edit` и её аргументы. Методы `edit_*()` ниже являются тонкими обёртками над ним и обычно более удобны.31893190#### `edit_modified(arg=None)`31913192Если *arg* опущен, возвращает текущее состояние флага изменений как `0` или `1`; флаг устанавливается автоматически при любой вставке или удалении текста. В противном случае устанавливает флаг в булево значение *arg*.31933194#### `edit_undo()`31953196Отменяет последнее действие редактирования, то есть все вставки и удаления, записанные в стек отмены после предыдущего разделителя, и переносит его в стек повтора. Вызывает [`TclError`](https://python-all.ru/3.14/library/tkinter.html#tkinter.TclError), если стек отмены пуст. Не действует, если параметр *undo* не равен true. Начиная с Tk 9.0, возвращает кортеж индексов, ограничивающих диапазоны текста, которые были изменены.31973198#### `edit_redo()`31993200Повторно применяет последнее отменённое действие редактирования, при условии, что после этого не было внесено изменений, и переносит его обратно в стек отмены. Вызывает [`TclError`](https://python-all.ru/3.14/library/tkinter.html#tkinter.TclError), если стек повтора пуст. Не действует, если параметр *undo* не равен true. Начиная с Tk 9.0, возвращает кортеж индексов, ограничивающих диапазоны текста, которые были изменены.32013202#### `edit_reset()`32033204Очищает стеки отмены и повтора.32053206#### `edit_separator()`32073208Добавляет разделитель в стек отмены, обозначая границу между действиями редактирования для отмены и повтора. Не действует, если параметр *undo* не равен true. Разделители вставляются автоматически, если параметр *autoseparators* равен true.32093210#### `search(pattern, index, stopindex=None, forwards=None, backwards=None, exact=None, regexp=None, nocase=None, count=None, elide=None)`32113212Ищет *pattern*, начиная с *index*, и возвращает индекс первого символа первого совпадения или пустую строку, если совпадений нет. Поиск останавливается на *stopindex*, если он задан; в противном случае он переходит через конец текста, пока снова не будет достигнута начальная позиция. Следующие логические флаги управляют поиском: *forwards* или *backwards* выбирают направление (по умолчанию – вперёд); *exact* (по умолчанию) или *regexp* выбирают литеральное или регулярное выражение; *nocase* делает поиск нечувствительным к регистру; а *elide* также включает скрытый текст. Если *count* является [`Variable`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable), в него сохраняется количество позиций индекса в совпадении.32133214#### `scan_mark(x, y)`32153216Запоминает *x*, *y* и текущий вид для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text.scan_dragto). Обычно привязывается к нажатию кнопки мыши в виджете.32173218#### `scan_dragto(x, y)`32193220Прокручивает виджет на разницу в 10 раз между *x*, *y* и координатами, переданными последнему вызову [`scan_mark()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text.scan_mark). Обычно привязывается к событиям движения мыши, создавая эффект перетаскивания текста на высокой скорости по окну.32213222#### `debug(boolean=None)`32233224Если *boolean* опущен, возвращает, включены ли проверки внутренней целостности B-дерева. В противном случае включает или отключает их. Эта настройка общая для всех текстовых виджетов и может заметно замедлить виджеты, содержащие большие объёмы текста.32253226#### `dump(index1, index2=None, command=None, **kw)`32273228Возвращает содержимое виджета от *index1* включительно до *index2* не включительно (или только сегмент на *index1*, если *index2* опущен), включая текст и информацию о метках, тегах, изображениях и окнах. Результат – список троек `(key, value, index)`, где *key* – одно из значений `'text'`, `'mark'`, `'tagon'`, `'tagoff'`, `'image'` или `'window'`. По умолчанию сообщаются все типы; передача любого из ключевых аргументов *all*, *text*, *mark*, *tag*, *image* или *window* со значением true ограничивает дамп выбранными типами. Если передан *command*, он вызывается один раз на каждую тройку с тремя значениями в качестве аргументов, и ничего не возвращается.32293230#### `peer_create(newPathName, cnf={}, **kw)`32313232Создаёт равноправный текстовый виджет с путём *newPathName*, который разделяет базовые данные этого виджета (текст, метки, теги, изображения и стек отмены). Изменения, сделанные через любой из равноправных виджетов, отражаются во всех них. По умолчанию равноправный виджет охватывает те же строки, что и данный виджет; могут быть заданы стандартные текстовые параметры, включая *startline* и *endline*, чтобы переопределить это.32333234Добавлено в версии 3.3.32353236#### `peer_names()`32373238Возвращает кортеж путей равноправных виджетов этого виджета, не включая сам виджет.32393240Добавлено в версии 3.3.32413242#### `yview_pickplace(*what)`32433244Настраивает вид так, чтобы местоположение, заданное *what*, стало видимым. Это устаревший эквивалент [`see()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text.see), который следует использовать вместо него.32453246### Классы переменных32473248#### `class tkinter.Variable(master=None, value=None, name=None)`32493250Базовый класс для обёрток переменных Tk. Переменная Tk – это значение, хранящееся в интерпретаторе Tcl, которое может быть связано с виджетами через их параметры *variable* или *textvariable* (см. [Связывание переменных виджетов](https://python-all.ru/3.14/library/tkinter.html#coupling-widget-variables)), так что изменения распространяются в обоих направлениях: обновление переменной обновляет все виджеты, привязанные к ней, а редактирование такого виджета пользователем обновляет переменную.32513252*master* – это виджет, интерпретатору Tcl которого принадлежит переменная; если опущен, используется корневое окно по умолчанию. *value* – начальное значение; если опущено, используется значение по умолчанию для данного типа. *name* – имя переменной в интерпретаторе Tcl; если опущено, генерируется уникальное имя вида `'PY_VARnum'`. Если *name* совпадает с существующей переменной, а *value* опущено, существующее значение сохраняется.32533254В большинстве случаев следует использовать один из типизированных подклассов ниже – [`StringVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.StringVar), [`IntVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.IntVar), [`DoubleVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.DoubleVar) или [`BooleanVar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.BooleanVar) – вместо `Variable` напрямую.32553256> **Примечание**3257>3258> Когда `Variable` удаляется сборщиком мусора, его переменная Tcl сбрасывается. Сохраняйте ссылку на неё до тех пор, пока виджет связан с ней, например, храня её как атрибут, а не в локальной переменной. В противном случае Tk воссоздаёт переменную Tcl для поддержания работы виджета, но она больше никогда не сбрасывается, что приводит к утечке одной переменной Tcl на каждую отброшенную обёртку.32593260Изменено в версии 3.10: Теперь две переменные сравниваются равными (`==`), только если они имеют одинаковое имя, принадлежат одному классу и одному интерпретатору Tcl.32613262#### `get()`32633264Возвращает текущее значение переменной. Для базового класса значение возвращается в виде строки; типизированные подклассы преобразуют его в соответствующий тип Python.32653266#### `set(value)`32673268Устанавливает переменную в *value*. [`initialize()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable.initialize) – это псевдоним `set()`.32693270Добавлено в версии 3.3: Написание *initialize*.32713272#### `trace_add(mode, callback)`32733274Регистрирует *колбэк*, который вызывается при доступе к переменной в соответствии с *mode*. *mode* – одна из строк `'array'`, `'read'`, `'write'` или `'unset'`, либо список или кортеж таких строк.32753276При срабатывании *колбэк* вызывается с тремя аргументами: имя переменной Tcl, индекс (или пустая строка, если переменная не является элементом массива) и *mode*, вызвавший срабатывание.32773278Возвращает внутреннее имя зарегистрированного колбэка, которое можно передать в [`trace_remove()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable.trace_remove).32793280Добавлено в версии 3.6.32813282#### `trace_remove(mode, cbname)`32833284Удаляет колбэк трассировки из переменной. *mode* должен совпадать с *mode*, переданным в [`trace_add()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable.trace_add), а *cbname* – это имя колбэка, возвращённое `trace_add()`.32853286Добавлено в версии 3.6.32873288#### `trace_info()`32893290Возвращает список пар `(modes, cbname)`, описывающих все трассировки, установленные на переменной, где *modes* – кортеж строк режимов, а *cbname* – внутреннее имя колбэка.32913292Добавлено в версии 3.6.32933294#### `trace_variable(mode, callback)`32953296Регистрирует *колбэк*, который вызывается при доступе к переменной в соответствии с *mode*. *mode* – одна из строк `'r'`, `'w'` или `'u'` для чтения, записи или удаления. Возвращает внутреннее имя зарегистрированного колбэка. [`trace()`](https://python-all.ru/3.14/library/trace.html#module-trace) – это псевдоним `trace_variable()`.32973298Устарело с версии 3.6: Вместо этого используйте [`trace_add()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable.trace_add). Этот метод оборачивает возможность Tcl, которая была удалена в Tcl 9.0.32993300#### `trace_vdelete(mode, cbname)`33013302Удаляет колбэк трассировки с именем *cbname*, зарегистрированный для *mode* с помощью [`trace_variable()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable.trace_variable).33033304Устарело с версии 3.6: Вместо этого используйте [`trace_remove()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable.trace_remove). Этот метод оборачивает возможность Tcl, которая была удалена в Tcl 9.0.33053306#### `trace_vinfo()`33073308Возвращает список пар `(mode, cbname)` для всех трассировок, установленных на переменной с помощью [`trace_variable()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable.trace_variable).33093310Устарело с версии 3.6: Вместо этого используйте [`trace_info()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable.trace_info). Этот метод оборачивает возможность Tcl, которая была удалена в Tcl 9.0.33113312#### `class tkinter.StringVar(master=None, value=None, name=None)`33133314Подкласс [`Variable`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable), хранящий строку. Значение по умолчанию – `''`.33153316#### `get()`33173318Возвращает значение переменной в виде [`str`](https://python-all.ru/3.14/library/stdtypes.html#str).33193320#### `class tkinter.IntVar(master=None, value=None, name=None)`33213322Подкласс [`Variable`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable), хранящий целое число. Значение по умолчанию – `0`.33233324#### `get()`33253326Возвращает значение переменной в виде [`int`](https://python-all.ru/3.14/library/functions.html#int).33273328#### `class tkinter.DoubleVar(master=None, value=None, name=None)`33293330Подкласс [`Variable`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable), хранящий число с плавающей точкой. Значение по умолчанию – `0.0`.33313332#### `get()`33333334Возвращает значение переменной в виде [`float`](https://python-all.ru/3.14/library/functions.html#float).33353336> **Примечание**3337>3338> Значение с плавающей точкой всегда разбирается с точкой (`.`) в качестве десятичного разделителя, но [`Spinbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Spinbox), [`Scale`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Scale) и [`ttk.Spinbox`](https://python-all.ru/3.14/library/tkinter.ttk.html#tkinter.ttk.Spinbox) форматируют его в соответствии с локалью `LC_NUMERIC`. В локали, использующей запятую, они выдают значение, которое [`get()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.DoubleVar.get) не может прочитать, вызывая [`TclError`](https://python-all.ru/3.14/library/tkinter.html#tkinter.TclError). Установите `LC_NUMERIC` на локаль, использующую точку (например, `'C'`), чтобы избежать этого.33393340#### `class tkinter.BooleanVar(master=None, value=None, name=None)`33413342Подкласс [`Variable`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Variable), который хранит булево значение. Значение по умолчанию – `False`.33433344#### `get()`33453346Возвращает значение переменной как [`bool`](https://python-all.ru/3.14/library/functions.html#bool). Вызывает [`ValueError`](https://python-all.ru/3.14/library/exceptions.html#ValueError), если значение не может быть интерпретировано как булево.33473348#### `set(value)`33493350Устанавливает переменную в *value*, преобразуя его в булево значение. [`initialize()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.BooleanVar.initialize) – псевдоним `set()`.33513352Добавлено в версии 3.3: Написание *initialize*.33533354### Классы изображений33553356#### `class tkinter.Image(imgtype, name=None, cnf={}, master=None, **kw)`33573358Базовый класс для изображений Tk. *imgtype* – это тип изображения Tk, один из `'photo'` или `'bitmap'`. Изображение – именованный объект, который может отображаться виджетами через их опцию *image*; удаление всех ссылок на объект `Image` удаляет базовое изображение Tk. Обычно создают [`PhotoImage`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PhotoImage) или [`BitmapImage`](https://python-all.ru/3.14/library/tkinter.html#tkinter.BitmapImage), а не напрямую `Image`.33593360Параметры конфигурации изображения задаются *cnf* и *kw* и могут быть запрошены и изменены позднее с помощью протокола отображения (используя `image[key]`) или метода [`configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Image.configure).33613362#### `configure(**kw)`33633364Изменяет один или несколько параметров конфигурации изображения. Допустимые параметры зависят от типа изображения; см. [`PhotoImage`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PhotoImage) и [`BitmapImage`](https://python-all.ru/3.14/library/tkinter.html#tkinter.BitmapImage). [`config()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Image.config) – псевдоним `configure()`.33653366#### `height()`33673368Возвращает высоту изображения в пикселях.33693370#### `width()`33713372Возвращает ширину изображения в пикселях.33733374#### `type()`33753376Возвращает тип изображения, то есть значение *imgtype*, с которым оно было создано (например, `'photo'` или `'bitmap'`).33773378#### `class tkinter.PhotoImage(name=None, cnf={}, master=None, **kw)`33793380Полноцветное изображение (тип изображения Tk `photo`), хранящееся внутри с различной степенью прозрачности для каждого пикселя. Может читать и записывать файлы GIF, PPM/PGM и (в Tk 8.6 и новее) PNG, читать файлы SVG (в Tk 9.0 и новее) и отображаться в виджетах. Наследует от [`Image`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Image).33813382Параметры конфигурации включают *data* (содержимое изображения в виде строки), *file* (имя файла для чтения содержимого), *format* (имя обработчика формата файла), *width* и *height* (размер изображения, используется при построении по частям), *gamma* и *palette*.33833384#### `blank()`33853386Очищает изображение; то есть устанавливает всё изображение без данных, так что оно отображается прозрачным, и фон окна, в котором оно отображается, просвечивает.33873388#### `cget(option)`33893390Возвращает текущее значение параметра конфигурации *option*.33913392#### `copy(*, from_coords=None, zoom=None, subsample=None)`33933394Возвращает новый `PhotoImage` с копией этого изображения.33953396*from\_coords* задаёт прямоугольную подобласть исходного изображения для копирования. Она должна быть кортежем или списком из 1–4 целых чисел `(x1, y1, x2, y2)`. `(x1, y1)` и `(x2, y2)` задают диагонально противоположные углы прямоугольника. Если *x2* и *y2* не указаны, они по умолчанию равны правому нижнему углу исходного изображения. Копируемые пиксели включают левый и верхний края прямоугольника, но не нижний или правый. Если *from\_coords* не задан, копируется всё исходное изображение.33973398Если указаны *zoom* или *subsample*, изображение преобразуется как в методах [`zoom()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PhotoImage.zoom) и [`subsample()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PhotoImage.subsample). Значением должно быть одно целое число или пара целых чисел.33993400Изменено в версии 3.13: Добавлены параметры *from\_coords*, *zoom* и *subsample*.34013402#### `copy_replace(sourceImage, *, from_coords=None, to=None, shrink=False, zoom=None, subsample=None, compositingrule=None)`34033404Копирует область из *sourceImage* (который должен быть `PhotoImage`) в это изображение, возможно с масштабированием пикселей и/или субдискретизацией. Если параметры не указаны, *sourceImage* копируется целиком в это изображение, начиная с координат `(0, 0)`.34053406Параметр *from\_coords* задаёт прямоугольную подобласть исходного изображения, которая будет скопирована, как в методе [`copy()`](https://python-all.ru/3.14/library/copy.html#module-copy).34073408*to* задаёт прямоугольную подобласть целевого изображения, которая будет затронута. Это должен быть кортеж или список из 1–4 целых чисел `(x1, y1, x2, y2)`. Если *x2* и *y2* не указаны, по умолчанию они равны `(x1, y1)` плюс размер исходной области (после субдискретизации и масштабирования, если они заданы). Если *x2* и *y2* указаны, исходная область при необходимости дублируется мозаичным способом для заполнения целевой области.34093410Если *shrink* истинно, размер целевого изображения при необходимости уменьшается так, чтобы копируемая область оказалась в правом нижнем углу изображения.34113412Если указаны *zoom* или *subsample*, изображение преобразуется как в методах [`zoom()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PhotoImage.zoom) и [`subsample()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PhotoImage.subsample). Значением должно быть одно целое число или пара целых чисел.34133414*compositingrule* определяет, как прозрачные пиксели исходного изображения объединяются с целевым изображением. При `'overlay'` (по умолчанию) старое содержимое целевого изображения остаётся видимым, как если бы исходное изображение было напечатано на прозрачной плёнке и наложено поверх целевого. При `'set'` старое содержимое целевого изображения отбрасывается, а исходное изображение используется как есть.34153416Добавлено в версии 3.13.34173418#### `data(format=None, *, from_coords=None, background=None, grayscale=False)`34193420Возвращает данные изображения.34213422*format* задаёт имя обработчика формата файла изображения. Если он не указан, данные возвращаются в виде кортежа (по одному элементу на строку) строк, содержащих разделённые пробелами (по одному элементу на пиксель/столбец) цвета в формате `#RRGGBB`.34233424*from\_coords* задаёт прямоугольную область изображения, которую нужно вернуть. Это должен быть кортеж или список из 1–4 целых чисел `(x1, y1, x2, y2)`. Если указаны только *x1* и *y1*, область простирается от `(x1, y1)` до правого нижнего угла изображения. Если заданы все четыре координаты, они определяют противоположные углы области по диагонали, включая `(x1, y1)` и исключая `(x2, y2)`. Если *from\_coords* не задан, возвращается всё изображение.34253426Если указан *background*, данные не содержат информации о прозрачности; во всех прозрачных пикселях цвет заменяется на указанный.34273428Если *grayscale* равен true, данные не содержат информации о цвете; все данные пикселей преобразуются в оттенки серого.34293430Добавлено в версии 3.13.34313432#### `get(x, y)`34333434Возвращает цвет пикселя по координатам (*x*, *y*) в виде `(r, g, b)` кортежа из трёх целых чисел от 0 до 255, представляющих красный, зелёный и синий компоненты соответственно.34353436#### `put(data, to=None)`34373438Устанавливает пиксели изображения в цвета, заданные в *data*, который должен быть строкой или вложенной последовательностью горизонтальных строк цветов пикселей (например, `"{red green} {blue yellow}"`).34393440*to* задаёт координаты области изображения, в которую копируются данные. Это должен быть кортеж или список из 2 или 4 целых чисел `(x1, y1)` или `(x1, y1, x2, y2)`, задающих левый верхний угол и, опционально, правый нижний угол области. Положение по умолчанию – `(0, 0)`.34413442#### `read(filename, format=None, *, from_coords=None, to=None, shrink=False)`34433444Читает данные изображения из файла с именем *filename* в изображение.34453446*format* задаёт формат данных изображения в файле.34473448*from\_coords* задаёт прямоугольную подобласть данных изображения из файла, которая будет скопирована в целевое изображение. Это должен быть кортеж или список из 1–4 целых чисел `(x1, y1, x2, y2)`. Если указаны только *x1* и *y1*, область простирается от `(x1, y1)` до правого нижнего угла изображения в файле. Если заданы все четыре координаты, они определяют противоположные углы области по диагонали. Если *from\_coords* не задан, читается всё изображение из файла.34493450*to* задаёт координаты левого верхнего угла области изображения, в которую читаются данные. По умолчанию – `(0, 0)`.34513452Если *shrink* истинно, размер изображения при необходимости уменьшается так, чтобы область, в которую читаются данные из файла, оказалась в правом нижнем углу изображения.34533454Добавлено в версии 3.13.34553456#### `subsample(x, y='', *, from_coords=None)`34573458Возвращает новый `PhotoImage` на основе данного изображения, но использующий только каждый *x*-й пиксель по оси X и каждый *y*-й пиксель по оси Y. Если *y* не указан, по умолчанию он равен *x*.34593460Параметр *from\_coords* задаёт прямоугольную подобласть исходного изображения, которая будет скопирована, как в методе [`copy()`](https://python-all.ru/3.14/library/copy.html#module-copy).34613462Изменено в версии 3.13: Добавлен параметр *from\_coords*.34633464#### `transparency_get(x, y)`34653466Возвращает `True`, если пиксель по координатам (*x*, *y*) полностью прозрачен, иначе `False`.34673468Добавлено в версии 3.8.34693470#### `transparency_set(x, y, boolean)`34713472Делает пиксель по координатам (*x*, *y*) полностью прозрачным, если *boolean* истинно, и полностью непрозрачным в противном случае.34733474Добавлено в версии 3.8.34753476#### `write(filename, format=None, from_coords=None, *, background=None, grayscale=False)`34773478Записывает данные изображения из изображения в файл с именем *filename*.34793480Параметр *format* задаёт имя обработчика формата файла изображения. Если он не указан, формат определяется по расширению файла.34813482Параметр *from\_coords* задаёт прямоугольную область изображения, которую нужно записать. Он должен быть кортежем или списком из 1–4 целых чисел `(x1, y1, x2, y2)`. Если указаны только *x1* и *y1*, область простирается от `(x1, y1)` до правого нижнего угла изображения. Если заданы все четыре координаты, они задают диагонально противоположные углы области. Если *from\_coords* не указан, записывается всё изображение.34833484Если указан *background*, данные не содержат информации о прозрачности; во всех прозрачных пикселях цвет заменяется на указанный.34853486Если *grayscale* равен true, данные не содержат информации о цвете; все данные пикселей преобразуются в оттенки серого.34873488Изменено в версии 3.13: Добавлены параметры *background* и *grayscale*.34893490#### `zoom(x, y='', *, from_coords=None)`34913492Возвращает новый `PhotoImage` с этим изображением, увеличенным в *x* раз по оси X и в *y* раз по оси Y. Если *y* не указан, по умолчанию используется то же значение, что и *x*.34933494Параметр *from\_coords* задаёт прямоугольную подобласть исходного изображения, которая будет скопирована, как в методе [`copy()`](https://python-all.ru/3.14/library/copy.html#module-copy).34953496Изменено в версии 3.13: Добавлен параметр *from\_coords*.34973498#### `class tkinter.BitmapImage(name=None, cnf={}, master=None, **kw)`34993500Двухцветное изображение (тип изображения Tk `bitmap`), созданное из X11-битовой карты. Каждый пиксель отображает цвет переднего плана, цвет фона или ничего (создавая эффект прозрачности). Наследует от [`Image`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Image).35013502Параметрами конфигурации являются *data* или *file* (исходная битовая карта, задаваемая строкой в формате X11 или именем файла в этом формате), *maskdata* или *maskfile* (маска битовой карты в тех же форматах), а также *foreground* и *background* (два цвета). Для пикселей, где маска равна нулю, изображение ничего не отображает; для остальных пикселей отображается цвет переднего плана, где исходный бит равен единице, и цвет фона, где он равен нулю. Если *background* установлен в пустую строку, фоновые пиксели становятся прозрачными.35033504`BitmapImage` не имеет собственных методов, кроме тех, что унаследованы от [`Image`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Image).35053506### Другие классы35073508#### `class tkinter.Event`35093510Контейнер для атрибутов события, передаваемого в колбэк, привязанный с помощью [`Misc.bind()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.bind). Экземпляр `Event` имеет следующие атрибуты, каждый из которых соответствует полю базового события Tk; в зависимости от типа события некоторые атрибуты могут быть установлены в строку `'??'`, чтобы указать, что они не имеют смысла. См. [Привязки и события](https://python-all.ru/3.14/library/tkinter.html#bindings-and-events).35113512#### `serial`35133514Серийный номер события.35153516#### `num`35173518Кнопка мыши, которая была нажата или отпущена (для событий кнопок).35193520#### `focus`35213522Указывает, имеет ли окно фокус (для событий `Enter` и `Leave`).35233524#### `height`35253526#### `width`35273528Новая высота и ширина окна (для событий `Configure` и `Expose`).35293530#### `keycode`35313532Код клавиши, которая была нажата или отпущена.35333534#### `state`35353536Состояние события в виде числа (для большинства событий) или строки (для событий `Visibility`).35373538#### `time`35393540Временная метка события в миллисекундах.35413542#### `x`35433544#### `y`35453546Положение указателя относительно виджета в пикселях.35473548#### `x_root`35493550#### `y_root`35513552Положение указателя относительно верхнего левого угла экрана, в пикселях.35533554#### `char`35553556Введённый символ в виде строки (для событий клавиш).35573558#### `send_event`35593560`True`, если событие было отправлено другим приложением.35613562#### `keysym`35633564Символическое имя клавиши, которая была нажата или отпущена.35653566#### `keysym_num`35673568Числовое значение [`keysym`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Event.keysym).35693570#### `type`35713572[`EventType`](https://python-all.ru/3.14/library/tkinter.html#tkinter.EventType) события.35733574#### `widget`35753576Виджет, на котором произошло событие.35773578#### `delta`35793580Величина, на которую было повёрнуто колесо мыши (для событий `MouseWheel`).35813582#### `class tkinter.EventType(*values)`35833584Перечисление [`enum.StrEnum`](https://python-all.ru/3.14/library/enum.html#enum.StrEnum), содержащее типы событий Tk, используемое в качестве значения [`Event.type`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Event.type). Его члены включают, среди прочего, `KeyPress`, `KeyRelease`, `ButtonPress`, `ButtonRelease`, `Motion`, `Enter`, `Leave`, `FocusIn`, `FocusOut`, `Configure`, `Map`, `Unmap`, `Expose`, `Destroy` и `MouseWheel`.35853586Добавлено в версии 3.6.35873588#### `class tkinter.CallWrapper(func, subst, widget)`35893590Внутренний вспомогательный класс, который оборачивает Python-колбэк, чтобы его можно было вызвать из Tcl. *func* – это Python-функция, *subst* – необязательная функция, которая предварительно обрабатывает аргументы Tcl, а *widget* – виджет, используемый для сообщения об ошибках. Экземпляры создаются автоматически с помощью [`Misc.register()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.register); этот класс обычно не используется напрямую.35913592### Функции уровня модуля35933594#### `tkinter.Tcl(screenName=None, baseName=None, className='Tk', useTk=False)`35953596Функция `Tcl()` – это фабричная функция, которая создаёт объект, очень похожий на тот, что создаётся классом [`Tk`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk), за исключением того, что она не инициализирует подсистему Tk. Она чаще всего полезна при работе с интерпретатором Tcl в среде, где не требуется создавать лишние окна верхнего уровня или где это невозможно (например, в системах Unix/Linux без X-сервера). Объект, созданный объектом `Tcl()`, может иметь окно Toplevel (и инициализированную подсистему Tk) при вызове его метода [`loadtk()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Tk.loadtk).35973598#### `tkinter.NoDefaultRoot()`35993600Подавляет создание неявного корневого окна по умолчанию. После этого `tkinter` больше не создаёт автоматически общий корневой элемент, а операции, которые от него зависят – например, создание виджета без явного *master* – вызывают исключение [`RuntimeError`](https://python-all.ru/3.14/library/exceptions.html#RuntimeError). Вызывайте эту функцию на раннем этапе в крупных приложениях, чтобы сделать корневое окно явным.36013602#### `tkinter.mainloop(n=0)`36033604Запускает главный цикл событий Tk на корневом окне по умолчанию, пока все окна не будут уничтожены. Эквивалентно вызову [`Misc.mainloop()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.mainloop) для корневого окна по умолчанию.36053606#### `tkinter.getboolean(s)`36073608Преобразует Tcl-строку логического типа *s* (одно из значений `'1'`, `'true'`, `'yes'`, `'on'` и подобных, или их ложные аналоги) в Python-объект [`bool`](https://python-all.ru/3.14/library/functions.html#bool). Вызывает [`TclError`](https://python-all.ru/3.14/library/tkinter.html#tkinter.TclError) для недопустимого значения.36093610#### `tkinter.getdouble(s)`36113612Преобразует *s* в число с плавающей запятой. Это встроенная функция [`float`](https://python-all.ru/3.14/library/functions.html#float).36133614#### `tkinter.getint(s)`36153616Преобразует *s* в целое число. Это встроенная функция [`int`](https://python-all.ru/3.14/library/functions.html#int).36173618#### `tkinter.image_names()`36193620Возвращает имена всех существующих изображений в интерпретаторе корневого окна по умолчанию.36213622#### `tkinter.image_types()`36233624Возвращает доступные типы изображений (например, `'photo'` и `'bitmap'`) в интерпретаторе корневого окна по умолчанию.36253626### Обработчики файлов36273628Tk позволяет регистрировать и удалять функцию обратного вызова, которая будет вызываться из главного цикла Tk, когда возможен ввод-вывод на файловом дескрипторе. Для каждого файлового дескриптора можно зарегистрировать только один обработчик. Пример кода:36293630```python3631import tkinter3632widget = tkinter.Tk()3633mask = tkinter.READABLE | tkinter.WRITABLE3634widget.tk.createfilehandler(file, mask, callback)3635...3636widget.tk.deletefilehandler(file)3637```36383639Эта функция недоступна в Windows.36403641Поскольку неизвестно, сколько байт доступно для чтения, не рекомендуется использовать методы [`BufferedIOBase`](https://python-all.ru/3.14/library/io.html#io.BufferedIOBase) или [`TextIOBase`](https://python-all.ru/3.14/library/io.html#io.TextIOBase) [`read()`](https://python-all.ru/3.14/library/io.html#io.BufferedIOBase.read) или [`readline()`](https://python-all.ru/3.14/library/io.html#io.IOBase.readline), так как они будут читать строго заданное количество байт. Для сокетов подойдут методы [`recv()`](https://python-all.ru/3.14/library/socket.html#socket.socket.recv) или [`recvfrom()`](https://python-all.ru/3.14/library/socket.html#socket.socket.recvfrom); для других файлов используйте необработанное чтение или `os.read(file.fileno(), maxbytecount)`.36423643#### `Widget.tk.createfilehandler(file, mask, func)`36443645Регистрирует функцию обратного вызова обработчика файла *func*. Аргумент *file* может быть объектом с методом [`fileno()`](https://python-all.ru/3.14/library/io.html#io.IOBase.fileno) (например, файлом или сокетом), либо целочисленным файловым дескриптором. Аргумент *mask* представляет собой комбинацию (побитовое ИЛИ) любых из трёх констант ниже. Колбэк вызывается следующим образом:36463647```python3648callback(file, mask)3649```36503651#### `Widget.tk.deletefilehandler(file)`36523653Удаляет обработчик файла.36543655#### `tkinter.READABLE`36563657#### `tkinter.WRITABLE`36583659#### `tkinter.EXCEPTION`36603661Константы, используемые в аргументе *mask*.36623663### Константы36643665Следующие символьные константы доступны в пространствах имён `tkinter` и `tkinter.constants`.36663667#### `tkinter.TRUE`36683669#### `tkinter.YES`36703671#### `tkinter.ON`36723673Истинные значения, все равны целому числу `1`.36743675#### `tkinter.FALSE`36763677#### `tkinter.NO`36783679#### `tkinter.OFF`36803681Ложные значения, все равны целому числу `0`.36823683#### `tkinter.N`36843685#### `tkinter.S`36863687#### `tkinter.E`36883689#### `tkinter.W`36903691#### `tkinter.NE`36923693#### `tkinter.NW`36943695#### `tkinter.SE`36963697#### `tkinter.SW`36983699#### `tkinter.NS`37003701#### `tkinter.EW`37023703#### `tkinter.NSEW`37043705#### `tkinter.CENTER`37063707Направления компаса (`'n'`, `'s'`, `'e'`, `'w'`, а также диагонали и грани) плюс `CENTER` (`'center'`), используются в качестве значений для опций *anchor* и *sticky*, а также методами, такими как [`Misc.grid_anchor()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Misc.grid_anchor).37083709#### `tkinter.LEFT`37103711#### `tkinter.RIGHT`37123713#### `tkinter.TOP`37143715#### `tkinter.BOTTOM`37163717Границы для опции *side* модуля packer (см. [`Pack.pack_configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Pack.pack_configure)).37183719#### `tkinter.X`37203721#### `tkinter.Y`37223723#### `tkinter.BOTH`37243725#### `tkinter.NONE`37263727Значения для опции *fill* модуля packer: `'x'`, `'y'`, `'both'` или `'none'`.37283729#### `tkinter.RAISED`37303731#### `tkinter.SUNKEN`37323733#### `tkinter.FLAT`37343735#### `tkinter.RIDGE`37363737#### `tkinter.GROOVE`37383739#### `tkinter.SOLID`37403741Значения для опции *relief*, управляющей трёхмерной границей виджета.37423743#### `tkinter.HORIZONTAL`37443745#### `tkinter.VERTICAL`37463747Значения для опции *orient* виджетов, таких как [`Scale`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Scale), [`Scrollbar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Scrollbar) и [`PanedWindow`](https://python-all.ru/3.14/library/tkinter.html#tkinter.PanedWindow).37483749#### `tkinter.CHAR`37503751#### `tkinter.WORD`37523753Значения для опции *wrap* виджета [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text), определяющей перенос строк по границам символов или слов.37543755#### `tkinter.BASELINE`37563757Значение выравнивания текста `'baseline'`.37583759#### `tkinter.INSIDE`37603761#### `tkinter.OUTSIDE`37623763Значения для параметра *bordermode* менеджера размещения (см. [`Place.place_configure()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Place.place_configure)).37643765#### `tkinter.INSERT`37663767#### `tkinter.CURRENT`37683769#### `tkinter.END`37703771#### `tkinter.ANCHOR`37723773#### `tkinter.SEL`37743775#### `tkinter.SEL_FIRST`37763777#### `tkinter.SEL_LAST`37783779Символические индексы, используемые виджетами [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text), [`Entry`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Entry), [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox) и [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas), такие как `'insert'` (курсор вставки), `'current'`, `'end'`, `'anchor'` и границы выделения (`'sel.first'` и `'sel.last'`).37803781#### `tkinter.ALL`37823783Специальный тег `'all'`, который соответствует каждому элементу [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas) или каждому символу [`Text`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Text) (например, `canvas.delete(ALL)`).37843785#### `tkinter.NORMAL`37863787#### `tkinter.DISABLED`37883789#### `tkinter.ACTIVE`37903791#### `tkinter.HIDDEN`37923793Значения для параметра *state* различных виджетов и элементов.37943795#### `tkinter.CASCADE`37963797#### `tkinter.CHECKBUTTON`37983799#### `tkinter.COMMAND`38003801#### `tkinter.RADIOBUTTON`38023803#### `tkinter.SEPARATOR`38043805Типы записей меню, используемые как аргумент *itemType* для [`Menu.add()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.add) и [`Menu.insert()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Menu.insert).38063807#### `tkinter.SINGLE`38083809#### `tkinter.BROWSE`38103811#### `tkinter.MULTIPLE`38123813#### `tkinter.EXTENDED`38143815Значения для параметра *selectmode* виджета [`Listbox`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Listbox).38163817#### `tkinter.PIESLICE`38183819#### `tkinter.CHORD`38203821#### `tkinter.ARC`38223823Значения для параметра *style* элемента [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas) arc.38243825#### `tkinter.BUTT`38263827#### `tkinter.PROJECTING`38283829#### `tkinter.ROUND`38303831#### `tkinter.BEVEL`38323833#### `tkinter.MITER`38343835Значения для параметров *capstyle* (`'butt'`, `'projecting'`, `'round'`) и *joinstyle* (`'round'`, `'bevel'`, `'miter'`) элементов линии [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas).38363837#### `tkinter.FIRST`38383839#### `tkinter.LAST`38403841Значения для параметра *arrow* элементов линии [`Canvas`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Canvas), указывающие, на каких концах установлены наконечники.38423843#### `tkinter.MOVETO`38443845#### `tkinter.SCROLL`38463847Первый аргумент, передаваемый [`Scrollbar`](https://python-all.ru/3.14/library/tkinter.html#tkinter.Scrollbar) в метод [`XView.xview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview) или [`YView.yview()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView.yview) прокручиваемого виджета.38483849#### `tkinter.UNITS`38503851#### `tkinter.PAGES`38523853Значения для аргумента *what* методов [`XView.xview_scroll()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.XView.xview_scroll) и [`YView.yview_scroll()`](https://python-all.ru/3.14/library/tkinter.html#tkinter.YView.yview_scroll).38543855#### `tkinter.UNDERLINE`38563857#### `tkinter.NUMERIC`38583859#### `tkinter.DOTBOX`38603861Другие значения параметров: `'underline'`, `'numeric'` и `'dotbox'`.3862