XSetInputFocus, XGetInputFocus - control input focus
SYNTAX
XSetInputFocus(display, focus, revert_to, time)
Display *display;
Window focus;
int revert_to;
Time time;
XGetInputFocus(display, focus_return, revert_to_return)
Display *display;
Window *focus_return;
int *revert_to_return;
ARGUMENTS
display Specifies the connection to the X server.
focus Specifies the window, PointerRoot, or None.
focus_return
Returns the focus window, PointerRoot, or None.
revert_to Specifies where the input focus reverts to if
the window becomes not viewable. You can pass
RevertToParent, RevertToPointerRoot, or
RevertToNone.
revert_to_return
Returns the current focus state (RevertToParent,
RevertToPointerRoot, or RevertToNone).
time Specifies the time. You can pass either a
timestamp or CurrentTime.
DESCRIPTION
The XSetInputFocus function changes the input focus and
the last-focus-change time. It has no effect if the spec-
ified time is earlier than the current last-focus-change
time or is later than the current X server time. Other-
wise, the last-focus-change time is set to the specified
time (CurrentTime is replaced by the current X server
time). XSetInputFocus causes the X server to generate
FocusIn and FocusOut events.
Depending on the focus argument, the following occurs:
o If focus is None, all keyboard events are discarded
until a new focus window is set, and the revert_to
argument is ignored.
o If focus is a window, it becomes the keyboard's focus
window. If a generated keyboard event would normally
o If revert_to is RevertToParent, the focus reverts to
the parent (or the closest viewable ancestor), and
the new revert_to value is taken to be RevertToNone.
o If revert_to is RevertToPointerRoot or RevertToNone,
the focus reverts to PointerRoot or None, respec-
tively. When the focus reverts, the X server gener-
ates FocusIn and FocusOut events, but the last-focus-
change time is not affected.
XSetInputFocus can generate BadMatch, BadValue, and Bad-
Window errors.
The XGetInputFocus function returns the focus window and
the current focus state.
DIAGNOSTICS
BadValue Some numeric value falls outside the range of
values accepted by the request. Unless a spe-
cific range is specified for an argument, the
full range defined by the argument's type is
accepted. Any argument defined as a set of
alternatives can generate this error.
BadWindow A value for a Window argument does not name a
defined Window.
SEE ALSO
XWarpPointer(3X11)
Xlib - C Language X Interface
X Version 11 Release 6.4 1