Struct pushrod::widget::text_widget::TextWidget

pub struct TextWidget { /* fields omitted */ }

This is the TextWidget, which draws a line of text on the screen. This structure contains no accessable objects, they are all internal to TextWidget's implementation.

Methods

impl TextWidget

Implementation of the constructor for the TextWidget. Creates a new text object to be displayed on the screen, given a font name, font size, and text message.

pub fn new(
    factory: GfxFactory,
    font_name: String,
    text: String,
    font_size: u32
) -> Self

Creates a new TextWidget object, requiring the current PistonWindow's factory object (which can be cloned), the name of the font (filename in the assets directory), the text to display, and the font size in which to use.

pub fn set_text_color(&mut self, color: Color)

Sets the color of the text for this Widget.

pub fn get_text_color(&mut self) -> Color

Retrieves the color of the text for this Widget. Defaults to black if not set.

pub fn set_text(&mut self, text: String)

Changes the text, redraws after change.

pub fn draw_text(&mut self, c: Context, g: &mut G2d)

Function to draw the text. Generates a context transformation to display the text based on the point of origin's X and Y coordinates. Since the text is drawn upwards from the point of origin, the starting point is the lower left-hand corner of the widget. (This may change based on text justification, and other optional padding, once padding is introduced.)

Trait Implementations

impl Widget for TextWidget

Implementation of the BoxWidget object with the Widget traits implemented. This implementation is similar to the CanvasWidget, but incorporates a drawable box inside the widget. Base widget is the CanvasWidget.

This is basically just a box with a fill color. Use this to draw other things like buttons, text widgets, and so on, if you need anything with a drawable border.

Example usage:

let mut window: PistonWindow = WindowSettings::new("Pushrod Window", [800, 600])
      .opengl(OpenGL::V3_2)
      .resizable(false)
      .build()
      .unwrap_or_else(|error| panic!("Failed to build PistonWindow: {}", error));
   let factory: GfxFactory = window.factory.clone();
   let mut prod: Pushrod = Pushrod::new(window);
   let mut text_widget = TextWidget::new(
      factory,
      "OpenSans-Regular.ttf".to_string(),
      "Welcome to Pushrod!".to_string(),
      32,
   );

   text_widget.set_origin(8, 8);
   text_widget.set_size(400, 40);
   text_widget.set_color([0.75, 0.75, 1.0, 1.0]);
   text_widget.set_text_color([0.0, 0.0, 1.0, 1.0]);
   prod.widget_store.add_widget(Box::new(text_widget));

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 draw(&mut self, c: Context, g: &mut G2d)

Draws the contents of the widget.

fn invalidate(&mut self)

Indicates that a widget needs to be redrawn/refreshed.

fn clear_invalidate(&mut self)

Clears the invalidation flag.

fn is_invalidated(&mut self) -> bool

Checks to see whether or not the widget needs to be redrawn/refreshed.

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 get_origin(&mut self) -> Point

Retrieves the Point of origin for this object. Defaults to origin (0, 0) if not set.

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 get_size(&mut self) -> Size

Retrieves the Size bounds for this widget. Defaults to size (0, 0) if not set.

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.