Class: Bewildr::Mouse

Inherits:
Object
  • Object
show all
Includes:
Singleton
Defined in:
lib/bewildr/mouse.rb

Overview

Represents and gives access to mouse actions. Implemented as a singleton, but accessed through class methods to make the API more contained.

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Mouse

Returns a new instance of Mouse.



5
6
7
 
# File 'lib/bewildr/mouse.rb', line 5

def initialize
  @clickr = Bewildr::Clickr::Clickr.new
end

Class Method Details

.click(point) ⇒ Object

Clicks the mouse at the supplied point



15
16
17
 
# File 'lib/bewildr/mouse.rb', line 15

def self.click(point)
  instance.clickr.click(point)
end

.double_click(point) ⇒ Object

Double clicks the mouse at the supplied point



20
21
22
 
# File 'lib/bewildr/mouse.rb', line 20

def self.double_click(point)
  instance.clickr.double_click(point)
end

.drag(args) ⇒ Object

Drags the mouse from one location to another, and optionally, via another! Pass a hash containing the following keys:

:from
:to
:via (optional)
:wait_at_via_for

The value for each of those keys should be either a point or an element apart from :wait_at_via_for which takes seconds (eg: 0.2, 3, etc). If an element is supplied, the drag point will be the element’s clickable point



51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
 
# File 'lib/bewildr/mouse.rb', line 51

def self.drag(args)
  raise "Can't drag without a :from key in the hash" unless args.keys.include?(:from)
  raise "Can't drag without a :to key in the hash" unless args.keys.include?(:to)

  point_from = args[:from]
  point_to   = args[:to]
  point_via  = args[:via]
  args[:wait_at_via_for].nil? ? wait_time = 2 : wait_time = args[:wait_at_via_for]

  point_from = point_from.clickable_point if point_from.instance_of?(Bewildr::Element)
  point_to   = point_to.clickable_point if point_to.instance_of?(Bewildr::Element)
  point_via  = point_via.clickable_point if !point_via.nil? && point_via.instance_of?(Bewildr::Element)
  
  raise "Supplied :from was not an Element or a Point" unless point_from.class == System::Windows::Point
  raise "Supplied :to was not an Element or a Point"   unless point_to.class   == System::Windows::Point
  raise "Supplied :via was not an Element or a Point"  unless point_via.nil? || point_via.class  == System::Windows::Point

  self.move_to(point_from)
  self.left_down
  sleep 0.2

  if point_via.instance_of?(System::Windows::Point)
    almost_midway = System::Windows::Point.new
    almost_midway.x = point_via.x + 1
    almost_midway.y = point_via.y + 1
    self.move_to(almost_midway)
    sleep 0.3
    self.move_to(point_via)
    sleep wait_time
  end

  almost_there = System::Windows::Point.new
  almost_there.x = point_to.x + 1
  almost_there.y = point_to.y + 1

  self.move_to(almost_there)
  sleep 0.2
  self.move_to(point_to)
  self.left_up
end

.left_down ⇒ Object

Press the left mouse button down at the current point



30
31
32
 
# File 'lib/bewildr/mouse.rb', line 30

def self.left_down
  instance.clickr.left_mouse_button_down
end

.left_up ⇒ Object

Release the left mouse button



35
36
37
 
# File 'lib/bewildr/mouse.rb', line 35

def self.left_up
  instance.clickr.left_mouse_button_up
end

.move_to(point) ⇒ Object

Moves the mouse to the supplied point



40
41
42
 
# File 'lib/bewildr/mouse.rb', line 40

def self.move_to(point)
  instance.clickr.set_location(point)
end

.right_click(point) ⇒ Object

Right clicks the mouse at the supplied point



25
26
27
 
# File 'lib/bewildr/mouse.rb', line 25

def self.right_click(point)
  instance.clickr.right_click(point)
end

Instance Method Details

#clickr ⇒ Object

Returns the BewildrClickr instance - don’t use!



10
11
12
 
# File 'lib/bewildr/mouse.rb', line 10

def clickr
  @clickr
end