bind

НАЗВАНИЕ

bind — Организация вызова скриптов Tcl для событий X

СИНТАКСИС

ВВЕДЕНИЕ

ШАБЛОНЫ СОБЫТИЙ

МОДИФИКАТОРЫ

ТИПЫ СОБЫТИЙ

Activate, Deactivate

MouseWheel

KeyPress, KeyRelease

ButtonPress, ButtonRelease, Motion

Configure

Map, Unmap

Visibility

Expose

Destroy

FocusIn, FocusOut

Enter, Leave

Property

Colormap

MapRequest, CirculateRequest, ResizeRequest, ConfigureRequest, Create

Gravity, Reparent, Circulate

Имя

Синтаксис

Введение

Если последовательность указана без скрипта, то возвращается скрипт, в настоящее время связанный с последовательностью, или возвращается пустая строка, если нет связывания для последовательности. Если ни последовательность, ни скрипт не указаны, то возвращаемое значение — список, элементы которого — все последовательности, для которых существуют связывания для тега.

Аргумент тег определяет, к каким окнам применяется связывание. Если тег начинается с точки, как в .a.b.c, то он должен быть именем пути к окну; в противном случае он может быть произвольной строкой. Каждое окно имеет связанный список тегов, и связывание применяется к конкретному окну, если его тег находится среди тегов, указанных для окна. Хотя команда bindtags может использоваться для присвоения произвольного набора тегов связывания окну, стандартные теги связывания обеспечивают следующее поведение:

• Если тег — имя внутреннего окна, связывание применяется к этому окну.
• Если тег — имя главного окна, связывание применяется к главному окну и всем его внутренним окнам.
• Если тег — имя класса виджетов, например Button, связывание применяется ко всем виджетам этого класса;
• Если тег имеет значение all, связывание применяется ко всем окнам приложения.

Шаблоны событий

<modifier-modifier-type-detail>

Третья форма шаблона используется для определения пользовательского, именованного виртуального события. Она имеет следующий синтаксис:

<<name>>

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

Модификаторы

Control	Mod1, M1, Command
Alt	Mod2, M2, Option
Shift	Mod3, M3
Lock	Mod4, M4
Extended	Mod5, M5
Button1, B1	Meta, M
Button2, B2	Double
Button3, B3	Triple
Button4, B4	Quadruple
Button5, B5

Meta и M относятся к любому из модификаторов M1 по M5, который ассоциирован с клавишей(ями) Meta на клавиатуре (keysyms Meta_R и Meta_L). Если нет клавиш Meta или они не связаны ни с какими модификаторами, то Meta и M не будут соответствовать ни одному событию. Аналогично, модификатор Alt относится к любому модификатору, связанному с клавишей(ями) Alt на клавиатуре (keysyms Alt_L и Alt_R).

Модификаторы Double, Triple и Quadruple — это удобный способ определения двойных щелчков мышью и других повторяющихся событий. Они заставляют определенный шаблон события повторяться 2, 3 или 4 раза, а также предъявляют требование по времени и пространству к последовательности: для соответствия последовательности событий шаблону Double, Triple или Quadruple, все события должны происходить близко друг к другу во времени и без существенного движения мышью между ними. Например, <Double-Button-1> эквивалентно <Button-1><Button-1> с дополнительными требованиями по времени и пространству.

Модификаторы Command и Option эквивалентны Mod1 соответственно Mod2, они соответствуют специфическим для Macintosh модификаторам клавиш.

Модификатор Extended в настоящее время специфичен для Windows. Он появляется в событиях, связанных с клавишами на «расширенной клавиатуре». На американской клавиатуре расширенные клавиши включают клавиши Alt и Control справа от клавиатуры, клавиши курсора в группе слева от цифрового блока, клавишу NumLock, клавишу Break, клавишу PrintScreen и клавиши / и Enter на цифровом блоке.

Типы событий

