Viewing file:  J2SE-access-bridge.py (9.2 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
# Orca
#
# Copyright 2006 Sun Microsystems Inc.
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Library General Public
# License as published by the Free Software Foundation; either
# version 2 of the License, or (at your option) any later version.
#
# This library 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
# Library General Public License for more details.
#
# You should have received a copy of the GNU Library General Public
# License along with this library; if not, write to the
# Free Software Foundation, Inc., 59 Temple Place - Suite 330,
# Boston, MA 02111-1307, USA.
__id__ = "$Id: J2SE-access-bridge.py,v 1.9 2006/08/23 12:30:59 oserb Exp $"
__version__ = "$Revision: 1.9 $"
__date__ = "$Date: 2006/08/23 12:30:59 $"
__copyright__ = "Copyright (c) 2005-2006 Sun Microsystems Inc."
__license__ = "LGPL"
import atspi
import default
import debug
import orca
import orca_state
import keybindings
import settings
import speech
import util
import rolenames
import Accessibility
import speechgenerator
from orca_i18n import _ # for gettext support
########################################################################
# #
# The Java script class. #
# #
########################################################################
class SpeechGenerator(speechgenerator.SpeechGenerator):
"""Overrides _getSpeechForLabel
"""
def _getSpeechForLabel(self, obj, already_focused):
"""Get the speech for a label.
Arguments:
- obj: the label
- already_focused: False if object just received focus
Returns a list of utterances to be spoken for the object.
"""
utterances=[]
if (not already_focused):
utterances = self._getDefaultSpeech(obj, already_focused)
obj.was_selected = False
if obj.state.count(Accessibility.STATE_EXPANDED) != 0:
utterances.append(_("expanded"))
elif obj.state.count(Accessibility.STATE_EXPANDED) == 0 and \
obj.state.count(Accessibility.STATE_EXPANDABLE) != 0:
utterances.append(_("collapsed"))
elif obj.state.count(Accessibility.STATE_SELECTED) != 0:
utterances.append(_("selected"))
obj.was_selected = True
elif obj.state.count(Accessibility.STATE_SELECTED) == 0 and \
obj.state.count(Accessibility.STATE_SELECTABLE) != 0:
utterances.append(_("unselected"))
self._debugGenerator("_getSpeechForLabel",
obj,
already_focused,
utterances)
return utterances
class Script(default.Script):
def __init__(self, app):
"""Creates a new script for Java applications.
Arguments:
- app: the application to create a script for.
"""
default.Script.__init__(self, app)
def getSpeechGenerator(self):
"""Returns the speech generator for this script.
"""
return SpeechGenerator()
def consumesKeyboardEvent(self, keyboardEvent):
"""Called when a key is pressed on the keyboard.
Arguments:
- keyboardEvent: an instance of input_event.KeyboardEvent
Returns True if the event is of interest.
"""
keysym = keyboardEvent.event_string
keyboardEvent.hw_code = keybindings._getKeycode(keysym)
return default.Script.consumesKeyboardEvent(self, keyboardEvent)
def onFocus(self, event):
"""Called whenever an object gets focus.
Arguments:
- event: the Event
"""
role = event.source.role
if role == rolenames.ROLE_LIST:
selectedItem = None
selection = event.source.selection
if selection and selection.nSelectedChildren > 0:
selectedItem = atspi.Accessible.makeAccessible(
selection.getSelectedChild(0))
elif event.source.childCount > 0:
selectedItem = event.source.child(0)
if selectedItem:
orca.setLocusOfFocus(event, selectedItem)
else:
# if impossible to get selection or list has 0 items, present list
orca.setLocusOfFocus(event, event.source)
elif role == rolenames.ROLE_LABEL:
# In FileChooserDemo, when enter in a new folder, a focus event for
# the top combo box selected item (not SHOWING item) is received.
# Should this check be more specific ?
#
if not event.source.state.count (Accessibility.STATE_SHOWING):
return
elif role == rolenames.ROLE_MENU:
# A JMenu has always selection.nSelectedChildren > 0
orca.setLocusOfFocus(event, event.source)
else:
default.Script.onFocus(self, event)
def onStateChanged(self, event):
"""Called whenever an object's state changes. Currently, the
state changes for non-focused objects are ignored.
Arguments:
- event: the Event
"""
# In java applications the events are comming in other order:
# "focus:" event comes before "state-changed:focused" event
#
if (event.type == "object:state-changed:focused"):
return
# Hand state changes when JTree labels become expanded
# or collapsed.
#
if ((event.source.role == rolenames.ROLE_LABEL) and \
(event.type == "object:state-changed:expanded")):
orca.visualAppearanceChanged(event, event.source)
return
# Present a value change in case of an focused popup menu.
# Fix for Swing file chooser.
#
if event.type == "object:state-changed:visible" and \
event.source.role == rolenames.ROLE_POPUP_MENU and \
event.source.parent.state.count(Accessibility.STATE_FOCUSED):
orca.setLocusOfFocus(event, event.source.parent)
return
default.Script.onStateChanged(self, event)
def onSelectionChanged(self, event):
"""Called when an object's selection changes.
Arguments:
- event: the Event
"""
if not event.source.state.count (atspi.Accessibility.STATE_FOCUSED):
return
if event.source.role == rolenames.ROLE_TABLE:
return
if event.source.role == rolenames.ROLE_TREE:
return
if event.source.role == rolenames.ROLE_LIST:
selection = event.source.selection
if selection.nSelectedChildren <= 0:
if event.source.childCount > 0:
child = event.source.child(0)
if child.state.count (atspi.Accessibility.STATE_ACTIVE):
return
else:
orca.setLocusOfFocus(event, event.source)
return
else:
selectedItem = atspi.Accessible.makeAccessible(
selection.getSelectedChild(0))
# If the selected list item is the same with the last focused object,
# present it only if the item was not selected and has SELECTED state
# or if the item doesn't have SELECTED state, but SELECTABLE and
# it was selected.
#
if util.isSameObject (selectedItem, orca_state.locusOfFocus):
if (orca_state.locusOfFocus.state.count(Accessibility.STATE_SELECTED) != 0 \
and not orca_state.locusOfFocus.was_selected) \
or (orca_state.locusOfFocus.state.count(Accessibility.STATE_SELECTED) == 0 \
and orca_state.locusOfFocus.state.count(Accessibility.STATE_SELECTABLE) != 0 \
and orca_state.locusOfFocus.was_selected):
orca.visualAppearanceChanged(event, selectedItem)
return
default.Script.onSelectionChanged(self, event)
def visualAppearanceChanged(self, event, obj):
"""Called when the visual appearance of an object changes. This
method should not be called for objects whose visual appearance
changes solely because of focus -- setLocusOfFocus is used for that.
Instead, it is intended mostly for objects whose notional 'value' has
changed, such as a checkbox changing state, a progress bar advancing,
a slider moving, text inserted, caret moved, etc.
Arguments:
- event: if not None, the Event that caused this to happen
- obj: the Accessible whose visual appearance changed.
"""
# Present to Braille and Speech an object that is the same
# with the last focused object, only if it is a label.
# This case is for LISTs which contain labels as items
# (see Open dialog lists).
#
if util.isSameObject (obj, orca_state.locusOfFocus):
if obj.role == rolenames.ROLE_LABEL:
self.updateBraille(orca_state.locusOfFocus)
speech.speakUtterances(self.speechGenerator.getSpeech(orca_state.locusOfFocus, True))
return
default.Script.visualAppearanceChanged(self, event, obj)
|