Next: Keyboard and Pointer State Events, Previous: Keyboard and Pointer Events, Up: Event Types [Contents][Index]
The input focus events are :focus-in and :focus-out.
Selected by: :focus-change.
:focus-in and :focus-out events are generated when the input focus changes. All :focus-out events caused by a window :unmap are generated after any :unmap-notify event, but the ordering of :focus-out with respect to generated :enter-notify, :leave-notify, :visibility-notify, and :expose events is not constrained.
Type window.
For :focus-in, the new input focus window. For :focus-out, the previous input focus window.
Type (member :normal :while-grabbed :grab :ungrab)
.
Events generated by set-input-focus when the keyboard is not grabbed have mode :normal. Events generated by set-input-focus when the keyboard is grabbed have mode :while-grabbed. Events generated when a keyboard grab activates have mode :grab, and events generated when a keyboard grab deactivates have mode :ungrab.
Type (member :ancestor :virtual :inferior :nonlinear :nonlinear-virtual :pointer :pointer-root :none).
When the focus moves from window A to window B, and A is an inferior of B, with the pointer in window P:
When the focus moves from window A to window B, and B is an inferior of A, with the pointer in window P:
When the focus moves from window A to window B, with window C being their least common ancestor, and with the pointer in window P:
When the focus moves from window A to window B, on different screens, with the pointer in window P:
When the focus moves from window A to :pointer-root (or :none), with the pointer in window P:
When the focus moves from :pointer-root (or :none) to window A, with the pointer in window P:
When the focus moves from :pointer-root to :none (or vice versa), with the pointer in window P:
When a keyboard grab activates (but before generating any actual :key-press event that activates the grab), with G the grab-window for the grab and F the current focus, then :focus-in and :focus-out events with mode :grab are generated (as for :normal above) as if the focus were to change from F to G.
When a keyboard grab deactivates (but after generating any actual :key-release event that deactivates the grab), with G the grab-window for the grab and F the current focus, then :focus-in and :focus-out events with mode :ungrab are generated (as for :normal above) as if the focus were to change from G to F.
Next: Keyboard and Pointer State Events, Previous: Keyboard and Pointer Events, Up: Event Types [Contents][Index]