MouseEvent

class MouseEvent : public HPS::InputEvent

The MouseEvent class is the event generated for each mouse action.

Public Types

enum class Action : uint32_t

Enumeration of various actions a mouse can undergo for a MouseEvent.

Values:

enumerator ButtonUp
enumerator ButtonDown

A mouse button has been released.

enumerator Move

A mouse button has been pressed.

enumerator Scroll

The mouse location has changed.

enumerator Enter

The scroll wheel has been moved.

enumerator Leave

The mouse cursor has moved into the active window.

The mouse cursor has moved out of the active window.

Public Functions

inline virtual char const *ClassName() const override
inline virtual Event *Clone() const override

Allocates and returns a copy of this MouseEvent.

Returns:A copy of this MouseEvent.
inline virtual bool Drop(Event const *in_that_event) const override

Determines if this MouseEvent can be dropped in favor of the following mouse event.

Parameters:in_that_event – Event to compare with this MouseEvent.
Returns:true if this event can be dropped, false otherwise.
inline virtual bool Equals(InputEvent const &in_that) const override

Check if the source object is equivalent to this object.

Parameters:in_that – The source object to compare to this object.
Returns:true if the objects are equivalent, false otherwise.
inline virtual bool Equals(MouseEvent const &in_that) const

Check if the source object is equivalent to this object.

Parameters:in_that – The source object to compare to this object.
Returns:true if the objects are equivalent, false otherwise.
inline virtual intptr_t Freshen() const override

This optional function is used to determine if the current event can be dropped in favor of newer event of the same type if one is available.

Returns:A cookie representing the freshen category. Zero indicates a non-freshening event.
inline MouseEvent()

The default constructor creates an uninitialized MouseEvent object.

inline MouseEvent(Action in_action, float in_wheel_delta, WindowPoint in_location = WindowPoint(0, 0, 0), ModifierKeys in_modifier = ModifierKeys(), size_t in_click_count = 0)

This constructor creates a MouseEvent object, most useful for a wheel action.

Parameters:
  • in_action – Action of the mouse for this MouseEvent.
  • in_wheel_delta – If the action involves the mouse wheel, this is the amount the wheel moved. It is positive if the mouse wheel is moved forward (away from the user) or negative if the mouse wheel is moved downward (toward the user).
  • in_location – The location in window space of the mouse cursor.
  • in_modifier – The modifier keys for this MouseEvent.
  • in_click_count – The number of clicks received.
inline MouseEvent(Action in_action, WindowPoint in_location, MouseButtons in_button = MouseButtons(), ModifierKeys in_modifier = ModifierKeys(), size_t in_click_count = 0)

This constructor creates a MouseEvent object for a given action.

Parameters:
  • in_action – Action of this MouseEvent.
  • in_location – The location in window space of the mouse cursor.
  • in_button – If the action is a button event, this is the button.
  • in_modifier – The modifier keys for this MouseEvent.
  • in_click_count – The number of clicks received.
inline MouseEvent(Event const &in_event)

This constructor converts an Event Object to a MouseEvent object.

Parameters:in_event – The Event Object to be converted.
inline virtual bool operator!=(MouseEvent const &in_that) const

Check if the source object is not equivalent to this object.

Parameters:in_kit – The source object to compare to this object.
Returns:true if the objects are not equivalent, false otherwise.
inline virtual bool operator==(MouseEvent const &in_that) const

Check if the source object is equivalent to this object.

Parameters:in_kit – The source object to compare to this object.
Returns:true if the objects are equivalent, false otherwise.
~MouseEvent()

Public Members

size_t ClickCount

The number of clicks received.

HPS::MouseEvent::Action CurrentAction

The action for this MouseEvent.

HPS::MouseButtons CurrentButton

If the action involves a button, this is the button.

WindowPoint Location

Location in window space of the mouse cursor.

float WheelDelta

If the action involves the mouse wheel, this is the amount the wheel moved. It is positive if the mouse wheel is moved forward (away from the user) or negative if the mouse wheel is moved downward (toward the user).