Activate	Destroy	Map
ButtonPress, Button	Enter	MapRequest
ButtonRelease	Expose	Motion
Circulate	FocusIn	MouseWheel
CirculateRequest	FocusOut	Property
Colormap	Gravity	Reparent
Configure	KeyPress, Key	ResizeRequest
ConfigureRequest	KeyRelease	Unmap
Create	Leave	Visibility
Deactivate

Activate, Deactivate

Эти два события отправляются всем дочерним окнам главного окна при изменении их состояния. В дополнение к окну фокуса, платформы Macintosh и Windows имеют понятие активного окна (которое часто, но не обязательно, имеет фокус). На Macintosh виджеты в активном окне имеют другой вид, чем виджеты в неактивных окнах. Событие Activate отправляется всем дочерним окнам главного окна, когда оно меняет состояние с неактивного на активное. Аналогично, событие Deactivate отправляется, когда состояние окна меняется с активного на неактивное. Привязываться к этим событиям не требуется замена процентов.

MouseWheel

Многие современные мыши поддерживают колесо прокрутки, которое используется для прокрутки документов без использования полос прокрутки. При прокрутке колеса система будет генерировать события MouseWheel, которые приложение может использовать для прокрутки. Как и события Key, событие всегда направляется в окно, имеющее в данный момент фокус. При получении события вы можете использовать замену %D для получения поля delta события, которое является целочисленным значением, описывающим, как переместилось колесо мыши. Наименьшее значение, которое система будет сообщать, определяется ОС. Знак значения определяет, в каком направлении ваш виджет должен прокручиваться. Положительные значения должны прокручивать вверх, а отрицательные — вниз.

KeyPress, KeyRelease

События KeyPress и KeyRelease генерируются всякий раз, когда клавиша нажимается или отпускается. События KeyPress и KeyRelease отправляются в окно, которое в данный момент имеет фокус клавиатуры.

ButtonPress, ButtonRelease, Motion

События ButtonPress и ButtonRelease генерируются, когда пользователь нажимает или отпускает кнопку мыши. События Motion генерируются всякий раз, когда указатель перемещается. События ButtonPress, ButtonRelease и Motion обычно отправляются в окно, содержащее указатель.

При нажатии кнопки мыши окно, содержащее указатель, автоматически получает временный захват указателя. Последующие события ButtonPress, ButtonRelease и Motion будут отправляться в это окно, независимо от того, в какое окно попадает указатель, до тех пор, пока все кнопки не будут отпущены.

Configure

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

Map, Unmap

События Map и Unmap генерируются всякий раз, когда изменяется состояние отображения окна.

Окна создаются в состоянии неотображения. Главные окна отображаются, когда они переходят в состояние нормальное, и скрываются в состояниях убрано и иконизировано. Другие окна отображаются, когда они помещаются под контроль менеджера геометрии (например, pack или grid).

Окно видимо только если оно и все его предки отображены. Обратите внимание, что менеджеры геометрии обычно не отображают своих потомков, пока сами не отображены, и скрывают всех потомков при скрытии себя; следовательно, в Tk события Map и Unmap указывают, видимо ли окно.

Visibility

Окно считается затемненным, когда другое окно над ним в порядке наложения полностью или частично перекрывает его. События Visibility генерируются всякий раз, когда изменяется состояние затемнения окна; поле state (%s) указывает новое состояние.

Expose

Событие Expose генерируется всякий раз, когда весь или часть окна должна быть перерисована (например, при первом отображении окна или если оно перестанет быть затемненным). Обычно приложениям-клиентам нет необходимости обрабатывать события Expose, так как Tk обрабатывает их внутренне.

Destroy

Событие Destroy передается окну при его уничтожении.

При получении события Destroy виджет находится в состоянии «полумертвого»: виджет все еще существует, но большинство операций с ним завершатся ошибкой.

FocusIn, FocusOut

