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
|
#
# Carbou - text entry and UI navigation application
#
# Copyright (C) 2009 Adaptive Technology Resource Centre
#
# This program is free software; you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License as published by the
# Free Software Foundation; either version 2.1 of the License, or (at your
# option) any later version.
#
# This program is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
# for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program; if not, write to the Free Software Foundation,
# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
import pyatspi
import gtk
import keyboard
import gettext
import getopt
import sys
_ = gettext.gettext
debug = False
class Test:
def __init__(self):
self.__current_acc = None
def on_text_caret_moved(self, event):
if self.__current_acc == event.source:
self.__set_location(event.source)
if debug == True:
print "object:text-caret-moved in", event.host_application.name, event.detail1, event.source.description
def __set_text_location(self, acc):
text = acc.queryText()
[x, y, width, height] = text.getCharacterExtents(text.caretOffset, pyatspi.DESKTOP_COORDS)
cp.set_cursor_location(gtk.gdk.Rectangle(x, y, width, height))
component = acc.queryComponent()
entry_bb = component.getExtents(pyatspi.DESKTOP_COORDS)
cp.set_entry_location(entry_bb)
cp.show_all()
def __set_entry_location(self, acc):
text = acc.queryText()
cursor_bb = gtk.gdk.Rectangle(
*text.getCharacterExtents(text.caretOffset,
pyatspi.DESKTOP_COORDS))
component = acc.queryComponent()
entry_bb = component.getExtents(pyatspi.DESKTOP_COORDS)
if cursor_bb == gtk.gdk.Rectangle(0, 0, 0, 0):
cursor_bb = entry_bb
cp.set_cursor_location(cursor_bb)
cp.set_entry_location(entry_bb)
cp.show_all()
def on_state_changed_focused(self, event):
acc = event.source
if pyatspi.STATE_EDITABLE in acc.getState().getStates():
if event.source_role == pyatspi.ROLE_TEXT:
if event.detail1 == 1:
self.__set_text_location(acc)
self.__current_acc = event.source
self.__set_location = self.__set_text_location
if debug == True:
print "enter text widget in", event.host_application.name
elif event.detail1 == 0:
cp.hide_all()
self.__current_acc = None
self.__set_location = None
if debug == True:
print "leave text widget in", event.host_application.name
elif event.source_role == pyatspi.ROLE_ENTRY:
if event.detail1 == 1:
self.__set_entry_location(acc)
self.__current_acc = event.source
self.__set_location = self.__set_entry_location
if debug == True:
print "enter entry widget in", event.host_application.name
elif event.detail1 == 0:
cp.hide_all()
self.__current_acc = None
self.__set_location = None
if debug == True:
print "leave entry widget in", event.host_application.name
else:
print _("WARNING - Caribou: unhandled editable widget:"), event.source
# Firefox does report leave entry widget events.
# This could be a way to get the entry widget leave events.
#else:
# if event.detail1 == 1:
# cp.hide_all()
# print "--> LEAVE EDITABLE TEXT <--"
def on_key_down(self, event):
# key binding for controling the row column scanning
# TODO: needs implementing
if event.event_string == "Shift_R":
pass
elif event.event_string == "Control_R":
if debug == True:
print "quitting ..."
# TODO: use for loop here? see below
result = pyatspi.Registry.deregisterEventListener(self.on_text_caret_moved, "object:text-caret-moved")
if debug == True:
print "deregisterEventListener - object:text-caret-moved ...",
if result == False:
print "OK"
else:
print "FAIL"
result = pyatspi.Registry.deregisterEventListener(self.on_state_changed_focused, "object:state-changed:focused")
if debug == True:
print "deregisterEventListener - object:state-changed:focused ...",
if result == False:
print "OK"
else:
print "FAIL"
result = pyatspi.Registry.deregisterKeystrokeListener(self.on_key_down, mask = None, kind = (pyatspi.KEY_PRESSED_EVENT,))
if debug == True:
print "deregisterKeystrokeListener"
gtk.main_quit()
def usage():
"""Prints out usage information."""
print _("Usage:")
print " " + sys.argv[0] + _(" [OPTION...]")
print
print _("Help Options:")
print " -d, --debug " + _("Print debug messages on stdout")
print " -h, --help " + _("Show this help message")
print " -v, --version " + _("Display version")
if __name__ == "__main__":
try:
options, xargs = getopt.getopt(sys.argv[1:], "dhv", ["debug", "help", "version"])
except getopt.GetoptError, e:
print "Error: " + e.__str__() + "\n"
usage()
sys.exit(1)
for opt, val in options:
if opt in ("-d", "--debug"):
debug = True
if opt in ("-h", "--help"):
usage()
sys.exit(0)
if opt in ("-v", "--version"):
print "caribou @VERSION@"
sys.exit(0)
test = Test()
# TODO: make a for loop
#EVENTS = ["object:state-changed:focused", "object:text-caret-moved"]
#for f in dir(test):
# print f, isinstance(f, str)
pyatspi.Registry.registerEventListener(test.on_state_changed_focused, "object:state-changed:focused")
pyatspi.Registry.registerEventListener(test.on_text_caret_moved, "object:text-caret-moved")
pyatspi.Registry.registerKeystrokeListener(test.on_key_down, mask = None, kind = (pyatspi.KEY_PRESSED_EVENT,))
# TODO: move text entry detection to its own file
cp = keyboard.CaribouWindowEntry()
cp.hide_all()
gtk.main()
|
