XkbSetNamedIndicator(3) XKB FUNCTIONS XkbSetNamedIndicator(3)
NAME
XkbSetNamedIndicator - Names an indicator if it is not already named;
toggles the state of the indicator; sets the indicator to a specified
state and sets the indicator map for the indicator
SYNOPSIS
Bool XkbSetNamedDeviceIndicator (Display *dpy, unsigned int de-
vice_spec, unsigned int led_class, unsigned int led_id, Atom
name, Bool change_state, Bool state, Bool create_new, XkbIndica-
torMapPtr map); Bool XkbSetNamedIndicator (Display *dpy, Atom
name, Bool change_state, Bool state, Bool create_new, XkbIndica-
torMapPtr map);
ARGUMENTS
dpy connection to the X server
device_spec
device ID, or XkbUseCoreKbd
led_class
feedback class, or XkbDfltXIClass
led_id feedback ID, or XkbDfltXIId
name name of the indicator to change
change_state
whether to change the indicator state or not
state desired new state for the indicator
create_new
whether a new indicator with the specified name should be cre-
ated when necessary
map new map for the indicator
DESCRIPTION
If a compatible version of the Xkb extension is not available in the
server, XkbSetNamedDeviceIndicator returns False. Otherwise, it sends a
request to the X server to change the indicator specified by name and
returns True.
If change_state is True, XkbSetNamedDeviceIndicator tells the server to
change the state of the named indicator to the value specified by
state. If change_state is False, then state is not used.
If an indicator with the name specified by name does not already exist,
the create_new parameter tells the server whether it should create a
new named indicator. If create_new is True, the server finds the first
indicator that doesn't have a name and gives it the name specified by
name. If the optional parameter, map, is not NULL, XkbSetNamedDevi-
ceIndicator tells the server to change the indicator's map to the val-
ues specified in map.
In addition, it can also generate XkbIndicatorStateNotify, XkbIndica-
torMapNotify, and XkbNamesNotify events.
XkbSetNamedIndicator is a convenience function that calls XkbSetNamed-
DeviceIndicator with a device_spec of XkbUseCoreKbd, a led_class of
XkbDfltXIClass, and a led_id of XkbDfltXIId. It returns the return
value from XkbSetNamedDeviceIndicator.
RETURN VALUES
True The XkbSetNamedIndicator and XkbSetNamedDeviceIndicator
functions return True if a compatible version of the Xkb
extension is available in the server.
False The XkbSetNamedIndicator and XkbSetNamedDeviceIndicator
functions return False if a compatible version of the
Xkb extension is not available in the server.
DIAGNOSTICS
BadAtom A name is neither a valid Atom or None
BadImplementation
Invalid reply from server
BadKeyboard device_spec does not specify a device with indicators.
BadMatch led_id is not DfltXIId and does not specify a feedback
of the class specified by led_class on the device speci-
fied by device_spec.
BadValue led_class does not specify DfltXIClass, LedFeedback-
Class, or KbdFeedbackClass.
SEE ALSO
XkbIndicatorMapNotify(3), XkbIndicatorStateNotify(3), XkbNamesNotify(3)
X Version 11 libX11 1.8.4 XkbSetNamedIndicator(3)
Generated by dwww version 1.15 on Sun Jun 23 21:15:55 CEST 2024.