Виджет Checkbutton (флажок) в Tkinter: свойства и методы

• 04.08.2023
• 442
• Встроенные модули
• Tkinter

Виджет Checkbutton в Tkinter представляет собой тип переключателя, который может принимать два состояния: выбранное (checked) и не выбранное (unchecked). Это позволяет пользователю выбрать одну или несколько опций из набора.

Создание Checkbutton

Создание Checkbutton в Tkinter осуществляется следующим образом:

chk = Checkbutton(master, option=value, ...)

Здесь master — это родительский виджет, а option=value — это пары опций и значений, которые можно использовать для настройки Checkbutton.

Свойства Checkbutton

Виджет Checkbutton имеет ряд свойств, которые позволяют настроить его поведение и внешний вид. Вот некоторые из них:

• activebackground: цвет фона кнопки, когда она находится в состоянии «активно».

chk = Checkbutton(root, activebackground='blue')

• activeforeground: цвет текста кнопки, когда она находится в состоянии «активно».

chk = Checkbutton(root, activeforeground='white')

• bg или background: задает цвет фона кнопки.

chk = Checkbutton(root, bg='red')

• bd или borderwidth: ширина границы кнопки.

chk = Checkbutton(root, bd=5)

• command: функция или метод, который будет вызываться при изменении состояния переключателя.

def on_click():
    print("Clicked")

chk = Checkbutton(root, command=on_click)

• cursor: тип курсора, который отображается при наведении на кнопку.

chk = Checkbutton(root, cursor='circle')

• font: задает шрифт текста на кнопке.

chk = Checkbutton(root, font=('Arial', 16))

• fg или foreground: задает цвет текста на кнопке.

chk = Checkbutton(root, fg='green')

• height и width: задают высоту и ширину кнопки соответственно.

chk = Checkbutton(root, height=2, width=10)

• image: позволяет установить изображение вместо текста на кнопке.

img = PhotoImage(file='check.gif')
chk = Checkbutton(root, image=img)

• state: состояние кнопки. Может быть normal, active или disabled.

chk = Checkbutton(root, state='disabled')

• text: задает текст, который будет отображаться на кнопке.

chk = Checkbutton(root, text='Check me')

• variable: связывает кнопку с экземпляром специального типа данных Tkinter (обычно IntVar или StringVar).

var = IntVar()
chk = Checkbutton(root, variable=var)

• onvalue и offvalue: значения, которые принимает связанная переменная, когда переключатель включен или выключен.

var = IntVar()
chk = Checkbutton(root, variable=var, onvalue=1, offvalue=0)

Методы Checkbutton

Виджет Checkbutton в Tkinter предоставляет несколько полезных методов для управления его поведением. Вот некоторые из них:

• deselect(): очищает (снимает отметку) с Checkbutton.
• select(): выбирает (ставит отметку) Checkbutton.
• toggle(): переключает состояние Checkbutton. Если он был выбран, он становится не выбранным, и наоборот.
• invoke(): программно вызывает «нажатие» на Checkbutton, что приводит к вызову связанной функции команды и переключению состояния.
• flash(): заставляет Checkbutton мигать несколько раз. Это может быть полезно для привлечения внимания пользователя.
• config(): изменяет конфигурацию Checkbutton после его создания. Вы можете использовать любые из свойств Checkbutton, описанных выше.
• cget(): получает текущее значение указанного свойства Checkbutton.

Эти методы можно использовать для управления Checkbutton после его создания и для взаимодействия с пользователем.

Пример использования Checkbutton

from tkinter import Tk, Checkbutton, IntVar

def on_click():
    print(var.get())

root = Tk()

var = IntVar()
chk = Checkbutton(root, text="Check me", variable=var, onvalue=1, offvalue=0, command=on_click)
chk.pack()

root.mainloop()

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

Заключение

Виджет Checkbutton в Tkinter представляет собой удобный инструмент для предоставления пользователю возможности выбрать одну или несколько опций из набора. Он предлагает широкий набор свойств и методов, которые позволяют настроить его внешний вид и поведение, а также программно управлять его состоянием.