tkinter.ttk — тематические виджеты Tk

Использование Ttk

Чтобы начать использовать Ttk, импортируйте его модуль:

from tkinter import ttk

Чтобы заменить базовые виджеты Tk, импорт должен следовать за импортом Tk:

from tkinter import *
from tkinter.ttk import *

Этот код заставляет несколько виджетов tkinter.ttk (Button, Checkbutton, Entry, Frame, Label, LabelFrame, Menubutton, OptionMenu, PanedWindow, Radiobutton, Scale, Scrollbar и Spinbox) автоматически заменять виджеты Tk.

Это позволяет использовать новые виджеты, которые обеспечивают более привлекательный внешний вид на разных платформах; однако заменяющие виджеты не полностью совместимы. Главное отличие состоит в том, что параметры виджетов, такие как fg, bg и другие параметры, связанные со стилизацией виджетов, больше не доступны для виджетов Ttk. Вместо них для более эффективной стилизации используйте класс ttk.Style.

Виджеты Ttk

Ttk включает 18 виджетов, двенадцать из которых уже существовали в tkinter: Button, Checkbutton, Entry, Frame, Label, LabelFrame, Menubutton, PanedWindow, Radiobutton, Scale, Scrollbar и Spinbox. Остальные шесть — новые: Combobox, Notebook, Progressbar, Separator, Sizegrip и Treeview. Все они являются подклассами Widget.

Использование виджетов Ttk улучшает внешний вид приложения. Как отмечалось выше, существуют различия в способах описания стилей.

Код Tk:

l1 = tkinter.Label(text="Test", fg="black", bg="white")
l2 = tkinter.Label(text="Test", fg="black", bg="white")

Код Ttk:

style = ttk.Style()
style.configure("BW.TLabel", foreground="black", background="white")

l1 = ttk.Label(text="Test", style="BW.TLabel")
l2 = ttk.Label(text="Test", style="BW.TLabel")

Дополнительные сведения о стилизации Ttk см. в документации класса Style.

Виджет

ttk.Widget определяет стандартные параметры и методы, поддерживаемые тематическими виджетами Tk, и не предназначен для непосредственного создания экземпляров.

Поле со списком

Виджет ttk.Combobox объединяет текстовое поле с раскрывающимся списком значений. Этот виджет является подклассом Entry.

Помимо методов, унаследованных от Widget: cget(), configure(), identify(), instate() и state(), а также методов, унаследованных от Entry: bbox(), delete(), icursor(), index(), insert(), selection*, xview*, он имеет и другие методы, описанные в разделе ttk.Combobox.

Счетчик

Виджет ttk.Spinbox — это ttk.Entry с кнопками увеличения и уменьшения. Его можно использовать для чисел или списков строковых значений. Этот виджет является подклассом Entry. Помимо методов, унаследованных от Widget: cget(), configure(), identify(), instate() и state(), а также методов, унаследованных от Entry: bbox(), delete(), icursor(), index(), insert(), xview*, он имеет и другие методы, описанные в ttk.Spinbox.

Блокнот

Виджет Ttk Notebook управляет коллекцией окон и отображает только одно из них в каждый момент времени. Каждое дочернее окно связано с вкладкой, которую пользователь может выбрать, чтобы изменить отображаемое в данный момент окно.

Индикатор выполнения

Виджет ttk.Progressbar показывает состояние длительной операции. Он может работать в двух режимах: 1) определенном, который показывает объем выполненной работы относительно общего объема, и 2) неопределенном, в котором отображается анимация, сообщающая пользователю о ходе работы.

Разделитель

Виджет ttk.Separator отображает горизонтальную или вертикальную разделительную линию.

Помимо методов, унаследованных от ttk.Widget, у него нет других методов.

Маркер изменения размера

Виджет ttk.Sizegrip (также известный как маркер изменения размера) позволяет пользователю изменить размер содержащего его окна верхнего уровня, нажав на маркер и перетащив его.

У этого виджета нет собственных параметров или методов, кроме унаследованных от ttk.Widget.

Иерархическое представление

Виджет ttk.Treeview отображает иерархическую коллекцию элементов. У каждого элемента есть текстовая метка, необязательное изображение и необязательный список значений данных. Значения данных отображаются в последовательных столбцах после метки дерева.

Порядок отображения значений данных можно настроить с помощью параметра виджета displaycolumns. Виджет дерева также может отображать заголовки столбцов. Доступ к столбцам можно получить по номеру или по символьным именам, перечисленным в параметре виджета columns. См. раздел Идентификаторы столбцов.

