Class: Charming::Events::MouseEvent

Inherits:
Data
  • Object
show all
Defined in:
lib/charming/events/mouse_event.rb

Overview

MouseEvent represents a mouse input event. button encodes which button or action was triggered (left, right, scroll), while x and y provide the cursor position. Modifier booleans (ctrl, alt, shift) capture key state at the time of the event.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(button:, x:, y:, ctrl: false, alt: false, shift: false) ⇒ MouseEvent

Returns a new instance of MouseEvent.



17
18
19
 
# File 'lib/charming/events/mouse_event.rb', line 17

def initialize(button:, x:, y:, ctrl: false, alt: false, shift: false)
  super
end

Instance Attribute Details

#alt ⇒ Object (readonly)

Returns the value of attribute alt

Returns:

  • (Object) —

    the current value of alt



16
17
18
 
# File 'lib/charming/events/mouse_event.rb', line 16

def alt
  @alt
end

#button ⇒ Object (readonly)

Returns the value of attribute button

Returns:

  • (Object) —

    the current value of button



16
17
18
 
# File 'lib/charming/events/mouse_event.rb', line 16

def button
  @button
end

#ctrl ⇒ Object (readonly)

Returns the value of attribute ctrl

Returns:

  • (Object) —

    the current value of ctrl



16
17
18
 
# File 'lib/charming/events/mouse_event.rb', line 16

def ctrl
  @ctrl
end

#shift ⇒ Object (readonly)

Returns the value of attribute shift

Returns:

  • (Object) —

    the current value of shift



16
17
18
 
# File 'lib/charming/events/mouse_event.rb', line 16

def shift
  @shift
end

#x ⇒ Object (readonly)

Returns the value of attribute x

Returns:

  • (Object) —

    the current value of x



16
17
18
 
# File 'lib/charming/events/mouse_event.rb', line 16

def x
  @x
end

#y ⇒ Object (readonly)

Returns the value of attribute y

Returns:

  • (Object) —

    the current value of y



16
17
18
 
# File 'lib/charming/events/mouse_event.rb', line 16

def y
  @y
end

Instance Method Details

#button_name ⇒ Object

Returns the semantic symbol for button — one of ‘left`, `right`, `scroll_up`, etc. or `:unknown`.



22
23
24
 
# File 'lib/charming/events/mouse_event.rb', line 22

def button_name
  MOUSE_BUTTON_MAP.fetch(button, :unknown)
end

#click? ⇒ Boolean

Returns ‘true` when the current event is a click (left, middle, or right button).

Returns:

  • (Boolean) 


27
28
29
 
# File 'lib/charming/events/mouse_event.rb', line 27

def click?
  %i[left middle right].include?(button_name)
end

#release? ⇒ Boolean

Returns ‘true` when the current event is a mouse release action.

Returns:

  • (Boolean) 


37
38
39
 
# File 'lib/charming/events/mouse_event.rb', line 37

def release?
  button_name == :release
end

#scroll? ⇒ Boolean

Returns ‘true` when the button name maps to either direction of scroll.

Returns:

  • (Boolean) 


32
33
34
 
# File 'lib/charming/events/mouse_event.rb', line 32

def scroll?
  %i[scroll_up scroll_down].include?(button_name)
end