tkinter.md

1> **Источник:** https://python-all.ru/3.15/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.15/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 9.0. Обратитесь к исходному коду модуля [`_tkinter`](https://python-all.ru/3.15/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.15/glossary.html#term-optional-module). Если его нет в вашей копии CPython, обратитесь к документации от вашего дистрибьютора (то есть того, кто предоставил вам Python). Если вы дистрибьютор, обратитесь к [требованиям к опциональным модулям](https://python-all.ru/3.15/using/configure.html#optional-module-requirements).2829> **См. также**30>31> - **[TkDocs](https://python-all.ru/3.15/library/tkinter.html)**32>33>   Обширное руководство по созданию пользовательских интерфейсов с помощью Tkinter. Объясняет ключевые концепции и иллюстрирует рекомендуемые подходы с использованием современного API.34> - **[Справочник по Tkinter 8.5: GUI для Python](https://python-all.ru/3.15/library/tkinter.html)**35>36>   Справочная документация по Tkinter 8.5 с подробным описанием доступных классов, методов и опций.37>38> Ресурсы по Tcl/Tk:39>40> - **[Команды Tk](https://python-all.ru/3.15/library/tkinter.html)**41>42>   Исчерпывающий справочник по каждой из базовых команд Tcl/Tk, используемых Tkinter.43> - **[Домашняя страница Tcl/Tk](https://python-all.ru/3.15/library/tkinter.html)**44>45>   Дополнительная документация и ссылки на разработку ядра Tcl/Tk.46>47> Книги:48>49> - **[Современный Tkinter для занятых разработчиков Python](https://python-all.ru/3.15/library/tkinter.html)**50>51>   Автор: Mark Roseman. (ISBN 978-1999149567)52> - **[Программирование GUI на Python с помощью Tkinter](https://python-all.ru/3.15/library/tkinter.html)**53>54>   Автор: Alan D. Moore. (ISBN 978-1788835886)55> - **[Программирование на Python](https://python-all.ru/3.15/library/tkinter.html)**56>57>   Автор: Mark Lutz; отличное освещение Tkinter. (ISBN 978-0596158101)58> - **[Tcl и инструментарий Tk (2-е издание)](https://python-all.ru/3.15/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.15/library/tkinter.html#threading-model)).6970**Tk**7172Tk – это [пакет Tcl](https://python-all.ru/3.15/library/tkinter.html), реализованный на C, который добавляет пользовательские команды для создания и управления GUI-виджетами. Каждый объект [`Tk`](https://python-all.ru/3.15/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.15/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.15/library/tkinter.html#module-_tkinter), который затем вызывает интерпретатор Tcl для её выполнения. Интерпретатор Tcl, в свою очередь, обращается к пакетам Tk и/или Ttk, которые затем вызывают Xlib, Cocoa или GDI.8182## Модули Tkinter8384Поддержка Tkinter распределена по нескольким модулям. Большинству приложений понадобится основной модуль `tkinter`, а также модуль [`tkinter.ttk`](https://python-all.ru/3.15/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.15/library/tkinter.colorchooser.html#module-tkinter.colorchooser)**9899Диалоговое окно для выбора цвета пользователем.100101**[`tkinter.commondialog`](https://python-all.ru/3.15/library/dialog.html#module-tkinter.commondialog)**102103Базовый класс для диалогов, определённых в других перечисленных здесь модулях.104105**[`tkinter.filedialog`](https://python-all.ru/3.15/library/dialog.html#module-tkinter.filedialog)**106107Стандартные диалоги для указания файла для открытия или сохранения.108109**[`tkinter.font`](https://python-all.ru/3.15/library/tkinter.font.html#module-tkinter.font)**110111Утилиты для работы со шрифтами.112113**[`tkinter.messagebox`](https://python-all.ru/3.15/library/tkinter.messagebox.html#module-tkinter.messagebox)**114115Доступ к стандартным диалоговым окнам Tk.116117**[`tkinter.scrolledtext`](https://python-all.ru/3.15/library/tkinter.scrolledtext.html#module-tkinter.scrolledtext)**118119Текстовый виджет со встроенной вертикальной полосой прокрутки.120121**[`tkinter.simpledialog`](https://python-all.ru/3.15/library/dialog.html#module-tkinter.simpledialog)**122123Базовые диалоги и вспомогательные функции.124125**[`tkinter.ttk`](https://python-all.ru/3.15/library/tkinter.ttk.html#module-tkinter.ttk)**126127Набор тематических виджетов, представленный в Tk 8.5, предоставляющий современные альтернативы многим классическим виджетам из основного модуля `tkinter`.128129Дополнительные модули:130131**[`_tkinter`](https://python-all.ru/3.15/library/tkinter.html#module-_tkinter)**132133Двоичный модуль, содержащий низкоуровневый интерфейс к Tcl/Tk. Он автоматически импортируется основным модулем `tkinter` и никогда не должен использоваться напрямую программистами приложений. Обычно это разделяемая библиотека (или DLL), но в некоторых случаях может быть статически слинкована с интерпретатором Python.134135**[`idlelib`](https://python-all.ru/3.15/library/idle.html#module-idlelib)**136137Интегрированная среда разработки и обучения Python (IDLE). Основана на `tkinter`.138139**`tkinter.constants`**140141Символические константы, которые можно использовать вместо строк при передаче различных параметров вызовам Tkinter. Автоматически импортируются основным модулем `tkinter`.142143**[`tkinter.dnd`](https://python-all.ru/3.15/library/tkinter.dnd.html#module-tkinter.dnd)**144145(экспериментально) Поддержка перетаскивания для `tkinter`. Станет устаревшим, когда будет заменён на Tk DND.146147**[`turtle`](https://python-all.ru/3.15/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.15/library/tkinter.html#tkinter.Tk), который инициализирует Tk и создаёт связанный с ним интерпретатор Tcl. Она также создаёт главное окно, известное как корневое окно, которое служит основным окном приложения.173174Следующая строка создаёт виджет Frame, который в данном случае будет содержать метку и кнопку, которые мы создадим далее. Frame помещается внутрь корневого окна.175176Следующая строка создаёт виджет Label с текстовой строкой. Метод [`grid()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.grid) используется для указания относительного расположения (позиции) метки внутри содержащего её виджета Frame, аналогично тому, как работают таблицы в HTML.177178Затем создаётся виджет Button, который размещается справа от метки. При нажатии он вызывает метод [`destroy()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.destroy) корневого окна.179180Наконец, метод [`mainloop()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.mainloop) выводит всё на экран и реагирует на ввод пользователя до завершения программы.181182### Важные концепции Tk183184Даже эта простая программа иллюстрирует следующие ключевые концепции Tk:185186**виджеты**187188Пользовательский интерфейс Tkinter состоит из отдельных *виджетов*. Каждый виджет представлен объектом Python, создаваемым из классов, таких как [`ttk.Frame`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.Frame), [`ttk.Label`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.Label) и [`ttk.Button`](https://python-all.ru/3.15/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.15/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.15/library/functions.html#print), может помочь определить, что вам нужно.236237Чтобы узнать, какие параметры конфигурации доступны для любого виджета, вызовите его метод [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.configure), который возвращает словарь с различной информацией о каждом объекте, включая его значения по умолчанию и текущие значения. Используйте [`keys()`](https://python-all.ru/3.15/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.15/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.15/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.15/library/tkinter.ttk.html#tkinter.ttk.Button.invoke) есть на man-странице [ttk::button](https://python-all.ru/3.15/library/tkinter.html)), тогда как функции, принимающие виджет в качестве параметра, часто имеют собственную man-страницу (например, [grid](https://python-all.ru/3.15/library/tkinter.html)).276277Многие общие параметры и методы можно найти на man-страницах [options](https://python-all.ru/3.15/library/tkinter.html) или [ttk::widget](https://python-all.ru/3.15/library/tkinter.html), тогда как остальные находятся на man-странице конкретного класса виджета.278279Многие методы Tkinter имеют составные имена, например, [`winfo_x()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_x), [`winfo_height()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_height), [`winfo_viewable()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_viewable). Документацию по всем ним можно найти на man-странице [winfo](https://python-all.ru/3.15/library/tkinter.html).280281> **Примечание**282>283> Несколько сбивает с толку то, что у всех виджетов Tkinter есть методы, которые на самом деле не работают с виджетом, а действуют на глобальном уровне, независимо от какого-либо виджета. Примерами являются методы для доступа к буферу обмена или системному звонку. (Они реализованы как методы в базовом классе [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget), от которого наследуют все виджеты Tkinter).284285## Модель многопоточности286287Python и Tcl/Tk имеют очень разные модели многопоточности, которые `tkinter` пытается согласовать. При использовании потоков следует учитывать это.288289Интерпретатор Python может иметь множество связанных с ним потоков. В Tcl можно создавать несколько потоков, но каждый поток имеет отдельный экземпляр интерпретатора Tcl. Потоки также могут создавать более одного экземпляра интерпретатора, но каждый экземпляр может использоваться только тем потоком, который его создал.290291Каждый объект [`Tk`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tk), созданный `tkinter`, содержит интерпретатор Tcl. Он также отслеживает, какой поток создал этот интерпретатор. Вызовы `tkinter` могут производиться из любого потока Python. Внутренне, если вызов поступает из потока, отличного от создавшего объект `Tk`, в очередь событий интерпретатора помещается событие, и при его выполнении результат возвращается вызывающему потоку Python.292293Приложения Tcl/Tk обычно управляются событиями, то есть после инициализации интерпретатор запускает цикл событий (то есть [`Tk.mainloop`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.mainloop)) и реагирует на события. Поскольку он однопоточный, обработчики событий должны отвечать быстро, иначе они заблокируют обработку других событий. Чтобы избежать этого, длительные вычисления не должны выполняться в обработчике событий; их либо разбивают на более мелкие части с помощью таймеров, либо запускают в другом потоке. Это отличается от многих наборов инструментов для графического интерфейса, где графический интерфейс работает в полностью отдельном потоке от всего кода приложения, включая обработчики событий.294295Если интерпретатор Tcl не выполняет цикл событий и не обрабатывает события, любые вызовы `tkinter` из потоков, отличных от того, в котором работает интерпретатор Tcl, завершатся ошибкой.296297Существует ряд особых случаев:298299- Библиотеки Tcl/Tk, собранные без поддержки потоков, теперь встречаются редко: Tcl/Tk 9.0 (поставляемая версия) всегда поддерживает потоки, поэтому такая ситуация возникает только с некоторыми старыми сборками 8.x. Когда библиотека не поддерживает потоки, `tkinter` вызывает библиотеку из исходного потока Python, даже если он отличается от потока, создавшего интерпретатор Tcl. Глобальная блокировка гарантирует, что одновременно выполняется только один вызов.300- Хотя `tkinter` позволяет создать более одного экземпляра объекта [`Tk`](https://python-all.ru/3.15/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.15/library/tkinter.html)*.332333В этом документе не делается различий между стандартными и специфичными для виджета параметрами. Некоторые параметры не применимы к некоторым типам виджетов. Реагирует ли данный виджет на определённый параметр, зависит от класса виджета: кнопки имеют параметр `command`, а метки – нет.334335Параметры, поддерживаемые данным виджетом, перечислены на его man-странице, или их можно запросить во время выполнения, вызвав метод [`config()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.config) без аргументов, или вызвав метод [`keys()`](https://python-all.ru/3.15/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.15/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.15/library/tkinter.html#tkinter.StringVar), [`IntVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.IntVar), [`DoubleVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.DoubleVar) и [`BooleanVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.BooleanVar). Чтобы прочитать текущее значение такой переменной, вызовите у неё метод [`get()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable.get), а чтобы изменить значение – метод `set()`. Если следовать этому протоколу, виджет будет всегда отслеживать значение переменной без дополнительных действий с вашей стороны.407408Сохраняйте ссылку на переменную всё время, пока виджет её использует, например, храня её в виде атрибута (см. [`Variable`](https://python-all.ru/3.15/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.15/library/tkinter.html#tkinter.Wm). Виджеты верхнего уровня являются подклассами класса `Wm`, поэтому могут напрямую вызывать методы `Wm`.447448Чтобы получить окно верхнего уровня, содержащее данный виджет, можно просто обратиться к [`master`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tk.master) виджета. Конечно, если виджет был упакован внутри рамки, `master` не будет представлять окно верхнего уровня. Чтобы получить окно верхнего уровня, содержащее произвольный виджет, можно вызвать метод [`winfo_toplevel()`](https://python-all.ru/3.15/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.15/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.15/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.15/library/tkinter.html#tkinter.Text) привязывает `Control`-`t` для транспозиции двух символов. Они описаны в разделе привязок страницы руководства Tk для данного виджета (например, *[text(3tk)](https://python-all.ru/3.15/library/tkinter.html)* или *[entry(3tk)](https://python-all.ru/3.15/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.15/library/tkinter.html#tkinter.Image):613614- [`BitmapImage`](https://python-all.ru/3.15/library/tkinter.html#tkinter.BitmapImage) для изображений в формате XBM.615- [`PhotoImage`](https://python-all.ru/3.15/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.15/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.15/library/tkinter.html#tkinter.Tk) и, через [`BaseWidget`](https://python-all.ru/3.15/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.15/library/tkinter.html#tkinter.Misc.config) является псевдонимом `configure()`.650651#### `keys()`652653Возвращает список имён всех опций конфигурации данного виджета.654655#### `getboolean(s)`656657Интерпретирует строку *s* как логическое значение Tcl и возвращает соответствующее [`bool`](https://python-all.ru/3.15/library/functions.html#bool). Tcl принимает такие значения, как `'1'`, `'0'`, `'yes'`, `'no'`, `'true'` и `'false'`. Вызывает [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError), если *s* не является допустимым логическим значением.658659#### `getdouble(s)`660661Интерпретирует строку *s* как число с плавающей запятой Tcl и возвращает его в виде [`float`](https://python-all.ru/3.15/library/functions.html#float). Вызывает [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError), если *s* не является допустимым числом.662663Добавлено в версии 3.5.664665#### `getint(s)`666667Интерпретирует строку *s* как целое число Tcl и возвращает его как [`int`](https://python-all.ru/3.15/library/functions.html#int). Вызывает [`ValueError`](https://python-all.ru/3.15/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.15/library/tkinter.html#tkinter.Variable), такой как [`StringVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.StringVar) или [`IntVar`](https://python-all.ru/3.15/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.15/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.15/library/tkinter.html#tkinter.Misc.lift) является псевдонимом `tkraise()`.706707#### `lower(belowThis=None)`708709Опускает данный виджет в стеке порядка, чтобы он отображался под своими соседями. Если указан *belowThis*, виджет перемещается непосредственно под этим элементом в стеке порядка.710711[`tkraise()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.tkraise)/[`lift()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.lift) и `lower()` переопределяются в виджете [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas), где они вместо этого переупорядочивают элементы canvas.712713#### `image_names()`714715Возвращает имена всех изображений, которые на данный момент существуют в интерпретаторе Tcl.716717Это переопределяется в виджете [`Text`](https://python-all.ru/3.15/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.15/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.15/library/tkinter.html#tkinter.Misc.bbox) – это псевдоним `grid_bbox()`, за исключением [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox), [`Spinbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox), [`Text`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text), [`ttk.Entry`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.Entry) и [`ttk.Treeview`](https://python-all.ru/3.15/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.15/library/tkinter.html#tkinter.Misc.columnconfigure) является псевдонимом `grid_columnconfigure()`.760761#### `grid_rowconfigure(index, cnf={}, **kw)`762763Запрашивает или задаёт свойства строки (или строк) *index* сетки, управляемой этим контейнером. *index* интерпретируется так же, как для [`grid_columnconfigure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_columnconfigure), а поддерживаемые опции (*minsize*, *weight*, *uniform* и *pad*) те же, но применяются к строке, а не к столбцу.764765[`rowconfigure()`](https://python-all.ru/3.15/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.15/library/tkinter.html#tkinter.Misc.size) – это псевдоним `grid_size()`, за исключением виджета [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox), который предоставляет собственный метод `size()`.782783#### `grid_slaves(row=None, column=None)`784785Возвращает список дочерних виджетов, управляемых в сетке этого контейнера, начиная с последнего добавленного. Если указаны *row* или *column*, возвращаются только дочерние элементы в этой строке или столбце.786787#### `grid_content(row=None, column=None)`788789То же, что [`grid_slaves()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_slaves): возвращает дочерние виджеты, управляемые в сетке этого контейнера, с возможностью ограничения по заданной *строке* или *столбцу*.790791Добавлено в версии 3.15.792793#### `pack_propagate()`794795#### `pack_propagate(flag)`796797Включает или отключает распространение геометрии для этого контейнера, когда он управляет своими дочерними элементами с помощью менеджера геометрии pack. Когда *flag* равен true, контейнер изменяет свой размер, чтобы соответствовать запрошенным размерам дочерних элементов; когда false, его размер остаётся под вашим контролем. При вызове без аргументов возвращает текущую настройку в виде булева значения.798799[`propagate()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.propagate) является псевдонимом `pack_propagate()`.800801#### `pack_slaves()`802803Возвращает список дочерних виджетов, управляемых этим контейнером с помощью менеджера геометрии pack, в порядке упаковки.804805[`slaves()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.slaves) является псевдонимом `pack_slaves()`.806807#### `pack_content()`808809То же, что [`pack_slaves()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.pack_slaves): возвращает дочерние виджеты, управляемые этим контейнером с помощью менеджера геометрии pack, в порядке упаковки.810811[`content()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.content) является псевдонимом `pack_content()`.812813Добавлено в версии 3.15.814815#### `place_slaves()`816817Возвращает список дочерних виджетов, управляемых этим контейнером с помощью менеджера геометрии place.818819#### `place_content()`820821То же, что [`place_slaves()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.place_slaves): возвращает дочерние виджеты, управляемые этим контейнером с помощью менеджера геометрии place.822823Добавлено в версии 3.15.824825Методы с префиксами `bind` и `unbind` связывают шаблоны событий с колбэками и удаляют эти связи.826827#### `bind(sequence=None, func=None, add=None)`828829Привязывает шаблон события *sequence* на этом виджете к вызываемому объекту *func*.830831*sequence* – это шаблон события, например `'<Button-1>'` (щелчок мыши) или `'<KeyPress-a>'`, и, возможно, объединение нескольких таких шаблонов, которые должны произойти один за другим. При наступлении события *func* вызывается с экземпляром [`Event`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Event), описывающим его, в качестве единственного аргумента; если *func* возвращает строку `'break'`, дальнейшие привязки для этого события не вызываются.832833Если *add* равен true, *func* добавляется к любым функциям, уже привязанным к *sequence*; в противном случае он заменяет их. Привязка применяется только к этому виджету.834835`bind()` возвращает строковый идентификатор (*funcid*), который впоследствии можно передать в [`unbind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.unbind), чтобы удалить привязку без утечки связанной команды Tcl.836837Если *func* опущен, вернуть привязку, связанную с *sequence*; если также опущен *sequence*, вернуть список всех последовательностей, для которых существуют привязки на этом виджете.838839#### `bind_class(className, sequence=None, func=None, add=None)`840841Как [`bind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind), но привязывает *func* к тегу привязки *className*, а не к отдельному виджету, так что привязка применяется к каждому виджету, имеющему этот тег. *className* обычно является именем класса виджета, например `'Button'`, в этом случае привязка влияет на все виджеты этого класса. Набор тегов привязки для виджета можно просмотреть и изменить с помощью [`bindtags()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bindtags).842843Остальные аргументы и возвращаемое значение такие же, как для [`bind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind).844845#### `bind_all(sequence=None, func=None, add=None)`846847Как [`bind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind), но привязывает *func* к специальному тегу привязки `'all'`, так что привязка применяется к каждому виджету в приложении.848849Остальные аргументы и возвращаемое значение такие же, как для [`bind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind).850851#### `unbind(sequence, funcid=None)`852853Удаляет привязки для шаблона события *sequence* на этом виджете.854855Если указан *funcid*, удаляется только функция, идентифицируемая им (значение, возвращённое предыдущим вызовом [`bind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind)), а связанная с ней команда Tcl удаляется. В противном случае уничтожаются все привязки для *sequence*, и он остаётся непривязанным.856857Изменено в версии 3.13: Если указан *funcid*, отвязывается только этот колбэк; остальные колбэки, привязанные к *sequence*, сохраняются.858859#### `unbind_class(className, sequence)`860861Удаляет все привязки для шаблона события *sequence* из тега привязки *className*. См. [`bind_class()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind_class).862863#### `unbind_all(sequence)`864865Удаляет все привязки для шаблона события *sequence* из специального тега привязки `'all'`. См. [`bind_all()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind_all).866867#### `bindtags(tagList=None)`868869Если *tagList* опущен, возвращает кортеж тегов привязки, связанных с этим виджетом. Когда в виджете происходит событие, оно применяется к каждому из тегов привязки виджета по порядку, и для каждого тега выполняется наиболее подходящая привязка. По умолчанию виджет имеет четыре тега привязки: собственное имя пути, его класс виджета, имя пути ближайшего предка верхнего уровня и `'all'`, именно в таком порядке.870871Если указан *tagList*, он должен быть последовательностью строк; теги привязки виджета устанавливаются равными его элементам, что определяет порядок, в котором вычисляются привязки.872873Методы с префиксом `event_` определяют виртуальные события и генерируют события программно.874875#### `event_add(virtual, *sequences)`876877Связывает виртуальное событие *virtual*, имя которого имеет форму `'<<Paste>>'`, с каждым из физических шаблонов событий, заданных *sequences*, так что виртуальное событие срабатывает всякий раз, когда происходит любое из них. Если *virtual* уже определён, новые последовательности добавляются к уже существующим.878879#### `event_delete(virtual, *sequences)`880881Удаляет каждую из *sequences* из тех, что связаны с виртуальным событием *virtual*. Последовательности, которые в данный момент не связаны с *virtual*, игнорируются. Если *sequences* не указаны, удаляются все физические последовательности событий, так что *virtual* больше не срабатывает.882883#### `event_generate(sequence, **kw)`884885Генерирует событие *sequence* на этом виджете и обеспечивает его обработку так, как если бы оно поступило от оконной системы. *sequence* должен быть одиночным шаблоном события, например `'<Button-1>'` или `'<<Paste>>'`, а не объединением нескольких. Именованные аргументы задают дополнительные поля события, например *x* и *y* для положения указателя, или *when* для управления моментом обработки события; полный список приведён на странице руководства Tk `event`.886887#### `event_info(virtual=None)`888889Если *virtual* опущен, возвращает кортеж всех виртуальных событий, которые в настоящее время определены. Если указан *virtual*, возвращает кортеж физических последовательностей событий, связанных с ним в настоящее время, или пустой кортеж, если он не определён.890891Методы с префиксом `after` планируют выполнение колбэков после задержки или когда приложение находится в состоянии простоя.892893#### `after(ms, func=None, *args, **kw)`894895Планирует вызов вызываемого объекта *func* через *ms* миллисекунд с передачей ему *args* и *kw* в качестве позиционных и именованных аргументов. Возвращает идентификатор, который можно передать в [`after_cancel()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.after_cancel) для отмены вызова.896897Если *func* опущен, вместо этого приостановить выполнение на *ms* миллисекунд, не обрабатывая события в течение этого времени, и вернуть `None`.898899Изменено в версии 3.10: *func* теперь может быть любым вызываемым объектом, а не только функцией.900901Изменено в версии 3.14: Именованные аргументы теперь передаются в *func*.902903#### `after_cancel(id)`904905Отменяет колбэк, ранее запланированный с помощью [`after()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.after) или [`after_idle()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.after_idle). *id* должен быть идентификатором, возвращённым одним из этих методов; передача значения, не являющегося таким идентификатором, вызывает [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError). Если колбэк уже выполнен или отменён, это не оказывает эффекта.906907Изменено в версии 3.7: Передача `None` (или любого ложного значения) в качестве *id* теперь вызывает [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError).908909#### `after_idle(func, *args, **kw)`910911Планирует вызов вызываемого объекта *func* с передачей ему *args* и *kw*, когда главный цикл Tk в следующий раз станет бездействующим, то есть когда у него не будет других событий для обработки. Возвращает идентификатор, который можно передать в [`after_cancel()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.after_cancel) для отмены вызова.912913Изменено в версии 3.14: Именованные аргументы теперь передаются в *func*.914915#### `after_info(id=None)`916917Если *id* опущен, возвращает кортеж идентификаторов всех колбэков, текущих запланированных с помощью [`after()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.after) и [`after_idle()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.after_idle) для данного интерпретатора.918919Если *id* указан, он должен идентифицировать колбэк, который ещё не выполнен или не отменён, и возвращаемое значение представляет собой кортеж `(script, type)`, где *script* ссылается на вызываемую функцию, а *type* – это либо `'idle'`, либо `'timer'`. Вызывается [`TclError`](https://python-all.ru/3.15/library/tkinter.html#tkinter.TclError), если *id* не существует.920921Добавлено в версии 3.13.922923#### `mainloop(n=0)`924925Входит в цикл событий Tk, который обрабатывает события до тех пор, пока все окна не будут уничтожены. Обычно вызывается один раз, на корневом окне, для запуска приложения.926927#### `quit()`928929Завершает интерпретатор Tcl, в результате чего [`mainloop()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.mainloop) возвращает управление.930931#### `update()`932933Входит в цикл событий до тех пор, пока все ожидающие события, включая бездействующие колбэки, не будут обработаны. Это обновляет отображение и обрабатывает любые события, которые уже находятся в очереди, после чего возвращает управление.934935#### `update_idletasks()`936937Входит в цикл событий до тех пор, пока не будут вызваны все ожидающие бездействующие колбэки. Это обновляет отображение окон, например после изменения геометрии, но не обрабатывает события, вызванные пользователем.938939#### `wait_variable(name)`940941Ожидает, пока переменная Tcl *name* не будет изменена, продолжая при этом обрабатывать события, чтобы приложение оставалось отзывчивым. *name* обычно является экземпляром [`Variable`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable), таким как [`IntVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.IntVar) или [`StringVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.StringVar).942943[`waitvar()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.waitvar) является псевдонимом `wait_variable()`.944945#### `wait_window(window=None)`946947Ожидает, пока *window* не будет уничтожено, продолжая при этом обрабатывать события. Если *window* опущен, используется данный виджет. Обычно используется для ожидания завершения взаимодействия пользователя с диалоговым окном.948949#### `wait_visibility(window=None)`950951Ожидает, пока состояние видимости *window* не изменится, например, когда оно впервые появляется на экране, продолжая при этом обрабатывать события. Если *window* опущен, используется данный виджет. Обычно используется для ожидания, пока новое окно не станет видимым, прежде чем выполнять с ним какие-либо действия.952953Методы с префиксом `focus_` управляют фокусом ввода с клавиатуры.954955#### `focus()`956957Направляет фокус ввода с клавиатуры для дисплея данного виджета на этот виджет. Если приложение в данный момент не имеет фокуса ввода на дисплее этого виджета, виджет запоминается как окно фокуса для своего верхнего уровня, и фокус будет перенаправлен на него в следующий раз, когда оконный менеджер передаст фокус верхнему уровню. `focus()` – это псевдоним `focus_set()`, за исключением виджетов [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas) и [`ttk.Treeview`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.Treeview), которые предоставляют собственный метод `focus()`.958959#### `focus_force()`960961Направляет фокус ввода с клавиатуры на этот виджет, даже если приложение в данный момент не имеет фокуса ввода для дисплея виджета. Этот метод следует использовать с осторожностью, если вообще использовать; обычно приложению следует дожидаться, пока оконный менеджер сам передаст ему фокус, а не захватывать его.962963#### `focus_get()`964965Возвращает виджет, который в данный момент имеет фокус клавиатуры в приложении, или `None`, если ни один виджет в приложении не имеет фокуса. Используйте [`focus_displayof()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.focus_displayof) для корректной работы с несколькими дисплеями.966967#### `focus_displayof()`968969Возвращает виджет, который в данный момент имеет фокус клавиатуры на дисплее, где расположен этот виджет, или `None`, если ни один виджет в приложении не имеет фокуса на этом дисплее.970971#### `focus_lastfor()`972973Возвращает последний виджет, который имел фокус клавиатуры среди всех виджетов на том же верхнем уровне, что и этот виджет; это виджет, который получит фокус в следующий раз, когда оконный менеджер передаст фокус этому верхнему уровню. Если ни один виджет на этом верхнем уровне никогда не имел фокуса, или если последний виджет с фокусом был удалён, возвращается сам верхний уровень.974975#### `tk_focusFollowsMouse()`976977Перенастраивает Tk на использование неявной модели фокуса, в которой фокус устанавливается на виджет при входе в него указателя мыши. После включения эту модель непросто отключить.978979#### `tk_focusNext()`980981Возвращает следующий виджет после данного в порядке обхода клавиатуры, или `None`, если такого нет. Порядок обхода: сначала следующий дочерний элемент, затем рекурсивно дочерние элементы этого дочернего элемента, а затем следующий родственный элемент, расположенный выше в порядке наложения. Виджет пропускается, если его опция `takefocus` имеет значение `0`. Этот метод используется в привязках по умолчанию для клавиши `Tab`.982983#### `tk_focusPrev()`984985Возвращает предыдущий виджет перед данным в порядке обхода клавиатуры, или `None`, если такого нет. См. [`tk_focusNext()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.tk_focusNext) для описания порядка. Этот метод используется в привязках по умолчанию для клавиши `Shift`-`Tab`.986987Методы с префиксом `grab_` устанавливают и запрашивают захват ввода, который направляет все события ввода на один виджет.988989#### `grab_set()`990991Устанавливает локальный захват на этот виджет. Захват ограничивает события указателя этим виджетом и его потомками: пока указатель находится вне поддерева виджета, нажатия и отпускания кнопок, а также перемещения указателя передаются виджету захвата, а окна за пределами поддерева становятся нечувствительными до освобождения захвата. Локальный захват влияет только на приложение, которое его установило. Любой предыдущий захват, установленный этим приложением на дисплее виджета, автоматически освобождается. Установка захвата – обычный способ сделать диалог модальным: пока захват активен, пользователь не может взаимодействовать с другими окнами приложения.992993#### `grab_set_global()`994995Устанавливает глобальный захват на этот виджет. Глобальный захват подобен локальному захвату, устанавливаемому методом [`grab_set()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grab_set), но он блокирует все остальные приложения на экране, так что только поддерево этого виджета чувствительно к событиям указателя, а также захватывает клавиатуру. Следует соблюдать осторожность: глобальный захват может легко сделать дисплей неработоспособным, поскольку другие приложения перестают получать события до его освобождения.996997#### `grab_release()`998999Освобождает захват на этот виджет, если он установлен; в противном случае ничего не делает.10001001#### `grab_current()`10021003Возвращает виджет, который в данный момент удерживает захват в этом приложении для дисплея данного виджета, или `None`, если такого виджета нет.10041005#### `grab_status()`10061007Возвращает `None`, если на данный момент на этом виджете не установлен захват, `"local"`, если установлен локальный захват, или `"global"`, если установлен глобальный захват.10081009Методы с префиксом `selection_` извлекают и управляют X-выделением.10101011#### `selection_clear(**kw)`10121013Очищает X-выделение, так чтобы ни одно окно больше не владело им. Очищаемое выделение задаётся именованным аргументом *selection*, именем атома, таким как `'PRIMARY'` или `'CLIPBOARD'`; по умолчанию используется `PRIMARY`. Именованный аргумент *displayof* задаёт виджет, определяющий дисплей, на котором следует выполнять операцию; по умолчанию используется этот виджет.10141015Это переопределяется виджетами [`Entry`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry), [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox) и [`Spinbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox), где `selection_clear()` вместо этого очищает собственное выделение виджета.10161017#### `selection_get(**kw)`10181019Возвращает содержимое текущего X-выделения. Именованный аргумент *selection* задаёт имя выделения; по умолчанию используется `PRIMARY`. Именованный аргумент *type* указывает форму, в которой должны быть возвращены данные (нужный целевой тип преобразования) – имя атома, такое как `'STRING'` или `'FILE_NAME'`; по умолчанию используется `STRING`, за исключением X11, где сначала пробуется `UTF8_STRING`, а в качестве запасного варианта применяется `STRING`. Именованный аргумент *displayof* задаёт виджет, определяющий дисплей, с которого следует получить выделение; по умолчанию используется этот виджет.10201021#### `selection_handle(command, **kw)`10221023Регистрирует *command* как обработчик для предоставления X-выделения, которым владеет этот виджет, когда другое приложение запрашивает его. При извлечении выделения *command* вызывается с двумя аргументами: начальным смещением символа и максимальным количеством возвращаемых символов; он должен вернуть не более этого количества символов выделения, начиная с указанного смещения; для очень длинных выделений он вызывается многократно с увеличивающимися смещениями. Именованный аргумент *selection* задаёт имя выделения (по умолчанию `PRIMARY`), а именованный аргумент *type* указывает форму выделения, которую предоставляет обработчик (например, `'STRING'` или `'FILE_NAME'`, по умолчанию `STRING`).10241025#### `selection_own(**kw)`10261027Делает этот виджет владельцем X-выделения на его дисплее. Предыдущий владелец, если он был, уведомляется о потере выделения. Именованный аргумент *selection* задаёт имя выделения; по умолчанию используется `PRIMARY`.10281029#### `selection_own_get(**kw)`10301031Возвращает виджет в этом приложении, которому принадлежит выделение X на дисплее, содержащем этот виджет, или `None`, если ни один виджет в этом приложении не владеет выделением. Именованный аргумент *selection* задаёт название выделения; значение по умолчанию – `PRIMARY`. Именованный аргумент *displayof* задаёт виджет, определяющий запрашиваемый дисплей; значение по умолчанию – этот виджет.10321033Методы с префиксом `clipboard_` управляют буфером обмена.10341035#### `clipboard_append(string, **kw)`10361037Добавляет *string* в буфер обмена Tk и заявляет права владения буфером обмена на дисплее этого виджета. Перед добавлением буфер обмена следует очистить с помощью [`clipboard_clear()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.clipboard_clear); все добавления должны быть завершены до возврата в цикл событий, чтобы буфер обмена обновился атомарно. Именованный аргумент *type* задаёт форму данных – имя атома, например `'STRING'` или `'FILE_NAME'` (по умолчанию `STRING`), а именованный аргумент *format* задаёт представление, используемое для передачи (по умолчанию `STRING`). Именованный аргумент *displayof* задаёт виджет, определяющий целевой дисплей; значение по умолчанию – этот виджет. Содержимое можно получить с помощью [`clipboard_get()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.clipboard_get) или [`selection_get()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.selection_get).10381039#### `clipboard_clear(**kw)`10401041Заявляет права владения буфером обмена на дисплее этого виджета и удаляет предыдущее содержимое. Именованный аргумент *displayof* задаёт виджет, определяющий целевой дисплей; значение по умолчанию – этот виджет.10421043#### `clipboard_get(**kw)`10441045Извлекает данные из буфера обмена на дисплее этого виджета. Именованный аргумент *type* задаёт форму, в которой должны быть возвращены данные – имя атома, например `'STRING'` или `'FILE_NAME'`; по умолчанию `STRING`, за исключением X11, где сначала пробуется `UTF8_STRING`, а `STRING` используется как запасной вариант. Именованный аргумент *displayof* задаёт виджет, определяющий дисплей; значение по умолчанию – корневое окно приложения. Это эквивалентно `selection_get(selection='CLIPBOARD')`.10461047Методы с префиксом `option_` запрашивают и изменяют базу данных опций Tk.10481049#### `option_add(pattern, value, priority=None)`10501051Добавляет опцию в базу данных опций Tk, связывающую *value* с *pattern*. *pattern* состоит из имён и/или классов, разделённых звёздочками или точками, в обычном формате X. *priority* – целое число от 0 до 100 или одно из символических имён `'widgetDefault'` (20), `'startupFile'` (40), `'userDefault'` (60) или `'interactive'` (80); по умолчанию `interactive`.10521053#### `option_clear()`10541055Очищает базу данных опций Tk. Опции по умолчанию из свойства `RESOURCE_MANAGER` или файла `.Xdefaults` автоматически перезагружаются при следующем добавлении или удалении опции из базы.10561057#### `option_get(name, className)`10581059Возвращает значение опции из базы данных опций Tk, соответствующей этому виджету по *name* и *className*, или пустую строку, если соответствующей записи нет. Если совпадает несколько записей, возвращается та, у которой наивысший приоритет, а среди записей с равным приоритетом – добавленная последней.10601061#### `option_readfile(fileName, priority=None)`10621063Читает файл с именем *fileName*, который должен иметь стандартный формат базы данных ресурсов X, например `.Xdefaults`, и добавляет все указанные в нём опции в базу данных опций Tk. *priority* интерпретируется так же, как для [`option_add()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.option_add), и по умолчанию равен `interactive`.10641065#### `bell(displayof=0)`10661067Воспроизводит звонок на дисплее этого виджета, используя текущие настройки звонка дисплея, и сбрасывает хранитель экрана для экрана. Если *displayof* задан как виджет, звонок воспроизводится на дисплее этого виджета.10681069#### `tk_setPalette(background, /)`10701071#### `tk_setPalette(*args, **kw)`10721073Устанавливает новую цветовую схему для всех элементов виджетов Tk. Существующие виджеты обновляются, а база данных опций изменяется так, чтобы будущие виджеты использовали новые цвета. Если передан один цветовой аргумент, он считается обычным цветом фона, на основе которого вычисляется полная палитра. В качестве альтернативы аргументы могут быть заданы как пары *name*/*value*, задающие отдельные опции в базе данных опций. Распознаваемые имена опций: `activeBackground`, `activeForeground`, `background`, `disabledForeground`, `foreground`, `highlightBackground`, `highlightColor`, `insertBackground`, `selectColor`, `selectBackground`, `selectForeground` и `troughColor`; для любых неуказанных опций вычисляются разумные значения по умолчанию.10741075#### `tk_bisque()`10761077Восстанавливает цвета приложения к светлой коричневой (bisque) цветовой схеме, использовавшейся в Tk 3.6 и более ранних версиях. Предусмотрено для обратной совместимости.10781079#### `tk_strictMotif(boolean=None)`10801081Запрашивает или устанавливает, должен ли внешний вид Tk строго соответствовать Motif. Значение *boolean*, равное true, включает строгое соответствие Motif (например, отсутствие изменения цвета при наведении мыши на ползунок). Возвращает результирующую настройку.10821083Методы с префиксом `busy_` управляют состоянием занятости окна, при котором отображается курсор занятости и игнорируется пользовательский ввод.10841085#### `tk_busy_hold(**kw)`10861087Делает этот виджет занятым. Перед виджетом помещается прозрачное окно, так что он и все его потомки в иерархии виджетов блокируются от событий указателя и отображают курсор занятости. Обычно сразу после этого следует вызвать [`update()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.update), чтобы операция удержания вступила в силу до того, как приложение начнёт обработку.10881089Единственная поддерживаемая опция конфигурации – *cursor*, курсор, отображаемый пока виджет занят; он может принимать любое из значений, принимаемых `configure()`.10901091[`busy_hold()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.busy_hold), [`busy()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.busy) и [`tk_busy()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.tk_busy) являются псевдонимами `tk_busy_hold()`.10921093Добавлено в версии 3.13.10941095#### `tk_busy_configure(cnf=None, **kw)`10961097Запрос или изменение параметров конфигурации занятого окна. Виджет должен быть предварительно переведён в состояние «занят» с помощью [`tk_busy_hold()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.tk_busy_hold). Без аргументов возвращает словарь со всеми доступными опциями; если *cnf* – имя опции, возвращает кортеж с её описанием. В противном случае устанавливает указанные опции в заданные значения. Опции могут принимать любые значения, поддерживаемые `tk_busy_hold()`.10981099База данных опций обращается по имени или классу виджета. Например, если виджет [`Frame`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Frame) с именем `frame` должен быть сделан занятым, для него можно указать курсор ожидания с помощью любого из вызовов:11001101```python1102w.option_add('*frame.busyCursor', 'gumby')1103w.option_add('*Frame.BusyCursor', 'gumby')1104```11051106[`busy_configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.busy_configure), [`busy_config()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.busy_config) и [`tk_busy_config()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.tk_busy_config) – это псевдонимы `tk_busy_configure()`.11071108Добавлено в версии 3.13.11091110#### `tk_busy_cget(option)`11111112Возвращает текущее значение *опции* конфигурации занятого виджета. Виджет должен быть предварительно переведён в состояние «занят» с помощью [`tk_busy_hold()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.tk_busy_hold), а *опция* может принимать любые значения, поддерживаемые этим методом.11131114[`busy_cget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.busy_cget) является псевдонимом `tk_busy_cget()`.11151116Добавлено в версии 3.13.11171118#### `tk_busy_forget()`11191120Переводит виджет из состояния «занят» обратно, освобождая ресурсы (включая прозрачное окно), выделенные при его занятости. Виджет снова начнёт получать события пользователя. Эти ресурсы также освобождаются при уничтожении виджета.11211122[`busy_forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.busy_forget) является псевдонимом `tk_busy_forget()`.11231124Добавлено в версии 3.13.11251126#### `tk_busy_status()`11271128Возвращает `True`, если виджет в данный момент занят, иначе `False`.11291130[`busy_status()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.busy_status) является псевдонимом `tk_busy_status()`.11311132Добавлено в версии 3.13.11331134#### `tk_busy_current(pattern=None)`11351136Возвращает список виджетов, которые в данный момент заняты. Если указан *pattern*, возвращаются только занятые виджеты, чьи имена путей соответствуют шаблону.11371138[`busy_current()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.busy_current) является псевдонимом `tk_busy_current()`.11391140Добавлено в версии 3.13.11411142Методы с префиксом `winfo_` получают информацию об окнах, управляемых Tk.11431144#### `winfo_atom(name, displayof=0)`11451146Возвращает целочисленный идентификатор атома с именем *name*, создавая новый атом, если такого не существует. Если указан *displayof*, атом ищется на экране этого окна; в противном случае – на экране главного окна приложения.11471148#### `winfo_atomname(id, displayof=0)`11491150Возвращает текстовое имя атома с целочисленным идентификатором *id*. Это обратная операция к [`winfo_atom()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_atom). Если указан *displayof*, идентификатор ищется на экране этого окна; в противном случае – на экране главного окна приложения.11511152#### `winfo_cells()`11531154Возвращает количество ячеек в цветовой карте (colormap) виджета.11551156#### `winfo_children()`11571158Возвращает список виджетов, являющихся дочерними по отношению к данному виджету, в порядке стека от нижнего к верхнему. Окна верхнего уровня возвращаются как дочерние своих логических родителей.11591160#### `winfo_class()`11611162Возвращает имя класса виджета.11631164#### `winfo_colormapfull()`11651166Возвращает `True`, если известно, что цветовая карта виджета заполнена, иначе `False`.11671168#### `winfo_containing(rootX, rootY, displayof=0)`11691170Возвращает виджет, содержащий точку с координатами *rootX* и *rootY*, или `None`, если ни одно окно в приложении не содержит эту точку. Координаты задаются в экранных единицах в системе координат корневого окна. Если указан *displayof*, координаты относятся к экрану, содержащему это окно; в противном случае – к экрану главного окна приложения.11711172#### `winfo_depth()`11731174Возвращает глубину цвета виджета, то есть количество бит на пиксель.11751176#### `winfo_exists()`11771178Возвращает `1`, если виджет существует, и `0` в противном случае.11791180#### `winfo_fpixels(number)`11811182Возвращает число с плавающей запятой, показывающее количество пикселей в виджете, соответствующее экранному расстоянию *number* (например, `"2.0c"` или `"1i"`). Результат может быть дробным; для округлённого целого значения используйте [`winfo_pixels()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_pixels).11831184#### `winfo_geometry()`11851186Возвращает геометрию виджета в формате `widthxheight+x+y`. Все размеры указаны в пикселях. Смещение может быть отрицательным; см. [`geometry()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.geometry).11871188#### `winfo_height()`11891190Возвращает высоту виджета в пикселях. При первом создании окна его высота равна 1 пикселю; впоследствии она изменяется менеджером геометрии. См. также [`winfo_reqheight()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_reqheight).11911192#### `winfo_id()`11931194Возвращает низкоуровневый платформенно-зависимый идентификатор виджета. В Unix это идентификатор X-окна, а в Windows – дескриптор окна.11951196#### `winfo_interps(displayof=0)`11971198Возвращает кортеж имён всех интерпретаторов Tcl, зарегистрированных в данный момент для конкретного дисплея. Если указан *displayof*, возвращаемое значение относится к дисплею этого окна; в противном случае – к дисплею главного окна приложения.11991200#### `winfo_ismapped()`12011202Возвращает `1`, если виджет в данный момент отображён, и `0` в противном случае.12031204#### `winfo_manager()`12051206Возвращает имя менеджера геометрии, который в данный момент управляет виджетом, или пустую строку, если он не управляется ни одним менеджером геометрии.12071208#### `winfo_name()`12091210Возвращает имя виджета внутри его родительского элемента, в отличие от полного путевого имени.12111212#### `winfo_parent()`12131214Возвращает путевое имя родительского элемента виджета или пустую строку, если виджет является главным окном приложения.12151216#### `winfo_pathname(id, displayof=0)`12171218Возвращает путевое имя окна, идентификатор которого равен *id*. Если указан *displayof*, идентификатор ищется на дисплее этого окна; в противном случае – на дисплее главного окна приложения.12191220#### `winfo_pixels(number)`12211222Возвращает количество пикселей в виджете, соответствующее экранному расстоянию *number* (например, `"2.0c"` или `"1i"`). Результат округляется до ближайшего целого; для получения дробного результата используйте [`winfo_fpixels()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_fpixels).12231224#### `winfo_pointerx()`12251226Возвращает координату *x* указателя в пикселях относительно корневого окна экрана (или виртуального корня, если он используется). Возвращает `-1`, если указатель находится не на том же экране, что и виджет.12271228#### `winfo_pointerxy()`12291230Возвращает координаты указателя в виде кортежа `(x, y)` в пикселях относительно корневого окна экрана (или виртуального корня, если он используется). Обе координаты равны `-1`, если указатель находится не на том же экране, что и виджет.12311232#### `winfo_pointery()`12331234Возвращает координату *y* указателя в пикселях относительно корневого окна экрана (или виртуального корня, если он используется). Возвращает `-1`, если указатель находится не на том же экране, что и виджет.12351236#### `winfo_reqheight()`12371238Возвращает запрошенную высоту виджета в пикселях. Это значение используется менеджером геометрии виджета для вычисления его геометрии.12391240#### `winfo_reqwidth()`12411242Возвращает запрошенную ширину виджета в пикселях. Это значение используется менеджером геометрии виджета для вычисления его геометрии.12431244#### `winfo_rgb(color)`12451246Возвращает кортеж `(r, g, b)` из интенсивностей красного, зелёного и синего в диапазоне от 0 до 65535, соответствующих *color* в виджете. *color* может быть задан в любой форме, допустимой для параметра цвета.12471248#### `winfo_rootx()`12491250Возвращает координату *x* в корневом окне экрана для верхнего левого угла границы виджета (или самого виджета, если у него нет границы).12511252#### `winfo_rooty()`12531254Возвращает координату *y* в корневом окне экрана для верхнего левого угла границы виджета (или самого виджета, если у него нет границы).12551256#### `winfo_screen()`12571258Возвращает имя экрана, связанного с виджетом, в форме `displayName.screenIndex`.12591260#### `winfo_screencells()`12611262Возвращает количество ячеек в цветовой карте по умолчанию для экрана виджета.12631264#### `winfo_screendepth()`12651266Возвращает глубину корневого окна экрана виджета, то есть количество бит на пиксель.12671268#### `winfo_screenheight()`12691270Возвращает высоту экрана виджета в пикселях.12711272#### `winfo_screenmmheight()`12731274Возвращает высоту экрана виджета в миллиметрах.12751276#### `winfo_screenmmwidth()`12771278Возвращает ширину экрана виджета в миллиметрах.12791280#### `winfo_screenvisual()`12811282Возвращает класс визуализации по умолчанию для экрана виджета: `"directcolor"`, `"grayscale"`, `"pseudocolor"`, `"staticcolor"`, `"staticgray"`, или `"truecolor"`.12831284#### `winfo_screenwidth()`12851286Возвращает ширину экрана виджета в пикселях.12871288#### `winfo_server()`12891290Возвращает строку с информацией о сервере дисплея виджета. Точный формат этой строки может различаться в зависимости от платформы.12911292#### `winfo_toplevel()`12931294Возвращает окно верхнего уровня иерархии, содержащее виджет. В стандартном Tk это всегда виджет [`Toplevel`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Toplevel).12951296#### `winfo_viewable()`12971298Возвращает `1`, если виджет и все его предки вплоть до ближайшего окна верхнего уровня отображены, и `0` в противном случае.12991300#### `winfo_visual()`13011302Возвращает класс визуализации для виджета: `"directcolor"`, `"grayscale"`, `"pseudocolor"`, `"staticcolor"`, `"staticgray"`, или `"truecolor"`.13031304#### `winfo_visualid()`13051306Возвращает X-идентификатор визуального представления виджета.13071308#### `winfo_visualsavailable(includeids=False)`13091310Возвращает список доступных для экрана виджета визуальных представлений. Каждый элемент состоит из класса визуального представления (см. [`winfo_visual()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_visual)) и целочисленной глубины. Если *includeids* равно true, также включается X-идентификатор визуального представления.13111312#### `winfo_vrootheight()`13131314Возвращает высоту виртуального корневого окна, связанного с виджетом, если таковое существует; в противном случае возвращает высоту экрана виджета.13151316#### `winfo_vrootwidth()`13171318Возвращает ширину виртуального корневого окна, связанного с виджетом, если таковое существует; в противном случае возвращает ширину экрана виджета.13191320#### `winfo_vrootx()`13211322Возвращает смещение *x* виртуального корневого окна, связанного с виджетом, относительно корневого окна его экрана. Обычно равно нулю или отрицательное, и равно `0`, если виртуальное корневое окно отсутствует.13231324#### `winfo_vrooty()`13251326Возвращает смещение *y* виртуального корневого окна, связанного с виджетом, относительно корневого окна его экрана. Обычно равно нулю или отрицательное, и равно `0`, если виртуальное корневое окно отсутствует.13271328#### `winfo_width()`13291330Возвращает ширину виджета в пикселях. При первом создании окна его ширина равна 1 пикселю; впоследствии она изменяется менеджером геометрии. См. также [`winfo_reqwidth()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_reqwidth).13311332#### `winfo_x()`13331334Возвращает *x*-координату верхнего левого угла рамки виджета (или самого виджета, если у него нет рамки) в родительском контейнере.13351336#### `winfo_y()`13371338Возвращает *y*-координату верхнего левого угла рамки виджета (или самого виджета, если у него нет рамки) в родительском контейнере.13391340#### `info_patchlevel()`13411342Возвращает уровень патча Tcl/Tk в виде именованного кортежа с теми же пятью полями, что и [`sys.version_info`](https://python-all.ru/3.15/library/sys.html#sys.version_info): *major*, *minor*, *micro*, *releaselevel* и *serial*. *releaselevel* принимает значения `'alpha'`, `'beta'` или `'final'`. При преобразовании в строку получается версия в обычной записи Tcl/Tk, например `'9.0.3'` для финального релиза или `'9.1b2'` для предварительной версии.13431344Добавлено в версии 3.12.13451346#### `class tkinter.Wm`13471348Миксин `Wm` предоставляет доступ к оконному менеджеру, позволяя приложению управлять такими вещами, как заголовок, геометрия и значок окна верхнего уровня, способ его изменения размера, а также реакция на протоколы оконного менеджера. Он встраивается в [`Tk`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tk) и [`Toplevel`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Toplevel), поэтому его методы доступны для любого окна верхнего уровня. Каждый метод имеет два эквивалентных написания: короткое имя и имя с префиксом `wm_` (например, [`title()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.title) и [`wm_title()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_title)).13491350#### `aspect(minNumer=None, minDenom=None, maxNumer=None, maxDenom=None)`13511352Ограничивает соотношение сторон (отношение ширины к высоте) окна. Если указаны все четыре аргумента, оконный менеджер поддерживает соотношение между `minNumer/minDenom` и `maxNumer/maxDenom`; передача пустых строк снимает все существующие ограничения. Без аргументов возвращает кортеж из четырёх текущих значений или пустую строку, если ограничение соотношения не действует. [`wm_aspect()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_aspect) – это псевдоним `aspect()`.13531354#### `attributes(*args, return_python_dict=False, **kwargs)`13551356Запрашивает или задаёт платформо-зависимые атрибуты окна. Без аргументов возвращает платформо-зависимые флаги и их значения; передайте *return\_python\_dict* равным true, чтобы получить их в виде словаря. Одно имя опции, например `'alpha'`, возвращает значение этой опции, а опции задаются с помощью именованных аргументов (`alpha=0.5`).13571358Доступные атрибуты различаются в зависимости от платформы. Все платформы поддерживают:13591360***alpha***13611362Непрозрачность окна от `0.0` (полностью прозрачно) до `1.0` (непрозрачно). Если прозрачность не поддерживается, значение остаётся `1.0`.13631364***внешний вид***13651366Определяет, отображается ли окно в тёмном режиме в Windows и macOS: `'auto'`, `'light'` или `'dark'` (не действует на X11).13671368***полноэкранный***13691370Определяет, развёрнуто ли окно на весь экран и не имеет ли границ.13711372***поверх всех окон***13731374Определяет, отображается ли окно поверх всех остальных окон.13751376Windows также поддерживает:13771378***отключён***13791380Определяет, находится ли окно в отключённом состоянии.13811382***окно инструментов***13831384Определяет, использует ли окно стиль инструментального окна.13851386***прозрачный цвет***13871388Цвет, который становится полностью прозрачным, или пустая строка для отсутствия прозрачности.13891390macOS также поддерживает:13911392***класс***13931394Определяет, является ли базовое окно Aqua `nswindow` или `nspanel`; это можно установить только до создания окна.13951396***изменён***13971398Состояние изменения, отображаемое кнопкой закрытия окна и значком-заместителем.13991400***уведомить***14011402Определяет, подпрыгивает ли значок приложения в доке, чтобы привлечь внимание.14031404***маска стиля***14051406Маска стиля базового окна Aqua, задаваемая в виде списка имён битов, таких как `titled` или `resizable`.14071408***идентификатор вкладок***14091410Идентификатор группы вкладок, к которой принадлежит окно.14111412***режим вкладок***14131414Определяет, может ли окно быть открыто как вкладка: `'auto'`, `'preferred'` или `'disallowed'`.14151416***путь заголовка***14171418Путь к файлу, представленному значком-заместителем окна.14191420***прозрачный***14211422Определяет, является ли область содержимого прозрачной и отключена ли тень окна.14231424X11 также поддерживает:14251426***тип***14271428Тип окна или список типов в порядке предпочтения, который менеджер окон должен использовать для интерпретации окна, например `'dialog'` или `'splash'`.14291430***увеличен***14311432Определяет, развёрнуто ли окно на весь экран.14331434> **Примечание**1435>1436> Tk 8.6 добавил атрибут *type*, а Tk 9.0 добавил атрибуты *appearance*, *class*, *stylemask*, *tabbingid* и *tabbingmode*.14371438В X11 изменения применяются асинхронно, поэтому запрошенное значение может ещё не отражать самый последний запрос. [`wm_attributes()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_attributes) является псевдонимом `attributes()`.14391440Изменено в версии 3.13: Теперь отдельный атрибут можно запросить по имени без начального `-`, а атрибуты можно задавать с помощью именованных аргументов. Был добавлен параметр *return\_python\_dict*.14411442Устарело с версии 3.13: Установка атрибута путём передачи имени опции (с начальным `-`) и её значения в виде двух позиционных аргументов, как в `w.attributes('-alpha', 0.5)`, устарела; вместо этого используйте именованные аргументы.14431444#### `client(name=None)`14451446Сохраняет *name* (должно быть именем хоста, на котором выполняется приложение) в свойстве `WM_CLIENT_MACHINE` окна для использования оконным менеджером или менеджером сессий. Пустая строка удаляет это свойство. Без аргументов возвращает последнее установленное имя или пустую строку. [`wm_client()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_client) – это псевдоним `client()`.14471448#### `colormapwindows(*wlist)`14491450Управляет свойством `WM_COLORMAP_WINDOWS`, которое сообщает оконному менеджеру об окнах, имеющих частные цветовые карты. Если задан *wlist*, перезаписывает свойство этими окнами (их порядок – это приоритет для установки цветовых карт). Без аргументов возвращает список окон, указанных в данный момент в свойстве. [`wm_colormapwindows()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_colormapwindows) – это псевдоним `colormapwindows()`.14511452#### `command(value=None)`14531454Сохраняет *value* в свойстве `WM_COMMAND` окна для использования оконным менеджером или менеджером сессий; это должен быть список слов команды, использованной для запуска приложения. Пустая строка удаляет свойство. Без аргументов возвращает последнее установленное значение или пустую строку. [`wm_command()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_command) – это псевдоним `command()`.14551456#### `deiconify()`14571458Отображает окно в обычной (не свёрнутой) форме, отображая его на экране. Если окно ещё ни разу не отображалось, это гарантирует, что при первом отображении оно появится уже развёрнутым. В Windows окно также поднимается и получает фокус. [`wm_deiconify()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_deiconify) – это псевдоним `deiconify()`.14591460#### `focusmodel(model=None)`14611462Устанавливает или запрашивает модель фокуса для окна. *model* может быть `'active'` (окно заявляет о получении фокуса ввода для себя или своих потомков, даже когда фокус находится в другом приложении) или `'passive'` (окно полагается на оконный менеджер, чтобы тот дал ему фокус). Без аргумента возвращает текущую модель. По умолчанию используется `'passive'`, что предполагает команда `focus()`. [`wm_focusmodel()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_focusmodel) – это псевдоним `focusmodel()`.14631464#### `forget(window)`14651466Скрывает *window* с экрана, так что оно больше не управляется оконным менеджером. Затем [`Toplevel`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Toplevel) обрабатывается как [`Frame`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Frame), хотя его конфигурация `-menu` запоминается, и меню снова появляется, если виджет снова становится управляемым. [`wm_forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_forget) – это псевдоним `forget()`.14671468Не путать с [`Pack.forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.forget).14691470Добавлено в версии 3.3.14711472#### `frame()`14731474Возвращает платформенно-зависимый идентификатор окна для самого внешнего декоративного фрейма, содержащего окно, если оконный менеджер поместил его в такой фрейм; в противном случае возвращает идентификатор самого окна. [`wm_frame()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_frame) – это псевдоним `frame()`.14751476#### `geometry(newGeometry=None)`14771478Устанавливает или запрашивает геометрию окна. *newGeometry* имеет форму `=widthxheight+x+y`, где любая из `=`, `widthxheight` и позиция `+x+y` может быть опущена. *width* и *height* задаются в пикселях (или в единицах сетки для окна с сеткой); позиция, перед которой стоит `+`, отсчитывается от левого или верхнего края экрана, а позиция, перед которой стоит `-`, – от правого или нижнего края. Смещение может быть отрицательным, как в `'200x100+-9+-8'`, когда край окна выходит за соответствующий край экрана. Пустая строка отменяет любую заданную пользователем геометрию, позволяя окну вернуться к своему естественному размеру. Без аргумента возвращает текущую геометрию в виде строки вида `'200x200+10+10'`. [`wm_geometry()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_geometry) – это псевдоним `geometry()`.14791480#### `grid(baseWidth=None, baseHeight=None, widthInc=None, heightInc=None)`14811482Управляет окном как окном с сеткой и определяет соотношение между единицами сетки и пикселями. *baseWidth* и *baseHeight* – это количество единиц сетки для внутреннего запрошенного размера окна, а *widthInc* и *heightInc* – это размеры в пикселях горизонтальной и вертикальной единицы сетки. Пустые строки отключают управление сеткой. Без аргументов возвращает кортеж из четырёх текущих значений или пустую строку, если окно не использует сетку. [`wm_grid()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_grid) – это псевдоним `grid()`.14831484Не путать с менеджером геометрии grid [`Grid.grid()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.grid).14851486#### `group(pathName=None)`14871488Устанавливает или запрашивает лидера группы связанных окон. *pathName* задаёт путь к лидеру группы; оконный менеджер может, например, скрыть все окна в группе, когда лидер сворачивается. Пустая строка удаляет окно из любой группы. Без аргумента возвращает путь к текущему лидеру группы или пустую строку. [`wm_group()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_group) – это псевдоним `group()`.14891490#### `iconbitmap(bitmap=None, default=None)`14911492Устанавливает или запрашивает битовую карту, используемую оконным менеджером для значка окна. *bitmap* задаёт битовую карту в одной из стандартных форм, принимаемых Tk; пустая строка отменяет текущую битовую карту значка. Без аргумента возвращает имя текущей битовой карты значка или пустую строку. В Windows аргумент *default* задаёт значок (например, файл `.ico`), применяемый ко всем окнам верхнего уровня, у которых нет собственного значка. [`wm_iconbitmap()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_iconbitmap) – это псевдоним `iconbitmap()`.14931494#### `iconify()`14951496Сворачивает окно. Если окно ещё не было отображено в первый раз, обеспечивает его отображение в свёрнутом состоянии при последующем отображении. [`wm_iconify()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_iconify) – это псевдоним `iconify()`.14971498#### `iconmask(bitmap=None)`14991500Устанавливает или запрашивает битовую карту, используемую в качестве маски для значка (см. [`iconbitmap()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.iconbitmap)). Если маска равна нулю, значок не отображается; если единице, показываются соответствующие биты битовой карты значка. Пустая строка отменяет текущую маску. Без аргумента возвращает имя текущей маски значка или пустую строку. [`wm_iconmask()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_iconmask) – это псевдоним `iconmask()`.15011502#### `iconname(newName=None)`15031504Устанавливает или запрашивает имя, отображаемое оконным менеджером внутри значка окна. Без аргумента возвращает текущее имя значка или пустую строку, если ничего не было установлено (в этом случае оконный менеджер обычно отображает заголовок окна). [`wm_iconname()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_iconname) – это псевдоним `iconname()`.15051506#### `iconphoto(default=False, *images)`15071508Устанавливает значок заголовка окна из одного или нескольких объектов [`PhotoImage`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PhotoImage), переданных в *images*. Можно передать несколько изображений разных размеров (например, 16×16 и 32×32), чтобы оконный менеджер мог выбрать подходящее. Данные изображения берутся как снимок на момент вызова; последующие изменения изображений не учитываются. Если *default* равно true, значок также применяется ко всем будущим окнам верхнего уровня. В macOS используется только первое изображение. [`wm_iconphoto()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_iconphoto) – псевдоним `iconphoto()`.15091510Добавлено в версии 3.3.15111512#### `iconposition(x=None, y=None)`15131514Устанавливает или запрашивает подсказку оконному менеджеру о том, где должен располагаться значок окна. Пустые строки отменяют имеющуюся подсказку. Без аргументов возвращает кортеж из двух текущих значений или пустую строку, если подсказка не задана. [`wm_iconposition()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_iconposition) – псевдоним `iconposition()`.15151516#### `iconwindow(pathName=None)`15171518Устанавливает или запрашивает окно, используемое в качестве значка окна. Когда окно свёрнуто, *pathName* отображается как его значок и снова скрывается при восстановлении. Пустая строка отменяет привязку. Без аргументов возвращает путь текущего окна-значка или пустую строку. Не все оконные менеджеры поддерживают окна-значки, и эта концепция бессмысленна на платформах, отличных от X11. [`wm_iconwindow()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_iconwindow) – псевдоним `iconwindow()`.15191520#### `manage(widget)`15211522Делает *widget* самостоятельным окном верхнего уровня, оформленным оконным менеджером с заголовком и т.д. Могут использоваться только виджеты [`Frame`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Frame), [`LabelFrame`](https://python-all.ru/3.15/library/tkinter.html#tkinter.LabelFrame) и [`Toplevel`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Toplevel) (версии из [`tkinter.ttk`](https://python-all.ru/3.15/library/tkinter.ttk.html#module-tkinter.ttk) **не** принимаются); передача любого другого типа виджета вызывает ошибку. [`wm_manage()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_manage) – псевдоним `manage()`.15231524Добавлено в версии 3.3.15251526#### `maxsize(width=None, height=None)`15271528Устанавливает или запрашивает максимально допустимые размеры окна в пикселях (или в единицах сетки для окна с сеткой). Оконный менеджер ограничивает окно размерами не больше *width* и *height*. Без аргументов возвращает кортеж текущих максимальной ширины и высоты. Максимальный размер по умолчанию равен размеру экрана. [`wm_maxsize()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_maxsize) – псевдоним `maxsize()`.15291530#### `minsize(width=None, height=None)`15311532Устанавливает или запрашивает минимально допустимые размеры окна в пикселях (или в единицах сетки для окна с сеткой). Оконный менеджер ограничивает окно размерами не меньше *width* и *height*. Без аргументов возвращает кортеж текущих минимальной ширины и высоты. Минимальный размер по умолчанию – один пиксель по каждому измерению. [`wm_minsize()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_minsize) – псевдоним `minsize()`.15331534#### `overrideredirect(boolean=None)`15351536Устанавливает или запрашивает флаг override-redirect для окна. Когда этот флаг установлен, оконный менеджер игнорирует окно: оно не помещается в декоративную рамку, и пользователь не может управлять им через обычные элементы управления оконного менеджера. Без аргументов возвращает булево значение, указывающее, установлен ли флаг. Флаг надёжно соблюдается только при первом отображении окна или при повторном отображении из состояния withdrawn. [`wm_overrideredirect()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_overrideredirect) – псевдоним `overrideredirect()`.15371538#### `positionfrom(who=None)`15391540Устанавливает или запрашивает источник текущего положения окна. *who* может быть `'program'` или `'user'`, указывает, было ли положение запрошено программой или пользователем; пустая строка отменяет текущий источник. Без аргументов возвращает текущий источник или пустую строку, если источник не установлен. Tk автоматически устанавливает источник в `'user'` при вызове [`geometry()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.geometry), если только явно не установлен `'program'`. [`wm_positionfrom()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_positionfrom) – псевдоним `positionfrom()`.15411542#### `protocol(name=None, func=None)`15431544Регистрирует *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.15/library/tkinter.html#tkinter.Wm.wm_protocol) – псевдоним `protocol()`.15451546#### `resizable(width=None, height=None)`15471548Управляет возможностью интерактивного изменения размера окна пользователем. *width* и *height* – булевы значения, определяющие, можно ли изменять ширину и высоту окна. Без аргументов возвращает кортеж из двух значений `0`/`1`, указывающих, можно ли изменять каждый размер в данный момент. По умолчанию размер окна можно изменять по обоим измерениям. [`wm_resizable()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_resizable) – псевдоним `resizable()`.15491550#### `sizefrom(who=None)`15511552Устанавливает или запрашивает источник текущего размера окна. *who* может быть `'program'` или `'user'`, указывает, был ли размер запрошен программой или пользователем; пустая строка отменяет текущий источник. Без аргументов возвращает текущий источник или пустую строку, если источник не установлен. [`wm_sizefrom()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_sizefrom) – псевдоним `sizefrom()`.15531554#### `state(newstate=None)`15551556Устанавливает или запрашивает состояние окна. Без аргументов возвращает текущее состояние: одно из `'normal'`, `'iconic'`, `'withdrawn'`, `'icon'` или, только в Windows и macOS, `'zoomed'`. `'iconic'` относится к свёрнутому окну, тогда как `'icon'` – к окну, служащему значком для другого окна (см. [`iconwindow()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.iconwindow)); состояние `'icon'` не может быть установлено. [`wm_state()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_state) – псевдоним `state()`.15571558Не путать с [`ttk.Widget.state`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.Widget.state).15591560#### `title(string=None)`15611562Устанавливает или запрашивает заголовок окна, который оконный менеджер должен отображать в строке заголовка. Без аргументов возвращает текущий заголовок. По умолчанию заголовок равен имени окна. [`wm_title()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_title) – псевдоним `title()`.15631564#### `transient(master=None)`15651566Помечает окно как временное (например, выпадающее меню или диалог), работающее от имени *master*, пути к другому окну верхнего уровня. Пустая строка снимает статус временного окна. Без аргументов возвращает путь текущего владельца или пустую строку. Временное окно отражает изменения состояния своего владельца и может оформляться оконным менеджером иначе; ошибка – сделать окно временным для самого себя. [`wm_transient()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_transient) – псевдоним `transient()`.15671568#### `withdraw()`15691570Убирает окно с экрана, скрывая его и заставляя оконный менеджер забыть о нём. Если окно никогда не отображалось, оно отображается в состоянии withdrawn. Иногда необходимо скрыть окно и снова отобразить его (например, с помощью [`deiconify()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.deiconify)), чтобы некоторые оконные менеджеры заметили изменения атрибутов окна. [`wm_withdraw()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.wm_withdraw) – псевдоним `withdraw()`.15711572#### `class tkinter.Pack`15731574Менеджер геометрии, который размещает виджеты, прижимая их к сторонам контейнера. Миксин `Pack` наследуется всеми виджетами (через [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget)) и предоставляет методы для управления виджетом с помощью менеджера геометрии *pack*. См. также [паковщик](https://python-all.ru/3.15/library/tkinter.html#pack-the-packer).15751576> **Примечание**1577>1578> `Pack`, [`Place`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Place) и [`Grid`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid) определяют короткие имена методов `forget()`, `info()`, `slaves()`, `content()` и `propagate()`. Для виджета эти простые имена разрешаются в версии менеджера *pack*, поскольку `Pack` и [`Misc`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc) предшествуют `Place` и `Grid` в порядке разрешения методов, независимо от того, какой менеджер фактически управляет виджетом; а `configure()`/`config()` настраивают параметры виджета, а не его геометрию. Используйте явные методы `pack_*`, `grid_*` и `place_*` (и `pack`, `grid`, `place` для настройки геометрии), чтобы воздействовать на конкретный менеджер геометрии.15791580#### `pack_configure(cnf={}, **kw)`15811582#### `pack(cnf={}, **kw)`15831584Упаковывает виджет внутри его контейнера, позиционируя его относительно уже упакованных там соседних виджетов. Поддерживаемые параметры:15851586***side***15871588К какой стороне контейнера прижимать виджет: `'top'` (по умолчанию), `'bottom'`, `'left'` или `'right'`.15891590***fill***15911592Следует ли растягивать виджет, чтобы заполнить его участок: `'none'` (по умолчанию), `'x'`, `'y'` или `'both'`.15931594***expand***15951596Следует ли виджету расширяться, чтобы занять лишнее пространство в его контейнере (логическое значение, по умолчанию false).15971598***anchor***15991600Где позиционировать виджет в его участке, когда участок больше виджета: привязка, например `'n'` или `'sw'` (по умолчанию `'center'`).16011602***ipadx*, *ipady***16031604Внутренний отступ, добавляемый слева и справа (*ipadx*) или сверху и снизу (*ipady*) от виджета, задаётся в экранных единицах (по умолчанию `0`).16051606***padx*, *pady***16071608Внешний отступ, оставляемый слева и справа (*padx*) или сверху и снизу (*pady*) от виджета, задаётся в экранных единицах или как пара значений для каждой из двух сторон (по умолчанию `0`).16091610***after***16111612Упаковывает виджет после указанного виджета в порядке упаковки, используя тот же контейнер.16131614***before***16151616Упаковывает виджет перед указанным виджетом в порядке упаковки, используя тот же контейнер.16171618***in\_***16191620Контейнер, в который упаковывать виджет; по умолчанию – родительский виджет.16211622`pack()`, [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.configure) и [`config()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.config) являются псевдонимами `pack_configure()`.16231624#### `pack_forget()`16251626Убирает виджет и удаляет его из порядка упаковки, забывая его параметры упаковки. Позже его можно снова упаковать с помощью [`pack_configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.pack_configure). [`forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.forget) является псевдонимом `pack_forget()`, за исключением [`PanedWindow`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow), [`ttk.Notebook`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.Notebook) и [`ttk.PanedWindow`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.PanedWindow), которые предоставляют собственный метод `forget()`.16271628Не путать с [`Wm.forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.forget).16291630#### `pack_info()`16311632Возвращает словарь текущих параметров упаковки виджета. [`info()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.info) является псевдонимом `pack_info()`.16331634#### `pack_propagate()`16351636#### `pack_propagate(flag)`16371638То же, что и [`Misc.pack_propagate()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.pack_propagate), рассматривая этот виджет как контейнер: включить или отключить распространение геометрии. [`propagate()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.propagate) является псевдонимом `pack_propagate()`.16391640#### `pack_slaves()`16411642То же, что и [`Misc.pack_slaves()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.pack_slaves): возвращает список виджетов, упакованных в этот виджет. [`slaves()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.slaves) – псевдоним `pack_slaves()`.16431644#### `pack_content()`16451646То же, что и [`Misc.pack_content()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.pack_content). [`content()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.content) – псевдоним `pack_content()`.16471648Добавлено в версии 3.15.16491650#### `class tkinter.Place`16511652Менеджер геометрии, размещающий виджеты в явных позициях и размерах внутри их контейнера. Примесь `Place` наследуется всеми виджетами (через [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget)).16531654#### `place_configure(cnf={}, **kw)`16551656#### `place(cnf={}, **kw)`16571658Размещает виджет внутри его контейнера в абсолютной или относительной позиции. Поддерживаемые опции:16591660***x*, *y***16611662Абсолютные горизонтальная и вертикальная позиции опорной точки виджета как экранное расстояние (по умолчанию `0`).16631664***relx*, *rely***16651666Горизонтальная и вертикальная позиции опорной точки виджета как доля ширины и высоты контейнера, где `0.0` – это левый или верхний край, а `1.0` – правый или нижний край. Если указаны как абсолютная, так и относительная опции, их значения суммируются.16671668***anchor***16691670Какая точка виджета размещается в заданной позиции: опорная точка, например `'n'` или `'se'` (по умолчанию `'nw'`).16711672***width*, *height***16731674Абсолютные ширина и высота виджета как экранное расстояние. По умолчанию используется запрошенный размер виджета.16751676***relwidth*, *relheight***16771678Ширина и высота виджета как доля ширины и высоты контейнера. Если указаны как абсолютная, так и относительная опции, их значения суммируются.16791680***bordermode***16811682Как граница контейнера влияет на размещение: `'inside'` (по умолчанию) измеряет область внутри границы, `'outside'` измеряет область, включая границу, а `'ignore'` использует официальную область X.16831684***in\_***16851686Контейнер, относительно которого размещается виджет; он должен быть родителем виджета или потомком родителя, по умолчанию – родитель.16871688`place()`, [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Place.configure) и [`config()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Place.config) являются псевдонимами `place_configure()`.16891690#### `place_forget()`16911692Скрыть виджет и удалить его из размещения, забыв его опции размещения.16931694#### `place_info()`16951696Возвращает словарь текущих опций размещения виджета.16971698#### `place_slaves()`16991700То же, что и [`Misc.place_slaves()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.place_slaves): возвращает список виджетов, размещённых в этом виджете.17011702#### `place_content()`17031704То же, что и [`Misc.place_content()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.place_content).17051706Добавлено в версии 3.15.17071708#### `class tkinter.Grid`17091710Менеджер геометрии, располагающий виджеты в двумерной сетке строк и столбцов внутри их контейнера. Примесь `Grid` наследуется всеми виджетами (через [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget)).17111712#### `grid_configure(cnf={}, **kw)`17131714#### `grid(cnf={}, **kw)`17151716Помещает виджет в ячейку сетки его контейнера.17171718Не путать с [`Wm.grid()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm.grid).17191720Поддерживаемые параметры:17211722***строка*, *столбец***17231724Строка и столбец ячейки, в которую помещается виджет, с отсчётом от `0`. *Столбец* по умолчанию равен столбцу, следующему за последним виджетом, помещённым в том же вызове `grid_configure()` (или `0`), а *строка* по умолчанию равна следующей пустой строке.17251726***rowspan*, *columnspan***17271728Количество строк и столбцов, которое должен охватывать виджет (по умолчанию `1`).17291730***sticky***17311732Определяет расположение или растяжение виджета, когда его ячейка больше самого виджета: строка, содержащая ноль или более символов из `'n'`, `'s'`, `'e'` и `'w'`, указывающих стороны ячейки, к которым прикрепляется виджет. Указание одновременно `'n'` и `'s'` (или `'e'` и `'w'`) растягивает виджет на всю высоту (или ширину) ячейки. По умолчанию `''` – виджет центрируется в ячейке с сохранением запрошенного размера.17331734***ipadx*, *ipady***17351736Внутренний отступ, добавляемый слева и справа (*ipadx*) или сверху и снизу (*ipady*) от виджета, задаётся в экранных единицах (по умолчанию `0`).17371738***padx*, *pady***17391740Внешний отступ, оставляемый слева и справа (*padx*) или сверху и снизу (*pady*) от виджета, задаётся в экранных единицах или как пара значений для каждой из двух сторон (по умолчанию `0`).17411742***in\_***17431744Контейнер, в сетку которого помещается виджет; по умолчанию – родительский виджет.17451746`grid()`, [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.configure) и [`config()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.config) являются псевдонимами `grid_configure()`.17471748#### `grid_forget()`17491750Скрывает виджет и удаляет его из сетки, забывая его параметры сетки.17511752#### `grid_remove()`17531754Скрывает виджет и удаляет его из сетки, но запоминает его параметры сетки, чтобы при повторном размещении он был восстановлен в той же ячейке.17551756#### `grid_info()`17571758Возвращает словарь текущих параметров сетки виджета.17591760#### `grid_bbox(column=None, row=None, col2=None, row2=None)`17611762То же, что и [`Misc.grid_bbox()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_bbox). [`bbox()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.bbox) – псевдоним `grid_bbox()`, за исключением [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox), [`Spinbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox), [`Text`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text), [`ttk.Entry`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.Entry) и [`ttk.Treeview`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.Treeview), которые предоставляют собственный метод `bbox()`.17631764#### `grid_columnconfigure(index, cnf={}, **kw)`17651766То же, что [`Misc.grid_columnconfigure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_columnconfigure): запрашивает или задаёт параметры столбца сетки (такие как *weight*, *minsize*, *pad* и *uniform*). [`columnconfigure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.columnconfigure) – псевдоним `grid_columnconfigure()`.17671768#### `grid_rowconfigure(index, cnf={}, **kw)`17691770То же, что [`Misc.grid_rowconfigure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_rowconfigure): запрашивает или задаёт параметры строки сетки. [`rowconfigure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.rowconfigure) – псевдоним `grid_rowconfigure()`.17711772#### `grid_location(x, y)`17731774То же, что [`Misc.grid_location()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_location): возвращает `(column, row)` ячейки, которая содержит пиксель с координатами *x*, *y*. [`location()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.location) – псевдоним `grid_location()`.17751776#### `grid_size()`17771778То же, что [`Misc.grid_size()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_size): возвращает кортеж `(columns, rows)`, содержащий размеры сетки. [`size()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.size) – псевдоним `grid_size()`, за исключением виджета [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox), который предоставляет собственный метод `size()`.17791780#### `grid_propagate()`17811782#### `grid_propagate(flag)`17831784То же, что и [`Misc.grid_propagate()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_propagate).17851786#### `grid_slaves(row=None, column=None)`17871788То же, что и [`Misc.grid_slaves()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_slaves): возвращает виджеты, управляемые сеткой, с возможностью ограничения по *строке* и/или *столбцу*.17891790#### `grid_content(row=None, column=None)`17911792То же, что и [`Misc.grid_content()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_content).17931794Добавлено в версии 3.15.17951796#### `class tkinter.XView`17971798Примесь, предоставляющая интерфейс горизонтальной прокрутки, общий для виджетов, таких как [`Entry`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry), [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox), [`Text`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text) и [`Spinbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox). Метод [`xview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview) виджета регистрируется как *команда* горизонтального [`Scrollbar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Scrollbar).17991800#### `xview(*args)`18011802Запрашивает или изменяет горизонтальное положение вида. Без аргументов возвращает кортеж `(first, last)` из двух дробей от 0 до 1, указывающих долю документа, которая в данный момент видна. В противном случае аргументы передаются команде виджета Tk `xview` и обычно генерируются полосой прокрутки; [`xview_moveto()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview_moveto) и [`xview_scroll()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview_scroll) предоставляют более удобный интерфейс.18031804#### `xview_moveto(fraction)`18051806Настраивает вид так, чтобы *fraction* от общей ширины документа находилось слева за экраном. *fraction* – число от 0 до 1.18071808#### `xview_scroll(number, what)`18091810Сдвигает вид влево или вправо на *число* единиц. *what* может быть `'units'` или `'pages'`; отрицательное *число* прокручивает влево, положительное – вправо.18111812#### `class tkinter.YView`18131814Примесь, предоставляющая интерфейс вертикальной прокрутки, общий для виджетов, таких как [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas), [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox) и [`Text`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text). Метод [`yview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView.yview) виджета регистрируется как *команда* вертикального [`Scrollbar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Scrollbar).18151816#### `yview(*args)`18171818Запрашивает или изменяет вертикальное положение вида. Без аргументов возвращает кортеж `(first, last)` из двух дробей от 0 до 1, указывающих долю документа, которая в данный момент видна. В противном случае аргументы передаются команде виджета Tk `yview`, обычно генерируемой полосой прокрутки; [`yview_moveto()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView.yview_moveto) и [`yview_scroll()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView.yview_scroll) предоставляют более удобный интерфейс.18191820#### `yview_moveto(fraction)`18211822Настраивает вид так, чтобы *fraction* от общей высоты документа находилось над верхней границей экрана. *fraction* – число от 0 до 1.18231824#### `yview_scroll(number, what)`18251826Сдвигает вид вверх или вниз на *число* единиц. *what* может быть `'units'` или `'pages'`; отрицательное *число* прокручивает вверх, положительное – вниз.18271828#### `class tkinter.BaseWidget(master, widgetName, cnf={}, kw={}, extra=())`18291830Внутренний базовый класс для всех виджетов. Наследует от [`Misc`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc) и добавляет механизм, который создаёт нижележащий Tk-виджет; прикладной код обычно использует [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget) или конкретный класс виджета, а не создаёт экземпляр `BaseWidget` напрямую.18311832#### `destroy()`18331834Уничтожает этот виджет и все его дочерние элементы, удаляя соответствующие Tk-виджеты и связанные команды Tcl.18351836#### `class tkinter.Widget(master, widgetName, cnf={}, kw={}, extra=())`18371838Внутренний базовый класс для стандартных виджетов. Объединяет [`BaseWidget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.BaseWidget) с примесями менеджеров геометрии [`Pack`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack), [`Place`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Place) и [`Grid`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid), так что любой виджет может управляться любым из трёх менеджеров геометрии. Конкретные классы виджетов ([`Button`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Button), [`Label`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Label) и так далее) наследуют от `Widget`.18391840### Виджеты верхнего уровня18411842#### `class tkinter.Tk(screenName=None, baseName=None, className='Tk', useTk=True, sync=False, use=None)`18431844Создаёт виджет верхнего уровня Tk, который обычно является главным окном приложения, и инициализирует для него интерпретатор Tcl. Каждый экземпляр имеет свой собственный связанный интерпретатор Tcl. Наследует от [`Misc`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc) и [`Wm`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm).18451846Чтобы создать интерпретатор Tcl без инициализации подсистемы Tk, используйте фабричную функцию [`Tcl()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tcl).18471848Класс `Tk` обычно создаётся со значениями по умолчанию. Однако в настоящее время распознаются следующие именованные аргументы:18491850***screenName***18511852При указании (в виде строки) устанавливает переменную окружения `DISPLAY`. (только X11)18531854***baseName***18551856Имя файла профиля. По умолчанию *baseName* берётся из имени программы (`sys.argv[0]`).18571858***className***18591860Имя класса виджета. Используется как файл профиля, а также как имя, с которым вызывается Tcl (*argv0* в *interp*).18611862***useTk***18631864Если `True`, инициализировать подсистему Tk. Функция [`tkinter.Tcl()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tcl) устанавливает это в `False`.18651866***sync***18671868Если `True`, выполнять все команды X-сервера синхронно, чтобы ошибки сообщались немедленно. Может использоваться для отладки. (только X11)18691870***use***18711872Задаёт *id* окна, в которое встраивается приложение, вместо того чтобы создавать его как независимое окно верхнего уровня. *id* должен быть указан так же, как значение опции -use для виджетов верхнего уровня (то есть иметь форму, подобную возвращаемой [`winfo_id()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_id)).18731874Обратите внимание, что на некоторых платформах это будет работать корректно только если *id* ссылается на Tk-фрейм или окно верхнего уровня, у которых включена опция -container.18751876`Tk` читает и интерпретирует файлы профилей с именами `.className.tcl` и `.baseName.tcl` в интерпретатор Tcl и вызывает [`exec()`](https://python-all.ru/3.15/library/functions.html#exec) для содержимого `.className.py` и `.baseName.py`. Путь к файлам профилей задаётся переменной окружения `HOME` или, если она не определена, то [`os.curdir`](https://python-all.ru/3.15/library/os.html#os.curdir).18771878> **Примечание**1879>1880> В Windows создание интерпретатора Tcl (путём создания экземпляра `Tk` или вызова [`Tcl()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tcl)) устанавливает переменную окружения `HOME` для процесса, если она ещё не установлена, в `%HOMEDRIVE%%HOMEPATH%` (или `USERPROFILE`, или `c:\`). Это делается Tcl и может повлиять на другой код, который читает `HOME`.18811882#### `tk`18831884Объект приложения Tk, созданный созданием экземпляра `Tk`. Он предоставляет доступ к интерпретатору Tcl. Каждый виджет, прикреплённый к тому же экземпляру `Tk`, имеет одинаковое значение для своего атрибута [`tk`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tk.tk).18851886#### `master`18871888Объект виджета, содержащий данный виджет. Для `Tk` `master` является [`None`](https://python-all.ru/3.15/library/constants.html#None), потому что это главное окно. Термины *master* и *parent* похожи и иногда используются как взаимозаменяемые имена аргументов; однако вызов [`winfo_parent()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.winfo_parent) возвращает строку с именем виджета, тогда как `master` возвращает объект. *parent*/*child* отражает древовидную связь, а *master* (или *container*)/*content* отражает структуру контейнера.18891890#### `children`18911892Непосредственные потомки этого виджета в виде [`dict`](https://python-all.ru/3.15/library/stdtypes.html#dict) с именами дочерних виджетов в качестве ключей и объектами экземпляров потомков в качестве значений.18931894#### `destroy()`18951896Уничтожить этот виджет и все дочерние виджеты, а для главного окна – завершить соединение с нижележащим интерпретатором Tcl.18971898#### `loadtk()`18991900Завершить загрузку и инициализацию подсистемы Tk. Это необходимо только в том случае, если интерпретатор был создан без Tk (например, через [`Tcl()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tcl)); он вызывается автоматически, когда *useTk* равно true.19011902#### `readprofile(baseName, className)`19031904Прочитать и выполнить (source) пользовательские файлы профилей `.className.tcl` и `.baseName.tcl` в интерпретатор Tcl, и выполнить соответствующие файлы `.className.py` и `.baseName.py`. Это вызывается во время инициализации; см. описание конструктора выше.19051906#### `report_callback_exception(exc, val, tb)`19071908Сообщить об исключении в колбэке. Вызывается, когда исключение распространяется из колбэка Tkinter; *exc*, *val* и *tb* – это тип исключения, значение и трассировка, возвращаемые [`sys.exc_info()`](https://python-all.ru/3.15/library/sys.html#sys.exc_info). Реализация по умолчанию выводит трассировку в [`sys.stderr`](https://python-all.ru/3.15/library/sys.html#sys.stderr). Может быть переопределена для настройки обработки ошибок, например для отображения трассировки в диалоговом окне.19091910#### `class tkinter.Toplevel(master=None, cnf={}, **kw)`19111912Виджет `Toplevel` – это окно верхнего уровня, похожее на [`Frame`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Frame), за исключением того, что его X-родителем является корневое окно экрана, а не его логический родитель. Его основное назначение – служить контейнером для диалоговых окон и других наборов виджетов; его видимые особенности – это только фон и необязательная 3D-рамка. Из заметных опций: *menu*, которая устанавливает [`Menu`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu) в качестве строки меню окна. Наследуется от [`BaseWidget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.BaseWidget) и [`Wm`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Wm), поэтому окно верхнего уровня управляется оконным менеджером. Полный список опций см. в руководстве по Tk `toplevel`.19131914### Классы виджетов19151916#### `class tkinter.Button(master=None, cnf={}, **kw)`19171918Виджет `Button` отображает текстовую строку, растровое изображение или картинку и вызывает команду при нажатии (по клику кнопкой мыши 1 на кнопке или, когда кнопка в фокусе, по нажатию пробела). Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget). В дополнение к стандартным опциям виджета, кнопка принимает опции, описанные на странице руководства Tk `button`, такие как *command* (колбэк, вызываемый при нажатии кнопки), *textvariable*, *state* и *default*.19191920#### `invoke()`19211922Вызывает команду, связанную с кнопкой, если она есть, и возвращает её результат, или пустую строку, если команда не задана. Игнорируется, если состояние кнопки `disabled`.19231924#### `flash()`19251926Мигает кнопкой, перерисовывая её несколько раз, чередуя активный и нормальный цвета. После мигания кнопка остаётся в том же нормальном или активном состоянии, что и при вызове метода. Игнорируется, если состояние кнопки `disabled`.19271928#### `class tkinter.Canvas(master=None, cnf={}, **kw)`19291930Виджет `Canvas` реализует структурированную графику. Он отображает любое количество *элементов*, таких как дуги, линии, овалы, многоугольники, прямоугольники, текст, растровые изображения, картинки и встроенные окна, которые можно рисовать, перемещать, менять их цвет и привязывать к событиям. Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget), [`XView`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView) и [`YView`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView), поэтому представление можно прокручивать по горизонтали и вертикали с помощью [`xview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview) и [`yview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView.yview). Обратитесь к странице руководства Tk `canvas` для полного списка опций виджета и элементов.19311932Каждый элемент имеет уникальный целочисленный *id*, присваиваемый при создании, и ноль или более строковых *тегов*. Тег – это произвольная строка, которая не должна иметь вид целого числа; один и тот же тег могут разделять несколько элементов, что делает теги удобными для группировки элементов. Специальный тег `'all'` соответствует каждому элементу на холсте, а `'current'` – верхнему элементу под указателем мыши. Большинство методов принимают аргумент *tagOrId*, который может быть целочисленным id, именующим один элемент, или тегом, именующим ноль или более элементов; как описано на странице руководства Tk `canvas`, тег также может быть логическим выражением из тегов, объединённых операторами `&&`, `||`, `^`, `!` и скобками. Когда метод, работающий с одним элементом, получает *tagOrId*, соответствующий нескольким элементам, он обычно использует самый нижний подходящий элемент в списке отображения.19331934Элементы хранятся в *списке отображения*, который определяет порядок рисования: элементы, расположенные позже в списке, рисуются поверх более ранних. Новый элемент помещается в начало списка; порядок можно изменить с помощью [`tag_raise()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.tag_raise) и [`tag_lower()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.tag_lower).19351936#### `create_arc(*args, **kw)`19371938#### `create_bitmap(*args, **kw)`19391940#### `create_image(*args, **kw)`19411942#### `create_line(*args, **kw)`19431944#### `create_oval(*args, **kw)`19451946#### `create_polygon(*args, **kw)`19471948#### `create_rectangle(*args, **kw)`19491950#### `create_text(*args, **kw)`19511952#### `create_window(*args, **kw)`19531954Создаёт новый элемент соответствующего типа и возвращает его целочисленный id. Каждый метод вызывается как `create_TYPE(coord..., **options)`: первые позиционные аргументы задают координаты, определяющие элемент (отдельные числа, единая последовательность чисел или пары координат), а ключевые аргументы устанавливают специфичные для элемента опции. Координаты и расстояния на экране могут быть заданы числами (интерпретируются как пиксели) или строками с суффиксом единицы измерения (`'m'`, `'c'`, `'i'` или `'p'` для миллиметров, сантиметров, дюймов или типографских пунктов), но всегда хранятся и возвращаются в пикселях.19551956Типы элементов: `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*).19571958Большинство типов элементов принимают общий набор *стандартных опций элементов*, а также несколько опций, специфичных для каждого типа. Имена опций передаются как ключевые аргументы, без ведущего дефиса.19591960Стандартные опции элементов:19611962***fill***19631964Цвет, используемый для заливки внутренней части элемента, или для рисования элемента *line* или символов элемента *text*. Пустая строка (значение по умолчанию для всех типов, кроме *line* и *text*) оставляет элемент незаполненным.19651966***outline***19671968Цвет, используемый для рисования контура элемента. Пустая строка означает отсутствие контура.19691970***width***19711972Ширина контура, по умолчанию `1.0`. Не действует, если *outline* пусто.19731974***dash***19751976Штриховой узор для контура, задаваемый либо как последовательность длин сегментов в пикселях, либо как строка из символов `'.'`, `','`, `'-'`, `'_'` и пробела. Пустой узор (по умолчанию) рисует сплошной контур.19771978***dashoffset***19791980Начальное смещение в пикселях в узоре *dash*. Игнорируется, если узор *dash* отсутствует.19811982***stipple***19831984Битовая карта, используемая как трафаретный узор при заливке элемента. Полноценно поддерживается только на X11.19851986***outlinestipple***19871988Битовая карта, используемая как трафаретный узор при рисовании контура. Не действует, если *outline* пуст.19891990***offset*, *outlineoffset***19911992Смещение узоров заливки и контура, задаваемое как `'x,y'` или как сторона, например `'n'`, `'se'` или `'center'`. Смещения трафарета поддерживаются только на X11.19931994***state***19951996Переопределяет состояние холста для этого элемента; одно из `'normal'`, `'disabled'` или `'hidden'`.19971998***tags***19992000Один тег или последовательность тегов для привязки к элементу, заменяя все существующие теги.20012002У многих из этих опций есть варианты *active…* и *disabled…* (например, *activefill*, *disabledfill*, *activewidth*, *disableddash*, *activeoutline*, *disabledstipple*), которые переопределяют основную опцию, когда элемент является активным (под указателем мыши) или находится в отключённом состоянии.20032004Следующие типы элементов поддерживают дополнительные опции.20052006Для элементов `arc`:20072008***start***20092010Начало углового диапазона дуги, в градусах, измеряемое против часовой стрелки от положения «3 часа».20112012***extent***20132014Размер углового диапазона, в градусах против часовой стрелки от *start*.20152016***стиль***20172018Как рисуется дуга: `'pieslice'` (по умолчанию), `'chord'` или `'arc'`.20192020Для элементов `line`:20212022***arrow***20232024Где рисовать наконечники стрелок: `'none'` (по умолчанию), `'first'`, `'last'` или `'both'`.20252026***arrowshape***20272028Последовательность из трёх расстояний, описывающих форму наконечников стрелок.20292030***capstyle***20312032Как рисуются концы линий: `'butt'` (по умолчанию), `'projecting'` или `'round'`.20332034***joinstyle***20352036Как рисуются вершины линий: `'round'` (по умолчанию), `'bevel'` или `'miter'`.20372038***smooth***20392040Метод сглаживания: ложное значение (по умолчанию) без сглаживания, или `'true'`/`'bezier'` или `'raw'` для рисования линии в виде кривой.20412042***splinesteps***20432044Количество отрезков, аппроксимирующих каждый сплайн, когда *smooth* включён.20452046Для элементов `polygon`:20472048***joinstyle*, *smooth*, *splinesteps***20492050Как и для элементов `line`, применяется к контуру многоугольника.20512052Для элементов `text`:20532054***text***20552056Отображаемая строка; символы новой строки начинают новые строки.20572058***font***20592060Шрифт, используемый для текста.20612062***выравнивание***20632064Способ выравнивания строк: `'left'` (по умолчанию), `'right'` или `'center'`.20652066***anchor***20672068Как текст позиционируется относительно своей точки; по умолчанию `'center'`.20692070***width***20712072Максимальная длина строки; если не равна нулю, строки переносятся по пробелам.20732074***angle***20752076На сколько градусов поворачивать текст против часовой стрелки относительно точки позиционирования, от `0.0` до `360.0` (по умолчанию `0.0`).20772078***underline***20792080Индекс символа для подчёркивания или `-1`, если подчёркивание не требуется.20812082Для элементов `bitmap`:20832084***bitmap***20852086Отображаемое растровое изображение.20872088***anchor***20892090Как растровое изображение позиционируется относительно своей точки.20912092***background*, *foreground***20932094Цвета для пикселей `0` и `1` растрового изображения; пустой *background* делает пиксели `0` прозрачными. Для обоих есть варианты *active…* и *disabled…*, а для *bitmap* – варианты *activebitmap* и *disabledbitmap*.20952096Для элементов `image`:20972098***image***20992100Изображение Tk для отображения, предварительно созданное с помощью протоколов изображений.21012102***anchor***21032104Как изображение позиционируется относительно своей точки.21052106Для обоих параметров существуют варианты *active…* и *disabled…* (*activeimage*, *disabledimage*), используемые в активном и отключённом состояниях.21072108Для элементов `window`:21092110***window***21112112Встраиваемый виджет; он должен быть дочерним элементом холста или одного из его предков и не может быть окном верхнего уровня.21132114***anchor***21152116Как окно позиционируется относительно своей точки.21172118***width*, *height***21192120Размер, назначаемый окну; если ноль (по умолчанию), окну присваивается его запрошенный размер.21212122Элементы `oval` и `rectangle` не имеют опций, специфичных для типа; они используют только стандартные опции элементов.21232124> **Примечание**2125>2126> Tk 8.6 добавил опцию *angle*, а Tk 9.0 добавил опцию *underline* для элементов `text`.21272128#### `coords(tagOrId)`21292130#### `coords(tagOrId, coordList, /)`21312132#### `coords(tagOrId, /, *coordList)`21332134Запрос или изменение координат элемента. С одним только *tagOrId* возвращает список координат с плавающей запятой элемента, заданного *tagOrId* (первый подходящий, если соответствует нескольким). При указании новых координат заменяет координаты этого элемента на указанные; как и методы `create_*`, координаты могут быть заданы отдельными числами, одной последовательностью или парами координат. Возвращаемые координаты всегда в пикселях, независимо от единиц, использованных при задании; для прямоугольников, овалов и дуг они упорядочены как лево, верх, право, низ.21352136Изменено в версии 3.12: Аргументы теперь уплощаются: координаты могут быть заданы отдельными аргументами, одной последовательностью или сгруппированы парами, как в методах `create_*`.21372138#### `move(tagOrId, xAmount, yAmount, /)`21392140Перемещает каждый из элементов, заданных *tagOrId*, в координатном пространстве холста, добавляя *xAmount* к каждой координате x и *yAmount* к каждой координате y элемента.21412142#### `moveto(tagOrId, x='', y='')`21432144Перемещает элементы, заданные *tagOrId*, так, чтобы первая пара координат (левый верхний угол ограничивающей рамки) наименьшего подходящего элемента находилась в позиции (*x*, *y*). *x* или *y* могут быть пустой строкой, в этом случае соответствующая координата не изменяется. Все подходящие элементы сохраняют свои позиции относительно друг друга.21452146Добавлено в версии 3.8.21472148#### `scale(tagOrId, xOrigin, yOrigin, xScale, yScale, /)`21492150Масштабирует координаты всех элементов, заданных *tagOrId*, в координатном пространстве холста. Каждая координата x корректируется так, чтобы её расстояние от *xOrigin* изменилось в *xScale* раз, а каждая координата y – чтобы её расстояние от *yOrigin* изменилось в *yScale* раз (коэффициент `1.0` оставляет координату без изменений).21512152#### `delete(*tagOrIds)`21532154Удаляет каждый из элементов, заданных аргументами *tagOrIds*.21552156#### `dchars(tagOrId, first, /)`21572158#### `dchars(tagOrId, first, last, /)`21592160Удаляет из каждого элемента, заданного *tagOrId*, символы (для текстовых элементов) или координаты (для элементов-линий и многоугольников) в диапазоне от *first* до *last* включительно; *last* по умолчанию равен *first*. Элементы, не поддерживающие индексацию, игнорируют эту операцию.21612162#### `insert(tagOrId, beforeThis, string, /)`21632164Вставляет *string* в каждый из элементов, заданных *tagOrId*, непосредственно перед символом или координатой, индекс которой равен *beforeThis*. Для элементов-линий и многоугольников *string* должна быть допустимой последовательностью координат.21652166#### `itemcget(tagOrId, option)`21672168Возвращает текущее значение опции конфигурации *option* для элемента, заданного *tagOrId* (наименьший подходящий элемент, если соответствует нескольким). Это похоже на [`cget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.cget), но применяется к отдельному элементу.21692170#### `itemconfigure(tagOrId, cnf=None, **kw)`21712172Запрос или изменение опций конфигурации элементов, заданных *tagOrId*. Это отражает [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.configure), но применяется к отдельным элементам, а не ко всему холсту. Без опций возвращает словарь, описывающий текущие опции первого подходящего элемента; в противном случае устанавливает указанные опции для каждого подходящего элемента. Допустимые опции – это те, которые принимает соответствующий метод `create_*`. [`itemconfig()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.itemconfig) является псевдонимом `itemconfigure()`.21732174#### `type(tagOrId)`21752176Возвращает тип элемента, заданного *tagOrId* (первый подходящий, если соответствует нескольким), например `'rectangle'` или `'text'`, или `None`, если *tagOrId* не соответствует ни одному элементу.21772178#### `gettags(tagOrId, /)`21792180Возвращает кортеж тегов, связанных с элементом, заданным параметром *tagOrId* (первый подходящий элемент в порядке отображения, если подходит несколько). Возвращает пустой кортеж, если ни один элемент не подходит или у элемента нет тегов.21812182#### `dtag(tagOrId, /)`21832184#### `dtag(tagOrId, tagToDelete, /)`21852186Удаляет тег *tagToDelete* (по умолчанию равный *tagOrId*) из каждого элемента, заданного параметром *tagOrId*. Элементы, у которых нет этого тега, остаются без изменений.21872188#### `addtag(newtag, searchSpec, /, *args)`21892190Добавляет тег *newtag* каждому элементу, выбранному по спецификации поиска *searchSpec* (и любым дополнительным параметрам *args*). *searchSpec* – одно из значений: `'above'`, `'all'`, `'below'`, `'closest'`, `'enclosed'`, `'overlapping'` или `'withtag'`; приведённые ниже методы `addtag_*` – это удобные обёртки, предоставляющие каждую из этих форм.21912192#### `addtag_above(newtag, tagOrId)`21932194Добавляет тег *newtag* элементу, расположенному непосредственно над (после) *tagOrId* в списке отображения.21952196#### `addtag_all(newtag)`21972198Добавляет тег *newtag* всем элементам на холсте.21992200#### `addtag_below(newtag, tagOrId)`22012202Добавляет тег *newtag* элементу, расположенному непосредственно под (перед) *tagOrId* в списке отображения.22032204#### `addtag_closest(newtag, x, y, halo=None, start=None)`22052206Добавляет тег *newtag* элементу, ближайшему к точке (*x*, *y*). Если задан *halo*, любой элемент в пределах этого расстояния от точки считается перекрывающим её. Если задан *start* (тег или id), выбирается самый верхний ближайший элемент, который находится ниже *start* в списке отображения. Это можно использовать для последовательного перебора всех ближайших элементов.22072208#### `addtag_enclosed(newtag, x1, y1, x2, y2)`22092210Добавляет тег *newtag* каждому элементу, полностью находящемуся внутри прямоугольника (*x1*, *y1*, *x2*, *y2*), где *x1* \<= *x2* и *y1* \<= *y2*.22112212#### `addtag_overlapping(newtag, x1, y1, x2, y2)`22132214Добавляет тег *newtag* каждому элементу, который перекрывает прямоугольник (*x1*, *y1*, *x2*, *y2*) или находится внутри него, где *x1* \<= *x2* и *y1* \<= *y2*.22152216#### `addtag_withtag(newtag, tagOrId)`22172218Добавляет тег *newtag* каждому элементу, заданному параметром *tagOrId*.22192220#### `find(searchSpec, /, *args)`22212222Возвращает кортеж идентификаторов всех элементов, выбранных по спецификации поиска *searchSpec* (и любым дополнительным параметрам *args*), в порядке наложения, начиная с самого нижнего элемента. Спецификация поиска может быть любой из форм, принимаемых методом [`addtag()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.addtag). Приведённые ниже методы `find_*` являются более удобными обёртками для него.22232224#### `find_above(tagOrId)`22252226Возвращает кортеж, содержащий идентификатор элемента, расположенного непосредственно над *tagOrId* в списке отображения.22272228#### `find_all()`22292230Возвращает кортеж идентификаторов всех элементов на холсте в порядке наложения.22312232#### `find_below(tagOrId)`22332234Возвращает кортеж, содержащий идентификатор элемента, расположенного непосредственно под *tagOrId* в списке отображения.22352236#### `find_closest(x, y, halo=None, start=None)`22372238Возвращает кортеж, содержащий идентификатор элемента, ближайшего к точке (*x*, *y*). Параметры *halo* и *start* интерпретируются так же, как в [`addtag_closest()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.addtag_closest).22392240#### `find_enclosed(x1, y1, x2, y2)`22412242Возвращает кортеж идентификаторов всех элементов, полностью находящихся внутри прямоугольника (*x1*, *y1*, *x2*, *y2*).22432244#### `find_overlapping(x1, y1, x2, y2)`22452246Возвращает кортеж идентификаторов всех элементов, которые перекрываются или находятся внутри прямоугольника (*x1*, *y1*, *x2*, *y2*).22472248#### `find_withtag(tagOrId)`22492250Возвращает кортеж идентификаторов всех элементов, заданных *tagOrId*.22512252#### `tag_raise(tagOrId, aboveThis=None, /)`22532254Перемещает все элементы, заданные *tagOrId*, на новую позицию в списке отображения сразу над элементом, заданным *aboveThis*, или в верхнюю часть списка отображения, если *aboveThis* опущен. При перемещении нескольких элементов их относительный порядок сохраняется. Это не влияет на встроенные оконные элементы, порядок наложения которых вместо этого управляется [`Misc.tkraise()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.tkraise) и [`Misc.lower()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.lower). [`lift()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.lift) и [`tkraise()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.tkraise) – псевдонимы `tag_raise()`.22552256#### `tag_lower(tagOrId, belowThis=None, /)`22572258Перемещает все элементы, заданные *tagOrId*, на новую позицию в списке отображения сразу под элементом, заданным *belowThis*, или в нижнюю часть списка отображения, если *belowThis* опущен. При перемещении нескольких элементов их относительный порядок сохраняется. Это не влияет на встроенные оконные элементы. [`lower()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.lower) – псевдоним `tag_lower()`.22592260> **Примечание**2261>2262> В классе `Canvas` методы [`tkraise()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.tkraise)/[`lift()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.lift) и [`lower()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.lower) изменяют порядок наложения элементов canvas, переопределяя унаследованные методы [`Misc.tkraise()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.tkraise)/[`Misc.lift()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.lift) и [`Misc.lower()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.lower), которые изменяют порядок самого виджета; поэтому эти унаследованные методы недоступны.22632264#### `tag_bind(tagOrId, sequence=None, func=None, add=None)`22652266Привязывает колбэк *func* к событию *sequence* для всех элементов, заданных *tagOrId*, так что *func* вызывается всякий раз, когда это событие происходит для одного из этих элементов. Это похоже на [`Widget.bind`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind), но работает с элементами canvas, а не с целыми виджетами; можно привязывать только события мыши, клавиатуры и виртуальные. События мыши направляются текущему элементу, а события клавиатуры – элементу с фокусом (см. [`focus()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.focus)). Если *add* истинно, новая привязка добавляется к уже существующим привязкам для того же события, а не заменяет их. Возвращает идентификатор привязанной функции, который можно передать [`tag_unbind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.tag_unbind).22672268#### `tag_unbind(tagOrId, sequence, funcid=None)`22692270Удаляет для всех элементов, заданных *tagOrId*, привязку к событию *sequence*. Если задан *funcid*, отвязывается и удаляется только этот колбэк (возвращённый [`tag_bind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.tag_bind)).22712272Изменено в версии 3.13: Если указан *funcid*, отвязывается только этот колбэк.22732274#### `bbox(tagOrId, /, *tagOrIds)`22752276Возвращает 4-кортеж `(x1, y1, x2, y2)`, задающий приблизительный ограничивающий прямоугольник в пикселях, который охватывает все элементы, заданные *tagOrId* и любыми дополнительными *tagOrIds*. Результат может превышать истинный ограничивающий прямоугольник на несколько пикселей. Возвращает `None`, если ни один элемент не соответствует или соответствующие элементы нечего отображать.22772278Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.22792280#### `canvasx(screenx, gridspacing=None)`22812282По заданной x-координате окна *screenx* возвращает x-координату canvas, отображаемую в этой позиции. Если задан *gridspacing*, результат округляется до ближайшего кратного *gridspacing* единицам.22832284#### `canvasy(screeny, gridspacing=None)`22852286По заданной y-координате окна *screeny* возвращает y-координату canvas, отображаемую в этой позиции. Если задан *gridspacing*, результат округляется до ближайшего кратного *gridspacing* единицам.22872288#### `focus()`22892290#### `focus(tagOrId, /)`22912292С параметром *tagOrId* устанавливает фокус клавиатуры canvas на первый элемент, заданный *tagOrId*, который поддерживает курсор вставки; если такого элемента нет, фокус остаётся без изменений. Если *tagOrId* – пустая строка, сбрасывает фокус так, что ни один элемент не имеет фокуса. Без аргументов возвращает идентификатор элемента, который в данный момент имеет фокус, или пустую строку, если такого нет. Элемент отображает курсор вставки только когда он сам является элементом с фокусом и его canvas имеет фокус ввода.22932294Этот метод затеняет унаследованный `Misc.focus()`; используйте [`focus_set()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.focus_set) для фокусировки самого виджета.22952296#### `icursor(tagOrId, index, /)`22972298Устанавливает курсор вставки элементов, заданных *tagOrId*, непосредственно перед символом, заданным *index*. Элементы, не поддерживающие курсор вставки, не затрагиваются. Курсор отображается только когда элемент имеет фокус, но его положение можно установить в любое время.22992300#### `index(tagOrId, index, /)`23012302Возвращает в виде целого числа числовой индекс внутри *tagOrId*, соответствующий *index*, который представляет собой текстовое описание позиции (для текстовых элементов – индекс символа, для отрезков и многоугольников – индекс в координатах). Если *tagOrId* соответствует нескольким элементам, используется первый из них, поддерживающий индексацию.23032304#### `select_adjust(tagOrId, index)`23052306Настраивает конец выделения в *tagOrId*, ближайший к *index*, так чтобы он находился на *index*, и делает другой конец якорной точкой для будущих вызовов [`select_to()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.select_to). Если выделение в данный момент не находится в *tagOrId*, это действует как `select_to()`.23072308#### `select_clear()`23092310Очищает выделение, если оно есть на этом холсте; в противном случае ничего не делает.23112312#### `select_from(tagOrId, index)`23132314Устанавливает точку привязки выделения непосредственно перед символом, заданным *index* в элементе, заданном *tagOrId*. Это не изменяет само выделение; оно устанавливает фиксированный конец для будущих вызовов [`select_to()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.select_to).23152316#### `select_item()`23172318Возвращает идентификатор элемента, содержащего выделение, или `None`, если выделение отсутствует на этом холсте. В отличие от методов [`find()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.find) и `find_*`, этот метод возвращает идентификатор в виде строки, а не целого числа.23192320#### `select_to(tagOrId, index)`23212322Устанавливает выделение на символы элемента *tagOrId* между точкой привязки выделения и *index*, включительно по *index*. Точкой привязки является та, что установлена последним вызовом [`select_adjust()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.select_adjust) или [`select_from()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.select_from).23232324#### `scan_mark(x, y)`23252326Запоминает *x*, *y* и текущий вид для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.scan_dragto). Обычно привязывается к нажатию кнопки мыши в виджете.23272328#### `scan_dragto(x, y, gain=10)`23292330Прокручивает холст на величину, равную *gain*, умноженному на разницу между *x*, *y* и координатами, переданными последнему вызову [`scan_mark()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas.scan_mark). Обычно это привязывается к событиям движения мыши на виджете, создавая эффект перетаскивания холста с высокой скоростью в его окне.23312332#### `postscript(cnf={}, **kw)`23332334Генерирует представление части или всего холста в формате PostScript (Encapsulated PostScript, версия 3.0). Если задан параметр *file* или *channel*, PostScript записывается туда и возвращается пустая строка; в противном случае он возвращается в виде строки. По умолчанию генерируется только область, видимая в данный момент в окне, поэтому обычно необходимо либо сначала вызвать [`update()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.update), либо использовать параметры *width* и *height*. Поддерживаемые параметры включают *colormap*, *colormode*, *file*, *fontmap*, *height*, *pageanchor*, *pageheight*, *pagewidth*, *pagex*, *pagey*, *rotate*, *width*, *x* и *y*.23352336#### `class tkinter.Checkbutton(master=None, cnf={}, **kw)`23372338Виджет `Checkbutton` отображает текстовую строку, растровое изображение или картинку вместе с квадратным индикатором и переключает логическое выделение при нажатии. Он обладает всем поведением простой кнопки и, кроме того, может быть выбран: при выборе индикатор рисуется с галочкой, а связанная переменная устанавливается в значение `onvalue`, а при отмене выбора индикатор рисуется пустым, а переменная устанавливается в значение `offvalue`. Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget). В дополнение к стандартным опциям виджета, флажок принимает опции, описанные на странице руководства Tk `checkbutton`, такие как *variable*, *onvalue*, *offvalue* и *command*.23392340#### `invoke()`23412342Делает то же самое, что произошло бы при нажатии пользователем на флажок мышью: переключает состояние выделения кнопки и вызывает связанную команду, если она есть. Возвращает результат команды или пустую строку, если с флажком не связана ни одна команда. Это игнорируется, если состояние флажка равно `disabled`.23432344#### `select()`23452346Выбирает флажок и устанавливает связанную переменную в его значение `onvalue`.23472348#### `deselect()`23492350Отменяет выбор флажка и устанавливает связанную переменную в его значение `offvalue`.23512352#### `toggle()`23532354Переключает состояние выделения кнопки, перерисовывая её и изменяя связанную переменную, чтобы отразить новое состояние.23552356#### `flash()`23572358Мигает флажком, перерисовывая его несколько раз, чередуя активный и обычный цвета. По окончании мигания флажок остаётся в том же обычном или активном состоянии, в котором он был при вызове метода. Это игнорируется, если состояние флажка равно `disabled`.23592360#### `class tkinter.Entry(master=None, cnf={}, **kw)`23612362Виджет `Entry` отображает одну строку текста и позволяет пользователю редактировать её. Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget) и [`XView`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView); поскольку поля ввода могут содержать слишком длинные строки, не помещающиеся в окно, они поддерживают горизонтальную прокрутку через [`xview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview).23632364В дополнение к стандартным опциям виджета, поле ввода принимает опции, описанные на странице руководства Tk `entry`. Примечательными являются *textvariable* (имя переменной, синхронизируемой с содержимым поля ввода), *show* (если установлено, каждый символ отображается как заданный символ, а не его истинное значение, полезно для ввода пароля), *validate* и *validatecommand* (которые вместе позволяют колбэку принять или отклонить правки), а также *state* (одно из значений `'normal'`, `'disabled'` или `'readonly'`).23652366Многие из приведенных ниже методов принимают аргумент *index*, который выбирает символ в строке поля ввода. Как описано на странице руководства Tk `entry`, *index* может быть числом (начиная с 0), `'insert'` (символ сразу после курсора вставки), `'end'` (сразу после последнего символа), `'anchor'` (точка привязки выделения), `'sel.first'` и `'sel.last'` (концы выделения), или `@x` (символ, соответствующий пиксельной координате x *x* в окне). Индексы вне диапазона округляются до ближайшего допустимого значения.23672368#### `delete(first, last=None)`23692370Удаляет символы от индекса *first* до индекса *last*, не включая его. Если *last* опущен, удаляется только один символ на позиции *first*.23712372#### `get()`23732374Возвращает текущую строку виджета Entry.23752376#### `insert(indexstring)`23772378Вставляет *string* непосредственно перед символом, заданным *index*.23792380#### `icursor(index)`23812382Устанавливает отображение курсора вставки непосредственно перед символом, заданным *index*.23832384#### `index(index)`23852386Возвращает числовой индекс, соответствующий *index*.23872388#### `selection_adjust(index)`23892390Находит конец выделения, ближайший к символу, заданному *index*, и перемещает этот конец на *index* (включительно, но не дальше); другой конец становится якорной точкой для последующих вызовов [`selection_to()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.selection_to). Если в поле ввода нет выделения, создаётся новое между *index* и последней якорной точкой включительно. [`select_adjust()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.select_adjust) – это псевдоним `selection_adjust()`.23912392#### `selection_clear()`23932394Очищает выделение, если оно находится в данном виджете. Если выделение не в этом виджете, метод не даёт эффекта. [`select_clear()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.select_clear) – это псевдоним `selection_clear()`.23952396> **Примечание**2397>2398> Этот метод переопределяет унаследованный [`Misc.selection_clear()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.selection_clear), который очищает X-выделение; этот метод недоступен для виджета `Entry`.23992400#### `selection_from(index)`24012402Устанавливает якорную точку выделения непосредственно перед символом, заданным *index*, не изменяя выделения. [`select_from()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.select_from) – это псевдоним `selection_from()`.24032404#### `selection_present()`24052406Возвращает `True`, если в поле ввода есть выделенные символы, иначе `False`. [`select_present()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.select_present) – это псевдоним `selection_present()`.24072408#### `selection_range(start, end)`24092410Устанавливает выделение, включающее символы, начиная с символа, индексированного *start*, и заканчивая символом, непосредственно предшествующим *end*. Если *end* ссылается на тот же символ, что и *start*, или более ранний, то выделение очищается. [`select_range()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.select_range) – это псевдоним `selection_range()`.24112412#### `selection_to(index)`24132414Устанавливает выделение между якорной точкой и *index*: если *index* находится до якорной точки, выделение идёт от *index* до якорной точки, не включая её; если *index* находится после неё, от якорной точки до *index*, не включая; если они совпадают, ничего не происходит. Якорная точка – это точка, установленная последним вызовом [`selection_from()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.selection_from) или [`selection_adjust()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.selection_adjust). Если в поле ввода нет выделения, создаётся новое с использованием последней якорной точки. [`select_to()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.select_to) – это псевдоним `selection_to()`.24152416#### `scan_mark(x)`24172418Запоминает *x* и текущий вид в окне поля ввода для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.scan_dragto). Обычно связано с нажатием кнопки мыши в виджете.24192420#### `scan_dragto(x)`24212422Вычисляет разницу между *x* и *x*, переданным в последний вызов [`scan_mark()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry.scan_mark), и смещает вид влево или вправо на 10-кратную величину этой разницы. Обычно используется с событиями движения мыши, чтобы создать эффект перетаскивания поля ввода с высокой скоростью по окну.24232424#### `class tkinter.Frame(master=None, cnf={}, **kw)`24252426Виджет `Frame` – это простой контейнер. Его основное назначение – служить разделителем или контейнером для сложных макетов окон; его единственные возможности – это фон и необязательная трёхмерная рамка, чтобы рамка выглядела приподнятой или утопленной. Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget). Обратитесь к странице руководства Tk `frame` для полного списка параметров.24272428#### `class tkinter.Label(master=None, cnf={}, **kw)`24292430Виджет `Label` отображает неинтерактивную текстовую строку, растровое изображение или картинку. Отображаемый текст задаётся параметром *text* или связывается с переменной через *textvariable*, а изображение можно показать с помощью параметра *image*. Весь текст должен быть одного шрифта, но может занимать несколько строк, и один символ может быть подчёркнут с помощью параметра *underline*. Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget). Обратитесь к странице руководства Tk `label` для полного списка параметров.24312432#### `class tkinter.LabelFrame(master=None, cnf={}, **kw)`24332434Виджет `LabelFrame` – это контейнер, который обладает возможностями [`Frame`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Frame) плюс возможность отображать метку. Текст метки задаётся параметром *text* и позиционируется с помощью *labelanchor*, или в качестве метки можно использовать произвольный виджет, передав его в параметре *labelwidget*. Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget). Обратитесь к странице руководства Tk `labelframe` для полного списка параметров.24352436#### `class tkinter.Listbox(master=None, cnf={}, **kw)`24372438Виджет `Listbox` отображает список однострочных текстовых элементов, по одному на строку, из которых пользователь может выбрать один или несколько. Поведение выделения определяется параметром *selectmode*, который может быть одним из: `browse` (по умолчанию; не более одного элемента, который можно перетаскивать мышью), `single` (не более одного элемента), `multiple` (любое количество элементов, переключаются индивидуально) или `extended` (любое количество элементов, включая несмежные диапазоны, выбираются щелчком и перетаскиванием). Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget), [`XView`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView) и [`YView`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView), поэтому представление можно прокручивать по горизонтали и вертикали с помощью [`xview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview) и [`yview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView.yview). Обратитесь к странице руководства Tk `listbox` для полного списка параметров.24392440Многие из методов принимают аргумент *индекс*, идентифицирующий конкретный элемент. Как описано на странице руководства Tk `listbox`, *индекс* может быть числовым индексом (начиная с 0 сверху), `'active'` (элемент в позиции курсора, задаётся с помощью [`activate()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.activate)), `'anchor'` (якорь выделения, задаётся с помощью [`selection_anchor()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.selection_anchor)), `'end'` (последний элемент, или для [`index()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.index) и [`insert()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.insert) позиция сразу после него), или `@x,y` (элемент, покрывающий пиксельные координаты *x*, *y* в окне listbox). Аргументы с именами *first* и *last* являются индексами тех же форм.24412442#### `insert(index, *elements)`24432444Вставляет заданные *элементы* как новые элементы непосредственно перед элементом, заданным *индексом*. Если *индекс* равен `'end'`, новые элементы добавляются в конец списка.24452446#### `delete(first, last=None)`24472448Удаляет элементы в диапазоне от *first* до *last* включительно. Если *last* опущен, по умолчанию используется *first*, так что удаляется один элемент.24492450#### `get(first, last=None)`24512452Если *last* опущен, возвращает содержимое элемента, заданного *first*, или пустую строку, если *first* ссылается на несуществующий элемент. Если *last* задан, возвращает кортеж всех элементов в диапазоне от *first* до *last* включительно.24532454#### `size()`24552456Возвращает общее количество элементов в listbox.24572458Этот метод затеняет унаследованный `Misc.size()`; используйте [`grid_size()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_size) для размера сетки.24592460#### `index(index)`24612462Возвращает целочисленное значение индекса, соответствующее *индексу*, или `None`, если *индекс* выходит за пределы диапазона. Если *индекс* равен `'end'`, результатом является количество элементов в listbox (не индекс последнего элемента).24632464#### `bbox(index)`24652466Возвращает кортеж `(x, y, width, height)`, описывающий ограничивающий прямоугольник (в пикселях относительно виджета) текста элемента, заданного *индексом*. Возвращает `None`, если ни одна часть этого элемента не видна на экране, или если *индекс* ссылается на несуществующий элемент; если элемент виден лишь частично, результат всё равно даёт полную область элемента, включая невидимые части.24672468Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.24692470#### `nearest(y)`24712472По заданной y-координате в окне listbox возвращает индекс видимого элемента, ближайшего к этой y-координате.24732474#### `see(index)`24752476Настраивает отображение так, чтобы элемент, заданный *индексом*, стал видимым. Если элемент уже видим, метод не даёт эффекта; если он находится у края окна, listbox прокручивается ровно настолько, чтобы показать его у этого края; в противном случае listbox прокручивается, чтобы центрировать элемент.24772478#### `activate(index)`24792480Устанавливает активный элемент равным элементу, заданному *индексом*. Если *индекс* находится вне диапазона элементов, вместо него активируется ближайший элемент. Активный элемент отображается в соответствии с опцией *activestyle*, когда виджет имеет фокус ввода; его индекс можно получить с помощью индекса `'active'`.24812482#### `curselection()`24832484Возвращает кортеж, содержащий числовые индексы всех элементов, которые в данный момент выбраны, или пустой кортеж, если ни один элемент не выбран.24852486#### `selection_anchor(index)`24872488Устанавливает якорь выделения на элемент, заданный *индексом*. Если *индекс* ссылается на несуществующий элемент, используется ближайший элемент. Якорь выделения – это конец выделения, который остаётся фиксированным при расширении выделения мышью; впоследствии на него можно ссылаться с помощью индекса `'anchor'`. [`select_anchor()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.select_anchor) является псевдонимом `selection_anchor()`.24892490#### `selection_clear(first, last=None)`24912492Снимает выделение с любых элементов в диапазоне от *first* до *last* включительно, которые выделены. Состояние выделения элементов вне этого диапазона не изменяется. [`select_clear()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.select_clear) является псевдонимом `selection_clear()`.24932494> **Примечание**2495>2496> Этот метод переопределяет унаследованный [`Misc.selection_clear()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.selection_clear), который очищает X-выделение; этот метод недоступен в `Listbox`.24972498#### `selection_includes(index)`24992500Возвращает `True`, если элемент, заданный *индексом*, в данный момент выбран, иначе `False`. [`select_includes()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.select_includes) является псевдонимом `selection_includes()`.25012502#### `selection_set(first, last=None)`25032504Выделяет все элементы в диапазоне от *first* до *last* включительно, не затрагивая состояние выделения элементов вне этого диапазона. [`select_set()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.select_set) является псевдонимом `selection_set()`.25052506#### `itemcget(index, option)`25072508Возвращает текущее значение конфигурационного параметра *option* для элемента, заданного *index*.25092510#### `itemconfigure(index, cnf=None, **kw)`25112512Запрашивает или изменяет параметры конфигурации элемента, заданного *index*. Это зеркально отражает [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.configure), но применяется к отдельному элементу, а не ко всему списковому полю. Без параметров возвращает словарь с описанием текущих параметров элемента; иначе устанавливает переданные параметры. Поддерживаемые параметры элемента: *background*, *foreground*, *selectbackground* и *selectforeground*. [`itemconfig()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.itemconfig) – это псевдоним `itemconfigure()`.25132514#### `scan_mark(x, y)`25152516Запоминает *x*, *y* и текущий вид для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.scan_dragto). Обычно привязывается к нажатию кнопки мыши в виджете.25172518#### `scan_dragto(x, y)`25192520Прокручивает список на величину, равную разнице между *x*, *y* и координатами, переданными последнему вызову [`scan_mark()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox.scan_mark), умноженную на 10. Обычно привязывается к событиям движения мыши в виджете, создавая эффект быстрого перетаскивания списка по окну.25212522#### `class tkinter.Menu(master=None, cnf={}, **kw)`25232524Виджет `Menu` отображает столбец записей, каждая из которых может быть командой, флажком, радиокнопкой, каскадом (который открывает связанное подменю) или разделителем. Меню используются как строка меню главного окна, как выпадающие меню, открываемые из каскадной записи или кнопки меню, а также как контекстные меню. Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget).25252526Многие методы записей принимают аргумент *index*, определяющий, с какой записью работать. Как описано на странице руководства Tk `menu`, *index* может быть числовым индексом (начиная с 0 сверху), `'active'` (текущая активная запись), `'end'` или `'last'` (самая нижняя запись), `'none'` (нет записи, в Tcl записывается как `{}`), `@y` (запись, покрывающая пиксельную координату y *y* в окне меню) или шаблоном, который сопоставляется с метками записей сверху вниз.25272528#### `add(itemType, cnf={}, **kw)`25292530Добавляет новую запись в конец меню. *itemType* – одно из значений `'command'`, `'cascade'`, `'checkbutton'`, `'radiobutton'` или `'separator'` и определяет тип новой записи; остальные параметры настраивают её. Методы-сокращения `add_command()`, `add_cascade()`, `add_checkbutton()`, `add_radiobutton()` и `add_separator()` вызывают этот метод с соответствующим *itemType*.25312532Запись настраивается следующими параметрами, хотя не каждый параметр применим ко всем типам записей (разделитель не принимает ни одного из них):25332534***label***25352536Текст, отображаемый в записи.25372538***command***25392540Функция, вызываемая при активации записи (для записей типа command, checkbutton и radiobutton).25412542***accelerator***25432544Строка, отображаемая справа от записи для указания клавиш быстрого вызова; сама она не создаёт привязку.25452546***underline***25472548Индекс символа в метке, который будет подчёркнут для навигации с клавиатуры.25492550***state***25512552Одно из `'normal'`, `'active'` или `'disabled'`.25532554***image***25552556Изображение, отображаемое вместо текстовой метки или вместе с ней.25572558***составной***25592560Где показывать изображение относительно текста: `'none'` (по умолчанию), `'text'`, `'image'`, `'top'`, `'bottom'`, `'left'` или `'right'`.25612562***bitmap***25632564Растровое изображение, отображаемое вместо текстовой метки.25652566***font***25672568Шрифт, используемый для текста.25692570***background*, *foreground***25712572Цвета фона и текста элемента в обычном состоянии (игнорируется на macOS).25732574***activebackground*, *activeforeground***25752576Цвета фона и текста, используемые, когда элемент активен (игнорируется на macOS).25772578***columnbreak***25792580Если true, элемент начинает новую колонку вместо того, чтобы располагаться под предыдущим элементом.25812582***hidemargin***25832584Если true, стандартный отступ вокруг элемента убирается; это полезно, когда меню используется как палитра.25852586***menu***25872588Подменю, открываемое каскадным элементом; оно должно быть дочерним по отношению к данному меню.25892590***переменная***25912592Переменная, связанная с элементом флажка или переключателя.25932594***onvalue*, *offvalue***25952596Значения, сохраняемые в *variable*, когда элемент флажка выбран или сброшен.25972598***значение***25992600Значение, сохраняемое в *variable*, когда элемент переключателя выбран.26012602***indicatoron***26032604Определяет, отображать ли индикатор элемента флажка или переключателя.26052606***selectcolor***26072608Цвет индикатора элемента флажка или переключателя, когда он выбран.26092610***selectimage***26112612Изображение, отображаемое, когда элемент флажка или переключателя выбран и также задано *image*.26132614#### `add_cascade(cnf={}, **kw)`26152616Добавляет новый каскадный элемент в нижнюю часть меню. Каскадный элемент имеет связанное подменю, задаваемое его опцией *menu*, которая должна быть дочерним меню по отношению к данному меню; при открытии элемента подменю отображается рядом с ним.26172618#### `add_checkbutton(cnf={}, **kw)`26192620Добавляет новый элемент флажка в нижнюю часть меню. При вызове элемент флажка переключается между значениями *onvalue* и *offvalue*, сохраняя результат в связанной *variable*, и отображает индикатор, показывающий, выбран ли он.26212622#### `add_command(cnf={}, **kw)`26232624Добавляет новый командный элемент в нижнюю часть меню. Командный элемент ведёт себя как кнопка: при его вызове выполняется колбэк, заданный опцией *command*.26252626#### `add_radiobutton(cnf={}, **kw)`26272628Добавляет новый элемент переключателя в нижнюю часть меню. Элементы переключателей, использующие одну и ту же *variable*, образуют группу, в которой в любой момент может быть выбран только один; при выборе элемента его *value* сохраняется в переменной.26292630#### `add_separator(cnf={}, **kw)`26312632Добавляет разделитель в нижнюю часть меню. Разделитель отображается в виде горизонтальной линии и не может быть активирован или вызван.26332634#### `insert(index, itemType, cnf={}, **kw)`26352636То же, что и [`add()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.add), за исключением того, что новый элемент вставляется непосредственно перед элементом с индексом *index*, а не добавляется в конец меню. *itemType* – одно из `'command'`, `'cascade'`, `'checkbutton'`, `'radiobutton'` или `'separator'`. Вспомогательные методы `insert_command()`, `insert_cascade()`, `insert_checkbutton()`, `insert_radiobutton()` и `insert_separator()` вызывают этот метод с соответствующим *itemType*.26372638#### `insert_cascade(index, cnf={}, **kw)`26392640Вставить новый каскадный элемент перед элементом, заданным *index* (см. [`add_cascade()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.add_cascade)).26412642#### `insert_checkbutton(index, cnf={}, **kw)`26432644Вставить новый элемент-флажок перед элементом, заданным *index* (см. [`add_checkbutton()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.add_checkbutton)).26452646#### `insert_command(index, cnf={}, **kw)`26472648Вставить новый элемент-команду перед элементом, заданным *index* (см. [`add_command()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.add_command)).26492650#### `insert_radiobutton(index, cnf={}, **kw)`26512652Вставить новый элемент-переключатель перед элементом, заданным *index* (см. [`add_radiobutton()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.add_radiobutton)).26532654#### `insert_separator(index, cnf={}, **kw)`26552656Вставить разделитель перед элементом, заданным *index* (см. [`add_separator()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.add_separator)).26572658#### `delete(index1, index2=None)`26592660Удаляет все пункты меню между *index1* и *index2* включительно. Если *index2* опущен, по умолчанию используется *index1*, так что удаляется один элемент. Попытки удалить отрывной элемент игнорируются; удалите его, изменив параметр *tearoff*.26612662#### `entrycget(index, option)`26632664Возвращает текущее значение параметра конфигурации *option* для элемента, заданного *index*.26652666#### `entryconfigure(index, cnf=None, **kw)`26672668Запрашивает или изменяет параметры конфигурации элемента, заданного *index*. Это работает как [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.configure), но применяется к отдельному элементу, а не ко всему меню. Без аргументов возвращает словарь с текущими параметрами элемента; иначе устанавливает указанные параметры. Поддерживаются те же параметры, что принимает [`add()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.add) для данного типа элемента. [`entryconfig()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.entryconfig) является псевдонимом `entryconfigure()`.26692670#### `index(index)`26712672Возвращает числовой индекс, соответствующий *index*, или `None`, если *index* не указывает ни на один элемент.26732674#### `type(index)`26752676Возвращает тип элемента, заданного *index*: одно из значений `'command'`, `'cascade'`, `'checkbutton'`, `'radiobutton'`, `'separator'` или `'tearoff'` (для отрывного элемента).26772678#### `activate(index)`26792680Делает элемент, заданный *index*, активным, перерисовывая его активными цветами, и деактивирует ранее активный элемент. Если *index* не указывает ни на один элемент или выбранный элемент отключён, в меню не будет активного элемента.26812682#### `invoke(index)`26832684Вызывает действие элемента, заданного *index*, как если бы на нём щёлкнули. Если элемент отключён, ничего не происходит. Если с элементом связана *command*, возвращается результат выполнения этой команды; в противном случае возвращается пустая строка.26852686#### `post(x, y)`26872688Отображает меню на экране в координатах корневого окна *x* и *y*, при необходимости корректируя их, чтобы всё меню было видимо. Если указан параметр *postcommand*, он вычисляется перед отображением меню.26892690#### `tk_popup(x, y, entry='')`26912692Отображает меню как всплывающее в координатах корневого окна *x* и *y*. Если указан *entry*, меню позиционируется так, чтобы этот элемент отображался под указателем.26932694#### `unpost()`26952696Скрывает меню, чтобы оно больше не отображалось, также скрывая любые отображённые каскадные подменю нижнего уровня. Не действует в Windows и macOS, которые управляют скрытием меню самостоятельно.26972698#### `xposition(index)`26992700Возвращает x-координату (в окне меню) самого левого пикселя элемента, заданного *index*.27012702Добавлено в версии 3.3.27032704#### `yposition(index)`27052706Возвращает координату y самого верхнего пикселя записи, заданной *index*, в окне меню.27072708#### `class tkinter.Menubutton(master=None, cnf={}, **kw)`27092710Виджет `Menubutton` отображает текстовую строку, растровое изображение или картинку и при нажатии показывает связанное [`Menu`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu), заданное параметром *menu*. Как и [`Label`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Label), он может показывать *text*, *textvariable* или *image*, а параметр *direction* управляет тем, где появится меню относительно кнопки. Наследуется от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget). Полный список параметров приведен на странице руководства Tk `menubutton`.27112712#### `class tkinter.Message(master=None, cnf={}, **kw)`27132714Виджет `Message` отображает неинтерактивную текстовую строку, заданную параметром *text* или связанную с переменной через *textvariable*. В отличие от [`Label`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Label), он разбивает строку на несколько строк для получения заданного соотношения сторон, выбирая разрывы строк на границах слов, и может выравнивать текст по левому краю, по центру или по правому. Наследуется от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget). Полный список параметров приведен на странице руководства Tk `message`.27152716#### `class tkinter.OptionMenu(master, variable, value, *values, **kwargs)`27172718Вспомогательный подкласс [`Menubutton`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menubutton), отображающий всплывающее меню с взаимоисключающими вариантами. *variable* – это [`Variable`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable), синхронизируемая с выбором, *value* – начальный выбор, а *values* – остальные пункты меню. Именованный аргумент *command* может задавать колбэк, который вызывается с выбранным значением, а именованный аргумент *name* устанавливает имя виджета Tk.27192720#### `destroy()`27212722Уничтожает виджет, а также очищает связанное всплывающее меню.27232724Изменено в версии 3.14: Добавлена поддержка аргумента-ключевого слова *name*.27252726#### `class tkinter.PanedWindow(master=None, cnf={}, **kw)`27272728`PanedWindow` – это виджет-менеджер геометрии, который размещает любое количество дочерних *панелей* в ряд (если *orient* равен `'horizontal'`) или в колонку (если *orient* равен `'vertical'`). Каждая панель содержит один виджет, и каждая пара соседних панелей разделена подвижным *разделителем*, который пользователь может перетаскивать мышью для изменения размеров виджетов по обе стороны от него. Наследуется от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget).27292730Параметр *orient* выбирает направление расположения, *sashwidth* задаёт ширину каждого разделителя, а *sashrelief* – его рельеф. Если *showhandle* равен true, на каждом разделителе рисуется небольшая ручка, за которую пользователь может ухватиться, чтобы перетащить его. Полный список параметров приведен на странице руководства Tk `panedwindow`.27312732#### `add(child, **kw)`27332734Добавляет *child* в panedwindow в качестве новой панели, размещая её после всех существующих панелей. Именованные аргументы задают параметры управления для *child*; это могут быть любые параметры, принимаемые [`paneconfigure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow.paneconfigure).27352736#### `remove(child)`27372738Удаляет панель, содержащую *child*, из panedwindow. Все параметры управления геометрией для *child* забываются. [`forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow.forget) – это псевдоним `remove()`. Этот метод скрывает унаследованный `forget()`; используйте [`pack_forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.pack_forget), [`grid_forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Grid.grid_forget) или [`place_forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Place.place_forget), чтобы удалить сам виджет из его менеджера.27392740#### `panes()`27412742Возвращает кортеж виджетов, управляемых panedwindow, по одному на панель, в порядке их расположения.27432744#### `panecget(child, option)`27452746Возвращает текущее значение параметра управления *option* для панели, содержащей *child*. *option* может быть любым значением, допустимым для [`paneconfigure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow.paneconfigure).27472748#### `paneconfigure(tagOrId, cnf=None, **kw)`27492750Запрашивает или изменяет параметры управления панели, содержащей виджет *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.15/library/tkinter.html#tkinter.PanedWindow.paneconfig) – это псевдоним `paneconfigure()`.27512752#### `identify(x, y)`27532754Определяет компонент panedwindow под точкой с координатами *x* и *y* в оконных координатах. Если точка находится над разделителем или ручкой разделителя, результатом будет кортеж из двух элементов: индекс разделителя или ручки и слово, указывающее, находится ли точка над разделителем или ручкой, например `(0, 'sash')` или `(2, 'handle')`. Если точка находится над любой другой частью panedwindow, результатом будет пустая строка.27552756#### `sash(*args)`27572758Запрашивает или изменяет положение разделителей в panedwindow. Это тонкая обёртка вокруг подкоманды Tk `sash`; обычно вместо неё следует использовать удобные методы [`sash_coord()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow.sash_coord), [`sash_mark()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow.sash_mark) и [`sash_place()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow.sash_place).27592760#### `sash_coord(index)`27612762Возвращает пару координат x и y для разделителя с индексом *index*, который должен быть целым числом от 0 до (количество панелей в panedwindow минус 1). Возвращаемые координаты – это координаты левого верхнего угла области, содержащей разделитель.27632764#### `sash_mark(index)`27652766Запоминает текущее положение мыши для разделителя с индексом *index* для последующего перемещения разделителя операциями перетаскивания.27672768#### `sash_place(index, x, y)`27692770Поместите sash, заданный через *index*, в координаты *x* и *y*.27712772#### `proxy(*args)`27732774Запрос или изменение позиции прокси-разделителя (sash proxy), «призрачного» разделителя, отображаемого во время перетаскивания разделителя при непрозрачном изменении размера. Это тонкая обёртка вокруг подкоманды Tk `proxy`; вместо неё обычно следует использовать удобные методы [`proxy_coord()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow.proxy_coord), [`proxy_forget()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow.proxy_forget) и [`proxy_place()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow.proxy_place).27752776#### `proxy_coord()`27772778Возвращает кортеж, содержащий координаты x и y последнего местоположения прокси.27792780#### `proxy_forget()`27812782Удаляет прокси с экрана.27832784#### `proxy_place(x, y)`27852786Помещает прокси в координаты *x* и *y*.27872788#### `class tkinter.Radiobutton(master=None, cnf={}, **kw)`27892790Виджет `Radiobutton` отображает текстовую строку, растровое изображение или картинку вместе с ромбовидным или круглым индикатором и позволяет выбрать один вариант из нескольких. Он обладает всем поведением простой кнопки и, кроме того, может быть выбран: обычно несколько радиокнопок используют одну *variable*, и выбор одной устанавливает эту переменную в *value* радиокнопки; каждая радиокнопка также отслеживает переменную и автоматически выбирает или снимает выбор при изменении переменной. Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget). В дополнение к стандартным опциям виджета, радиокнопка принимает опции, описанные на странице руководства Tk `radiobutton`, такие как *variable*, *value* и *command*.27912792#### `invoke()`27932794Делает то же самое, что произошло бы при нажатии пользователем на радиокнопку мышью: выбирает кнопку и вызывает связанную команду, если таковая имеется. Возвращает результат команды или пустую строку, если с радиокнопкой не связана ни одна команда. Игнорируется, если состояние радиокнопки `disabled`.27952796#### `select()`27972798Выбирает радиокнопку и устанавливает связанную переменную в значение, соответствующее этому виджету.27992800#### `deselect()`28012802Снимает выбор с радиокнопки и устанавливает связанную переменную в пустую строку. Если эта радиокнопка не была выбрана, действие не выполняется.28032804#### `flash()`28052806Мигает радиокнопкой, перерисовывая её несколько раз с чередованием активного и обычного цветов. По завершении мигания радиокнопка остаётся в том же обычном или активном состоянии, что и в момент вызова метода. Игнорируется, если состояние радиокнопки `disabled`.28072808#### `class tkinter.Scale(master=None, cnf={}, **kw)`28092810Виджет `Scale` позволяет пользователю выбрать числовое значение путём перемещения ползунка вдоль дорожки. Он может быть ориентирован вертикально или горизонтально и при желании отображать метку и текущее значение. Наследует от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget).28112812В дополнение к стандартным опциям виджета, шкала (scale) принимает опции, описанные на странице руководства Tk `scale`, такие как *from\_*, *to*, *resolution*, *orient*, *tickinterval*, *variable* и *command*. Как и везде в `tkinter`, ведущий `-` имени опции Tk опускается; *from* записывается как `from_`, потому что [`from`](https://python-all.ru/3.15/reference/simple_stmts.html#from) является ключевым словом Python.28132814При нецелом *resolution* см. [числовые значения и локаль](https://python-all.ru/3.15/library/tkinter.html#tkinter-numeric-locale).28152816#### `get()`28172818Возвращает текущее значение шкалы. Результат является целым числом, если *resolution* шкалы даёт целые числа, и числом с плавающей запятой в противном случае.28192820#### `set(value)`28212822Устанавливает шкалу в значение *value*, соответственно перемещая ползунок. Не действует, если шкала отключена.28232824#### `coords(value=None)`28252826Возвращает кортеж `(x, y)`, содержащий пиксельные координаты относительно виджета точки на центральной линии дорожки, соответствующей *value*. Если *value* опущен, используется текущее значение шкалы.28272828#### `identify(x, y)`28292830Возвращает строку, описывающую часть шкалы в пиксельных координатах *x*, *y*: `'slider'`, `'trough1'` (часть дорожки выше или левее ползунка), `'trough2'` (ниже или правее ползунка), или пустую строку, если точка не находится ни над одним из этих элементов.28312832#### `class tkinter.Scrollbar(master=None, cnf={}, **kw)`28332834Виджет `Scrollbar` отображает ползунок и две стрелки, позволяющие пользователю прокручивать связанный виджет, например [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox), [`Text`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text), [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas) или [`Entry`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry). Он соединяется с прокручиваемым виджетом путём установки опции *xscrollcommand* или *yscrollcommand* этого виджета на метод [`set()`](https://python-all.ru/3.15/library/stdtypes.html#set) полосы прокрутки, а опции *command* полосы прокрутки – на метод [`xview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview) или [`yview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView.yview) прокручиваемого виджета. Наследуется от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget).28352836#### `get()`28372838Возвращает текущие настройки полосы прокрутки в виде кортежа `(first, last)` из двух дробей от 0 до 1, описывающих часть документа, которая в данный момент видна, как было последний раз передано в [`set()`](https://python-all.ru/3.15/library/stdtypes.html#set).28392840#### `set(first, last)`28412842Устанавливает полосу прокрутки. *first* и *last* – это дроби от 0 до 1, задающие позиции начала и конца видимой части связанного документа. Этот метод обычно регистрируется как *xscrollcommand* или *yscrollcommand* прокручиваемого виджета и вызывается этим виджетом.28432844#### `activate(index=None)`28452846Помечает элемент *index* (один из `'arrow1'`, `'slider'` или `'arrow2'`) как активный, отображая его в соответствии с опциями *activebackground* и *activerelief*. Если *index* опущен, возвращает имя текущего активного элемента или `None`, если ни один элемент не активен.28472848Изменено в версии 3.5: Аргумент *index* теперь необязателен.28492850#### `delta(deltax, deltay)`28512852Возвращает число с плавающей точкой, указывающее дробное изменение настройки полосы прокрутки, соответствующее перемещению ползунка на *deltax* пикселей по горизонтали (для горизонтальных полос прокрутки) или на *deltay* пикселей по вертикали (для вертикальных полос прокрутки).28532854#### `fraction(x, y)`28552856Возвращает число с плавающей точкой от 0 до 1, указывающее, где находится точка с пиксельными координатами *x*, *y* в желобе: 0 соответствует верхнему или левому краю желоба, а 1 – нижнему или правому.28572858#### `identify(x, y)`28592860Возвращает имя элемента под пиксельными координатами *x*, *y* (например, `'arrow1'`) или пустую строку, если точка не находится ни в одном элементе полосы прокрутки.28612862#### `class tkinter.Spinbox(master=None, cnf={}, **kw)`28632864Виджет `Spinbox` – это виджет, похожий на [`Entry`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry), с парой кнопок со стрелками вверх/вниз, позволяющих пользователю перебирать диапазон значений, а также редактировать значение напрямую. Набор значений может быть числовым диапазоном, задаваемым опциями *from\_*, *to* и *increment*, или явным списком строк, задаваемым опцией *values* (которая имеет приоритет над диапазоном). Каждый раз при нажатии на стрелку вызывается колбэк *command*, если он задан; опция *wrap* управляет тем, будет ли переход за пределы диапазона зацикливаться на другой стороне; опция *format* определяет форматирование числовых значений; а опция *validate* включает проверку введённого текста. Наследуется от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget) и [`XView`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView).28652866При нецелом *increment* см. [числовые значения и локаль](https://python-all.ru/3.15/library/tkinter.html#tkinter-numeric-locale).28672868Многие методы принимают аргумент *index*, идентифицирующий символ в строке spinbox. Как описано на странице руководства Tk `spinbox`, *index* может быть числовым индексом (начиная с 0), `'anchor'` (якорная точка выделения), `'end'` (сразу после последнего символа), `'insert'` (символ сразу после курсора вставки), `'sel.first'` или `'sel.last'` (концы выделения) или `@x` (символ, покрывающий пиксельную координату x *x* в окне).28692870#### `get()`28712872Возвращает строку spinbox.28732874#### `insert(index, s)`28752876Вставляет символы строки *s* непосредственно перед символом, заданным *index*.28772878#### `delete(first, last=None)`28792880Удаляет один или несколько символов spinbox. *first* – это индекс первого удаляемого символа, а *last* – индекс символа, следующего за последним удаляемым. Если *last* опущен, удаляется один символ по индексу *first*.28812882#### `icursor(index)`28832884Устанавливает отображение курсора вставки непосредственно перед символом, заданным *index*.28852886#### `index(index)`28872888Возвращает числовой индекс, соответствующий *index*, в виде строки.28892890#### `bbox(index)`28912892Возвращает кортеж из четырёх целых чисел `(x, y, width, height)`, описывающих ограничивающий прямоугольник символа, заданного *index*. *x* и *y* – это пиксельные координаты левого верхнего угла символа относительно виджета, а *width* и *height* – его размер в пикселях. Ограничивающий прямоугольник может относиться к области за пределами видимой части окна.28932894Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.28952896#### `identify(x, y)`28972898Возвращает имя элемента окна по координатам пикселей *x*, *y*: одно из `'buttondown'`, `'buttonup'`, `'entry'` или `'none'`.28992900#### `invoke(element)`29012902Вызывает кнопку вращения, заданную *элементом*, либо `'buttonup'`, либо `'buttondown'`, запуская связанное с ней действие.29032904#### `scan(*args)`29052906Тонкая обёртка вокруг подкоманды виджета Tk `scan`, используемая для быстрого перетаскивания представления: `scan('mark', x)` записывает *x* и текущее представление, а `scan('dragto', x)` корректирует представление относительно этой метки. Методы [`scan_mark()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.scan_mark) и [`scan_dragto()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.scan_dragto) оборачивают две формы.29072908#### `scan_mark(x)`29092910Записывает *x* и текущее представление в окне spinbox для последующего вызова [`scan_dragto()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.scan_dragto). Обычно это связано с нажатием кнопки мыши на виджете.29112912#### `scan_dragto(x)`29132914Корректирует представление на величину, равную 10-кратной разности между *x* и *x*, переданным последнему вызову [`scan_mark()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.scan_mark). Обычно это связано с событиями движения мыши, создавая эффект перетаскивания spinbox с высокой скоростью по окну.29152916#### `selection(*args)`29172918Тонкая обёртка вокруг подкоманды виджета 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.15/library/tkinter.html#tkinter.Spinbox.selection_adjust), [`selection_clear()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.selection_clear), [`selection_element()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.selection_element), [`selection_from()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.selection_from), [`selection_present()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.selection_present), [`selection_range()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.selection_range) и [`selection_to()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.selection_to) оборачивают эти формы.29192920#### `selection_adjust(index)`29212922Находит конец выделения, ближайший к символу, заданному *index*, и корректирует этот конец, чтобы он находился на *index* (включая *index*, но не выходя за него). Другой конец становится якорной точкой для будущих вызовов [`selection_to()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.selection_to). Если выделение в данный момент отсутствует в spinbox, создаётся новое выделение, включающее символы между *index* и последней якорной точкой включительно.29232924#### `selection_clear()`29252926Очищает выделение, если оно находится в этом виджете. Если выделения нет в этом виджете, метод не даёт эффекта.29272928> **Примечание**2929>2930> Этот метод переопределяет унаследованный [`Misc.selection_clear()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.selection_clear), который очищает X-выделение; этот метод недоступен в `Spinbox`.29312932#### `selection_element(element=None)`29332934Устанавливает или возвращает текущий выбранный элемент. Если передан *элемент* (один из `'buttonup'`, `'buttondown'` или `'none'`), эта кнопка вращения выбирается и отображается нажатой; в противном случае возвращается имя текущего выбранного элемента.29352936#### `selection_from(index)`29372938Устанавливает якорную точку выделения непосредственно перед символом, заданным *index*, не изменяя само выделение.29392940Добавлено в версии 3.8.29412942#### `selection_present()`29432944Возвращает `True`, если в spinbox выбраны какие-либо символы, и `False` в противном случае.29452946Добавлено в версии 3.8.29472948#### `selection_range(start, end)`29492950Устанавливает выделение, включающее символы, начиная с символа с индексом *start* и заканчивая символом непосредственно перед *end*. Если *end* указывает на тот же символ, что и *start*, или на более ранний, выделение очищается.29512952Добавлено в версии 3.8.29532954#### `selection_to(index)`29552956Устанавливает выделение между *index* и якорной точкой. Если *index* находится до якорной точки, выделение идёт от *index* до якорной точки, не включая её; если после – выделение идёт от якорной точки до *index*, не включая его; если совпадает, ничего не происходит. Якорная точка задаётся последним вызовом [`selection_from()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.selection_from) или [`selection_adjust()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox.selection_adjust). Если выделение отсутствует в этом виджете, создаётся новое выделение с использованием последней якорной точки.29572958Добавлено в версии 3.8.29592960#### `class tkinter.Text(master=None, cnf={}, **kw)`29612962Виджет `Text` отображает и редактирует многострочный текст. Части текста могут быть стилизованы с помощью **тегов**, отдельные позиции могут быть помечены плавающими **метками**, а в текст могут быть встроены произвольные изображения и другие виджеты. Виджет также предоставляет неограниченный механизм отмены/повтора и поддерживает равноправные виджеты (peer widgets), использующие те же базовые данные. Наследуется от [`Widget`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Widget), [`XView`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView) и [`YView`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView), поэтому представление можно прокручивать по горизонтали и вертикали с помощью [`xview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview) и [`yview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView.yview). Полный список опций см. на странице руководства Tk `text`.29632964Большинство методов принимают один или несколько аргументов *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'`.29652966#### `insert(index, chars, *args)`29672968Вставляет строку *chars* непосредственно перед символом на *index* (если *index* равен `'end'`, то непосредственно перед последним символом новой строки). По умолчанию новый текст наследует любые теги, присутствующие с обеих сторон точки вставки. Если задан *args*, он состоит из чередующихся значений *tagList*, *chars*: предыдущий *chars* получает именно перечисленные теги (список тегов может быть именем одного тега или последовательностью имён), переопределяя окружающие теги.29692970#### `delete(index1, index2=None)`29712972Удаляет диапазон символов от *index1* включительно до *index2* не включительно. Если *index2* опущен, удаляется единственный символ в *index1*. Виджет всегда сохраняет символ новой строки в качестве последнего символа, поэтому удаление, которое могло бы его удалить, корректируется соответствующим образом.29732974#### `replace(index1, index2, chars, *args)`29752976Заменяет диапазон символов от *index1* включительно до *index2* не включительно на *chars*. Это эквивалентно [`delete()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text.delete), за которым следует [`insert()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text.insert) в позиции *index1*; *args* интерпретируется так же, как для `insert()`.29772978Добавлено в версии 3.3.29792980#### `get(index1, index2=None)`29812982Возвращает текст от *index1* до *index2* (не включая) в виде строки. Если *index2* опущен, возвращает единственный символ по индексу *index1*. Встроенные изображения и окна не включаются в результат.29832984#### `index(index)`29852986Возвращает позицию, соответствующую *index*, в канонической форме `'line.char'`.29872988#### `compare(index1, op, index2)`29892990Сравнивает позиции *index1* и *index2* с помощью оператора отношения *op*, который должен быть одним из `'<'`, `'<='`, `'=='`, `'>='`, `'>'` или `'!='`, и возвращает логический результат.29912992#### `count(index1, index2, *options, return_ints=False)`29932994Подсчитывает количество элементов запрошенных типов между *index1* и *index2*; результат отрицательный, если *index1* находится после *index2*. Каждый из *options* задаёт тип подсчитываемого элемента: `'chars'`, `'displaychars'`, `'displayindices'`, `'displaylines'`, `'indices'`, `'lines'`, `'xpixels'` или `'ypixels'` (по умолчанию, если ни один параметр не указан, используется `'indices'`). Псевдо-параметр `'update'` принудительно пересчитывает устаревшую информацию о расположении до обработки последующих параметров. Если *return\_ints* равен true и указан только один параметр подсчёта, возвращается простое целое число; в противном случае возвращается кортеж с одним целым числом для каждого параметра подсчёта (или `None`, если результат пуст).29952996Добавлено в версии 3.3.29972998Изменено в версии 3.13: Добавлен параметр *return\_ints*.29993000#### `see(index)`30013002Настраивает отображение так, чтобы символ, заданный *index*, был видимым. Если он уже видим, метод не производит никакого эффекта; если он находится на небольшом расстоянии за пределами видимости, виджет прокручивает ровно настолько, чтобы подвести его к ближайшему краю; в противном случае прокручивает так, чтобы *index* оказался в центре окна.30033004#### `bbox(index)`30053006Возвращает кортеж `(x, y, width, height)`, задающий ограничивающий прямоугольник (в пикселях) видимой части символа по индексу *index*, или `None`, если этот символ не видим на экране.30073008Этот метод переопределяет унаследованный `Misc.bbox()`; используйте [`grid_bbox()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_bbox) для получения ограничивающего прямоугольника в сетке.30093010#### `dlineinfo(index)`30113012Возвращает кортеж `(x, y, width, height, baseline)`, описывающий строку отображения, содержащую *index*: первые четыре значения задают ограничивающий прямоугольник строки в пикселях, а *baseline* задаёт смещение базовой линии вниз от верхней границы области. Возвращает `None`, если эта строка отображения не видна на экране.30133014#### `mark_set(markName, index)`30153016Устанавливает метку с именем *markName* в позицию непосредственно перед символом по индексу *index*, создавая метку, если её ещё не существует. Метка, созданная таким образом, по умолчанию имеет правую гравитацию.30173018#### `mark_unset(*markNames)`30193020Удаляет каждую из меток, имена которых указаны в *markNames*. Специальные метки `insert` и `current` не могут быть удалены.30213022#### `mark_names()`30233024Возвращает кортеж имён всех меток, установленных в данный момент в виджете.30253026#### `mark_gravity(markName, direction=None)`30273028Если *direction* опущен, возвращает гравитацию метки *markName*: либо `'left'`, либо `'right'`. В противном случае устанавливает её гравитацию равной *direction*. Гравитация определяет, с какой стороны от метки появляется текст, вставленный в позицию метки: метка с правой гравитацией (по умолчанию) остаётся справа от такого текста.30293030#### `mark_next(index)`30313032Возвращает имя первой метки, находящейся в позиции *index* или после неё, или `None`, если такой метки нет. Если *index* является именем метки, поиск начинается сразу после этой метки.30333034#### `mark_previous(index)`30353036Возвращает имя последней метки, находящейся в позиции *index* или перед ней, или `None`, если такой метки нет. Если *index* является именем метки, поиск начинается непосредственно перед этой меткой.30373038#### `tag_add(tagName, index1, *args)`30393040Добавляет тег *tagName* к диапазону символов от *index1* включительно до следующего индекса в *args* (не включая его). Дополнительные пары индексов можно передать в *args*, чтобы пометить ещё несколько диапазонов; одиночный индекс в конце помечает только символ по этому индексу.30413042#### `tag_remove(tagName, index1, index2=None)`30433044Удаляет тег *tagName* у символов от *index1* включительно до *index2* (не включая его) (или у одного символа по *index1*, если *index2* не указан). Сам тег продолжает существовать, даже если ни один символ его не содержит.30453046#### `tag_delete(*tagNames)`30473048Удаляет каждый из тегов, перечисленных в *tagNames*, убирая их со всех символов и отбрасывая их параметры и привязки.30493050#### `tag_configure(tagName, cnf=None, **kw)`30513052Запрашивает или изменяет параметры конфигурации тега *tagName*. Это отражает [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.configure), за исключением того, что применяется к тегу, а не к виджету в целом: без параметров возвращает словарь, описывающий текущие параметры, иначе устанавливает переданные параметры. Определение тега таким образом также даёт ему приоритет выше, чем у любого существующего тега.30533054Поддерживаемые параметры тега, все управляющие внешним видом размеченного текста:30553056***font***30573058Шрифт, используемый для текста.30593060***foreground***30613062Цвет текста.30633064***background***30653066Цвет фона за текстом.30673068***fgstipple*, *bgstipple***30693070Растровые изображения для точечной заливки переднего плана (текста) и фона; хорошо поддерживаются только в X11.30713072***borderwidth***30733074Ширина границы, рисуемой вокруг текста в соответствии с *relief* (по умолчанию `0`).30753076***relief***30773078Трёхмерный вид границы текста: `'flat'` (по умолчанию), `'raised'`, `'sunken'`, `'ridge'`, `'groove'` или `'solid'`.30793080***offset***30813082Насколько текст поднимается над (или, если отрицательное, опускается под) базовую линию для верхних и нижних индексов.30833084***underline***30853086Указывает, подчёркивается ли текст.30873088***underlinefg***30893090Цвет подчёркивания; по умолчанию равен цвету текста.30913092***overstrike***30933094Указывает, рисуется ли линия через середину текста.30953096***overstrikefg***30973098Цвет линии зачёркивания; по умолчанию равен цвету текста.30993100***elide***31013102Скрыт ли текст.31033104***выравнивание***31053106Как выравнивать первый символ отображаемой строки: `'left'` (по умолчанию), `'right'` или `'center'`.31073108***перенос***31093110Как переносить слишком длинные строки: `'char'`, `'word'` или `'none'`.31113112***lmargin1*, *lmargin2***31133114Отступ в пикселях первой отображаемой строки логической строки и остальных отображаемых строк.31153116***lmargincolor***31173118Цвет левой области поля.31193120***rmargin***31213122Правое поле, в пикселях.31233124***rmargincolor***31253126Цвет правой области поля.31273128***spacing1*, *spacing2*, *spacing3***31293130Дополнительное пространство в пикселях над первой отображаемой строкой логической строки, между её отображаемыми строками и под её последней отображаемой строкой.31313132***tabs***31333134Набор позиций табуляции в той же форме, что и опция *tabs* виджета.31353136***tabstyle***31373138Как интерпретируются позиции табуляции: `'tabular'` или `'wordprocessor'`.31393140***selectbackground*, *selectforeground***31413142Цвет фона и текста, используемые для текста, когда он выделен.31433144> **Примечание**3145>3146> Tk 8.6 добавил опции *lmargincolor*, *overstrikefg*, *rmargincolor*, *selectbackground*, *selectforeground* и *underlinefg*.31473148[`tag_config()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text.tag_config) является псевдонимом `tag_configure()`.31493150#### `tag_cget(tagName, option)`31513152Возвращает текущее значение опции конфигурации *option* для тега *tagName*.31533154#### `tag_names(index=None)`31553156Если *index* опущен, возвращает кортеж имён всех тегов, определённых в виджете; в противном случае возвращает только имена тегов, применённых к символу по *index*. Имена упорядочены от наименьшего приоритета к наибольшему.31573158#### `tag_ranges(tagName)`31593160Возвращает кортеж индексов, описывающих все диапазоны текста, помеченные тегом *tagName*. Результат чередует начальные и конечные индексы, так что элементы `2*i` и `2*i+1` ограничивают *i*-й диапазон.31613162#### `tag_nextrange(tagName, index1, index2=None)`31633164Ищет от *index1* (до *index2*, если задан) первый диапазон символов, помеченный тегом *tagName*, и возвращает кортеж из двух элементов с начальным и конечным индексами, или пустой кортеж, если такого диапазона нет.31653166#### `tag_prevrange(tagName, index1, index2=None)`31673168Ищет назад от *index1* (до *index2*, если задан) ближайший предшествующий диапазон символов, помеченный тегом *tagName*, и возвращает кортеж из двух элементов с начальным и конечным индексами, или пустой кортеж, если такого диапазона нет.31693170#### `tag_raise(tagName, aboveThis=None)`31713172Повышает приоритет тега *tagName* так, чтобы он был сразу над приоритетом *aboveThis*, или до наивысшего приоритета среди всех тегов, если *aboveThis* не указан. Если параметры отображения перекрывающихся тегов конфликтуют, побеждает тег с более высоким приоритетом.31733174#### `tag_lower(tagName, belowThis=None)`31753176Понижает приоритет тега *tagName* так, чтобы он был сразу под приоритетом *belowThis*, или до наинизшего приоритета среди всех тегов, если *belowThis* не указан.31773178#### `tag_bind(tagName, sequence, func, add=None)`31793180Привязывает событие *sequence* для символов, помеченных тегом *tagName*, к колбэку *func*, так что *func* вызывается, когда это событие происходит над таким символом. Если *add* равен true, привязка добавляется вместе с любыми существующими привязками для *sequence*; в противном случае она заменяет их. Работает как [`bind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind) и возвращает идентификатор новой привязки.31813182#### `tag_unbind(tagName, sequence, funcid=None)`31833184Удаляет привязки события *sequence* для символов, помеченных *tagName*. Если указан *funcid*, удаляется только та привязка (возвращённая [`tag_bind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text.tag_bind)) и её колбэк отменяется.31853186Изменено в версии 3.13: Если указан *funcid*, отвязывается только этот колбэк.31873188#### `image_create(index, cnf={}, **kw)`31893190Встраивает изображение в позиции *index* и возвращает имя, назначенное этому экземпляру изображения, которое затем можно использовать как индекс или передавать другим методам `image_*`. Параметры, задаваемые в *cnf* и *kw*, включают *image* (изображение Tk для отображения), *name* (базовое имя экземпляра), *align*, *padx* и *pady*.31913192#### `image_cget(index, option)`31933194Возвращает текущее значение параметра конфигурации *option* для встроенного изображения в позиции *index*.31953196#### `image_configure(index, cnf=None, **kw)`31973198Запрашивает или изменяет параметры конфигурации встроенного изображения в позиции *index*, как [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.configure), но применяется к этому изображению.31993200#### `image_names()`32013202Возвращает кортеж имён всех изображений, встроенных в виджет.32033204> **Примечание**3205>3206> Этот метод переопределяет унаследованный [`Misc.image_names()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.image_names), который возвращает имена всех изображений в интерпретаторе Tcl; этот метод недоступен для `Text`.32073208#### `window_create(index, cnf={}, **kw)`32093210Встраивает окно (любой виджет) в позиции *index*. Параметры, задаваемые в *cnf* и *kw*, включают *window* (виджет для встраивания), *create* (колбэк, создающий виджет по требованию), *align*, *stretch*, *padx* и *pady*. Встраиваемый виджет должен быть потомком родителя текстового виджета.32113212#### `window_cget(index, option)`32133214Возвращает текущее значение параметра конфигурации *option* для встроенного окна в позиции *index*.32153216#### `window_configure(index, cnf=None, **kw)`32173218Запрашивает или изменяет параметры конфигурации встроенного окна в позиции *index*, как [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.configure), но применяется к этому окну.32193220[`window_config()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text.window_config) является псевдонимом `window_configure()`.32213222#### `window_names()`32233224Возвращает кортеж имён всех окон, встроенных в виджет.32253226#### `edit(*args)`32273228Низкоуровневая обёртка над виджет-командой Tk `edit`, управляющей механизмом undo/redo и флагом изменений; *args* – это подкоманда `edit` и её аргументы. Методы `edit_*()` ниже являются тонкими обёртками над ним и обычно более удобны.32293230#### `edit_modified(arg=None)`32313232Если *arg* опущен, возвращает текущее состояние флага изменений как `0` или `1`; флаг устанавливается автоматически при любой вставке или удалении текста. В противном случае устанавливает флаг в булево значение *arg*.32333234#### `edit_undo()`32353236Отменяет последнее действие редактирования, то есть все вставки и удаления, записанные в стек отмены после предыдущего разделителя, и переносит его в стек повтора. Вызывает [`TclError`](https://python-all.ru/3.15/library/tkinter.html#tkinter.TclError), если стек отмены пуст. Не действует, если параметр *undo* не равен true. Начиная с Tk 9.0, возвращает кортеж индексов, ограничивающих диапазоны текста, которые были изменены.32373238#### `edit_redo()`32393240Повторно применяет последнее отменённое действие редактирования, при условии, что после этого не было внесено изменений, и переносит его обратно в стек отмены. Вызывает [`TclError`](https://python-all.ru/3.15/library/tkinter.html#tkinter.TclError), если стек повтора пуст. Не действует, если параметр *undo* не равен true. Начиная с Tk 9.0, возвращает кортеж индексов, ограничивающих диапазоны текста, которые были изменены.32413242#### `edit_reset()`32433244Очищает стеки отмены и повтора.32453246#### `edit_separator()`32473248Добавляет разделитель в стек отмены, обозначая границу между действиями редактирования для отмены и повтора. Не действует, если параметр *undo* не равен true. Разделители вставляются автоматически, если параметр *autoseparators* равен true.32493250#### `search(pattern, index, stopindex=None, forwards=None, backwards=None, exact=None, regexp=None, nocase=None, count=None, elide=None, *, nolinestop=None, strictlimits=None)`32513252Ищет *pattern* начиная с *index* и возвращает индекс первого символа первого совпадения или пустую строку, если совпадений нет. Поиск останавливается на *stopindex*, если он указан; в противном случае он переходит через концы текста, пока снова не достигнет начальной позиции. Следующие логические флаги управляют поиском: *forwards* или *backwards* выбирают направление (прямой поиск по умолчанию); *exact* (по умолчанию) или *regexp* выбирают точное совпадение или совпадение с регулярным выражением; *nocase* делает поиск нечувствительным к регистру; *elide* позволяет искать скрытый текст; *nolinestop* (только для regexp) позволяет `.` и `[^` совпадать с символами новой строки; а *strictlimits* требует, чтобы всё совпадение находилось в пределах *index* и *stopindex*. Если *count* является [`Variable`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable), в него сохраняется количество позиций индекса в совпадении.32533254Изменено в версии 3.15: Добавлены параметры *nolinestop* и *strictlimits*.32553256#### `search_all(pattern, index, stopindex=None, *, forwards=None, backwards=None, exact=None, regexp=None, nocase=None, count=None, elide=None, nolinestop=None, overlap=None, strictlimits=None)`32573258Как [`search()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text.search), но находит все совпадения в заданном диапазоне и возвращает кортеж начальных индексов всех совпадений (пустой, если их нет). По умолчанию перекрывающиеся совпадения не сообщаются; передача истинного *overlap* возвращает каждое совпадение, которое не полностью содержится в другом. Если *count* является [`Variable`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable), он получает список по одному элементу на каждое совпадение.32593260Добавлено в версии 3.15.32613262#### `scan_mark(x, y)`32633264Запоминает *x*, *y* и текущий вид для использования в последующих вызовах [`scan_dragto()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text.scan_dragto). Обычно привязывается к нажатию кнопки мыши в виджете.32653266#### `scan_dragto(x, y)`32673268Прокручивает виджет на разницу в 10 раз между *x*, *y* и координатами, переданными последнему вызову [`scan_mark()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text.scan_mark). Обычно привязывается к событиям движения мыши, создавая эффект перетаскивания текста на высокой скорости по окну.32693270#### `debug(boolean=None)`32713272Если *boolean* опущен, возвращает, включены ли проверки внутренней целостности B-дерева. В противном случае включает или отключает их. Эта настройка общая для всех текстовых виджетов и может заметно замедлить виджеты, содержащие большие объёмы текста.32733274#### `dump(index1, index2=None, command=None, **kw)`32753276Возвращает содержимое виджета от *index1* включительно до *index2* не включительно (или только сегмент на *index1*, если *index2* опущен), включая текст и информацию о метках, тегах, изображениях и окнах. Результат – список троек `(key, value, index)`, где *key* – одно из значений `'text'`, `'mark'`, `'tagon'`, `'tagoff'`, `'image'` или `'window'`. По умолчанию сообщаются все типы; передача любого из ключевых аргументов *all*, *text*, *mark*, *tag*, *image* или *window* со значением true ограничивает дамп выбранными типами. Если передан *command*, он вызывается один раз на каждую тройку с тремя значениями в качестве аргументов, и ничего не возвращается.32773278#### `peer_create(newPathName, cnf={}, **kw)`32793280Создаёт равноправный текстовый виджет с путём *newPathName*, который разделяет базовые данные этого виджета (текст, метки, теги, изображения и стек отмены). Изменения, сделанные через любой из равноправных виджетов, отражаются во всех них. По умолчанию равноправный виджет охватывает те же строки, что и данный виджет; могут быть заданы стандартные текстовые параметры, включая *startline* и *endline*, чтобы переопределить это.32813282Добавлено в версии 3.3.32833284#### `peer_names()`32853286Возвращает кортеж путей равноправных виджетов этого виджета, не включая сам виджет.32873288Добавлено в версии 3.3.32893290#### `yview_pickplace(*what)`32913292Настраивает вид так, чтобы местоположение, заданное *what*, стало видимым. Это устаревший эквивалент [`see()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text.see), который следует использовать вместо него.32933294### Классы переменных32953296#### `class tkinter.Variable(master=None, value=None, name=None)`32973298Базовый класс для обёрток переменных Tk. Переменная Tk – это значение, хранящееся в интерпретаторе Tcl, которое может быть связано с виджетами через их параметры *variable* или *textvariable* (см. [Связывание переменных виджетов](https://python-all.ru/3.15/library/tkinter.html#coupling-widget-variables)), так что изменения распространяются в обоих направлениях: обновление переменной обновляет все виджеты, привязанные к ней, а редактирование такого виджета пользователем обновляет переменную.32993300*master* – это виджет, интерпретатору Tcl которого принадлежит переменная; если опущен, используется корневое окно по умолчанию. *value* – начальное значение; если опущено, используется значение по умолчанию для данного типа. *name* – имя переменной в интерпретаторе Tcl; если опущено, генерируется уникальное имя вида `'PY_VARnum'`. Если *name* совпадает с существующей переменной, а *value* опущено, существующее значение сохраняется.33013302В большинстве случаев следует использовать один из типизированных подклассов ниже – [`StringVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.StringVar), [`IntVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.IntVar), [`DoubleVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.DoubleVar) или [`BooleanVar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.BooleanVar) – вместо `Variable` напрямую.33033304> **Примечание**3305>3306> Когда `Variable` удаляется сборщиком мусора, его переменная Tcl сбрасывается. Сохраняйте ссылку на неё до тех пор, пока виджет связан с ней, например, храня её как атрибут, а не в локальной переменной. В противном случае Tk воссоздаёт переменную Tcl для поддержания работы виджета, но она больше никогда не сбрасывается, что приводит к утечке одной переменной Tcl на каждую отброшенную обёртку.33073308Изменено в версии 3.10: Теперь две переменные сравниваются равными (`==`), только если они имеют одинаковое имя, принадлежат одному классу и одному интерпретатору Tcl.33093310#### `get()`33113312Возвращает текущее значение переменной. Для базового класса значение возвращается в виде строки; типизированные подклассы преобразуют его в соответствующий тип Python.33133314#### `set(value)`33153316Устанавливает переменную в *value*. [`initialize()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable.initialize) – это псевдоним `set()`.33173318Добавлено в версии 3.3: Написание *initialize*.33193320#### `trace_add(mode, callback)`33213322Регистрирует *колбэк*, который вызывается при доступе к переменной в соответствии с *mode*. *mode* – одна из строк `'array'`, `'read'`, `'write'` или `'unset'`, либо список или кортеж таких строк.33233324При срабатывании *колбэк* вызывается с тремя аргументами: имя переменной Tcl, индекс (или пустая строка, если переменная не является элементом массива) и *mode*, вызвавший срабатывание.33253326Возвращает внутреннее имя зарегистрированного колбэка, которое можно передать в [`trace_remove()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable.trace_remove).33273328Добавлено в версии 3.6.33293330#### `trace_remove(mode, cbname)`33313332Удаляет колбэк трассировки из переменной. *mode* должен совпадать с *mode*, переданным в [`trace_add()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable.trace_add), а *cbname* – это имя колбэка, возвращённое `trace_add()`.33333334Добавлено в версии 3.6.33353336#### `trace_info()`33373338Возвращает список пар `(modes, cbname)`, описывающих все трассировки, установленные на переменной, где *modes* – кортеж строк режимов, а *cbname* – внутреннее имя колбэка.33393340Добавлено в версии 3.6.33413342#### `trace_variable(mode, callback)`33433344Регистрирует *колбэк*, который вызывается при доступе к переменной в соответствии с *mode*. *mode* – одна из строк `'r'`, `'w'` или `'u'` для чтения, записи или удаления. Возвращает внутреннее имя зарегистрированного колбэка. [`trace()`](https://python-all.ru/3.15/library/trace.html#module-trace) – это псевдоним `trace_variable()`.33453346Устарело с версии 3.6: Вместо этого используйте [`trace_add()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable.trace_add). Этот метод оборачивает возможность Tcl, которая была удалена в Tcl 9.0.33473348#### `trace_vdelete(mode, cbname)`33493350Удаляет колбэк трассировки с именем *cbname*, зарегистрированный для *mode* с помощью [`trace_variable()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable.trace_variable).33513352Устарело с версии 3.6: Вместо этого используйте [`trace_remove()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable.trace_remove). Этот метод оборачивает возможность Tcl, которая была удалена в Tcl 9.0.33533354#### `trace_vinfo()`33553356Возвращает список пар `(mode, cbname)` для всех трассировок, установленных на переменной с помощью [`trace_variable()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable.trace_variable).33573358Устарело с версии 3.6: Вместо этого используйте [`trace_info()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable.trace_info). Этот метод оборачивает возможность Tcl, которая была удалена в Tcl 9.0.33593360#### `class tkinter.StringVar(master=None, value=None, name=None)`33613362Подкласс [`Variable`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable), хранящий строку. Значение по умолчанию – `''`.33633364#### `get()`33653366Возвращает значение переменной в виде [`str`](https://python-all.ru/3.15/library/stdtypes.html#str).33673368#### `class tkinter.IntVar(master=None, value=None, name=None)`33693370Подкласс [`Variable`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable), хранящий целое число. Значение по умолчанию – `0`.33713372#### `get()`33733374Возвращает значение переменной в виде [`int`](https://python-all.ru/3.15/library/functions.html#int).33753376#### `class tkinter.DoubleVar(master=None, value=None, name=None)`33773378Подкласс [`Variable`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable), хранящий число с плавающей точкой. Значение по умолчанию – `0.0`.33793380#### `get()`33813382Возвращает значение переменной в виде [`float`](https://python-all.ru/3.15/library/functions.html#float).33833384> **Примечание**3385>3386> Значение с плавающей точкой всегда разбирается с точкой (`.`) в качестве десятичного разделителя, но [`Spinbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Spinbox), [`Scale`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Scale) и [`ttk.Spinbox`](https://python-all.ru/3.15/library/tkinter.ttk.html#tkinter.ttk.Spinbox) форматируют его в соответствии с локалью `LC_NUMERIC`. В локали, использующей запятую, они выдают значение, которое [`get()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.DoubleVar.get) не может прочитать, вызывая [`TclError`](https://python-all.ru/3.15/library/tkinter.html#tkinter.TclError). Установите `LC_NUMERIC` на локаль, использующую точку (например, `'C'`), чтобы избежать этого.33873388#### `class tkinter.BooleanVar(master=None, value=None, name=None)`33893390Подкласс [`Variable`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Variable), который хранит булево значение. Значение по умолчанию – `False`.33913392#### `get()`33933394Возвращает значение переменной как [`bool`](https://python-all.ru/3.15/library/functions.html#bool). Вызывает [`ValueError`](https://python-all.ru/3.15/library/exceptions.html#ValueError), если значение не может быть интерпретировано как булево.33953396#### `set(value)`33973398Устанавливает переменную в *value*, преобразуя его в булево значение. [`initialize()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.BooleanVar.initialize) – псевдоним `set()`.33993400Добавлено в версии 3.3: Написание *initialize*.34013402### Классы изображений34033404#### `class tkinter.Image(imgtype, name=None, cnf={}, master=None, **kw)`34053406Базовый класс для изображений Tk. *imgtype* – это тип изображения Tk, один из `'photo'` или `'bitmap'`. Изображение – именованный объект, который может отображаться виджетами через их опцию *image*; удаление всех ссылок на объект `Image` удаляет базовое изображение Tk. Обычно создают [`PhotoImage`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PhotoImage) или [`BitmapImage`](https://python-all.ru/3.15/library/tkinter.html#tkinter.BitmapImage), а не напрямую `Image`.34073408Параметры конфигурации изображения задаются *cnf* и *kw* и могут быть запрошены и изменены позднее с помощью протокола отображения (используя `image[key]`) или метода [`configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Image.configure).34093410#### `configure(**kw)`34113412Изменяет один или несколько параметров конфигурации изображения. Допустимые параметры зависят от типа изображения; см. [`PhotoImage`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PhotoImage) и [`BitmapImage`](https://python-all.ru/3.15/library/tkinter.html#tkinter.BitmapImage). [`config()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Image.config) – псевдоним `configure()`.34133414#### `height()`34153416Возвращает высоту изображения в пикселях.34173418#### `width()`34193420Возвращает ширину изображения в пикселях.34213422#### `type()`34233424Возвращает тип изображения, то есть значение *imgtype*, с которым оно было создано (например, `'photo'` или `'bitmap'`).34253426#### `class tkinter.PhotoImage(name=None, cnf={}, master=None, **kw)`34273428Полноцветное изображение (тип изображения Tk `photo`), хранящееся внутри с различной степенью прозрачности для каждого пикселя. Может читать и записывать файлы GIF, PPM/PGM и (в Tk 8.6 и новее) PNG, читать файлы SVG (в Tk 9.0 и новее) и отображаться в виджетах. Наследует от [`Image`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Image).34293430Параметры конфигурации включают *data* (содержимое изображения в виде строки), *file* (имя файла для чтения содержимого), *format* (имя обработчика формата файла), *width* и *height* (размер изображения, используется при построении по частям), *gamma* и *palette*.34313432#### `blank()`34333434Очищает изображение; то есть устанавливает всё изображение без данных, так что оно отображается прозрачным, и фон окна, в котором оно отображается, просвечивает.34353436#### `cget(option)`34373438Возвращает текущее значение параметра конфигурации *option*.34393440#### `copy(*, from_coords=None, zoom=None, subsample=None)`34413442Возвращает новый `PhotoImage` с копией этого изображения.34433444*from\_coords* задаёт прямоугольную подобласть исходного изображения для копирования. Она должна быть кортежем или списком из 1–4 целых чисел `(x1, y1, x2, y2)`. `(x1, y1)` и `(x2, y2)` задают диагонально противоположные углы прямоугольника. Если *x2* и *y2* не указаны, они по умолчанию равны правому нижнему углу исходного изображения. Копируемые пиксели включают левый и верхний края прямоугольника, но не нижний или правый. Если *from\_coords* не задан, копируется всё исходное изображение.34453446Если указаны *zoom* или *subsample*, изображение преобразуется как в методах [`zoom()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PhotoImage.zoom) и [`subsample()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PhotoImage.subsample). Значением должно быть одно целое число или пара целых чисел.34473448Изменено в версии 3.13: Добавлены параметры *from\_coords*, *zoom* и *subsample*.34493450#### `copy_replace(sourceImage, *, from_coords=None, to=None, shrink=False, zoom=None, subsample=None, compositingrule=None)`34513452Копирует область из *sourceImage* (который должен быть `PhotoImage`) в это изображение, возможно с масштабированием пикселей и/или субдискретизацией. Если параметры не указаны, *sourceImage* копируется целиком в это изображение, начиная с координат `(0, 0)`.34533454Параметр *from\_coords* задаёт прямоугольную подобласть исходного изображения, которая будет скопирована, как в методе [`copy()`](https://python-all.ru/3.15/library/copy.html#module-copy).34553456*to* задаёт прямоугольную подобласть целевого изображения, которая будет затронута. Это должен быть кортеж или список из 1–4 целых чисел `(x1, y1, x2, y2)`. Если *x2* и *y2* не указаны, по умолчанию они равны `(x1, y1)` плюс размер исходной области (после субдискретизации и масштабирования, если они заданы). Если *x2* и *y2* указаны, исходная область при необходимости дублируется мозаичным способом для заполнения целевой области.34573458Если *shrink* истинно, размер целевого изображения при необходимости уменьшается так, чтобы копируемая область оказалась в правом нижнем углу изображения.34593460Если указаны *zoom* или *subsample*, изображение преобразуется как в методах [`zoom()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PhotoImage.zoom) и [`subsample()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PhotoImage.subsample). Значением должно быть одно целое число или пара целых чисел.34613462*compositingrule* определяет, как прозрачные пиксели исходного изображения объединяются с целевым изображением. При `'overlay'` (по умолчанию) старое содержимое целевого изображения остаётся видимым, как если бы исходное изображение было напечатано на прозрачной плёнке и наложено поверх целевого. При `'set'` старое содержимое целевого изображения отбрасывается, а исходное изображение используется как есть.34633464Добавлено в версии 3.13.34653466#### `data(format=None, *, from_coords=None, background=None, grayscale=False)`34673468Возвращает данные изображения.34693470*format* задаёт имя обработчика формата файла изображения. Если он не указан, данные возвращаются в виде кортежа (по одному элементу на строку) строк, содержащих разделённые пробелами (по одному элементу на пиксель/столбец) цвета в формате `#RRGGBB`.34713472*from\_coords* задаёт прямоугольную область изображения, которую нужно вернуть. Это должен быть кортеж или список из 1–4 целых чисел `(x1, y1, x2, y2)`. Если указаны только *x1* и *y1*, область простирается от `(x1, y1)` до правого нижнего угла изображения. Если заданы все четыре координаты, они определяют противоположные углы области по диагонали, включая `(x1, y1)` и исключая `(x2, y2)`. Если *from\_coords* не задан, возвращается всё изображение.34733474Если указан *background*, данные не содержат информации о прозрачности; во всех прозрачных пикселях цвет заменяется на указанный.34753476Если *grayscale* равен true, данные не содержат информации о цвете; все данные пикселей преобразуются в оттенки серого.34773478Добавлено в версии 3.13.34793480#### `get(x, y)`34813482Возвращает цвет пикселя по координатам (*x*, *y*) в виде `(r, g, b)` кортежа из трёх целых чисел от 0 до 255, представляющих красный, зелёный и синий компоненты соответственно.34833484#### `put(data, to=None)`34853486Устанавливает пиксели изображения в цвета, заданные в *data*, который должен быть строкой или вложенной последовательностью горизонтальных строк цветов пикселей (например, `"{red green} {blue yellow}"`).34873488*to* задаёт координаты области изображения, в которую копируются данные. Это должен быть кортеж или список из 2 или 4 целых чисел `(x1, y1)` или `(x1, y1, x2, y2)`, задающих левый верхний угол и, опционально, правый нижний угол области. Положение по умолчанию – `(0, 0)`.34893490#### `read(filename, format=None, *, from_coords=None, to=None, shrink=False)`34913492Читает данные изображения из файла с именем *filename* в изображение.34933494*format* задаёт формат данных изображения в файле.34953496*from\_coords* задаёт прямоугольную подобласть данных изображения из файла, которая будет скопирована в целевое изображение. Это должен быть кортеж или список из 1–4 целых чисел `(x1, y1, x2, y2)`. Если указаны только *x1* и *y1*, область простирается от `(x1, y1)` до правого нижнего угла изображения в файле. Если заданы все четыре координаты, они определяют противоположные углы области по диагонали. Если *from\_coords* не задан, читается всё изображение из файла.34973498*to* задаёт координаты левого верхнего угла области изображения, в которую читаются данные. По умолчанию – `(0, 0)`.34993500Если *shrink* истинно, размер изображения при необходимости уменьшается так, чтобы область, в которую читаются данные из файла, оказалась в правом нижнем углу изображения.35013502Добавлено в версии 3.13.35033504#### `subsample(x, y='', *, from_coords=None)`35053506Возвращает новый `PhotoImage` на основе данного изображения, но использующий только каждый *x*-й пиксель по оси X и каждый *y*-й пиксель по оси Y. Если *y* не указан, по умолчанию он равен *x*.35073508Параметр *from\_coords* задаёт прямоугольную подобласть исходного изображения, которая будет скопирована, как в методе [`copy()`](https://python-all.ru/3.15/library/copy.html#module-copy).35093510Изменено в версии 3.13: Добавлен параметр *from\_coords*.35113512#### `transparency_get(x, y)`35133514Возвращает `True`, если пиксель по координатам (*x*, *y*) полностью прозрачен, иначе `False`.35153516Добавлено в версии 3.8.35173518#### `transparency_set(x, y, boolean)`35193520Делает пиксель по координатам (*x*, *y*) полностью прозрачным, если *boolean* истинно, и полностью непрозрачным в противном случае.35213522Добавлено в версии 3.8.35233524#### `write(filename, format=None, from_coords=None, *, background=None, grayscale=False)`35253526Записывает данные изображения из изображения в файл с именем *filename*.35273528Параметр *format* задаёт имя обработчика формата файла изображения. Если он не указан, формат определяется по расширению файла.35293530Параметр *from\_coords* задаёт прямоугольную область изображения, которую нужно записать. Он должен быть кортежем или списком из 1–4 целых чисел `(x1, y1, x2, y2)`. Если указаны только *x1* и *y1*, область простирается от `(x1, y1)` до правого нижнего угла изображения. Если заданы все четыре координаты, они задают диагонально противоположные углы области. Если *from\_coords* не указан, записывается всё изображение.35313532Если указан *background*, данные не содержат информации о прозрачности; во всех прозрачных пикселях цвет заменяется на указанный.35333534Если *grayscale* равен true, данные не содержат информации о цвете; все данные пикселей преобразуются в оттенки серого.35353536Изменено в версии 3.13: Добавлены параметры *background* и *grayscale*.35373538#### `zoom(x, y='', *, from_coords=None)`35393540Возвращает новый `PhotoImage` с этим изображением, увеличенным в *x* раз по оси X и в *y* раз по оси Y. Если *y* не указан, по умолчанию используется то же значение, что и *x*.35413542Параметр *from\_coords* задаёт прямоугольную подобласть исходного изображения, которая будет скопирована, как в методе [`copy()`](https://python-all.ru/3.15/library/copy.html#module-copy).35433544Изменено в версии 3.13: Добавлен параметр *from\_coords*.35453546#### `class tkinter.BitmapImage(name=None, cnf={}, master=None, **kw)`35473548Двухцветное изображение (тип изображения Tk `bitmap`), созданное из X11-битовой карты. Каждый пиксель отображает цвет переднего плана, цвет фона или ничего (создавая эффект прозрачности). Наследует от [`Image`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Image).35493550Параметрами конфигурации являются *data* или *file* (исходная битовая карта, задаваемая строкой в формате X11 или именем файла в этом формате), *maskdata* или *maskfile* (маска битовой карты в тех же форматах), а также *foreground* и *background* (два цвета). Для пикселей, где маска равна нулю, изображение ничего не отображает; для остальных пикселей отображается цвет переднего плана, где исходный бит равен единице, и цвет фона, где он равен нулю. Если *background* установлен в пустую строку, фоновые пиксели становятся прозрачными.35513552`BitmapImage` не имеет собственных методов, кроме тех, что унаследованы от [`Image`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Image).35533554### Другие классы35553556#### `class tkinter.Event`35573558Контейнер для атрибутов события, передаваемого в колбэк, привязанный с помощью [`Misc.bind()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.bind). Экземпляр `Event` имеет следующие атрибуты, каждый из которых соответствует полю базового события Tk; в зависимости от типа события некоторые атрибуты могут быть установлены в строку `'??'`, чтобы указать, что они не имеют смысла. См. [Привязки и события](https://python-all.ru/3.15/library/tkinter.html#bindings-and-events).35593560#### `serial`35613562Серийный номер события.35633564#### `num`35653566Кнопка мыши, которая была нажата или отпущена (для событий кнопок).35673568#### `focus`35693570Указывает, имеет ли окно фокус (для событий `Enter` и `Leave`).35713572#### `height`35733574#### `width`35753576Новая высота и ширина окна (для событий `Configure` и `Expose`).35773578#### `keycode`35793580Код клавиши, которая была нажата или отпущена.35813582#### `state`35833584Состояние события в виде числа (для большинства событий) или строки (для событий `Visibility`).35853586#### `time`35873588Временная метка события в миллисекундах.35893590#### `x`35913592#### `y`35933594Положение указателя относительно виджета в пикселях.35953596#### `x_root`35973598#### `y_root`35993600Положение указателя относительно верхнего левого угла экрана, в пикселях.36013602#### `char`36033604Введённый символ в виде строки (для событий клавиш).36053606#### `send_event`36073608`True`, если событие было отправлено другим приложением.36093610#### `keysym`36113612Символическое имя клавиши, которая была нажата или отпущена.36133614#### `keysym_num`36153616Числовое значение [`keysym`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Event.keysym).36173618#### `type`36193620[`EventType`](https://python-all.ru/3.15/library/tkinter.html#tkinter.EventType) события.36213622#### `widget`36233624Виджет, на котором произошло событие.36253626#### `delta`36273628Величина, на которую было повёрнуто колесо мыши (для событий `MouseWheel`).36293630#### `user_data`36313632Строка данных виртуального события, передаваемая в опцию *data* функции [`Misc.event_generate()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.event_generate). Для невиртуальных событий она равна `'??'`.36333634Добавлено в версии 3.15.36353636#### `detail`36373638Фиксированная строка detail для событий `Enter`, `Leave`, `FocusIn`, `FocusOut` и `ConfigureRequest` (см. документацию Tcl/Tk). Для прочих событий она равна `'??'`.36393640Добавлено в версии 3.15.36413642#### `class tkinter.EventType(*values)`36433644Перечисление [`enum.StrEnum`](https://python-all.ru/3.15/library/enum.html#enum.StrEnum), содержащее типы событий Tk, используемое в качестве значения [`Event.type`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Event.type). Его члены включают, среди прочего, `KeyPress`, `KeyRelease`, `ButtonPress`, `ButtonRelease`, `Motion`, `Enter`, `Leave`, `FocusIn`, `FocusOut`, `Configure`, `Map`, `Unmap`, `Expose`, `Destroy` и `MouseWheel`.36453646Добавлено в версии 3.6.36473648#### `class tkinter.CallWrapper(func, subst, widget)`36493650Внутренний вспомогательный класс, который оборачивает Python-колбэк, чтобы его можно было вызвать из Tcl. *func* – это Python-функция, *subst* – необязательная функция, которая предварительно обрабатывает аргументы Tcl, а *widget* – виджет, используемый для сообщения об ошибках. Экземпляры создаются автоматически с помощью [`Misc.register()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.register); этот класс обычно не используется напрямую.36513652### Функции уровня модуля36533654#### `tkinter.Tcl(screenName=None, baseName=None, className='Tk', useTk=False)`36553656Функция `Tcl()` – это фабричная функция, которая создаёт объект, очень похожий на тот, что создаётся классом [`Tk`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tk), за исключением того, что она не инициализирует подсистему Tk. Она чаще всего полезна при работе с интерпретатором Tcl в среде, где не требуется создавать лишние окна верхнего уровня или где это невозможно (например, в системах Unix/Linux без X-сервера). Объект, созданный объектом `Tcl()`, может иметь окно Toplevel (и инициализированную подсистему Tk) при вызове его метода [`loadtk()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Tk.loadtk).36573658#### `tkinter.NoDefaultRoot()`36593660Подавляет создание неявного корневого окна по умолчанию. После этого `tkinter` больше не создаёт автоматически общий корневой элемент, а операции, которые от него зависят – например, создание виджета без явного *master* – вызывают исключение [`RuntimeError`](https://python-all.ru/3.15/library/exceptions.html#RuntimeError). Вызывайте эту функцию на раннем этапе в крупных приложениях, чтобы сделать корневое окно явным.36613662#### `tkinter.mainloop(n=0)`36633664Запускает главный цикл событий Tk на корневом окне по умолчанию, пока все окна не будут уничтожены. Эквивалентно вызову [`Misc.mainloop()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.mainloop) для корневого окна по умолчанию.36653666#### `tkinter.getboolean(s)`36673668Преобразует Tcl-строку логического типа *s* (одно из значений `'1'`, `'true'`, `'yes'`, `'on'` и подобных, или их ложные аналоги) в Python-объект [`bool`](https://python-all.ru/3.15/library/functions.html#bool). Вызывает [`TclError`](https://python-all.ru/3.15/library/tkinter.html#tkinter.TclError) для недопустимого значения.36693670#### `tkinter.getdouble(s)`36713672Преобразует *s* в число с плавающей запятой. Это встроенная функция [`float`](https://python-all.ru/3.15/library/functions.html#float).36733674#### `tkinter.getint(s)`36753676Преобразует *s* в целое число. Это встроенная функция [`int`](https://python-all.ru/3.15/library/functions.html#int).36773678#### `tkinter.image_names()`36793680Возвращает имена всех существующих изображений в интерпретаторе корневого окна по умолчанию.36813682#### `tkinter.image_types()`36833684Возвращает доступные типы изображений (например, `'photo'` и `'bitmap'`) в интерпретаторе корневого окна по умолчанию.36853686### Обработчики файлов36873688Tk позволяет регистрировать и удалять функцию обратного вызова, которая будет вызываться из главного цикла Tk, когда возможен ввод-вывод на файловом дескрипторе. Для каждого файлового дескриптора можно зарегистрировать только один обработчик. Пример кода:36893690```python3691import tkinter3692widget = tkinter.Tk()3693mask = tkinter.READABLE | tkinter.WRITABLE3694widget.tk.createfilehandler(file, mask, callback)3695...3696widget.tk.deletefilehandler(file)3697```36983699Эта функция недоступна в Windows.37003701Поскольку неизвестно, сколько байт доступно для чтения, не рекомендуется использовать методы [`BufferedIOBase`](https://python-all.ru/3.15/library/io.html#io.BufferedIOBase) или [`TextIOBase`](https://python-all.ru/3.15/library/io.html#io.TextIOBase) [`read()`](https://python-all.ru/3.15/library/io.html#io.BufferedIOBase.read) или [`readline()`](https://python-all.ru/3.15/library/io.html#io.IOBase.readline), так как они будут читать строго заданное количество байт. Для сокетов подойдут методы [`recv()`](https://python-all.ru/3.15/library/socket.html#socket.socket.recv) или [`recvfrom()`](https://python-all.ru/3.15/library/socket.html#socket.socket.recvfrom); для других файлов используйте необработанное чтение или `os.read(file.fileno(), maxbytecount)`.37023703#### `Widget.tk.createfilehandler(file, mask, func)`37043705Регистрирует функцию обратного вызова обработчика файла *func*. Аргумент *file* может быть объектом с методом [`fileno()`](https://python-all.ru/3.15/library/io.html#io.IOBase.fileno) (например, файлом или сокетом), либо целочисленным файловым дескриптором. Аргумент *mask* представляет собой комбинацию (побитовое ИЛИ) любых из трёх констант ниже. Колбэк вызывается следующим образом:37063707```python3708callback(file, mask)3709```37103711#### `Widget.tk.deletefilehandler(file)`37123713Удаляет обработчик файла.37143715#### `tkinter.READABLE`37163717#### `tkinter.WRITABLE`37183719#### `tkinter.EXCEPTION`37203721Константы, используемые в аргументе *mask*.37223723### Константы37243725Следующие символьные константы доступны в пространствах имён `tkinter` и `tkinter.constants`.37263727#### `tkinter.TRUE`37283729#### `tkinter.YES`37303731#### `tkinter.ON`37323733Истинные значения, все равны целому числу `1`.37343735#### `tkinter.FALSE`37363737#### `tkinter.NO`37383739#### `tkinter.OFF`37403741Ложные значения, все равны целому числу `0`.37423743#### `tkinter.N`37443745#### `tkinter.S`37463747#### `tkinter.E`37483749#### `tkinter.W`37503751#### `tkinter.NE`37523753#### `tkinter.NW`37543755#### `tkinter.SE`37563757#### `tkinter.SW`37583759#### `tkinter.NS`37603761#### `tkinter.EW`37623763#### `tkinter.NSEW`37643765#### `tkinter.CENTER`37663767Направления компаса (`'n'`, `'s'`, `'e'`, `'w'`, а также диагонали и грани) плюс `CENTER` (`'center'`), используются в качестве значений для опций *anchor* и *sticky*, а также методами, такими как [`Misc.grid_anchor()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Misc.grid_anchor).37683769#### `tkinter.LEFT`37703771#### `tkinter.RIGHT`37723773#### `tkinter.TOP`37743775#### `tkinter.BOTTOM`37763777Границы для опции *side* модуля packer (см. [`Pack.pack_configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Pack.pack_configure)).37783779#### `tkinter.X`37803781#### `tkinter.Y`37823783#### `tkinter.BOTH`37843785#### `tkinter.NONE`37863787Значения для опции *fill* модуля packer: `'x'`, `'y'`, `'both'` или `'none'`.37883789#### `tkinter.RAISED`37903791#### `tkinter.SUNKEN`37923793#### `tkinter.FLAT`37943795#### `tkinter.RIDGE`37963797#### `tkinter.GROOVE`37983799#### `tkinter.SOLID`38003801Значения для опции *relief*, управляющей трёхмерной границей виджета.38023803#### `tkinter.HORIZONTAL`38043805#### `tkinter.VERTICAL`38063807Значения для опции *orient* виджетов, таких как [`Scale`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Scale), [`Scrollbar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Scrollbar) и [`PanedWindow`](https://python-all.ru/3.15/library/tkinter.html#tkinter.PanedWindow).38083809#### `tkinter.CHAR`38103811#### `tkinter.WORD`38123813Значения для опции *wrap* виджета [`Text`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text), определяющей перенос строк по границам символов или слов.38143815#### `tkinter.BASELINE`38163817Значение выравнивания текста `'baseline'`.38183819#### `tkinter.INSIDE`38203821#### `tkinter.OUTSIDE`38223823Значения для параметра *bordermode* менеджера размещения (см. [`Place.place_configure()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Place.place_configure)).38243825#### `tkinter.INSERT`38263827#### `tkinter.CURRENT`38283829#### `tkinter.END`38303831#### `tkinter.ANCHOR`38323833#### `tkinter.SEL`38343835#### `tkinter.SEL_FIRST`38363837#### `tkinter.SEL_LAST`38383839Символические индексы, используемые виджетами [`Text`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text), [`Entry`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Entry), [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox) и [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas), такие как `'insert'` (курсор вставки), `'current'`, `'end'`, `'anchor'` и границы выделения (`'sel.first'` и `'sel.last'`).38403841#### `tkinter.ALL`38423843Специальный тег `'all'`, который соответствует каждому элементу [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas) или каждому символу [`Text`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Text) (например, `canvas.delete(ALL)`).38443845#### `tkinter.NORMAL`38463847#### `tkinter.DISABLED`38483849#### `tkinter.ACTIVE`38503851#### `tkinter.HIDDEN`38523853Значения для параметра *state* различных виджетов и элементов.38543855#### `tkinter.CASCADE`38563857#### `tkinter.CHECKBUTTON`38583859#### `tkinter.COMMAND`38603861#### `tkinter.RADIOBUTTON`38623863#### `tkinter.SEPARATOR`38643865Типы записей меню, используемые как аргумент *itemType* для [`Menu.add()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.add) и [`Menu.insert()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Menu.insert).38663867#### `tkinter.SINGLE`38683869#### `tkinter.BROWSE`38703871#### `tkinter.MULTIPLE`38723873#### `tkinter.EXTENDED`38743875Значения для параметра *selectmode* виджета [`Listbox`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Listbox).38763877#### `tkinter.PIESLICE`38783879#### `tkinter.CHORD`38803881#### `tkinter.ARC`38823883Значения для параметра *style* элемента [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas) arc.38843885#### `tkinter.BUTT`38863887#### `tkinter.PROJECTING`38883889#### `tkinter.ROUND`38903891#### `tkinter.BEVEL`38923893#### `tkinter.MITER`38943895Значения для параметров *capstyle* (`'butt'`, `'projecting'`, `'round'`) и *joinstyle* (`'round'`, `'bevel'`, `'miter'`) элементов линии [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas).38963897#### `tkinter.FIRST`38983899#### `tkinter.LAST`39003901Значения для параметра *arrow* элементов линии [`Canvas`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Canvas), указывающие, на каких концах установлены наконечники.39023903#### `tkinter.MOVETO`39043905#### `tkinter.SCROLL`39063907Первый аргумент, передаваемый [`Scrollbar`](https://python-all.ru/3.15/library/tkinter.html#tkinter.Scrollbar) в метод [`XView.xview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview) или [`YView.yview()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView.yview) прокручиваемого виджета.39083909#### `tkinter.UNITS`39103911#### `tkinter.PAGES`39123913Значения для аргумента *what* методов [`XView.xview_scroll()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.XView.xview_scroll) и [`YView.yview_scroll()`](https://python-all.ru/3.15/library/tkinter.html#tkinter.YView.yview_scroll).39143915#### `tkinter.UNDERLINE`39163917#### `tkinter.NUMERIC`39183919#### `tkinter.DOTBOX`39203921Другие значения параметров: `'underline'`, `'numeric'` и `'dotbox'`.3922