1XkbSAScreen(3)                   XKB FUNCTIONS                  XkbSAScreen(3)
2
3
4

NAME

6       XkbSAScreen  - Returns the screenXXX field of act converted to a signed
7       int
8

SYNOPSIS

10       int XkbSAScreen (XkbSwitchScreenAction act);
11

ARGUMENTS

13       - act  action from which to extract screen
14

DESCRIPTION

16       Actions associated with the XkbSwitchScreen action structure change the
17       active screen on a multiscreen display.
18
19       The  type field of the XkbSwitchScreenAction structure should always be
20       XkbSA_SwitchScreen.
21
22       The flags field is composed of the bitwise inclusive OR  of  the  masks
23       shown in Table 1.
24
25
26                       Table 1 Switch Screen Action Flags
27       ───────────────────────────────────────────────────────────────────
28       Flag                      Meaning
29       ───────────────────────────────────────────────────────────────────
30       XkbSA_SwitchAbsolute      If  set,  the screenXXX field represents
31                                 the index of the new screen.  Otherwise,
32                                 it represents an offset from the current
33                                 screen to the new screen.
34       XkbSA_SwitchApplication   If not set, the action should switch  to
35                                 another screen on the same server.  Oth‐
36                                 erwise, it should switch  to  another  X
37                                 server  or  application  that shares the
38                                 same physical display.
39
40       The screenXXX field is a signed character value that represents  either
41       the  relative  or  absolute screen index, depending on the state of the
42       XkbSA_SwitchAbsolute bit in the flags field. Xkb provides the following
43       macros  to  convert  between the integer and signed character value for
44       screen numbers in XkbSwitchScreenAction structures.
45
46       XkbSAScreen macro returns the screenXXX field of  act  converted  to  a
47       signed int.
48

STRUCTURES

50           typedef struct _XkbSwitchScreenAction {
51               unsigned char    type;        /* XkbSA_SwitchScreen */
52               unsigned char    flags;       /* controls screen switching */
53               char             screenXXX;   /* screen number or delta */
54           } XkbSwitchScreenAction;
55
56
57

NOTES

59       The  XkbSwitchScreen action is optional. Servers are free to ignore the
60       action or any of its flags if they do not support the requested  behav‐
61       ior.  If  the action is ignored, it behaves like XkbSA_NoAction. Other‐
62       wise, key press and key release events do not generate an event.
63
64
65
66X Version 11                     libX11 1.8.1                   XkbSAScreen(3)
Impressum