Каждый элемент имеет уникальное имя. Если вызывающий код не указал идентификаторы элементов, виджет создаст их самостоятельно. Существует особый корневой элемент с именем {}. Сам корневой элемент не отображается; его дочерние элементы находятся на верхнем уровне иерархии.

У каждого элемента также есть список тегов, которые можно использовать для привязки событий к отдельным элементам и управления их внешним видом.

Виджет Treeview поддерживает горизонтальную и вертикальную прокрутку в соответствии с параметрами, описанными в разделе Параметры прокручиваемого виджета, и методами Treeview.xview() и Treeview.yview().

Стилизация Ttk

Каждому виджету в ttk назначается стиль, который определяет набор элементов, составляющих виджет, и способ их расположения, а также динамические и стандартные значения параметров элементов. По умолчанию имя стиля совпадает с именем класса виджета, но его можно переопределить с помощью параметра стиля виджета. Если вы не знаете имя класса виджета, используйте метод Misc.winfo_class (somewidget.winfo_class()).

class tkinter.ttk.Style

Этот класс используется для управления базой данных стилей.

configure(style, query_opt=None, **kw)

Запрашивает или задаёт стандартное значение указанного параметра или параметров в style.

Каждый ключ в kw — это параметр, а каждое значение — строка, определяющая значение этого параметра.

Например, чтобы изменить все стандартные кнопки на плоские кнопки с некоторыми отступами и другим цветом фона:

from tkinter import ttk
import tkinter

root = tkinter.Tk()

ttk.Style().configure("TButton", padding=6, relief="flat",
   background="#ccc")

btn = ttk.Button(text="Sample")
btn.pack()

root.mainloop()

map(style, query_opt=None, **kw)

Запрашивает или задаёт динамические значения указанного параметра или параметров в style.

Каждый ключ в kw — это параметр, а каждое значение должно быть списком или кортежем (как правило), содержащим спецификации состояний, сгруппированные в кортежи, списки или каким-либо иным способом. Спецификация состояния состоит из одного или нескольких состояний, за которыми следует значение.

Пример поможет лучше понять это:

import tkinter
from tkinter import ttk

root = tkinter.Tk()

style = ttk.Style()
style.map("C.TButton",
    foreground=[('pressed', 'red'), ('active', 'blue')],
    background=[('pressed', '!disabled', 'black'), ('active', 'white')]
    )

colored_btn = ttk.Button(text="Test", style="C.TButton").pack()

root.mainloop()

Обратите внимание, что порядок последовательностей (состояния, значение) для параметра имеет значение. Например, если изменить порядок на [('active', 'blue'), ('pressed', 'red')] в параметре foreground, при активном состоянии или состоянии нажатия цвет переднего плана станет синим.

При вызове для запроса карты (без указания задаваемых значений) возвращается словарь, сопоставляющий каждому параметру его список спецификаций состояний.

Изменено в версии 3.10: Исправлено возвращаемое при запросе карты значение.

lookup(style, option, state=None, default=None)

Возвращает значение, указанное для option в style.

Если указан state, ожидается последовательность из одного или нескольких состояний. Если задан аргумент default, он используется в качестве резервного значения, если спецификация для параметра не найдена.

Чтобы проверить, какой шрифт по умолчанию использует Button:

from tkinter import ttk

print(ttk.Style().lookup("TButton", "font"))

layout(style, layoutspec=None)

Определяет макет виджета для заданного style. Если layoutspec не указан, возвращает спецификацию макета для заданного стиля.

Если указан layoutspec, ожидается список или другой тип последовательности (кроме строк), каждый элемент которой должен быть кортежем: первый элемент — имя макета, а второй должен иметь формат, описанный в разделе Макеты.

Чтобы понять формат, рассмотрите следующий пример (он не предназначен для выполнения полезных действий):

from tkinter import ttk
import tkinter

root = tkinter.Tk()

style = ttk.Style()
style.layout("TMenubutton", [
   ("Menubutton.background", None),
   ("Menubutton.button", {"children":
       [("Menubutton.focus", {"children":
           [("Menubutton.padding", {"children":
               [("Menubutton.label", {"side": "left", "expand": 1})]
           })]
       })]
   }),
])

mbtn = ttk.Menubutton(text='Text')
mbtn.pack()
root.mainloop()

element_create(elementname, etype, *args, **kw)

Создаёт новый элемент в текущей теме заданного типа etype, которым может быть «image», «from» или «vsapi». Последний доступен только в Tk 8.6 для Windows.

Если используется «image», аргумент args должен содержать имя изображения по умолчанию, за которым следуют пары спецификация состояния/значение (это спецификация изображения), а kw может содержать следующие параметры:

