185 lines
5.0 KiB
Plaintext
185 lines
5.0 KiB
Plaintext
.\" $Xorg: Repeater,v 1.3 2000/08/17 19:42:27 cpqbld Exp $
|
|
.NH 2
|
|
Repeater Widget
|
|
.XS
|
|
Repeater Widget
|
|
.XE
|
|
.IN "Repeater widget" "" "@DEF@"
|
|
.Ds 0
|
|
.TA 2.0i
|
|
.ta 2.0i
|
|
.sp
|
|
Application header file <X11/Xaw/Repeater.h>
|
|
.IN "Repeater.h" ""
|
|
Class header file <X11/Xaw/RepeaterP.h>
|
|
.IN "RepeaterP.h" ""
|
|
Class repeaterWidgetClass
|
|
.IN "repeaterWidgetClass" ""
|
|
Class Name Repeater
|
|
.IN "Repeater widget" "class name"
|
|
Superclass Command
|
|
.sp
|
|
.De
|
|
.LP
|
|
The Repeater widget is a subclass of the Command widget; see the
|
|
Command documentation for details. The difference is that the Repeater can call its
|
|
registered callbacks repeatedly, at an increasing rate. The default translation
|
|
does so for the duration the user holds down pointer button 1 while the pointer
|
|
is on the Repeater.
|
|
.NH 3
|
|
Resources
|
|
.LP
|
|
When creating a Repeater widget instance, the following resources are
|
|
retrieved from the argument list or from the resource database:
|
|
.LP
|
|
.IN "Repeater widget" "resources"
|
|
.TS H
|
|
expand;
|
|
lw(1i) lw(1i) lw(1i) lw(.5i) lw(2i).
|
|
_
|
|
.sp 3p
|
|
.TB
|
|
Name Class Type Notes Default Value
|
|
.sp 3p
|
|
_
|
|
.TH
|
|
.R
|
|
.sp 3p
|
|
accelerators Accelerators AcceleratorTable NULL
|
|
ancestorSensitive AncestorSensitive Boolean D True
|
|
background Background Pixel XtDefaultBackground
|
|
backgroundPixmap Pixmap Pixmap XtUnspecifiedPixmap
|
|
bitmap Bitmap Pixmap None
|
|
borderColor BorderColor Pixel XtDefaultForeground
|
|
borderPixmap Pixmap Pixmap XtUnspecifiedPixmap
|
|
borderWidth BorderWidth Dimension 1
|
|
callback Callback XtCallbackList NULL
|
|
colormap Colormap Colormap Parent's Colormap
|
|
cornerRoundPercent CornerRoundPercent Dimension 25
|
|
cursor Cursor Cursor None
|
|
cursorName Cursor String NULL
|
|
decay Decay Int 5
|
|
depth Depth int C Parent's Depth
|
|
destroyCallback Callback XtCallbackList NULL
|
|
encoding Encoding UnsignedChar XawTextEncoding8bit
|
|
flash Boolean Boolean False
|
|
font Font XFontStruct XtDefaultFont
|
|
fontSet FontSet XFontSet XtDefaultFontSet
|
|
foreground Foreground Pixel XtDefaultForeground
|
|
height Height Dimension A graphic height + 2 * \fBinternalHeight\fP
|
|
highlightThickness Thickness Dimension A 2 (0 if Shaped)
|
|
initialDelay Delay Int 200
|
|
insensitiveBorder Insensitive Pixmap GreyPixmap
|
|
internalHeight Height Dimension 2
|
|
internalWidth Width Dimension 4
|
|
international International Boolean C False
|
|
justify Justify Justify XtJustifyCenter (center)
|
|
label Label String name of widget
|
|
leftBitmap LeftBitmap Bitmap None
|
|
mappedWhenManaged MappedWhenManaged Boolean True
|
|
minimumDelay MinimumDelay Int 10
|
|
pointerColor Foreground Pixel XtDefaultForeground
|
|
pointerColorBackground Background Pixel XtDefaultBackground
|
|
repeatDelay Delay Int 50
|
|
resize Resize Boolean True
|
|
screen Screen Pointer R Parent's Screen
|
|
sensitive Sensitive Boolean True
|
|
shapeStyle ShapeStyle ShapeStyle Rectangle
|
|
startCallback StartCallback Callback NULL
|
|
stopCallback StopCallback Callback NULL
|
|
translations Translations TranslationTable See below
|
|
width Width Dimension A graphic width + 2 * \fBinternalWidth\fP
|
|
x Position Position 0
|
|
y Position Position 0
|
|
.sp 3p
|
|
_
|
|
.TE
|
|
\" Resource Descriptions
|
|
.Ac
|
|
.As
|
|
.Bg
|
|
.Gp
|
|
.Bm
|
|
.Bc
|
|
.Bp
|
|
.Bw
|
|
.Cb
|
|
.Cm
|
|
.Cr
|
|
.Cu
|
|
.Cn
|
|
.IP \fBdecay\fP 1.5i
|
|
The number of milliseconds that should be subtracted from each succeeding
|
|
interval while the Repeater button is being held down until the interval
|
|
has reached \fBminimumDelay\fP milliseconds.
|
|
.Dp
|
|
.Dc
|
|
.Le
|
|
.IP \fBflash\fP 1.5i
|
|
Whether or not to flash the Repeater button whenever the timer goes off.
|
|
.Lf
|
|
.Ls
|
|
.Lg
|
|
.Hw
|
|
.Ht
|
|
.IP \fBinitialDelay\fP 1.5i
|
|
The number of milliseconds between the beginning of the Repeater button
|
|
being held down and the first invocation of the \fBcallback\fP function.
|
|
.Ib
|
|
.Ih
|
|
.In
|
|
.Ju
|
|
.La
|
|
.Ll
|
|
.Mm
|
|
.IP \fBminimumDelay\fP 1.5i
|
|
The minimum time between callbacks in milliseconds.
|
|
.Pf
|
|
.Pb
|
|
.IP \fBrepeatDelay\fP 1.5i
|
|
The number of milliseconds between each callback after the first (minus an
|
|
increasing number of \fBdecay\fPs).
|
|
.Re
|
|
.Sc
|
|
.Se
|
|
.Ss
|
|
.IP \fBstartCallback\fP 1.5i
|
|
The list of functions to invoke by the \fBstart\fP action (typically
|
|
when the Repeater button is first pressed). The callback data parameter
|
|
is set to NULL.
|
|
.IP \fBstopCallback\fP 1.5i
|
|
The list of functions to invoke by the \fBstop\fP action (typically
|
|
when the Repeater button is released). The callback data parameter
|
|
is set to NULL.
|
|
.Tr
|
|
.Xy
|
|
.NH 3
|
|
Repeater Actions
|
|
.IN "Repeater widget" "actions"
|
|
.LP
|
|
The Repeater widget supports the following actions beyond those of the Command
|
|
button:
|
|
.IP \fBstart\fP() 1.5i
|
|
This invokes the functions on the \fBstartCallback\fP and \fBcallback\fP lists
|
|
and sets a timer to go off in \fBinitialDelay\fP milliseconds. The timer
|
|
will cause the \fBcallback\fP functions to be invoked with increasing
|
|
frequency until the \fBstop\fP action occurs.
|
|
.IP \fBstop\fP() 1.5i
|
|
This invokes the functions on the \fBstopCallback\fP list and prevents any
|
|
further timers from occuring until the next \fBstart\fP action.
|
|
.LP
|
|
.sp
|
|
.IN "Repeater widget" "translation bindings"
|
|
The following are the default translation bindings used by the
|
|
Repeater widget:
|
|
.LP
|
|
.Ds 0
|
|
.TA .5i 2.25i
|
|
.ta .5i 2.25i
|
|
<EnterWindow>: highlight(\|)
|
|
<LeaveWindow>: unhighlight(\|)
|
|
<Btn1Down>: set(\|) start(\|)
|
|
<Btn1Up>: stop(\|) unset(\|)
|
|
.De
|
|
.LP
|