XkbGetNamedIndicator(3) XKB FUNCTIONS XkbGetNamedIndicator(3)
NAME
XkbGetNamedIndicator - Look up the indicator map and other information
for an indicator by name
SYNOPSIS
Bool XkbGetNamedDeviceIndicator (Display *dpy, unsigned int dev_spec,
unsigned int led_class, unsigned int led_id, Atom name, int
*ndx_rtrn, Bool *state_rtrn, XkbIndicatorMapPtr map_rtrn, Bool
*real_rtrn);
Bool XkbGetNamedIndicator (Display *dpy, Atom name, int *ndx_rtrn, Bool
*state_rtrn, XkbIndicatorMapPtr map_rtrn, Bool *real_rtrn);
ARGUMENTS
dpy connection to the X server
dev_spec
keyboard device ID, or XkbUseCoreKbd
led_class
feedback class, or XkbDfltXIClass
led_id feedback ID, or XkbDfltXIId
name name of the indicator to be retrieved
ndx_rtrn
backfilled with the index of the retrieved indicator
state_rtrn
backfilled with the current state of the retrieved indicator
map_rtrn
backfilled with the mapping for the retrieved indicator
real_rtrn
backfilled with True if the named indicator is real (physical)
DESCRIPTION
Xkb also allows applications to refer to indicators by name. Use XkbGet-
Names to get the indicator names. Using names eliminates the need for
hard-coding bitmask values for particular keyboards. For example, in-
stead of using vendor-specific constants such as WSKBLed_ScrollLock mask
on Digital workstations or XLED_SCROLL_LOCK on Sun workstations, you can
instead use XkbGetNamedDeviceIndicator to look up information on the in-
dicator named "Scroll Lock."
If the device specified by device_spec has an indicator named name, Xk-
bGetNamedDeviceIndicator returns True and populates the rest of the pa-
rameters with information about the indicator. Otherwise, XkbGetNamedDe-
viceIndicator returns False.
The ndx_rtrn field returns the zero-based index of the named indicator.
This index is the bit position to use in any function call that requires
a mask of indicator bits, as well as the indicator's index into the Xk-
bIndicatorRec array of indicator maps. state_rtrn returns the current
state of the named indicator (True = on, False = off). map_rtrn returns
the indicator map for the named indicator. In addition, if the indicator
is mapped to a physical LED, the real_rtrn parameter is set to True.
Each of the " _rtrn " arguments is optional; you can pass NULL for any
unneeded " _rtrn " arguments.
XkbGetNamedIndicator is a convenience function that calls XkbGetNamedDe-
viceIndicator with a device_spec of XkbUseCoreKbd, a led_class of XkbD-
fltXIClass, and a led_id of XkbDfltXIId. It returns the return value
from XkbGetNamedDeviceIndicator.
RETURN VALUES
True The XkbGetNamedIndicator and XkbGetNamedDeviceIndicator
functions return True if the device specified by de-
vice_spec has an indicator named name.
False The XkbGetNamedIndicator and XkbGetNamedDeviceIndicator
functions return False if the device specified by de-
vice_spec does not have an indicator named name.
SEE ALSO
XkbGetNames(3)
X Version 11 libX11 1.8.12 XkbGetNamedIndicator(3)
Generated by dwww version 1.16 on Sat Oct 3 06:01:36 CEST 2026.