События FocusIn и FocusOut генерируются всякий раз, когда меняется фокус клавиатуры. Событие FocusOut отправляется старому окну фокуса, а событие FocusIn — новому.

Кроме того, если старое и новое окна фокуса не имеют общего родителя, «виртуальные перекрестные» события фокуса отправляются промежуточным окнам в иерархии. Таким образом, событие FocusIn указывает, что целевое окно или одно из его потомков получило фокус, а событие FocusOut указывает, что фокус переключен на окно вне иерархии целевого окна.

Фокус клавиатуры может быть изменен явно с помощью вызова focus или неявно менеджером окон.

Enter, Leave

Событие Enter отправляется окну, когда указатель входит в это окно, а событие Leave — когда указатель покидает его.

Если активен захват указателя, события Enter и Leave передаются только окну, владеющему захватом.

Кроме того, когда указатель перемещается между двумя окнами, «виртуальные перекрестные» события Enter и Leave отправляются промежуточным окнам в иерархии аналогичным образом, как и для событий FocusIn и FocusOut.

Property

Событие Property отправляется окну всякий раз, когда изменяется или удаляется свойство X, принадлежащее этому окну. События Property обычно не доставляются приложениям Tk, так как они обрабатываются ядром Tk.

Colormap

Событие Colormap генерируется всякий раз, когда цветовая палитра, связанная с окном, была изменена, установлена или удалена.

Виджеты могут быть назначены частной цветовой палитре, указав опцию -colormap; менеджер окон отвечает за установку и удаление цветовых палитр по мере необходимости.

Обратите внимание, что Tk не предоставляет полезных данных для этого типа событий.

MapRequest, CirculateRequest, ResizeRequest, ConfigureRequest, Create

Эти события обычно не доставляются приложениям Tk. Они включены для полноты, чтобы можно было создавать менеджеры окон X11 в Tk. (Эти события передаются только тогда, когда клиент выбрал SubstructureRedirectMask для окна; ядро Tk не использует эту маску.)

Gravity, Reparent, Circulate

События Gravity и Reparent обычно не доставляются приложениям Tk. Они включены для полноты.

Событие Circulate указывает, что окно переместилось в верхнюю или нижнюю часть порядка наложения в результате запроса протокола XCirculateSubwindows. Обратите внимание, что порядок наложения может быть изменен по другим причинам, которые не генерируют событие Circulate, и что Tk не использует XCirculateSubwindows() внутренне. Этот тип события включен только для полноты; нет надежного способа отслеживать изменения положения окна в порядке наложения.

Подробности событий

Если тип события — KeyPress или KeyRelease, то detail может быть указан в виде символа X keysym. Keysym — это текстовое описание определённой клавиши на клавиатуре; они включают все буквенно-цифровые ASCII-символы (например, «a» — keysym для ASCII-символа «a»), а также описания символов, не являющихся буквенно-цифровыми («запятая» — keysym для запятой), плюс описания всех не-ASCII клавиш на клавиатуре (например, «Shift_L» — keysym для левой клавиши Shift, а «F1» — keysym для функциональной клавиши F1, если она есть). Полный список keysym здесь не представлен; он доступен в другой документации X и может отличаться в зависимости от системы. При необходимости можно использовать обозначение %K, описанное ниже, для вывода имени keysym для конкретной клавиши. Если указан detail keysym, то поле type можно опустить; оно будет по умолчанию равно KeyPress. Например, <Control-запятая> эквивалентно <Control-KeyPress-запятая>.

Связывание скриптов и подстановки

%%

Заменяется на одиночный знак процента.

%#

Номер последнего запроса клиента, обработанного сервером (поле serial из события). Действительно для всех типов событий.

%a

Поле above из события, отформатированное как шестнадцатеричное число. Действительно только для событий Configure. Указывает окно-сиблинг, расположенное непосредственно под окном-получателем в порядке стекирования, или 0, если окно-получатель находится внизу.

%b