border=padding

padding — это список, содержащий до четырёх целых чисел, которые задают соответственно левую, верхнюю, правую и нижнюю границы.

height=height

Задаёт минимальную высоту элемента. Если значение меньше нуля, в качестве значения по умолчанию используется высота базового изображения.

padding=padding

Задаёт внутренние отступы элемента. Если значение не указано, по умолчанию используется значение border.

sticky=spec

Задаёт расположение изображения внутри итоговой области. spec содержит ноль или более символов «n», «s», «w» или «e».

width=width

Задаёт минимальную ширину элемента. Если значение меньше нуля, в качестве значения по умолчанию используется ширина базового изображения.

Пример:

img1 = tkinter.PhotoImage(master=root, file='button.png')
img1 = tkinter.PhotoImage(master=root, file='button-pressed.png')
img1 = tkinter.PhotoImage(master=root, file='button-active.png')
style = ttk.Style(root)
style.element_create('Button.button', 'image',
                     img1, ('pressed', img2), ('active', img3),
                     border=(2, 4), sticky='we')

Если в качестве значения etype используется «from», element_create() клонирует существующий элемент. Ожидается, что args содержит имя темы, из которой будет клонирован элемент, и, при необходимости, элемент, который нужно клонировать. Если элемент для клонирования не указан, будет использован пустой элемент. Аргумент kw отбрасывается.

Пример:

style = ttk.Style(root)
style.element_create('plain.background', 'from', 'default')

Если в качестве значения etype используется «vsapi», element_create() создаёт новый элемент в текущей теме, визуальный вид которого отрисовывается с помощью API визуальных стилей Microsoft, отвечающего за стили оформления в Windows XP и Vista. Ожидается, что args содержит класс и часть визуальных стилей, указанные в документации Microsoft, за которыми может следовать последовательность кортежей из состояний ttk и соответствующих значений состояния API визуальных стилей. Аргумент kw может содержать следующие параметры:

padding=padding

Задаёт внутренние отступы элемента. padding — это список, содержащий до четырёх целых чисел, которые задают соответственно левый, верхний, правый и нижний отступы. Если указано меньше четырёх элементов, нижний отступ по умолчанию равен верхнему, правый — левому, а верхний — левому. Иными словами, список из трёх чисел задаёт левый, вертикальный и правый отступы; список из двух чисел задаёт горизонтальный и вертикальный отступы; одно число задаёт одинаковые отступы со всех сторон виджета. Этот параметр нельзя сочетать с другими параметрами.

margins=padding

Задаёт внешние отступы элемента. padding — это список, содержащий до четырёх целых чисел, которые задают соответственно левый, верхний, правый и нижний отступы. Этот параметр нельзя сочетать с другими параметрами.

width=width

Задаёт ширину элемента. Если этот параметр задан, API визуальных стилей не будет запрашиваться для получения рекомендуемого размера или части. В этом случае также следует задать height. Параметры width и height нельзя сочетать с параметрами padding или margins.

height=height

Задаёт высоту элемента. См. комментарии к параметру width.

Пример:

style = ttk.Style(root)
style.element_create('pin', 'vsapi', 'EXPLORERBAR', 3, [
                     ('pressed', '!selected', 3),
                     ('active', '!selected', 2),
                     ('pressed', 'selected', 6),
                     ('active', 'selected', 5),
                     ('selected', 4),
                     ('', 1)])
style.layout('Explorer.Pin',
             [('Explorer.Pin.pin', {'sticky': 'news'})])
pin = ttk.Checkbutton(style='Explorer.Pin')
pin.pack(expand=True, fill='both')

Изменено в версии 3.13: Добавлена поддержка фабрики элементов «vsapi».

element_names()

Возвращает кортеж элементов, определённых в текущей теме.

element_options(elementname)

Возвращает кортеж параметров элемента elementname.

theme_create(themename, parent=None, settings=None)

Создаёт новую тему.

Если themename уже существует, возникает ошибка. Если указан parent, новая тема наследует стили, элементы и макеты родительской темы. Если задан settings, ожидается, что он будет иметь тот же синтаксис, что и theme_settings().

theme_settings(themename, settings)

Временно задаёт текущей тему themename, применяет указанные settings, а затем восстанавливает предыдущую тему.

Каждый ключ в settings — это стиль, а каждое значение может содержать ключи ‘configure’, ‘map’, ‘layout’ и ‘element create’; предполагается, что их формат совпадает с форматом, указанным в методах Style.configure(), Style.map(), Style.layout() и Style.element_create() соответственно.

