Xraw: Repeater widget

Repeater widget

Application Header file	<Xraw/Repeater.h>
Class Header file	<Xraw/RepeaterP.h>
Class	repeaterWidgetClass
Class Name	Repeater
Superclass	Command --> Simple --> Core

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.

New Resources

Name Class Type Notes Default Value

decay Decay Int 5

flash Boolean Boolean False

initialDelay Delay Int 200

minimumDelay MinimumDelay Int 10

repeatDelay Delay Int 50

startCallback StartCallback Callback NULL

stopCallback StopCallback Callback 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.

Name	Class	Type	Default Value
decay	Decay	Int	5
flash	Boolean	Boolean	False
initialDelay	Delay	Int	200
minimumDelay	MinimumDelay	Int	10
repeatDelay	Delay	Int	50
startCallback	StartCallback	Callback	NULL
stopCallback	StopCallback	Callback	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.

Repeater Actions

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()
	<LeaveWindow>:	unhighlight()
	<Btn1Down>:	set() start()
	<Btn1Up>:	stop() unset()

[ Xraw home ] [ Xraw widget class hierarchy ]

Vladimir T. Romanovski
romsky@hp1.oea.ihep.su