diff options
Diffstat (limited to 'man/xkb/XkbSAPtrDfltValue.man')
-rw-r--r-- | man/xkb/XkbSAPtrDfltValue.man | 117 |
1 files changed, 117 insertions, 0 deletions
diff --git a/man/xkb/XkbSAPtrDfltValue.man b/man/xkb/XkbSAPtrDfltValue.man new file mode 100644 index 0000000..77409a7 --- /dev/null +++ b/man/xkb/XkbSAPtrDfltValue.man @@ -0,0 +1,117 @@ +'\" t +.\" Copyright (c) 1999 - Sun Microsystems, Inc. +.\" All rights reserved. +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining a +.\" copy of this software and associated documentation files (the +.\" "Software"), to deal in the Software without restriction, including +.\" without limitation the rights to use, copy, modify, merge, publish, +.\" distribute, and/or sell copies of the Software, and to permit persons +.\" to whom the Software is furnished to do so, provided that the above +.\" copyright notice(s) and this permission notice appear in all copies of +.\" the Software and that both the above copyright notice(s) and this +.\" permission notice appear in supporting documentation. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +.\" OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR +.\" HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL +.\" INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING +.\" FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, +.\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION +.\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.\" +.\" Except as contained in this notice, the name of a copyright holder +.\" shall not be used in advertising or otherwise to promote the sale, use +.\" or other dealings in this Software without prior written authorization +.\" of the copyright holder. +.\" +.TH XkbSAPtrDfltValue __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" +.SH NAME +XkbSAPtrDfltValue \- Returns the valueXXX field of act converted to a signed int +.SH SYNOPSIS +.B int XkbSAPtrDfltValue macro +( +.I act +) +.br + XkbAction \fIact\fP\^; +.if n .ti +5n +.if t .ti +.5i +.SH ARGUMENTS +.TP +.I \- act +action from which to extract group +.SH DESCRIPTION +.LP +Actions associated with the XkbPtrDfltAction structure change the mk_dflt_btn +attribute of the MouseKeys control. + +If the MouseKeys control is not enabled, KeyPress and KeyRelease events are +treated as though the action is XkbSA_NoAction. Otherwise, this action changes +the +.I mk_dflt_btn +attribute of the MouseKeys control. + +The +.I type +field of the XkbPtrDfltAction structure should always be XkbSA_SetPtrDflt. + +The +.I flags +field is composed of the bitwise inclusive OR of the values shown in Table 1 +(currently there is only one value defined). + +.TS +c s +l l +l lw(4i). +Table 1 Pointer Default Flags +_ +Flag Meaning +_ +XkbSA_DfltBtnAbsolute T{ +If set, the value field represents an absolute pointer button. Otherwise, the +value field represents the amount to be added to the current default button. +T} +.TE + +The +.I affect +field specifies what changes as a result of this action. The only valid value +for the +.I affect +field is XkbSA_AffectDfltBtn. + +The +.I valueXXX +field is a signed character that represents the new button value for the +.I mk_dflt_btn +attribute of the MouseKeys control. If XkbSA_DfltBtnAbsolute is set in +.I flags, valueXXX +specifies the button to be used; otherwise, +.I valueXXX +specifies the amount to be added to the current default button. In either case, +illegal button choices are wrapped back around into range. Xkb provides macros, +to convert between the integer and signed character values in XkbPtrDfltAction +structures. + +.I XkbSAPtrDfltValue +returns the +.I valueXXX +field of +.I act +converted to a signed int. +.SH STRUCTURES +.LP +.nf + + typedef struct _XkbPtrDfltAction { + unsigned char type; /* XkbSA_SetPtrDflt */ + unsigned char flags; /* controls the pointer button number */ + unsigned char affect; /* XkbSA_AffectDfltBtn */ + char valueXXX; /* new default button member */ + } XkbPtrDfltAction; + +.fi |