Например, немного изменим Combobox для стандартной темы:

from tkinter import ttk
import tkinter

root = tkinter.Tk()

style = ttk.Style()
style.theme_settings("default", {
   "TCombobox": {
       "configure": {"padding": 5},
       "map": {
           "background": [("active", "green2"),
                          ("!disabled", "green4")],
           "fieldbackground": [("!disabled", "green3")],
           "foreground": [("focus", "OliveDrab1"),
                          ("!disabled", "OliveDrab2")]
       }
   }
})

combo = ttk.Combobox().pack()

root.mainloop()

theme_names()

Возвращает кортеж всех известных тем.

theme_use(themename=None)

Если themename не задан, возвращает используемую тему. В противном случае задаёт текущей тему themename, обновляет все виджеты и генерирует событие <<ThemeChanged>>.

Дополнительные виджеты

Следующие тематические виджеты дополняют набор виджетов tkinter.ttk. Каждый из них является тематическим аналогом классического виджета tkinter с таким же именем и наследует общие методы Widget.

class tkinter.ttk.Button(master=None, **kw)

Виджет Ttk Button отображает текстовую метку и/или изображение и выполняет команду при нажатии. Это тематический аналог tkinter.Button; он наследует общие методы виджетов от Widget.

invoke()

Вызывает команду, связанную с кнопкой, и возвращает её результат.

class tkinter.ttk.Checkbutton(master=None, **kw)

Виджет Ttk Checkbutton используется для управления логической переменной, переключаемой между включённым и выключенным состояниями. Это тематический аналог tkinter.Checkbutton; он наследует общие методы виджетов от Widget.

invoke()

Переключает кнопку между выбранным и невыбранным состояниями, вызывает связанную с кнопкой команду и возвращает её результат.

class tkinter.ttk.Entry(master=None, widget=None, **kw)

Виджет Ttk Entry отображает однострочный текст и позволяет пользователю редактировать его. Это тематический аналог tkinter.Entry; он наследует общие методы виджетов от Widget, а также методы редактирования от tkinter.Entry.

bbox(index)

Возвращает кортеж (x, y, width, height), задающий ограничивающий прямоугольник символа с указанным index.

Этот метод переопределяет унаследованный Misc.bbox(); для получения ограничивающего прямоугольника сетки используйте grid_bbox().

identify(x, y)

Возвращает имя элемента под точкой с координатами x и y или пустую строку, если в этом месте нет элемента.

validate()

Принудительно выполняет проверку поля ввода и возвращает True, если проверка прошла успешно, и False в противном случае.

class tkinter.ttk.Frame(master=None, **kw)

Виджет Ttk Frame — это контейнер, предназначенный для группировки и размещения других виджетов. Это тематический аналог tkinter.Frame; он наследует общие методы виджетов от Widget.

class tkinter.ttk.Label(master=None, **kw)

Виджет Ttk Label отображает текстовую метку и/или изображение. Это тематический аналог tkinter.Label; он наследует общие методы виджетов от Widget.

class tkinter.ttk.Labelframe(master=None, **kw)

Виджет Ttk Labelframe — это контейнер, который обводит содержимое рамкой и заголовком. Это тематический аналог tkinter.LabelFrame; он наследует общие методы виджетов от Widget.

class tkinter.ttk.Menubutton(master=None, **kw)

Виджет Ttk Menubutton отображает текстовую метку и/или изображение и открывает меню при нажатии. Это тематический аналог tkinter.Menubutton; он наследует общие методы виджетов от Widget.

class tkinter.ttk.OptionMenu(master, variable, default=None, *values, **kwargs)

Виджет Ttk OptionMenu — это Menubutton, который открывает меню взаимно исключающих вариантов. variable — это переменная, отслеживающая выбранное значение; default — значение, задаваемое изначально; values — элементы, отображаемые в меню. Аргумент-ключевое слово command можно использовать, чтобы задать вызываемый объект, который будет вызываться с выбранным значением при каждом изменении выбора; аргумент-ключевое слово style задаёт стиль основной кнопки меню; аргумент-ключевое слово direction задаёт расположение меню относительно кнопки меню (одно из значений 'above', 'below' (по умолчанию), 'left', 'right' или 'flush'); аргумент-ключевое слово name задаёт имя виджета Tk.

set_menu(default=None, *values)

Заменяет элементы меню на values. Если задан default, он также устанавливается в качестве текущего значения variable.

destroy()

Уничтожает этот виджет и связанное с ним меню.

Изменено в версии 3.14: Добавлена поддержка аргумента-ключевого слова name.

