Работая над проектом svgwidgets я активно использовал функционал tk busy, который появился в релизе Tcl/Tk 8.6.0. Мне стало интересно, а поддерживается ли этот функционал в Python-е, а точнее в Tkinter-е. Каково же было мое удивление узнать, что именно сейчас в Tkinter, который входит в состав Python версии 3.13, добавляется функционал tk busy, который давно включен в tcl/tk. Релиз Python 3.13 ожидается в октябре этого года. Мне показалось, что будет полезно рассказать о функционале tk busy, а точнее о новых методах для виджетов в Tkinter. Вот эти методы - tk_busy_hold(), tk_busy_configure(), tk_busy_cget(), tk_busy_forget() и tk_busy_current().
Команда tk busy предоставляет простой способ блокировки виджета от действий пользователя.
Как работают методы блокировки tk_busy в Tkinter рассмотрим на примере. При этом будем использовать классические виджеты.
Но для начала пришлось собрать из исходных кодов Python-3.13.0rc1.tgz дистрибутив Python-а. Все это было мною проделано в Linux на Mageia release 9.
Итак, создадим некий графический интерфейс, в котором будет главное окно (mwin) размером 10 сантиметров на 6 сантиметров с виджетом панели (frame1), в которой будут размещены поле ввода данных (ent1) и кнопка (but1):
bash-5.2$ /usr/local/bin64/python3.13 Python 3.13.0rc1 (main, Aug 21 2024, 15:48:04) [GCC 12.3.0] on linux Type "help", "copyright", "credits" or "license" for more information.
from tkinter import *
... mwin=Tk()
... #Установим размер главного окна
... w1=mwin.winfo_pixels('10c')
... h1=mwin.winfo_pixels('6c')
... gg=str(w1) +'x'+ str(h1)
... mwin.geometry(gg)
... #Установим желтый фон главного окна
... mwin.configure(bg='yellow')
... #создадим панель/frame на гланом окне с цветом cyan
... fr1=Frame(mwin, bg='cyan')
... #Разместим панель fr1 в главном окне
... fr1.pack(fill='both',expand='1',padx='1c',pady='5m',side='top')
... #Создадим поле для ввода данных на панели fr1
... ent1=Entry(fr1)
... #Расместим поле ent1
... ent1.pack(fill='x', expand='0',padx='1c', pady='5m', anchor='nw')
... #Создадим кновку Ввод на панели fr1
... but1=Button(fr1, text='Ввод')
... #Разместим кнопку but1
... but1.pack(anchor='n')
... but1.pack(anchor='n', pady='0')
... #Определим фнкцию для обработки события , которая будет печатать имя виджета, на котором произошло это
событие
... def on_enter(event):
... print('Виджет=' + str(event.widget) + '\r')
... fr1.unbind('')
... mwin.bind('', on_enter, add=None)
... #Функция для нажатия кнопки
... def put_str (data):
... print ('Кнопка=' + data + '\r')
... #Подключаем вызов функции при нажатии кнопки:
... but1.configure(command=lambda: put_str("but1"))
... #фокус курсора убираем на главное окно
... mwin.focus()
... fr1.tk_busy_hold()
...
Теперь создадим функцию do_enter, которая будет вызываться при наведении курсора на главное окно и печатать идентификатор этого виджета:
def on_enter(event):
print('Виджет=' + str(event.widget) + '\r')Для того, чтобы эта функция срабатывала, необходимо связать ее с главным окном и событием:
mwin.bind('<Enter>', on_enter, add=None)Напомним команды для отмены вызова обработчика:
mwin.unbind('<Enter>')Напоминаю на тот случай, если кто-то будет обновлять обработчик, чтобы обновленный обработчик заработал, надо сначала отключить старый, в противном случае могут срабатывать оба обработчика.
Особенность связывания обработки событий <Enter> и <Leave> для главного окна состоит в том, что эта обработка будет вызываться и при наведении курсора мыши на любой виджет в этом окне.
После того, как был подключен обработчик события <Enter>, при наведении курсора на тот или иной виджет будет печататься его идентификатор.
Для полноты картины добавим еще одну функцию, которая будет печатать передаваемую ей строку:
def put_str (data):
print ('Кнопка=' + data + '\r') Эта функция будет вызываться у нас при нажатии кнопки «Ввод»:
but1.configure(command=lambda: put_str("but1"))Теперь при попадании курсора на тот или иной виджет будет печататься имя (идентификатор) виджета, а при нажатии на кнопку «Ввод» печататься текст:
Кнопка=but1
Предположим, что мы хотим на какой-то период обезопасить себя и сделать так, чтобы любые события и действия для панели fr1 и расположенных на ней поля ввода ent1 и кнопки but1 были заблокированы. Отметим, что блокировка тех или иных виджетов и операций с ними является неотъемлемой частью безопасности приложения, защиты как от преднамеренных, так и случайных деструктивных действий.
Возьмем сразу быка за рога и применим метод tk_busy_hold() для блокировки панели fr1 и посмотрим, что будет:
fr1.tk_busy_hold() Но перед выполнением этой операции переведем фокус курсора мыши на главное окно:
mwin.focus()Зачем мы это делаем, будет сказан чуть ниже.
Итак, после выполнения команды fr1.tk_busy_hold() в нашем примере появится курсор занятости или блокирования в виде вращающегося круга с сине-красным ободком:
Этот курсор будет на всем пространстве панели, включая поле ввода и кнопку. За пределами панели fr1 курсор примет обычный вид. Кстати, вид курсора занятости можно поменять, задав его его вид как параметр в методе tk_busy_hold(cursor='<имя курсора>'), yапример, fr1.tk_busy_hold(cursor='gumby'):
Стандартный курсор занятости имеет идентификатор watch.
Эффект блокировки впечатляет. Кнопка «Ввод» полностью блокирована, мы не можем нажать на кнопку и она не реагирует на появление курсора мыши на ее поверхности. Аналогичным образом ведет себя и поле ввода. А вот перемещение курсора мыши на поверхность самой панели fr1 вызывает печать следующего текста:
Виджет=.!frame_Busy
До блокировки панели при наведении курсора мыши на нее печатался несколько иной текст:
Виджет=.!frame
Функция блокировки реализована простым и элегантным способом путем создания и отображения прозрачного окна, полностью закрывающего блокируемый виджет. Это окно создается с постфиксом _Busy и оно наследует обработку событий <Enter> и <Leave>, определенных для главного окна. Блокирующее прозрачное окно .!frame_Busy закрывает виджеты ent1 и but1, поэтому курсор мыши не попадает на них и событие для них не наступает.
К сожалению, если наш обработчик события показывет наличие виджета .!frame_Busy, то методы winfo_children() и children.values() не показывают окно блокировки. Может еще не реализовали? Подождем релиза. На вырочку приходит метод call():
mwin.call('winfo', 'children', mwin)
Результат выполнения этой команды будет следующим:
('.!frame', '.!frame_Busy')
Здесь мы видим и виджет, который мы блокируем .!frame и собственно блокирующий виджет .!frame_Busy.
Используя метод tk_busy_current() можно узнать к каким виджетам был применем метод блокирования tk_busy_hold(), т.е. какие виджеты заблокированы, например:
mwin.tk_busy_current()
Результат выполнения будет следующим:
[<tkinter.Frame object .!frame>, <tkinter.Tk object .>]
В данном примере заблокированными являются главное окно (tkinter.Tk) с именем «.» (точка) и панель (tkinter.Frame) с именем «.!frame».
Если мы хотим узнать текущий статус виджета, то можно использовать метод tk_busy_status(), который возвращает либо False либо True:
ent1.tk_busy_status()
Результатом выполнения данной команды будет False, к виджету ent1 метод tk_busy_hold() не применялся.
Узнать какой курсор занятости установлен или сменить его можно, применив метод tk_busy_configure(cursor='<идентификатор курсора>'). Например, установить курсор в виде песочных часов можно следующей командой:
fr1.tk_busy_configure(cursor='clock')
Но не все так радужно, есть и нюансы. Вот о них и пойдет речь ниже.
Вспомним, что перед блокированием виджета fr1 фокус курсора был связан с главным окном:
mwin.focus()
Это связано с тем, что блокирующее окно не предотвращает отправку событий клавиатуры на виджеты.
Предположим, мы в поле ввода ввели текст «Курсор здесь» и сразу же заблокировали панель fr1, оставив курсор в поле ввода:
На верхнем скриншоте показано состояние gui на момент блокирования панели fr1, курсор находился в поле ввода. На нижнем скриншоте показано, что несмотря на то, что панель заблокирована, если главное окно активно и идет ввод с клавиатуры, то он следует за курсором. Вот чтобы этого избежать и требуется установить курсор в нейтральное положение. Лично я ставлю его на главное окно. Можно создать временный виджет (ту же панель), обязательно его разместить (place, pack, grid), установить на него фокус курсора, а после этого временный виджет можно и уничтожить.
Естественно, мы могли не блокировать всю панель fr1, а просто заблокировать отдельно поле ввода ent1 и кнопку but1:
#Разблокируем панель fr1
fr1.tk_busy_forget()
#Курсор мыши на панель fr1
fr1.focus()
#Блокируем поле ввода ent1
ent1.tk_busy_hold()
# Блокируем кнопку but1
but1.tk_busy_hold()Теперь при наведении курсора на панель fr1 будет печататься сообщение «Виджет=.!frame», а вот при попадание курсора на поле ввода или кнопку будет печататься идентификатор блокирующего окна «Виджет=.!frame.!entry_Busy» или «Виджет=.!frame.!button_Busy».
А чтобы все было как при блокировании панели fr1, можно установить для нее курсор watch:
fr1.configure(cursor='watch')
предварительно сохранив текущий курсор:
cur=fr1.cget('cursor')
Вернуть курсор в исходное состояние можно так:
fr1.configure(cursor=cur)
Теперь вернемся в исходное состояние, когда заблокирована панель fr1:
Для начала разблокируем поле ввода и кнопку:
ent1.tk_busy_forget()
fr1 tk_busy_forget()И снова заблокируем панель fr1:
#Прячем курсор
fr1.focus()
#Блокируем панель fr1
fr1.tk_busy_hold()Все, и поле ввода, и кнопка для нас недоступны.
А теперь попробуйте применить метод lift() к заблокированной панели:
fr1.lift()
И вы увидите, что панель, а следовательно, и поле ввода и кнопки стали доступны!
При этом метод tk_busy_status() показывает, что панель заблокирована:
fr1.tk_busy_status()
True Также как и метод tk_busy_current():
fr1.tk_busy_current()
[<tkinter.Frame object .!frame>] Также как и метод call():
mwin.call('winfo', 'children', mwin)
('.!frame', '.!frame_Busy'Все очень просто, блокируемое окно (.!frame) и блоукирующее (.!frame_Busy) находятся на одном уровне иерархии и к ним применимы методы lift() и lower().
Метод lower() позволит опустить панель под блокирующее окно:
fr1.lower('.!frame.!button_Busy')
Методы lift() и lower() открывают широкий простор применения методов семества tk_busy для блокировки одноуровневых виджетов. Но эта тема для отдельной статьи.
А теперь будем ждать выхода Python релиза 3.13.
Всех с началом нового учебного года!
