Struct egui::PointerState

source ·

pub struct PointerState { /* private fields */ }

Expand description

Mouse or touch state.

Implementations§

source §

impl PointerState

source

pub fn delta(&self) -> Vec2

How much the pointer moved compared to last frame, in points.

source

pub fn velocity(&self) -> Vec2

Current velocity of pointer.

source

pub fn press_origin(&self) -> Option<Pos2>

Where did the current click/drag originate? None if no mouse button is down.

source

pub fn press_start_time(&self) -> Option<f64>

When did the current click/drag originate? None if no mouse button is down.

source

pub fn latest_pos(&self) -> Option<Pos2>

Latest reported pointer position. When tapping a touch screen, this will be None.

source

pub fn hover_pos(&self) -> Option<Pos2>

If it is a good idea to show a tooltip, where is pointer?

source

pub fn interact_pos(&self) -> Option<Pos2>

If you detect a click or drag and wants to know where it happened, use this.

Latest position of the mouse, but ignoring any Event::PointerGone if there were interactions this frame. When tapping a touch screen, this will be the location of the touch.

source

pub fn has_pointer(&self) -> bool

Do we have a pointer?

false if the mouse is not over the egui area, or if no touches are down on touch screens.

source

pub fn is_still(&self) -> bool

Is the pointer currently still? This is smoothed so a few frames of stillness is required before this returns true.

source

pub fn is_moving(&self) -> bool

Is the pointer currently moving? This is smoothed so a few frames of stillness is required before this returns false.

source

pub fn time_since_last_movement(&self) -> f32

How long has it been (in seconds) since the pointer was last moved?

source

pub fn any_pressed(&self) -> bool

Was any pointer button pressed (!down -> down) this frame?

This can sometimes return true even if any_down() == false because a press can be shorted than one frame.

source

pub fn any_released(&self) -> bool

Was any pointer button released (down -> !down) this frame?

source

pub fn button_pressed(&self, button: PointerButton) -> bool

Was the button given pressed this frame?

source

pub fn button_released(&self, button: PointerButton) -> bool

Was the button given released this frame?

source

pub fn primary_pressed(&self) -> bool

Was the primary button pressed this frame?

source

pub fn secondary_pressed(&self) -> bool

Was the secondary button pressed this frame?

source

pub fn primary_released(&self) -> bool

Was the primary button released this frame?

source

pub fn secondary_released(&self) -> bool

Was the secondary button released this frame?

source

pub fn any_down(&self) -> bool

Is any pointer button currently down?

source

pub fn any_click(&self) -> bool

Were there any type of click this frame?

source

pub fn button_clicked(&self, button: PointerButton) -> bool

Was the button given clicked this frame?

source

pub fn button_double_clicked(&self, button: PointerButton) -> bool

Was the button given double clicked this frame?

source

pub fn button_triple_clicked(&self, button: PointerButton) -> bool

Was the button given triple clicked this frame?

source

pub fn primary_clicked(&self) -> bool

Was the primary button clicked this frame?

source

pub fn secondary_clicked(&self) -> bool

Was the secondary button clicked this frame?

source

pub fn button_down(&self, button: PointerButton) -> bool

Is this button currently down?

source

pub fn could_any_button_be_click(&self) -> bool

If the pointer button is down, will it register as a click when released?

pub fn is_decidedly_dragging(&self) -> bool

Just because the mouse is down doesn’t mean we are dragging. We could be at the start of a click. But if the mouse is down long enough, or has moved far enough, then we consider it a drag.

This function can return true on the same frame the drag is released, but NOT on the first frame it was started.

source