Viewing file:  planner.py (8.03 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.
"""Custom script for planner."""
__id__ = "$Id: planner.py,v 1.8 2006/06/10 00:54:48 wwalker Exp $"
__version__ = "$Revision: 1.8 $"
__date__ = "$Date: 2006/06/10 00:54:48 $"
__copyright__ = "Copyright (c) 2005-2006 Sun Microsystems Inc."
__license__ = "LGPL"
import orca.debug as debug
import orca.default as default
import orca.atspi as atspi
import orca.rolenames as rolenames
import orca.orca as orca
import orca.braille as braille
import orca.speech as speech
import orca.settings as settings
import orca.util as util
import orca.speechgenerator as speechgenerator
import orca.braillegenerator as braillegenerator
from orca.orca_i18n import _ # for gettext support
class BrailleGenerator(braillegenerator.BrailleGenerator):
#We make this to appropiately present
#ribbon's toggle button in a toolbar
# used to display in a menu those options that doesn
#fill in toolbar when the application is resized.
#
# Also for each one of the grphics buttons in the main window
def _getBrailleRegionsForToggleButton(self, obj):
"""Get the braille for a radio button. If the button already had
focus, then only the state is displayed.
Arguments:
- obj: the check box
Returns a list where the first element is a list of Regions to display
and the second element is the Region which should get focus.
"""
self._debugGenerator("_getBrailleRegionsForRadioButton", obj)
text = ""
text = util.appendString(text, util.getDisplayedLabel(obj))
text = util.appendString(text, util.getDisplayedText(obj))
# First special toggle button is the one in the toolbar and that it has no name
# Application should implement an accessible name in this component,
# but until this is made We speech/braille "display more options" when
# the focus is in one of these toggle buttons.
roleList=[rolenames.ROLE_TOGGLE_BUTTON,\
rolenames.ROLE_TOOL_BAR]
if util.isDesiredFocusedItem(obj, roleList) and not obj.name:
text += _("Display more options")
# Second special case is each one of the four graphics toggle
# buttons in the main window
# Application should implement an accessible relationship between the button
# and the label, but until this is made we append for each one the button
# the label that should be associated and its state (checked or not)
#
rolesList = [rolenames.ROLE_TOGGLE_BUTTON,\
rolenames.ROLE_FILLER,\
rolenames.ROLE_FILLER,\
rolenames.ROLE_PANEL,\
rolenames.ROLE_PANEL]
if util.isDesiredFocusedItem(obj, rolesList):
debug.println(debug.LEVEL_FINEST,
"planner.onFocus - main window: " \
+ "one of the four graphic toggle buttons.")
filler = obj.parent
allLabels = util.findByRole(filler, rolenames.ROLE_LABEL)
text += allLabels[0].name
if obj.state.count(atspi.Accessibility.STATE_CHECKED):
text = util.appendString(text, "&=y")
else:
text = util.appendString(text, "& y")
text = util.appendString(text, self._getTextForRole(obj))
regions = []
componentRegion = braille.Component(obj, text)
regions.append(componentRegion)
return [regions, componentRegion]
class SpeechGenerator(speechgenerator.SpeechGenerator):
#We make this to appropiately present
#ribbon's toggle button in a toolbar
# used to display in a menu those options that doesn
#fill in toolbar when the application is resized.
#
# Also for each one of the grphics buttons in the main window
def _getSpeechForToggleButton(self, obj, already_focused):
utterances=[]
tmp=[]
# Application should implement an accessible name in this component,
# but until this is made We speech/braille "display more options" when
# the focus is in one of these toggle buttons.
roleList=[rolenames.ROLE_TOGGLE_BUTTON,\
rolenames.ROLE_TOOL_BAR]
if util.isDesiredFocusedItem(obj, roleList) and not obj.name:
if not already_focused:
tmp.append(_("Display more options"))
tmp.extend(self._getDefaultSpeech(obj, already_focused))
if obj.state.count(atspi.Accessibility.STATE_CHECKED):
tmp.append(_("pressed"))
else:
tmp.append(_("not pressed"))
utterances.extend(tmp)
utterances.extend(self._getSpeechForObjectAvailability(obj))
else:
if obj.state.count(atspi.Accessibility.STATE_CHECKED):
utterances.append(_("pressed"))
else:
utterances.append(_("not pressed"))
return utterances
# Application should implement an accessible relationship between the button
# and the label, but until this is made we append for each one the button
# the label that should be associated and its state (checked or not)
roleList = [rolenames.ROLE_TOGGLE_BUTTON,\
rolenames.ROLE_FILLER,\
rolenames.ROLE_FILLER,\
rolenames.ROLE_PANEL,\
rolenames.ROLE_PANEL]
if util.isDesiredFocusedItem(obj, roleList):
debug.println(debug.LEVEL_FINEST,
"planner.onFocus - main window: " \
+ "one of the four graphic toggle buttons.")
if not already_focused:
filler = obj.parent
allLabels = util.findByRole(filler, rolenames.ROLE_LABEL)
tmp.append(allLabels[0].name)
tmp.extend(self._getDefaultSpeech(obj, already_focused))
if obj.state.count(atspi.Accessibility.STATE_CHECKED):
tmp.append(_("pressed"))
else:
tmp.append(_("not pressed"))
utterances.extend(tmp)
utterances.extend(self._getSpeechForObjectAvailability(obj))
else:
if obj.state.count(atspi.Accessibility.STATE_CHECKED):
utterances.append(_("pressed"))
else:
utterances.append(_("not pressed"))
return utterances
self._getSpeechForLabel(obj, already_focused)
########################################################################
# #
# The planner script class. #
# #
########################################################################
class Script(default.Script):
def __init__(self, app):
"""Creates a new script for the given application.
Arguments:
- app: the application to create a script for.
"""
default.Script.__init__(self, app)
# This method tries to detect and handle the following cases:
# 1) Toolbar: the last toggle button to show 'more options'
# 2) Main window: one of the four graphic toggle buttons.
def getBrailleGenerator(self):
return BrailleGenerator()
def getSpeechGenerator(self):
return SpeechGenerator()
|