Class: AX::SystemWide

Inherits:

Element

• Object
• Element
• AX::SystemWide

show all

Includes:

Accessibility::String

Defined in:

lib/ax/systemwide.rb

Overview

Constant Summary

Class Method Summary (collapse)

• + (AX::Group) desktop

  Find and return the group that represents the desktop.

• + (AX::MenuBarItem) status_items

  Find and return menu bar items for the system.

Instance Method Summary (collapse)

• - (AX::Element^?) element_at(point)

  Find the element in at the given point for the topmost appilcation window.

• - (AX::Application) focused_application

  Find and return the application which is frontmost.

• - (Number^?) hold_modifier(key)

  Press the given modifier key and hold it down while yielding to the given block.

• - (SystemWide) initialize constructor

  Overridden since there is only one way to get the element ref.

• - (Object) on_notification(*args)

  Raises an NoMethodError instead of (possibly) silently failing to register for a notification.

• - (Object) search(*args)

  The system wide object cannot be used to perform searches.

• - (Number) set_global_timeout(seconds)

  Set the global messaging timeout.

• - (Boolean) type(string) (also: #type_string)

  Generate keyboard events by simulating keyboard input.

Methods included from Accessibility::String

#keyboard_events_for

Methods inherited from Element

#==, #actions, #ancestor, #ancestry, #application, #attribute, #attributes, #blank?, #bounds, #children, #description, #inspect, #inspect_subtree, #invalid?, #method_missing, #methods, #parameterized_attribute, #parameterized_attributes, #perform, #pid, #respond_to?, #set, #size_of, #to_point, #to_s, #writable?

Methods included from Accessibility::PrettyPrinter

#pp_checkbox, #pp_children, #pp_identifier, #pp_position

43
44
45

# File 'lib/ax/systemwide.rb', line 43

def initialize
  super Accessibility::Element.system_wide
end

19
20
21

# File 'lib/ax/systemwide.rb', line 19

def desktop
  AX::Application.finder.scroll_areas.first.groups.first
end

35
36
37

# File 'lib/ax/systemwide.rb', line 35

def status_items
  AX::Application.new('SystemUIServer').menu_bar.children
end

111
112
113

# File 'lib/ax/systemwide.rb', line 111

def element_at point
  @ref.element_at(point).to_ruby
end

127
128
129

# File 'lib/ax/systemwide.rb', line 127

def focused_application
  AX::Application.frontmost_app
end

hold_key "\\CONTROL" do
  drag_mouse_to point
end

77
78
79
80
81
82
83
84
85

# File 'lib/ax/systemwide.rb', line 77

def hold_modifier key
  code = EventGenerator::CUSTOM[key]
  raise ArgumentError, "Invalid modifier `#{key}' given" unless code
  @ref.post [[code, true]]
  yield
ensure # if block raises the button might stuck, so ensure it is released
  @ref.post [[code,false]] if code
  code
end

99
100
101

# File 'lib/ax/systemwide.rb', line 99

def on_notification *args
  raise NoMethodError, 'AX::SystemWide cannot register for notifications'
end

90
91
92

# File 'lib/ax/systemwide.rb', line 90

def search *args
  raise NoMethodError, 'AX::SystemWide cannot search'
end

122
123
124

# File 'lib/ax/systemwide.rb', line 122

def set_global_timeout seconds
  @ref.set_timeout_to seconds
end

59
60
61
62

# File 'lib/ax/systemwide.rb', line 59

def type string
  @ref.post keyboard_events_for string
  true
end