XkbGetAccessXTimeout(3Xkb) XKB FUNCTION XkbGetAccessXTimeout(3Xkb)NAMEXkbGetAccessXTimeout - Queries the current AccessXTimeout options for a
keyboard device
SYNOPSIS
Bool XkbGetAccessXTimeout ( display, device_spec, timeout_rtrn,
ctrls_mask_rtrn, ctrls_values_rtrn, options_mask_rtrn, options_val‐
ues_rtrn )
Display * display ;
unsigned int device_spec ;
unsigned short * timeout_rtrn ;
unsigned int * ctrls_mask_rtrn ;
unsigned int * ctrls_values_rtrn ;
unsigned short * options_mask_rtrn ;
unsigned short * options_values_rtrn ;
ARGUMENTS
- display
unsigned short
- device_spec
device to query, or XkbUseCoreKbd
- timeout_rtrn
delay until AccessXTimeout, seconds
- ctrls_mask_rtrn
backfilled with controls to modify
- ctrls_values_rtrn
backfilled with on/off status for controls
- options_mask_rtrn
backfilled with ax_options to modify
- options_values_rtrn
backfilled with values for ax_options
DESCRIPTION
In environments where computers are shared, features such as SlowKeys
present a problem: if SlowKeys is on, the keyboard can appear to be
unresponsive because keys are not accepted until they are held for a
certain period of time. To help solve this problem, Xkb provides an
AccessXTimeout control to automatically change the enabled/disabled
state of any boolean controls and to change the value of the
AccessXKeys and AccessXFeedback control attributes if the keyboard is
idle for a specified period of time.
When a timeout as specified by AccessXTimeout occurs and a control is
consequently modified, Xkb generates an XkbControlsNotify event.
XkbGetAccessXTimeout sends a request to the X server to obtain the cur‐
rent values for the AccessXTimeout attributes, waits for a reply, and
backfills the values into the appropriate arguments. The parameters
options_mask_rtrn and options_values_rtrn are backfilled with the
options to modify and the values for ax_options, which is a field in
the XkbControlsRec structure. XkbGetAccessXTimeout returns True if
successful; if a compatible version of the Xkb extension is not avail‐
able in the server, XkbGetAccessXTimeout returns False.
RETURN VALUES
True The XkbGetAccessXTimeout returns True when it success‐
fully sends a request to the X server to obtain the cur‐
rent values for the AccessXTimeout attributes, waits for
a reply, and backfills the values into the appropriate
arguments.
False The XkbGetAccessXTimeout funtion returns False if a com‐
patible version of the Xkb extension is not available in
the server.
STRUCTURES
The XkbControlsRec structure is defined as follows:
#define XkbMaxLegalKeyCode 255
#define XkbPerKeyBitArraySize ((XkbMaxLegalKeyCode+1)/8)
typedef struct {
unsigned char mk_dflt_btn; /* default button for keyboard driven mouse */
unsigned char num_groups; /* number of keyboard groups */
unsigned char groups_wrap; /* how to wrap out-of-bounds groups */
XkbModsRec internal; /* defines server internal modifiers */
XkbModsRec ignore_lock; /* modifiers to ignore when checking for grab */
unsigned int enabled_ctrls; /* 1 bit => corresponding boolean control enabled */
unsigned short repeat_delay; /* ms delay until first repeat */
unsigned short repeat_interval; /* ms delay between repeats */
unsigned short slow_keys_delay; /* ms minimum time key must be down to be ok */
unsigned short debounce_delay; /* ms delay before key reactivated */
unsigned short mk_delay; /* ms delay to second mouse motion event */
unsigned short mk_interval; /* ms delay between repeat mouse events */
unsigned short mk_time_to_max; /* # intervals until constant mouse move */
unsigned short mk_max_speed; /* multiplier for maximum mouse speed */
short mk_curve; /* determines mouse move curve type */
unsigned short ax_options; /* 1 bit => Access X option enabled */
unsigned short ax_timeout; /* seconds until Access X disabled */
unsigned short axt_opts_mask; /* 1 bit => options to reset on Access X timeout */
unsigned short axt_opts_values; /* 1 bit => turn option on, 0=> off */
unsigned int axt_ctrls_mask; /* which bits in enabled_ctrls to modify */
unsigned int axt_ctrls_values; /* values for new bits in enabled_ctrls */
unsigned char per_key_repeat[XkbPerKeyBitArraySize]; /* per key auto repeat */
} XkbControlsRec, *XkbControlsPtr;
X v11 Rel. 6.4 11 Aug 1999 XkbGetAccessXTimeout(3Xkb)