tkinter.ttk – темизированные виджеты Tk¶tkinter.ttk – Tk themed widgets

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

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

from tkinter import ttk

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

from tkinter import *
from tkinter.ttk import *

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

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

Виджеты Ttk¶Ttk widgets

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")

Для получения дополнительной информации о TtkStyling см. документацию класса Style.

Widget¶

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

Combobox¶

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

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

Spinbox¶

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

Notebook¶

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

Progressbar¶

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

Separator¶

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

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

Sizegrip¶

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

Этот виджет не имеет ни специфических опций, ни специфических методов, кроме унаследованных от ttk.Widget.

Treeview¶

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

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

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

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

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

Стилизация Ttk¶Ttk styling

Каждому виджету в ttk назначается стиль, который определяет набор элементов, составляющих виджет, и то, как они располагаются, а также динамические и стандартные настройки для параметров элементов. По умолчанию имя стиля совпадает с именем класса виджета, но его можно переопределить с помощью параметра style виджета. Если имя класса виджета неизвестно, используйте метод 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 является параметром, а каждое значение должно быть списком или кортежем (обычно), содержащим спецификации состояний (statespecs), сгруппированные в кортежи, списки или как-то иначе. Спецификация состояний – это комбинация одного или нескольких состояний, за которыми следует значение.

Пример может прояснить это.

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()

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

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

Изменено в версии 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, если указан, должен быть списком или другим типом последовательности (исключая строки), где каждый элемент должен быть кортежем, первый элемент – имя макета, а второй элемент должен иметь формат, описанный в разделе Layouts.

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

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 должен содержать имя изображения по умолчанию, за которым следуют пары спецификация состояния/значение (это imagespec), а 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() создаёт новый элемент в текущей теме, внешний вид которого отрисовывается с помощью Microsoft Visual Styles API – API, отвечающего за темы оформления в Windows XP и Vista. args должен содержать класс и часть Visual Styles, как указано в документации Microsoft, за которыми следует опциональная последовательность кортежей состояний ttk и соответствующих значений состояний Visual Styles API. kw может иметь следующие опции:

padding=padding

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

margins=padding

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

width=width

Задаёт ширину элемента. Если эта опция установлена, Visual Styles 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>>.

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

Следующие тематические виджеты дополняют набор виджетов 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 задаёт стиль, используемый базовой кнопкой меню; а аргумент 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', целочисленным индексом или именем управляемого подокна. Если child уже управляется окном с панелями, перемещает его на указанную позицию. Любые аргументы-ключевые слова задают параметры панели.

forget(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.