Переключение изображения в ttk.Button: почему нужен str(state)

Почему в ttk.Button чтение state возвращает Tcl-объект и ломает сравнения; рабочий пример: переключение изображения по клику в Tkinter через str(state).

Переключать изображение на кнопке Tkinter по клику звучит тривиально, но при чтении состояния виджета у ttk.Button возникает распространённая ловушка. Симптом выглядит странно: колбэк работает только тогда, когда в нём есть вызов print. Уберите print — и логика перестаёт переключаться как задумано. Исправление простое, если знать, что именно Tkinter возвращает «под капотом».

Постановка задачи

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

from tkinter import *
from tkinter import ttk
def flip_visual():
    print(toggle_btn["state"])  # работает, если эта строка присутствует
    if toggle_btn["state"] == "normal":
        pic_obj = PhotoImage(file="test1.png")
        toggle_btn.configure(image=pic_obj)
        toggle_btn.image = pic_obj
        toggle_btn.configure(state="active")
    elif toggle_btn["state"] == "active":
        pic_obj = PhotoImage(file="test.png")
        toggle_btn.configure(image=pic_obj)
        toggle_btn.image = pic_obj
        toggle_btn.configure(state="normal")
app = Tk()
app.geometry("600x600")
pic_obj = PhotoImage(file="test.png")
turn_btn = ttk.Button(app, text="TEST", image=pic_obj, command=flip_visual)
turn_btn.pack(anchor="center")
app.mainloop()

Что происходит на самом деле

Проблема в проверках условий. Для виджетов ttk чтение параметра конфигурации, такого как state, возвращает объект Tcl, а не обычную строку Python. Иными словами, toggle_btn["state"] — это не строка "normal" или "active". Если посмотреть на тип, вы увидите что-то вроде <class '_tkinter.Tcl_Obj'> вместо str. Сравнение такого Tcl-объекта напрямую со строкой Python не даст ожидаемого результата.

Вызов print — ложный след. Он лишь показывает значение, но не устраняет несоответствие типов. Чтобы условия работали стабильно, приводите значение к строке Python перед сравнением.

Исправление и рабочий пример

Преобразуйте state в str прямо в условиях. Остальная логика не меняется: по-прежнему происходит смена изображения и сохраняется ссылка на объект, чтобы избежать сборки мусора:

from tkinter import *
from tkinter import ttk
def flip_visual():
    if str(toggle_btn["state"]) == "normal":
        pic_swap = PhotoImage(file="test1.png")
        toggle_btn.configure(image=pic_swap)
        toggle_btn.image = pic_swap
        toggle_btn.configure(state="active")
    elif str(toggle_btn["state"]) == "active":
        pic_swap = PhotoImage(file="test.png")
        toggle_btn.configure(image=pic_swap)
        toggle_btn.image = pic_swap
        toggle_btn.configure(state="normal")
app = Tk()
app.geometry("600x600")
pic_initial = PhotoImage(file="test.png")
turn_btn = ttk.Button(app, text="TEST", image=pic_initial, command=flip_visual)
turn_btn.pack(anchor="center")
app.mainloop()

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

О состоянии «active»

Полезно также понимать смысл значений состояния в ttk. Состояние active связано с нажатием указателя на виджете и обычно возвращается к прежнему при отпускании. Если вам нужен устойчивый визуальный переключатель в режиме вкл/выкл, это ближе к состоянию выбора, а не взаимодействия. Практичный вариант — использовать ttk.Checkbutton с настраиваемым стилем и задать одно изображение для состояния selected и другое для !selected. Так вы получите стабильное переключение, не перегружая состояния, отвечающие за взаимодействие. За идеями обратитесь к примерам пользовательских стилей для чекбоксов в материалах, посвящённых ttk.

Почему это важно

Код GUI часто держится на мелких допущениях о типах и состояниях. Смешение подходов tk и ttk обманчиво: доступ к атрибутам выглядит одинаково, хотя под капотом объекты различаются. Явное приведение значений к строкам при сравнении состояний виджетов устраняет трудноуловимые ошибки. Понимание семантики состояний вроде active и selected помогает избежать тонких логических багов в интерфейсе.

Выводы

При чтении опций виджетов ttk, таких как state, сравнивайте со строками только после приведения через str(...). Держите постоянную ссылку на изображения, назначенные виджетам, чтобы предотвратить преждевременную сборку мусора. Если нужен постоянный переключатель, а не отклик на нажатие, рассмотрите ttk.Checkbutton с пользовательским стилем, где картинки сопоставлены состояниям selected и !selected. За дополнительными пояснениями по чтению состояний см. материалы о получении state в Tkinter, например обсуждения в формате Q&A, посвящённые именно этой проблеме.

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