Struct pushrod::widget::timer_widget::TimerWidget

pub struct TimerWidget { /* fields omitted */ }

This is the TimerWidget. It contains no base widget, it only contains a start and end time,

Methods

impl TimerWidget

Implementation of the constructor for the TimerWidget. Timer widgets are not accessible on the screen, so they have an origin of 0x0 and width of 0x0.

The timer provides a simple way to call a callback function after a certain amount of time has passed. Upon instantiation, the timer is enabled.

Here are a few limitations of the timer as it currently stands:

• Timer cannot be paused; it is enabled or disabled, and the timer resets when enabled.
• Timer is called when the screen refreshes, so slower FPS settings will affect the timer.

pub fn new() -> Self

Constructor, creates a new TimerWidget struct with an empty timeout function.

pub fn set_enabled(&mut self, enabled: bool)

Enables or disables the timer. When disabled, the timer will not initiate the callback function. When re-enabled, the initiation time resets, so the timer will reset back to zero, effectively resetting the entire timer.

pub fn on_timeout(&mut self, callback: BlankCallback)

Sets the closure function for the timer when a timeout has been triggered. This closure needs to be Boxed.

pub fn set_timeout(&mut self, timeout: u64)

Sets the timeout in milliseconds for this timer. Will trigger a call to the function set in on_timeout when triggered, and will continue to call that function until this timer is disabled by using self.set_enabled(false).

Trait Implementations

impl Widget for TimerWidget

Implementation of the TimerWidget object with the Widget traits implemented.

Example usage:

   let mut timer_widget = TimerWidget::new();

   timer_widget.set_timeout(60000);
   timer_widget.on_timeout(Box::new( || eprintln!("Timer triggered.") ));
   timer_widget.set_enabled(true);

fn config(&mut self) -> &mut Configurable

Retrieves the configuration HashMap that stores the configuration list of settings for this widget.

fn callbacks(&mut self) -> &mut CallbackStore

Returns the CallbackStore for this Widget. This contains a set of callbacks that only apply to this Widget.

fn is_invalidated(&mut self) -> bool

Timer is always invalidated, this way, the tick function is always called on each screen refresh.

fn get_origin(&mut self) -> Point

Origin is always set to X/Y at points 0x0.

fn get_size(&mut self) -> Size

Size is always unsized, as timers are invisible.

fn draw(&mut self, _context: Context, _graphics: &mut G2d)

Does not draw anything - only calls the timer tick() function to increment the timer.

fn invalidate(&mut self)

Indicates that a widget needs to be redrawn/refreshed.

fn clear_invalidate(&mut self)

Clears the invalidation flag.

fn set_origin(&mut self, x: i32, y: i32)

Sets the Point of origin for this widget, given the X and Y origin points. Invalidates the widget afterward.

fn set_size(&mut self, w: i32, h: i32)

Sets the Size for this widget, given a width and height. Invalidates the widget afterward.

fn set_color(&mut self, color: Color)

Sets the color for this widget. Invalidates the widget afterward.

fn get_color(&mut self) -> Color

Retrieves the color of this widget. Defaults to white color [1.0; 4] if not set.

fn perform_single_callback(&mut self, callback_id: u32, widget_id: i32)

Performs a callback stored in the CallbackStore for this Widget, but only for the CallbackTypes::SingleCallback enum type. If the callback does not exist, or is not defined properly, it will be silently dropped and ignored.

fn perform_point_callback(
    &mut self,
    callback_id: u32,
    widget_id: i32,
    point: Point
)

Performs a callback stored in the CallbackStore for this Widget, but only for the CallbackTypes::PointCallback enum type. If the callback does not exist, or is not defined properly, it will be silently dropped and ignored.

fn perform_key_callback(
    &mut self,
    callback_id: u32,
    widget_id: i32,
    key: Key,
    state: ButtonState
)

fn key_pressed(&mut self, widget_id: i32, key: &Key, state: &ButtonState)

Called when a keyboard event takes place within the bounds of a widget. Includes the widget ID, the key code that was affected, and its state - pressed or released.

fn mouse_entered(&mut self, widget_id: i32)

Called when a mouse enters the bounds of the widget. Includes the widget ID. Only override if you want to signal a mouse enter event.

fn mouse_exited(&mut self, widget_id: i32)

Called when a mouse exits the bounds of the widget. Includes the widget ID. Only override if you want to signal a mouse exit event.

fn mouse_scrolled(&mut self, widget_id: i32, point: Point)

Called when a scroll event is called within the bounds of the widget. Includes the widget ID. Only override if you want to signal a mouse scroll event.

fn mouse_moved(&mut self, widget_id: i32, point: Point)

Called when the mouse pointer is moved inside a widget. Includes the widget ID and point. Only override if you want to track mouse movement.

fn on_key_pressed(&mut self, callback: KeyCallback)

fn on_mouse_entered(&mut self, callback: SingleCallback)

Sets the closure action to be performed when a mouse enters a Widget.

fn on_mouse_exited(&mut self, callback: SingleCallback)

Sets the closure action to be performed when a mouse exits a Widget.

fn on_mouse_scrolled(&mut self, callback: PointCallback)

Sets the closure action to be performed when a mouse scrolls inside a Widget.

fn on_mouse_moved(&mut self, callback: PointCallback)

Sets the closure action to be performed when a mouse moves within a Widget.