C4 Engine
C4 Engine API Documentation

Widget::TrackTask

Defined in:  C4Widgets.h
Called once per frame while the mouse interacts with a widget.
Prototype

virtual void TrackTask(WidgetPart widgetPart, const Point2D& mousePosition);

Parameters
widgetPart The part of the widget in which the user originally clicked.
mousePosition The current mouse position in the widget's local coordinate system.
Description
The TrackTask function is called once per frame by the Interface Manager in between the times when mouse down and mouse up events are sent to a widget through the Widget::HandleMouseEvent function. This allows the widget's implementation to perform any kind of periodic task necessary while the user continues to hold the mouse button down without necessarily moving it.

The widgetPart parameter always specifies the part of the widget that was associated with the original mouse down event and does not reflect the part of the widget associated with the current position of the mouse.
See Also

Widget::HandleMouseEvent