class tkinter.ttk.Panedwindow(master=None, **kw)

Виджет Ttk Panedwindow отображает несколько подокон, расположенных вертикально или горизонтально. Пользователь может изменять относительные размеры подокон, перетаскивая разделитель между панелями. Это тематический аналог tkinter.PanedWindow; он наследует общие методы виджетов от Widget, а также методы add() и panes() от tkinter.PanedWindow.

insert(pos, child, **kw)

Вставляет панель, содержащую child, в позицию pos. pos может быть строкой 'end', целочисленным индексом или именем управляемого подокна. Если панель уже управляется панельным окном, она перемещается в указанную позицию. Любые аргументы-ключевые слова задают параметры панели.

forget(child)

Удаляет child из панелей. В качестве child можно указать целочисленный индекс или имя управляемого подокна.

Этот метод переопределяет унаследованный метод менеджера геометрии forget(); используйте pack_forget(), grid_forget() или place_forget(), чтобы удалить сам виджет из менеджера.

pane(pane, option=None, **kw)

Запрашивает или изменяет параметры указанной pane, где pane — это целочисленный индекс или имя управляемого подокна. Если аргументы не заданы, возвращает словарь значений параметров панели. Если указан option, возвращает значение этого параметра. В противном случае задаёт переданные в виде аргументов-ключевых слов параметры соответствующими значениями.

sashpos(index, newpos=None)

Если задан newpos, задаёт позицию разделителя с номером index и возвращает его новую позицию. Это может привести к изменению позиций соседних разделителей, чтобы обеспечить их монотонный рост; позиции также ограничены диапазоном от 0 до общего размера виджета. Если newpos не задан, возвращает текущую позицию разделителя.

class tkinter.ttk.Radiobutton(master=None, **kw)

Виджет Ttk Radiobutton используется в составе группы для управления одной общей переменной посредством выбора одного из нескольких взаимоисключающих значений. Это тематический аналог tkinter.Radiobutton; он наследует общие методы виджетов от Widget.

invoke()

Задаёт переменной параметра значение кнопки, выбирает кнопку, вызывает связанную с ней команду и возвращает результат.

class tkinter.ttk.Scale(master=None, **kw)

Виджет Ttk Scale отображает ползунок, позволяющий пользователю выбрать числовое значение из диапазона, перемещая ползунок вдоль желоба. Это тематический аналог tkinter.Scale; он наследует общие методы виджетов от Widget.

configure(cnf=None, **kw)

Изменяет параметры виджета или запрашивает их, как Widget.configure. Кроме того, этот метод ограничивает значения from и to, чтобы текущее значение оставалось в заданном ими диапазоне.

Изменено в версии 3.9: Теперь возвращает значение конфигурации, как Widget.configure.

get(x=None, y=None)

Возвращает текущее значение шкалы. Если заданы x и y, вместо этого возвращает значение, соответствующее координатам пикселя x, y.

class tkinter.ttk.Scrollbar(master=None, **kw)

Виджет Ttk Scrollbar управляет областью просмотра связанного прокручиваемого виджета, например Treeview, Entry или tkinter.Text. Это тематический аналог tkinter.Scrollbar; он наследует общие методы виджетов от Widget, а также методы set() и get() от tkinter.Scrollbar.

class tkinter.ttk.Separator(master=None, **kw)

Виджет Ttk Separator отображает горизонтальную или вертикальную линию-разделитель. Он не имеет прямого аналога в tkinter и наследует общие методы виджетов от Widget.

class tkinter.ttk.Sizegrip(master=None, **kw)

Виджет Ttk Sizegrip отображает маркер, позволяющий пользователю изменять размер содержащего его окна верхнего уровня, нажав на маркер и перетащив его; обычно он располагается в правом нижнем углу. Он не имеет прямого аналога в tkinter и наследует общие методы виджетов от Widget.

class tkinter.ttk.LabeledScale(master=None, variable=None, from_=0, to=10, **kw)

Frame, содержащий Scale и Label, отображающий текущее значение шкалы. variable — это IntVar, отслеживаемая шкалой (если она не задана, создаётся новая), а from_ и to задают диапазон шкалы.

destroy()

Уничтожает этот виджет и удаляет функцию обратного вызова трассировки, зарегистрированную для связанной переменной.

class tkinter.ttk.LabelFrame(master=None, **kw)

Псевдоним Labelframe, сохранённый для совместимости имён с tkinter.LabelFrame.

class tkinter.ttk.PanedWindow(master=None, **kw)

Псевдоним Panedwindow, сохранённый для совместимости имён с tkinter.PanedWindow.