Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XkbSetNamedIndicator(3) 	  XKB FUNCTIONS 	 XkbSetNamedIndicator(3)

NAME
     XkbSetNamedIndicator  - Names an indicator if it is not already named; tog-
     gles 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 device_spec,
	    unsigned  int  led_class,  unsigned  int  led_id,  Atom  name,  Bool
	    change_state,  Bool state, Bool create_new, XkbIndicatorMapPtr map);
	    Bool   XkbSetNamedIndicator   (Display   *dpy,   Atom   name,   Bool
	    change_state, Bool state, Bool create_new, XkbIndicatorMapPtr 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 created
	    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 re-
     quest 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  op-
     tional  parameter,  map,  is not NULL, XkbSetNamedDeviceIndicator tells the
     server to change the indicator's map to the values specified in map.

     In addition, it can also generate XkbIndicatorStateNotify, XkbIndicatorMap-
     Notify, and XkbNamesNotify events.

     XkbSetNamedIndicator is a convenience function that calls	XkbSetNamedDevi-
     ceIndicator  with a device_spec of XkbUseCoreKbd, a led_class of XkbDfltXI-
     Class, and a led_id of XkbDfltXIId.  It returns the return value from  Xkb-
     SetNamedDeviceIndicator.

RETURN VALUES
     True	    The   XkbSetNamedIndicator	 and  XkbSetNamedDeviceIndicator
		    functions return True if a compatible version of the Xkb ex-
		    tension 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 specified by
		    device_spec.

     BadValue	    led_class does not specify DfltXIClass, LedFeedbackClass, or
		    KbdFeedbackClass.

SEE ALSO
     XkbIndicatorMapNotify(3), XkbIndicatorStateNotify(3), XkbNamesNotify(3)

X Version 11			  libX11 1.8.13 	 XkbSetNamedIndicator(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XkbSetNamedIndicator&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help