summaryrefslogtreecommitdiff
path: root/man/XSetInputFocus.man
diff options
context:
space:
mode:
Diffstat (limited to 'man/XSetInputFocus.man')
-rw-r--r--man/XSetInputFocus.man40
1 files changed, 20 insertions, 20 deletions
diff --git a/man/XSetInputFocus.man b/man/XSetInputFocus.man
index f7e5ade3..258c8a9a 100644
--- a/man/XSetInputFocus.man
+++ b/man/XSetInputFocus.man
@@ -39,7 +39,7 @@
.\" Digital and Tektronix makes no representations about the suitability
.\" of this documentation for any purpose.
.\" It is provided "as is" without express or implied warranty.
-.\"
+.\"
.\"
.ds xT X Toolkit Intrinsics \- C Language Interface
.ds xW Athena X Widgets \- C Language X Toolkit Interface
@@ -51,10 +51,10 @@ XSetInputFocus, XGetInputFocus \- control input focus
.SH SYNTAX
.HP
int XSetInputFocus\^(\^Display *\fIdisplay\fP\^, Window \fIfocus\fP\^, int
-\fIrevert_to\fP\^, Time \fItime\fP\^);
+\fIrevert_to\fP\^, Time \fItime\fP\^);
.HP
int XGetInputFocus\^(\^Display *\fIdisplay\fP\^, Window *\fIfocus_return\fP\^,
-int *\fIrevert_to_return\fP\^);
+int *\fIrevert_to_return\fP\^);
.SH ARGUMENTS
.IP \fIdisplay\fP 1i
Specifies the connection to the X server.
@@ -66,21 +66,21 @@ or
.IP \fIfocus_return\fP 1i
Returns the focus window,
.BR PointerRoot ,
-or
+or
.BR None .
.IP \fIrevert_to\fP 1i
Specifies where the input focus reverts to if the window becomes not
viewable.
-You can pass
+You can pass
.BR RevertToParent ,
.BR RevertToPointerRoot ,
-or
+or
.BR RevertToNone .
.IP \fIrevert_to_return\fP 1i
Returns the current focus state
-.Pn ( RevertToParent ,
+.Pn ( RevertToParent ,
.BR RevertToPointerRoot ,
-or
+or
.BR RevertToNone ).
.IP \fItime\fP 1i
Specifies the time.
@@ -93,54 +93,54 @@ function changes the input focus and the last-focus-change time.
It has no effect if the specified time is earlier than the current
last-focus-change time or is later than the current X server time.
Otherwise, the last-focus-change time is set to the specified time
-.Pn ( CurrentTime
+.Pn ( CurrentTime
is replaced by the current X server time).
.B XSetInputFocus
causes the X server to generate
.B FocusIn
-and
+and
.B FocusOut
events.
.LP
Depending on the focus argument,
-the following occurs:
+the following occurs:
.IP \(bu 5
If focus is
.BR None ,
all keyboard events are discarded until a new focus window is set,
and the revert_to argument is ignored.
.IP \(bu 5
-If focus is a window,
+If focus is a window,
it becomes the keyboard's focus window.
If a generated keyboard event would normally be reported to this window
-or one of its inferiors, the event is reported as usual.
+or one of its inferiors, the event is reported as usual.
Otherwise, the event is reported relative to the focus window.
.IP \(bu 5
If focus is
.BR PointerRoot ,
-the focus window is dynamically taken to be the root window of whatever screen
-the pointer is on at each keyboard event.
+the focus window is dynamically taken to be the root window of whatever screen
+the pointer is on at each keyboard event.
In this case, the revert_to argument is ignored.
.LP
-The specified focus window must be viewable at the time
+The specified focus window must be viewable at the time
.B XSetInputFocus
is called,
or a
.B BadMatch
error results.
-If the focus window later becomes not viewable,
+If the focus window later becomes not viewable,
the X server
-evaluates the revert_to argument to determine the new focus window as follows:
+evaluates the revert_to argument to determine the new focus window as follows:
.IP \(bu 5
If revert_to is
.BR RevertToParent ,
-the focus reverts to the parent (or the closest viewable ancestor),
+the focus reverts to the parent (or the closest viewable ancestor),
and the new revert_to value is taken to be
.BR RevertToNone .
.IP \(bu 5
If revert_to is
.B RevertToPointerRoot
-or
+or
.BR RevertToNone ,
the focus reverts to
.B PointerRoot