Application Header file Class Header file Class Class Name Superclass |
<X11/XawPlus/Repeater.h> <X11/XawPlus/RepeaterP.h> repeaterWidgetClass Repeater Command |
The Repeater widget is a version of the Command button that triggers at an increasing rate while it is held down. It is typically used to implement valuators or certain types of scrollbars.
Since the core extension class Add3dExt is inserted, the Repeater widget has the additional resources highlightColor, shadowColor and buttonBorderWidth. The default background color is now grey75. These three colors and the width of the button border are used to draw the shape of a button with an inherited method of the Add3dExt class. Since XawPlus only supply rectangular buttons, the resources shapeStyle and cornerRoundPercent lost their meaning.
The bitmap and leftBitmap resources now also provide support of XPM styled pixmaps. These resources are inherited from the Label widget class. Look there for a description of this new feature.
Since Release 1.5 this widget provide a help function. If a help text and useHelp is set in the resources, a help window is popped up afer 1.2 seconds when the mouse pointer stay over the widgets window. This feature is inherited from the Command widget class. Look there for a detailed description.
Since release 2.0 this widget has a new highlight mode. The old highlight mode of Xaw is not longer available. This new feature is inherited from the Command widget class. Look there for a detailed description.
When creating a Command widget instance, the following resources are retrieved from the argument list of XtSetValues() or XtVaSetValues() or from the resource database:
Name | Class | RepType | Default Value |
OBJECT: | |||
destroyCallback | Callback | Pointer | NULL |
RECTANGLE: | |||
borderWidth height sensitive width x y |
BorderWidth Height Sensitive Width Position Position |
Dimension Dimension Boolean Dimension Position Position |
0 12 True 12 0 0 |
CORE: | |||
border background mappedWhenManaged |
BorderColor Background MappedWhenManaged |
Pixel Pixel Boolean |
XtDefaultForeground grey75 True |
ADD3DEXT: | |||
highlightColor shadowColor buttonBorderWidth |
Background Background Width |
Pixel Pixel Dimension |
grey90 grey40 2 |
SIMPLE: | |||
cursor cursorName pointerColor pointerColorBackground insensitiveBorder |
Cursor Cursor Foreground Background Insensitive |
Cursor String Pixel Pixel Pixmap |
None NULL XtDefaultForeground XtDefaultBackground NULL |
LABEL: | |||
internalHeight internalWidth justify resize font encoding foreground label leftBitmap bitmap |
Height Width Justify Resize Font Encoding Foreground Label LeftBitmap Pixmap |
Dimension Dimension XtJustify Boolean XFontStruct* unsigned char Pixel String Pixmap Pixmap |
2 4 XtJustifyCenter True XtDefaultFont XawTextEncoding8bit XtDefaultForeground NULL None None |
COMMAND: | |||
helpText helpEncoding helpBackground useHelp highlightThickness highlightMode callback translations accelerators ancestorSensitive |
Label Encoding Background Boolean Thickness Boolean Callback Translations Accelerators AncestorSensitive |
String unsigned char Pixel Boolean Dimension Boolean XtCallbackList TranslationTable AcceleratorTable Boolean |
NULL XawTextEncoding8bit LightGoldenrodYellow True 2 True NULL see doc or source NULL True |
REPEATER: | |||
decay flash initialDelay minimumDelay repeatDelay startCallback stopCallback |
Decay Boolean Delay MinimumDelay Delay StartCallback StopCallback |
int Boolean int int int XtCallbackList XtCallbackList |
5 milliseconds FALSE 200 milliseconds 10 milliseconds 50 milliseconds NULL NULL |
decay | 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 minimumDelay milliseconds. |
flash | Whether or not to flash the Repeater button whenever the timer goes off. |
initialDelay | The number of milliseconds between the beginning of the Repeater button being held down and the first invocation of the callback function. |
minimumDelay | The minimum time between callbacks in milliseconds. |
repeatDelay | The number of milliseconds between each callback after the first (minus an increasing number of decays). |
startCallback | The list of functions to invoke by the start action (typically when the Repeater button is first pressed). The callback data parameter is set to NULL. |
stopCallback | The list of functions to invoke by the stop action (typically when the Repeater button is released). The callback data parameter is set to NULL. |
The Repeater widget supports the following actions beyond those of the Command button:
start() | This invokes the functions on the startCallback and callback lists and sets a timer to go off in initialDelay milliseconds. The timer will cause the callback functions to be invoked with increasing frequency until the stop action occurs. |
stop() | This invokes the functions on the stopCallback list and prevents any further timers from occuring until the next start action. |
The following are the default translation bindings used by the Repeater widget:
<EnterWindow> |
highlight() unhighlight() set(), start() stop(), unset() |