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

NAME

6       XkbSetNamedIndicator  -  Names an indicator if it is not already named;
7       toggles the state of the indicator; sets the indicator to  a  specified
8       state and sets the indicator map for the indicator
9

SYNOPSIS

11
12
13       Bool   XkbSetNamedDeviceIndicator   (Display  *dpy,  unsigned  int  de‐
14              vice_spec, unsigned int led_class,  unsigned  int  led_id,  Atom
15              name, Bool change_state, Bool state, Bool create_new, XkbIndica‐
16              torMapPtr map); Bool XkbSetNamedIndicator  (Display  *dpy,  Atom
17              name, Bool change_state, Bool state, Bool create_new, XkbIndica‐
18              torMapPtr map);
19

ARGUMENTS

21       dpy    connection to the X server
22
23       device_spec
24              device ID, or XkbUseCoreKbd
25
26       led_class
27              feedback class, or XkbDfltXIClass
28
29       led_id feedback ID, or XkbDfltXIId
30
31       name   name of the indicator to change
32
33       change_state
34              whether to change the indicator state or not
35
36       state  desired new state for the indicator
37
38       create_new
39              whether a new indicator with the specified name should  be  cre‐
40              ated when necessary
41
42       map    new map for the indicator
43

DESCRIPTION

45       If  a  compatible  version of the Xkb extension is not available in the
46       server, XkbSetNamedDeviceIndicator returns False. Otherwise, it sends a
47       request  to  the X server to change the indicator specified by name and
48       returns True.
49
50       If change_state is True, XkbSetNamedDeviceIndicator tells the server to
51       change  the  state  of  the  named  indicator to the value specified by
52       state.  If change_state is False, then state is not used.
53
54       If an indicator with the name specified by name does not already exist,
55       the  create_new  parameter  tells the server whether it should create a
56       new named indicator. If create_new is True, the server finds the  first
57       indicator  that  doesn't have a name and gives it the name specified by
58       name.  If the optional parameter, map, is  not  NULL,  XkbSetNamedDevi‐
59       ceIndicator  tells the server to change the indicator's map to the val‐
60       ues specified in map.
61
62       In addition, it can also generate  XkbIndicatorStateNotify,  XkbIndica‐
63       torMapNotify, and XkbNamesNotify events.
64
65       XkbSetNamedIndicator  is a convenience function that calls XkbSetNamed‐
66       DeviceIndicator with a device_spec of  XkbUseCoreKbd,  a  led_class  of
67       XkbDfltXIClass,  and  a  led_id  of XkbDfltXIId.  It returns the return
68       value from XkbSetNamedDeviceIndicator.
69

RETURN VALUES

71       True           The XkbSetNamedIndicator and  XkbSetNamedDeviceIndicator
72                      functions return True if a compatible version of the Xkb
73                      extension is available in the server.
74
75       False          The XkbSetNamedIndicator and  XkbSetNamedDeviceIndicator
76                      functions  return  False  if a compatible version of the
77                      Xkb extension is not available in the server.
78

DIAGNOSTICS

80       BadAtom        A name is neither a valid Atom or None
81
82       BadImplementation
83                      Invalid reply from server
84
85       BadKeyboard    device_spec does not specify a device with indicators.
86
87       BadMatch       led_id is not DfltXIId and does not specify  a  feedback
88                      of the class specified by led_class on the device speci‐
89                      fied by device_spec.
90
91       BadValue       led_class does  not  specify  DfltXIClass,  LedFeedback‐
92                      Class, or KbdFeedbackClass.
93

SEE ALSO

95       XkbIndicatorMapNotify(3), XkbIndicatorStateNotify(3), XkbNamesNotify(3)
96
97
98
99
100X Version 11                     libX11 1.8.7          XkbSetNamedIndicator(3)
Impressum