Номер нажатой или отпущенной кнопки. Действительно только для событий ButtonPress и ButtonRelease.

%c

Поле count из события. Действительно только для событий Expose. Указывает, что имеется count ожидающих событий Expose, которые еще не были доставлены в окно.

%d

Поле detail или user_data из события. %d заменяется строкой, идентифицирующей деталь. Для событий Enter, Leave, FocusIn и FocusOut строка будет одной из следующих:

NotifyAncestor	NotifyNonlinearVirtual
NotifyDetailNone	NotifyPointer
NotifyInferior	NotifyPointerRoot
NotifyNonlinear	NotifyVirtual

Для событий ConfigureRequest строка будет одной из:

Above	Opposite
Below	None
BottomIf	TopIf

Для виртуальных событий строка будет тем значением, которое хранится в поле user_data при создании события (обычно с помощью event generate), или пустой строкой, если поле равно NULL. Виртуальные события, соответствующие нажатиям последовательности клавиш (подробности см. в event add), устанавливают user_data в NULL. Для других событий заменяемая строка не определена.

%f

Поле focus из события (0 или 1). Действительно только для событий Enter и Leave. 1, если окно-получатель является окном фокуса или потомком окна фокуса, 0 в противном случае.

%h

Поле height из события. Действительно для событий Configure, ConfigureRequest, Create, ResizeRequest и Expose. Указывает новый или запрошенный размер высоты окна.

%i

Поле window из события, представленное как шестнадцатеричное целое число. Действительно для всех типов событий.

%k

Поле keycode из события. Действительно только для событий KeyPress и KeyRelease.

%m

Поле mode из события. Заменяемая строка — одна из NotifyNormal, NotifyGrab, NotifyUngrab или NotifyWhileGrabbed. Действительно только для событий Enter, FocusIn, FocusOut и Leave.

%o

Поле override_redirect из события. Действительно только для событий Map, Reparent и Configure.

%p

Поле place из события, заменяемое одной из строк PlaceOnTop или PlaceOnBottom. Действительно только для событий Circulate и CirculateRequest.

%s

Поле state из события. Для событий ButtonPress, ButtonRelease, Enter, KeyPress, KeyRelease, Leave и Motion заменяется десятичной строкой. Для Visibility — одна из строк VisibilityUnobscured, VisibilityPartiallyObscured и VisibilityFullyObscured. Для событий Property — либо строка NewValue (указывает, что свойство было создано или изменено), либо Delete (указывает, что свойство было удалено).

%t

Поле time из события. Это временная метка сервера X (обычно время с момента последней перезагрузки сервера) в миллисекундах, когда произошло событие. Действительно для большинства событий.

%w

Поле width из события. Указывает новый или запрошенный размер ширины окна. Действительно только для событий Configure, ConfigureRequest, Create, ResizeRequest и Expose.

%x, %y

Поля x и y из события. Для событий ButtonPress, ButtonRelease, Motion, KeyPress, KeyRelease и MouseWheel %x и %y указывают положение указателя мыши относительно окна-получателя. Для событий Enter и Leave — положение, где указатель мыши пересек окно, относительно окна-получателя. Для событий Configure и Create — координаты x и y окна относительно его родительского окна.

%A

Заменяется символом Юникода, соответствующим событию, или пустой строкой, если событие не соответствует символу Юникода (например, была нажата клавиша Shift). XmbLookupString (или XLookupString, когда поддержка метода ввода выключена) выполняет всю работу по преобразованию из события в символ Юникода. Действительно только для событий KeyPress и KeyRelease.

%B

Поле border_width из события. Действительно только для событий Configure, ConfigureRequest и Create.

%D

Сообщает значение delta события MouseWheel. Значение delta представляет собой количество единиц поворота колесика мыши. Знак значения обозначает направление прокрутки колесика мыши.

%E

Поле send_event из события. Действительно для всех типов событий. 0 указывает, что это «нормальное» событие, 1 указывает, что это «синтетическое» событие, сгенерированное с помощью SendEvent.

