pub fn set_input_focus<Conn, A, B>(
conn: &Conn,
revert_to: InputFocus,
focus: A,
time: B,
) -> Result<VoidCookie<'_, Conn>, ConnectionError>Expand description
Sets input focus.
Changes the input focus and the last-focus-change time. If the specified time
is earlier than the current last-focus-change time, the request is ignored (to
avoid race conditions when running X over the network).
A FocusIn and FocusOut event is generated when focus is changed.
§Fields
-
focus- The window to focus. All keyboard events will be reported to this window. The window must be viewable (TODO), or axcb_match_error_toccurs (TODO).If
focusisXCB_NONE(TODO), all keyboard events are discarded until a new focus window is set.If
focusisXCB_POINTER_ROOT(TODO), focus is on the root window of the screen on which the pointer is on currently. -
time- Timestamp to avoid race conditions when running X over the network.The special value
XCB_CURRENT_TIMEwill be replaced with the current server time. -
revert_to- Specifies what happens when thefocuswindow becomes unviewable (iffocusis neitherXCB_NONEnorXCB_POINTER_ROOT).
§Errors
Window- The specifiedfocuswindow does not exist.Match- The specifiedfocuswindow is not viewable.Value- TODO: Reasons?
§See
FocusIn: eventFocusOut: event