XSetInputFocus(3X) — X Version 11

NAME

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

displaySpecifies the connection to the X server.

focusSpecifies the window ID.

focus_returnReturns the focus window ID, or either PointerRoot, or None.

revert_toSpecifies which window the input focus reverts to if the window becomes not viewable. You can pass one of these constants: RevertToParent, RevertToPointerRoot, or RevertToNone.

revert_to_return
Returns the current focus state. The function can return one of these constants: RevertToParent, RevertToPointerRoot, or RevertToNone.

timeSpecifies the time. You can pass either a timestamp, expressed in milliseconds, or CurrentTime.

DESCRIPTION

The XSetInputFocus function changes the input focus and the last-focus-change time. .PN XSetInputFocus can generate BadMatch, BadValue, and BadWindow errors.

The XGetInputFocus function returns the focus window ID and the current focus state.

DIAGNOSTICS

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific 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.

Museum