%K

Символ клавиши, соответствующий событию, заменяемый как текстовая строка. Действительно только для событий KeyPress и KeyRelease.

%M

Количество сопоставленных шаблонов привязки на основе сценариев до сих пор для события. Действительно для всех типов событий.

%N

Символ клавиши, соответствующий событию, заменяемый как десятичное число. Действительно только для событий KeyPress и KeyRelease.

%P

Имя свойства, которое обновляется или удаляется (которое может быть преобразовано в XAtom с помощью winfo atom). Действительно только для событий Property.

%R

Идентификатор окна root из события. Действительно только для событий, содержащих поле root.

%S

Идентификатор окна subwindow из события, отформатированный как шестнадцатеричное число. Действительно только для событий, содержащих поле subwindow.

%T

Поле type из события. Действительно для всех типов событий.

%W

Имя пути окна, которому было сообщено событие (поле window из события). Действительно для всех типов событий.

%X, %Y

Поля x_root и y_root из события. Если используется менеджер виртуальной корневой системы, то заменяемые значения — соответствующая координата x и координата y в виртуальной корневой системе. Действительно только для событий ButtonPress, ButtonRelease, KeyPress, KeyRelease и Motion. Имеет то же значение, что и %x и %y, за исключением того, что относительно окна виртуальной корневой системы.

Строка замены для %-замены отформатирована как элемент списка Tcl. Это означает, что пробелы или специальные символы, такие как $ и {, могут предваряться обратными слешами. Это гарантирует, что строка будет передана в анализатор Tcl при оценке скрипта привязки. Большинство замен — числа или хорошо определенные строки, такие как Above; для этих замен никогда не требуется специальный формат. Наиболее распространенный случай, когда требуется переформатирование, — это замена %A. Например, если script —

insert %A

insert \[

Несколько совпадений

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

Если более чем одна привязка соответствует определённому событию и они имеют одинаковый тег, то выбирается наиболее конкретная привязка, и её скрипт оценивается. Следующие тесты применяются, в порядке очереди, чтобы определить, какая из нескольких соответствующих последовательностей более специфична:

1. Шаблон события, который указывает на определённую кнопку или клавишу, более специфичен, чем тот, который этого не делает;
2. Более длинная последовательность (с точки зрения количества сопоставленных событий) более специфична, чем более короткая последовательность;
3. Если модификаторы, указанные в одном шаблоне, являются подмножеством модификаторов в другом шаблоне, то шаблон с большим количеством модификаторов более специфичен.
4. Виртуальное событие, физический шаблон которого соответствует последовательности, менее специфичен, чем тот же физический шаблон, который не связан с виртуальным событием.
5. Учитывая последовательность, которая соответствует двум или более виртуальным событиям, одно из виртуальных событий будет выбрано, но порядок не определён.

Если сопоставленные последовательности содержат более одного события, то тесты (c)-(e) применяются в порядке от последнего события к самому раннему в последовательностях. Если эти тесты не определяют победителя, то самая последняя зарегистрированная последовательность является победителем.

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

event add <<Paste>> <Control-y>
event add <<Paste>> <Button-2>
event add <<Scroll>> <Button-2>
bind Entry <<Paste>> {puts Paste}
bind Entry <<Scroll>> {puts Scroll}

Если событие X не соответствует ни одной из существующих привязок, то событие игнорируется. Несвязанное событие не считается ошибкой.

Последовательности из нескольких событий и игнорируемые события

Ошибки

Примеры

bind . <Double-1> {
    puts "hi from (%x,%y)"
}

Небольшая программа с графическим интерфейсом, которая отображает имя keysym последней нажатой клавиши:

set keysym "Press any key"
pack [label .l -textvariable keysym -padx 2m -pady 1m]
bind . <Key> {
    set keysym "You pressed %K"
}

См. также