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

NAME

6       XkbNoteDeviceChanges - Note device changes reported in an XkbExtension‐
7       DeviceNotify event
8

SYNOPSIS

10       void XkbNoteDeviceChanges (XkbDeviceChangesPtr  old,  XkbExtensionDevi‐
11              ceNotifyEvent *new, unsigned int wanted);
12

ARGUMENTS

14       - old  structure tracking state changes
15
16       - new  event indicating state changes
17
18       - wanted
19              mask indicating changes to note
20

DESCRIPTION

22       The wanted field specifies the changes that should be noted in old, and
23       is composed of the bitwise inclusive OR of one or  more  of  the  masks
24       from  Table 1. The reason field of the event in new indicates the types
25       of changes the event is reporting.   XkbNoteDeviceChanges  updates  the
26       XkbDeviceChangesRec  specified  by  old  with the changes that are both
27       specified in wanted and contained in new->reason.
28
29                                Table 1 XkbDeviceInfoRec Mask Bits
30       ____________________________________________________________________________________
31       Name                         XkbDeviceInfoRec Value     Capability If Set
32                                    Fields Effected
33       ____________________________________________________________________________________
34       XkbXI_KeyboardsMask                           (1L <<0) Clients can use all
35                                                              Xkb requests and events
36                                                              with KeyClass devices
37                                                              supported by the input
38                                                              device extension.
39
40       XkbXI_ButtonActionsMask       num_btns        (1L <<1) Clients can assign key
41                                     btn_acts                 actions to buttons
42                                                              non-KeyClass input
43                                                              extension devices.
44
45       XkbXI_IndicatorNamesMask      leds->names     (1L <<2) Clients can assign
46                                                              names to indicators on
47                                                              non-KeyClass input
48                                                              extension devices.
49
50       XkbXI_IndicatorMapsMask       leds->maps      (1L <<3) Clients can assign
51                                                              indicator maps to
52                                                              indicators on
53                                                              non-KeyClass input
54                                                              extension devices.
55
56       XkbXI_IndicatorStateMask      leds->state     (1L <<4) Clients can request
57                                                              the status of indicators
58                                                              on non-KeyClass input
59                                                              extension devices.
60
61       XkbXI_IndicatorsMask          sz_leds         (0x1c)   XkbXI_IndicatorNamesMask |
62                                     num_leds                 XkbXI_IndicatorMapsMask |
63                                     leds->*                  XkbXI_IndicatorStateMask
64
65       XkbXI_UnsupportedFeaturesMask unsupported     (1L <<15)
66
67       XkbXI_AllDeviceFeaturesMask   Those selected  (0x1e)   XkbXI_IndicatorsMask |
68                                     by Value Column          XkbSI_ButtonActionsMask
69                                     masks
70
71       XkbXI_AllFeaturesMask         Those selected  (0x1f)   XkbSI_AllDeviceFeaturesMask |
72                                     by Value Column          XkbSI_KeyboardsMask
73                                     masks
74
75       XkbXI_AllDetailsMask          Those selected  (0x801f) XkbXI_AllFeaturesMask |
76                                     by Value column          XkbXI_UnsupportedFeaturesMask
77                                     masks
78
79       To update a local copy of the state and configuration of an X input ex‐
80       tension   device  with  the  changes  previously  noted  in  an  XkbDe‐
81       viceChangesRec structure, use XkbGetDeviceInfoChanges.
82

STRUCTURES

84       Changes to an Xkb extension device may be tracked by listening to  Xkb‐
85       DeviceExtensionNotify  events and accumulating the changes in an XkbDe‐
86       viceChangesRec structure. The changes noted in the structure  may  then
87       be  used  in subsequent operations to update either a server configura‐
88       tion or a local copy of an  Xkb  extension  device  configuration.  The
89       changes structure is defined as follows:
90
91       typedef struct _XkbDeviceChanges {
92           unsigned int         changed;       /∗ bits indicating what has changed */
93           unsigned short       first_btn;     /∗ number of first button which changed, if any */
94           unsigned short       num_btns;      /∗ number of buttons that have changed */
95           XkbDeviceLedChangesRec leds;
96       } XkbDeviceChangesRec,*XkbDeviceChangesPtr;
97
98

SEE ALSO

100       XkbGetDeviceInfoChanges(3)
101
102
103
104X Version 11                     libX11 1.7.0          XkbNoteDeviceChanges(3)
Impressum