1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 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 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187
|
import gi
from gi.repository import Gtk as gtk
from gi.repository import Gdk as gdk
from gi.repository import Wnck as wnck
from accerciser.plugin import Plugin
from accerciser.i18n import N_, _
import pyatspi
class QuickSelect(Plugin):
'''
Plugin class for quick select.
'''
plugin_name = N_('Quick Select')
plugin_name_localized = _(plugin_name)
plugin_description = \
N_('Plugin with various methods of selecting accessibles quickly.')
def init(self):
'''
Initialize plugin.
'''
self.global_hotkeys = [(N_('Inspect last focused accessible'),
self._inspectLastFocused,
gdk.KEY_a, gdk.ModifierType.CONTROL_MASK | \
gdk.ModifierType.MOD1_MASK),
(N_('Inspect accessible under mouse'),
self._inspectUnderMouse,
gdk.KEY_question, gdk.ModifierType.CONTROL_MASK | \
gdk.ModifierType.MOD1_MASK)]
pyatspi.Registry.registerEventListener(self._accEventFocusChanged,
'object:state-changed')
pyatspi.Registry.registerEventListener(self._accEventSelectionChanged,
'object:selection-changed')
self.last_focused = None
self.last_selected = None
def _accEventFocusChanged(self, event):
'''
Hold a reference for the last focused accessible. This is used when a certain
global hotkey is pressed to select this accessible.
@param event: The event that is being handled.
@type event: L{pyatspi.event.Event}
'''
if not self.isMyApp(event.source):
self.last_focused = event.source
def _accEventSelectionChanged(self, event):
'''
Hold a reference for the last parent of a selected accessible.
This will be useful if we want to find an accessible at certain coords.
@param event: The event that is being handled.
@type event: L{pyatspi.event.Event}
'''
if not self.isMyApp(event.source):
self.last_selected = event.source
def _inspectLastFocused(self):
'''
Inspect the last focused widget's accessible.
'''
if self.last_focused:
self.node.update(self.last_focused)
def _inspectUnderMouse(self):
'''
Inspect accessible of widget under mouse.
'''
display = gdk.Display.get_default()
screen, x, y, flags = display.get_pointer()
del screen # A workaround http://bugzilla.gnome.org/show_bug.cgi?id=593732
# First check if the currently selected accessible has the pointer over it.
# This is an optimization: Instead of searching for
# STATE_SELECTED and ROLE_MENU and LAYER_POPUP in the entire tree.
item = self._getPopupItem(x, y)
if item:
self.node.update(item)
return
# Inspect accessible under mouse
desktop = pyatspi.Registry.getDesktop(0)
wnck_screen = wnck.Screen.get_default()
window_order = [w.get_name() for w in wnck_screen.get_windows_stacked()]
top_window = (None, -1)
for app in desktop:
if not app or self.isMyApp(app):
continue
for frame in app:
if not frame:
continue
acc = self._getComponentAtCoords(frame, x, y)
if acc:
try:
z_order = window_order.index(frame.name)
except ValueError:
# It's possibly a popup menu, so it would not be in our frame name
# list. And if it is, it is probably the top-most component.
try:
if acc.queryComponent().getLayer() == pyatspi.LAYER_POPUP:
self.node.update(acc)
return
except:
pass
else:
if z_order > top_window[1]:
top_window = (acc, z_order)
if top_window[0]:
self.node.update(top_window[0])
def _getPopupItem(self, x, y):
suspect_children = []
# First check if the currently selected accessible has the pointer over it.
# This is an optimization: Instead of searching for
# STATE_SELECTED and ROLE_MENU and LAYER_POPUP in the entire tree.
if self.last_selected and \
self.last_selected.getRole() == pyatspi.ROLE_MENU and \
self.last_selected.getState().contains(pyatspi.STATE_SELECTED):
try:
si = self.last_selected.querySelection()
except NotImplementedError:
return None
if si.nSelectedChildren > 0:
suspect_children = [si.getSelectedChild(0)]
else:
suspect_children = self.last_selected
for child in suspect_children:
try:
ci = child.queryComponent()
except NotImplementedError:
continue
if ci.contains(x, y, pyatspi.DESKTOP_COORDS) and \
ci.getLayer() == pyatspi.LAYER_POPUP:
return child
return None
def _getComponentAtCoords(self, parent, x, y):
'''
Gets any child accessible that resides under given desktop coordinates.
@param parent: Top-level accessible.
@type parent: L{Accessibility.Accessible}
@param x: X coordinate.
@type x: integer
@param y: Y coordinate.
@type y: integer
@return: Child accessible at given coordinates, or None.
@rtype: L{Accessibility.Accessible}
'''
container = parent
while True:
container_role = container.getRole()
if container_role == pyatspi.ROLE_PAGE_TAB_LIST:
try:
si = container.querySelection()
container = si.getSelectedChild(0)[0]
except NotImplementedError:
pass
try:
ci = container.queryComponent()
except:
break
else:
inner_container = container
container = ci.getAccessibleAtPoint(x, y, pyatspi.DESKTOP_COORDS)
if not container or container.queryComponent() == ci:
# The gecko bridge simply has getAccessibleAtPoint return itself
# if there are no further children
break
if inner_container == parent:
return None
else:
return inner_container
|