Crusty Blaa

The details of behind input focus and X/GTK+ have always confused the
hell out of me. Its all fine and dandy when you only have to think
about GTK+ focus, but whenever I had to think about the interaction
between GTK+, the window manager and what's actually happening at the
Xlib/Xserver level, by brain used to go to mush. I'd barely figure
out the bits neccessary to fix whatever bug I was up against and
promptly forget it all again five minutes later.

Well, this morning I have to get focus handling working with Xnest
embedded in a GTK+ window. So, I figure I'm really going to have to
understand it this time. Here's some of the details:

• In order for any X window to receive events of a certain type,
  you must call XSelectInput() on that window with the
  appropriate event mask.
• When a key event is generated, the Xserver tries to find a
  client and window to deliver the event to. It starts with the
  window which contains the pointer and recurses up through its
  ancestors until it finds a window with that event selected.
• X has the notion of "the keyboard focus window". This is set
  using XSetInputFocus(). When a key event is generated,
  the event is propopagated as normal if the focus window contains
  the pointer, but propogation stops at the focus window. If the
  focus window doesn't contain the pointer, the event is
  delivered directly to the focus window.
• What's important here is this has nothing to do with GTK+
  keyboard focus. Its more about which toplevel window is
  currently focused by the window manager, rather than which
  widget is focused within the application. The XEmbed
  spec more or less redefines this as the window's "activation
  state" - i.e. if a toplevel or its descendants is the current
  keyboard focus window then the toplevel is said to be active.
• None of this really reflects the way modern desktops and
  toolkits work. What happens in reality is that applications
  never focus themselves (i.e. XSetInputFocus()) unless
  the window manager tells it to using the WM_TAKE_FOCUS ICCCM
  ClientMessage.
• On receipt of this message GTK+ makes a 1 pixel square window,
  located just outside the visible area of the toplevel
  window, be the keyboard focus window. That causes all
  KeyPresses to always go straight to this window (the window
  doesn't have any descendants which can contain the pointer).
• When this window receives an X KeyPress event, GTK+ then
  generates a GTK key press event (with the toplevel as the
  target window) and puts that on the GTK event queue.
• At this point the event is entirely in the hands of GTK+. X
  has wiped its hands of the whole affair.
• Each toplevel GtkWindow knows which widget within the window
  is currently focused. All the toplevel now needs to do is
  send that event onto the currently focused widget.

One last little interesting detail is how the window manager
implements click-to-focus:

• The WM establishes a pasive grab on each unfocused toplevel
  window using XGrabButton()
• A passive grab is where events are delivered as normal until a
  specific key or button combination is pressed and an active grab
  is established causing the event (and following events) to be
  delived to the grabbing client.
• The WM passes GrabModeSync to XGrabButton()
  which causes all event delivery to freeze when the specific
  key/button combination is pressed.
• So, when a user clicks on an unfocused window, all subsequent
  events are queued in the Xserver, the WM gets the ButtonPress,
  focuses the toplevel of the window which was clicked in and
  releases the event queue again using XAllowEvents()

In case its not obvious, I'm only really writing this down so there's
less chance of me forgetting it all again :-)