| Server IP : 182.53.201.61 / Your IP : 216.73.217.175 Web Server : Apache/2.2.15 (Fedora) System : Linux km10.dyndns.org 2.6.31.5-127.fc12.i686.PAE #1 SMP Sat Nov 7 21:25:57 EST 2009 i686 User : apache ( 48) PHP Version : 5.3.3 Disable Function : NONE MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/lib/python2.6/site-packages/orca/ |
Upload File : |
z#Jc @ s! d Z d Z d Z d Z d Z d Z d d k Z d d k Z d d k Z d d k Z d d k
Z
d d k Z d d k Z d d k
Z
d d k Z d d k l Z d d k l Z d d
k l Z d d d YZ e g Z d
d d YZ e g Z d Z d e i f d YZ d S( s6 Utilities for obtaining speech utterances for objects.s $Id:$s $Revision:$s $Date:$s- Copyright (c) 2005-2009 Sun Microsystems Inc.t LGPLiN( t _( t ngettext( t C_t Pausec B s e Z d Z d Z RS( sJ A dummy class to indicate we want to insert a pause into an
utterance.c C s d S( N( ( t self( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt __init__- s ( t __name__t
__module__t __doc__R ( ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyR * s t LineBreakc B s e Z d Z d Z RS( sY A dummy class to indicate we want to break an utterance into
separate calls to speak.c C s d S( N( ( R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyR 5 s ( R R R R ( ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyR
2 s t _generatet SpeechGeneratorc B s e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d
Z d Z
d Z d
Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d d d g d Z d Z d Z d Z d Z d Z d! Z d" Z! d# Z" d$ Z# d% Z$ d& Z% d' Z& d( Z' d) Z( d* Z) d+ Z* d, Z+ d- Z, d. Z- d/ Z. d0 Z/ d1 Z0 d2 Z1 d3 Z2 d4 Z3 d5 Z4 d6 Z5 d7 Z6 d8 Z7 d9 Z8 d; d: Z: RS(< s Takes accessible objects and produces a string to speak for
those objects. See the generateSpeech method, which is the primary
entry point. Subclasses can feel free to override/extend the
speechGenerators instance field as they see fit.c C s t i i | | d d S( Nt speech( t generatort GeneratorR ( R t script( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyR K s c C s1 t i i | | | i | d <| i | d <d S( sC Other things to make available from the formatting string.
t voicet playN( R R t _addGlobalsR R ( R t globalsDict( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyR N s
c C sT y t i t i | } Wn0 t | t o t i | } qM d } n X| g S( s Returns an array containing a sound.Sound instance.
The key can a value to be used to look up a filename in the
settings.py:sounds dictionary (e.g., a pyatspi.ROLE_* value)
or just the name of an audio file to use.
N( t soundt Soundt settingst soundst
isinstancet
basestringt None( R t keyt soundBite( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyR U s
c K s | i | | S( N( t generate( R t objt args( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt generateSpeechd s c K sO g } | i d | i } | t i j o | i | i | | n | S( sw A convenience method to prevent the pyatspi.ROLE_PARAGRAPH role
from being spoken. In the case of a pyatspi.ROLE_PARAGRAPH
role, an empty array will be returned. In all other cases, the
role name will be returned as an array of strings (and
possibly voice and audio specifications). Note that a 'role'
attribute in args will override the accessible role of the
obj. [[[WDW - I wonder if this should be moved to
_generateRoleName. Or, maybe make a 'do not speak roles' attribute
of a speech generator that we can update and the user can
override.]]]
t role( t gett getRolet pyatspit ROLE_PARAGRAPHt extendt _generateRoleName( R R R t resultR" ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateTextRolem s
c K sO g } | i d | i } | t i j o | i t i | | n | S( s7 Returns the role name for the object in an array of strings (and
possibly voice and audio specifications), with the exception
that the pyatspi.ROLE_UNKNOWN role will yield an empty array.
Note that a 'role' attribute in args will override the
accessible role of the obj.
R" ( R# R$ R% t ROLE_UNKNOWNt appendt rolenamest getSpeechForRoleName( R R R R) R" ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyR( s
c K s | i | | S( sy Returns the role name for the object in an array of strings (and
possibly voice and audio specifications), with the exception
that the pyatspi.ROLE_UNKNOWN role will yield an empty array.
Note that a 'role' attribute in args will override the
accessible role of the obj. This is provided mostly as a
method for scripts to call.
( R( ( R R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt getRoleName s c K sL | i i | } g } x- | D]% } | i | | } | i | q W| S( s Returns, as an array of strings (and possibly voice
specifications), all the labels which are underneath the obj's
hierarchy and which are not in a label for or labelled by
relation.
( t _scriptt findUnrelatedLabelst
_generateNameR' ( R R R t labelsR) t labelt name( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateUnrelatedLabels s c K sE | i | | } | p( y | i | i i WqA qA Xn | S( s Returns an array of strings (and possibly voice and audio
specifications) used especially for handling embedded objects.
This either is the label or name of the object or the name of
the application for the object.
( t _generateLabelOrNameR, t getApplicationR5 ( R R R R) ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateEmbedded s c K sL g } | i i t i o) | i | i i i d d d d n | S( s
Returns an array of strings (and possibly voice and audio
specifications) that represent the multiselectable state of
the object. This is typically for check boxes. If the object
is not multiselectable, an empty array will be returned.
t modeR
t
stringTypet multiselect( t getStatet containsR% t STATE_MULTISELECTABLER, R0 t
formattingt getString( R R R R) ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateMultiselectableState s c K s{ g } | i i | } | pI | i | i | | i | i | | i | i i | nt i | } | d d j oD | d i d } | i t d h | d d 6| d d 6 n t d
| d } | i i | } | p | i i
| } n | o | d | 7} n | i | | i o8 | d i t
i j o | i | i | d n | S(
s Returns an array of strings (and possibly voice and audio
specifications) that represent the protocol of the URI of
the link associated with obj.
i t ftpt ftpst filei t /s %(uri)s link to %(file)st uriis %s linkt ( RC RD s file( R0 t getURIR' t _generateLabelR( R, t getDisplayedTextt urlparset splitR t getLinkBasenamet
childCountR$ R% t
ROLE_IMAGE( R R R R) t link_urit
link_uri_infot fileNamet
linkOutputt text( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateLinkInfo s,
$ c
K sU g } | i i | } | o t i | } n | S| i i } | ot i | } | d | d j oC | d | d j o | i t d qM| i t d qQ| d i d } | d i d } t | d j oN | d j oA | d | d j o, | d | d j o | i t d qQ| i t d n | S( s Returns an array of strings (and possibly voice and audio
specifications) that describe the site (same or different)
pointed to by the URI of the link associated with obj.
i i s same pages same sitet .iis different site( R0 RI RL t getDocumentFrameURIR, R RM t len(
R R R R) RQ RR t doc_urit doc_uri_infot
linkdomaint docdomain( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateSiteDescription s( c K s6 g } d } | i i | } | p | Sy= t i | } y | i d } Wn t j
o n XWn t t i t f j
o n X| o t | } | d j o! | i
t d d | | q2| d j o% | i
t d t
| d q2| d j o% | i
t d t
| d
q2n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the size (Content-length) of
the file pointed to by the URI of the link associated with
obj.
t s Content-lengthi' s %d bytes %d bytesi@B s %.2f kilobytesgMbP?s %.2f megabytesgư>( R0 RI t urllib2t urlopent infot KeyErrort
ValueErrort URLErrort OSErrort intR, R R t float( R R R R) t
sizeStringRG t xt size( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateFileSize/ s,
!
%
)c K sJ g } y | i } Wn n' Xt i | d <| i | i | | | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the image on the the object, if
it exists. Otherwise, an empty array is returned.
R" ( t
queryImageR% RP R' R ( R R R R) t image( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateImageX s
c
K s g } | oy| i d d } y
| i } Wn
d } n X| i t i j p# | i o&| i i t i j o
y | i } Wn
d } n X| oQ | i t i j p | i t i j o% | i i | } | i
| } n d } y | i i } Wn qX| i i | } | i
| } | d j o@ | | j o3 | | j p | i | j o | i | | } qqn | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the row header for an object
that is in a table, if it exists and if it is different from
the previous row header. Otherwise, an empty array is
returned. The previous row header is determined by looking at
the row header for the 'priorObj' attribute of the args
dictionary. The 'priorObj' is typically set by Orca to be the
previous object with focus.
t priorObjii N( R# R t parentR$ R% t ROLE_TABLE_CELLt
ROLE_TABLEt
queryTableR0 t getCellIndext
getRowAtIndext _generateRowHeader(
R R R R) Rp t priorParentt tablet indext oldRowt newRow( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateNewRowHeaderm s>
#
c
K s g } | o| i d t oy| i d d } y
| i } Wn
d } n X| i t i j p# | i o&| i i t i j o
y | i } Wn
d } n X| oQ | i t i j p | i t i j o% | i i
| } | i | } n d } y | i i } Wn qX| i i
| } | i | } | d j o@ | | j o3 | | j p | i | j o | i | | } qqn | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the column header for an object
that is in a table, if it exists and if it is different from
the previous column header. Otherwise, an empty array is
returned. The previous column header is determined by looking
at the column header for the 'priorObj' attribute of the args
dictionary. The 'priorObj' is typically set by Orca to be the
previous object with focus.
t
readingRowRp ii N(
R# t FalseR Rq R$ R% Rr Rs Rt R0 Ru t getColumnAtIndext _generateColumnHeader(
R R R R) Rp Rx Ry Rz t oldColt newCol( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateNewColumnHeader s>
#
c K s g } | i d | } | i | i | | | i | | | o5 t i o+ | i d t o | i t d n | S( sh Orca has a feature to automatically read an entire row of a table
as the user arrows up/down the roles. This leads to complexity in
the code. This method is used to return an array of strings
(and possibly voice and audio specifications) for a single table
cell itself. The string, 'blank', is added for empty cells.
t REAL_ROLE_TABLE_CELLR~ t blank(
t
_overrideRoleR' R t _restoreRoleR t speakBlankLinesR# R R, R ( R R R R) t oldRole( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateRealTableCell s c K s- g } t } d \ } } } | o9 | i } | i } | i o | i i } q[ n | t i j o* | t i j p | t i j o
t } n | o' t
i o t
i i d j o
t } n | t i
j o | t i j o
t } n | o5 | o. | i t i o | i t d d n | S( sj Returns an array of strings (and possibly voice and audio
specifications) if this is an icon within an layered pane or a
table cell within a table or a tree table and the item is
focused but not selected. Otherwise, an empty array is
returned. [[[WDW - I wonder if this string should be moved to
settings.py.]]]
t Leftt Rightt tablecells not selectedN( NNN( R R ( R R R$ R= Rq R% Rr t ROLE_TREE_TABLERs t Truet
orca_statet lastNonModifierKeyEventt event_stringt ROLE_ICONt ROLE_LAYERED_PANER> t STATE_SELECTEDR, R ( R R R R) t checkIfSelectedt objRolet
parentRolet state( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateUnselectedCell s.
c K s g } d } | i i t i j o
| i } n | i } y | i } Wn6 | i d t o | i i i d d } q n" X| i i | } | i
| } | d j o | i t d | d n | S( s Returns an array of strings (and possibly voice and audio
specifications) reflecting the column number of a cell.
it guessCoordinatest
lastColumni s column %di (
Rq R$ R% Rr Rt R# R R0 t pointOfReferenceRu R R, R ( R R R R) t colRq Ry Rz ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateColumn
s
c K s g } d } | i i t i j o
| i } n | i } y | i } Wn6 | i d t o | i i i d d } q n" X| i i | } | i
| } | d j o | i t d | d n | S( s Returns an array of strings (and possibly voice and audio
specifications) reflecting the row number of a cell.
iR t lastRowi s row %di (
Rq R$ R% Rr Rt R# R R0 R Ru Rv R, R ( R R R R) t rowRq Ry Rz ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateRow$ s
c K s g } | i i t i j o
| i } n | i } y | i } Wn
d } n X| i i | } | i | } | i | } | i
t d h | d d 6| i d 6 | i
t d h | d d 6| i
d 6 | S( s Returns an array of strings (and possibly voice and audio
specifications) reflecting the position of the cell in terms
of its column number, the total number of columns, its row,
and the total number of rows.
s column %(index)d of %(total)di Rz t totals row %(index)d of %(total)dN( Rq R$ R% Rr Rt R R0 Ru R Rv R, R t nColumnst nRows( R R R R) Rq Ry Rz R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateColumnAndRow; s$
c K s g } t i t i j o | i t i j o
| } n% | i i | t i g t i g } y | i i
} Wn q X| i i | } | i | } | i
| } | d | i j o+ | d | i j o | i t d q n | S( s Returns an array of strings (and possibly voice and audio
specifications) indicating that this cell is the last cell
in the table.
i s End of table( R t speechVerbosityLevelt VERBOSITY_LEVEL_VERBOSER$ R% Rr R0 t getAncestort
ROLE_FRAMERq Rt Ru Rv R R R R, R ( R R R R) t cellRy Rz R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateEndOfTableIndicatorY s"
(c K s` g } d } | i i | } | o
| i } n | p | i i | } n | i | | S( sS Returns an array of strings (and possibly voice and audio
specifications) used especially for handling terminal objects.
This either is the name of the frame the terminal is in or the
displayed label of the terminal. [[[WDW - it might be nice
to return an empty array if this is not a terminal.]]]
N( R R0 t getFrameR5 t getDisplayedLabelR, ( R R R R) t titlet frame( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateTerminal{ s
t stylet weightt underlinec C s d } | i } | i i | } | i | } | d o? | i i | d }
x& |
i D] } |
| | | <qa Wn | o]x | D]} t i | } | | j o | | }
t i |
} |
o | d j o5 t |
d j o | d 7} | t d 7} qq| d j o) |
d j o | d 7} | | 7} qq| d j o) |
d
j o | d 7} | | 7} qq| d 7} | | d | 7} qq q W| i i | | d j o | d 7} | t d 7} qn | S( sy Helper function that returns a string containing the
given attributes from keys for the given character.
R_ i R i RH t boldR t noneR t normalt link(
t getDefaultAttributesR0 t attributeStringToDictionaryt
getAttributest keyst text_attribute_namest getTextAttributeNameRg R t getLinkIndex( R R RU t
textOffsett lineIndexR t attribStrt defaultAttributest attributesDictionaryt charAttributest charDictR t localizedKeyt attributet localizedValue( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _getCharacterAttributes sF
c C s y | i i d SWn n X| i } | i } d } t } | i } | i i | \ } } | p | o% t } | i i | \ } } }
n | i | i t
i \ } } }
t | oZ | i
d } | i i | j o | i i | | |
} n | i i | } | } nN | i | t
i }
|
d d j o' | | j o t i o t d } n | | |
| g | i i d <| i i d S( s Returns [textContents, startOffset, endOffset, selected] as
follows:
A. if no text on the current line is selected, the current line
B. if text is selected, the selected text
C. if the current line is blank/empty, 'blank'
Also sets up a 'textInformation' attribute in
self._script.generatorCache to prevent computing this
information repeatedly while processing a single event.
t textInformationR_ s UTF-8i s
R ( R0 t generatorCachet queryTextt caretOffsetR t getNSelectionst hasTextSelectionsR t getAllSelectedTextt getTextAtOffsetR% t TEXT_BOUNDARY_LINE_STARTRY t decodet EMBEDDED_OBJECT_CHARACTERt
expandEOCst adjustForRepeatst TEXT_BOUNDARY_CHARR R R ( R R t textObjR t textContentst selectedt nSelectionst currentt othert startOffsett endOffsett linet unicodeTextt char( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _getTextInformation s:
c K s[ y | i } Wn t j
o g SX| i | \ } } } } | d j o g S| g S( s Returns an array of strings (and possibly voice and audio
specifications) containing the text content. This requires
_generateTextInformation to have been called prior to this method.
R_ ( R t NotImplementedErrorR ( R R R RU R R R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateTextContent s
c
K s: y | i } Wn t j
o g SX| i | \ } } } } d } d } | }
x t d t | D]} } | i | | |
| } | o: | | j o- | o | d 7} n | | 7} | d 7} n | } | | | 7} |
d 7}
qj W| i | | | d d g } | o# | o | d 7} n | | 7} n | g S( s; Returns an array of strings (and possibly voice and audio
specifications) containing the text content, obtained from the
'textInformation' value, with character attribute information
mixed in. This requires _generateTextInformation to have been
called prior to this method.
R_ i s ; RH i s paragraph-styleN( R R R R t rangeRY R (
R R R RU R R R R t newLinet lastAttribsR t it attribs( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt" _generateTextContentWithAttributes& s:
c K sL g } | i | \ } } } } | o t d d } | i | n | S( s Returns an array of strings (and possibly voice and audio
specifications) that says if any of the text for the entire
object is selected. [[[WDW - I wonder if this string should be
moved to settings.py.]]]
RU R ( R R R, ( R R R R) R R R R RU ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateAnyTextSelectionP s c K s g } y | i } Wn nr X| i } | d j oX | i d t i \ } } } | d j o) | t | j o t d d g } q n | S( s Returns an array of strings (and possibly voice and audio
specifications) that says if all the text for the entire
object is selected. [[[WDW - I wonder if this string should be
moved to settings.py.]]]
i i RU R ( R R R R% R RY R ( R R R R) R t noOfSelectionst stringR R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateAllTextSelectionc s
c K sq g } | i i | i d d } | i i | } | | j o* | d j o | i | i | | n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represents the tree node level of the
object, or an empty array if the object is not a tree node or
if the node level is not different from the 'priorObj'
'priorObj' attribute of the args dictionary. The 'priorObj'
is typically set by Orca to be the previous object with
focus.
Rp i N( R0 t getNodeLevelR# R R' t _generateNodeLevel( R R R R) t oldLevelt newLevel( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateNewNodeLevel s c K sh g } y | i } Wn t j
o n: X| i | i | i d } t d | } | i | | S( s Returns an array of strings (and possibly voice and audio
specifications) that represents the percentage value of the
object. This is typically for progress bars. [[[WDW - we
should consider returning an empty array if there is no value.
g Y@s
%d percent( t
queryValueR t currentValuet maximumValuet minimumValueR R, ( R R R R) t valuet percentValuet
percentage( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generatePercentage s
c K s, g } | i d d } | o | i t i j o d } t } | i } x | D] } | o) | i t i j o | i d } n | oa | i t i
j oK xH t d | i D]- } | i | }
|
| j o t
} Pq q WqT qT W| o$ | o | i | i i | q(n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represents the radio button group label
of the object, or an empty array if the object has no such
label or if the radio button group is not different from the
'priorObj' 'priorObj' attribute of the args dictionary. The
'priorObj' is typically set by Orca to be the previous object
with focus.
Rp i N( R# R R$ R% t ROLE_RADIO_BUTTONR t getRelationSett getRelationTypet RELATION_LABELLED_BYt getTargett RELATION_MEMBER_OFR t getNTargetsR R, R0 RK ( R R R R) Rp t radioGroupLabelt inSameGroupt relationst relationR t target( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateNewRadioButtonGroup s0
!c K sV g } | i i | } t | } | o' t d d | | } | i | n | S( s5 Returns an array of strings (and possibly voice and audio
specifications) that represents the number of children the
object has. [[[WDW - can we always return an empty array if
this doesn't apply?]]] [[[WDW - I wonder if this string should
be moved to settings.py.]]]
s %d items %d items( R0 t
getChildNodesRY R R, ( R R R R) t
childNodest childrent
itemString( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateNumberOfChildren s c K si g } t } x8 | D]0 } | i } | i t i o t } Pq q W| p | i t d n | S( sh Returns an array of strings (and possibly voice and audio
specifications) that says if this object has no showing
children (e.g., it's an empty table or list). object has.
[[[WDW - can we always return an empty array if this doesn't
apply?]]] [[[WDW - I wonder if this string should be moved to
settings.py.]]]
s 0 items( R R= R> R% t
STATE_SHOWINGR R, R ( R R R R) t hasItemst childR ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateNoShowingChildren s c K s+ g } | i p | i t d n | S( sh Returns an array of strings (and possibly voice and audio
specifications) that says if this object has no children at
all (e.g., it's an empty table or list). object has. [[[WDW
- can we always return an empty array if this doesn't
apply?]]] [[[WDW - I wonder if this string should be moved to
settings.py.]]]
s 0 items( RO R, R ( R R R R) ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateNoChildren s
c K s. g } | i d | i t i j o
| i } n | i } g } d } d } xo | D]g } | i } | i t i o | d 7} | i | n | i t i
o | i d } qW qW Wt d d | h | d 6| d 6}
| i |
| i | i
i i d d d
d h | d 6| d 6 | S( s Returns an array of strings (and possibly voice and audio
specifications) indicating how many items are selected in this
and the position of the current item. This object will be an icon
panel or a layered pane.
R" i i s$ %(index)d of %(total)d item selecteds% %(index)d of %(total)d items selectedRz R R: R
R; t iconindex( R# R$ R% R Rq RO R= R> R R, t
STATE_FOCUSEDt getIndexInParentR R0 R@ RA ( R R R R) RO t
selectedItemst totalSelectedItemst currentItemR R t countString( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateSelectedItemCount s6 "
c K s} g } | i d | i t i j o
| i } n xA | D]9 } | i i t i o | i | i | q< q< W| S( s Returns an array of strings (and possibly voice and audio
specifications) containing the names of all the selected items.
This object will be an icon panel or a layered pane.
R" (
R# R$ R% R Rq R= R> R R' t _generateLabelAndName( R R R R) R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateSelectedItems8 s "
c K sJ g } | i i | } | d j o! | i t d d | | n | S( s Returns an array of strings (and possibly voice and audio
specifications) that says how many unfocused alerts and
dialogs are associated with the application for this object.
[[[WDW - I wonder if this string should be moved to
settings.py.]]]
i s %d unfocused dialogs %d unfocused dialogs( R0 t getUnfocusedAlertAndDialogCountR, R ( R R R R) t alertAndDialogCount( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateUnfocusedDialogCountH s
c K s g } | i d d } | i d t } | i i | | } | | j o| i } | o9 | i t i j o# | i t i j o
| i } n x;| o/| i | j o | | j o Pn | i i | p | i i
| } | o; | p | o, d t i | j o | i i | } n | o t
| i oz | i t i t i g j o | i | i | n | i | | i t i j o | i | i | qqn | i } q Wn | i p | S( sE Returns an array of strings (and possibly voice and audio
specifications) that represent the text of the ancestors for
the object. This is typically used to present the context for
an object (e.g., the names of the window, the panels, etc.,
that the object is contained in). If the 'priorObj' attribute
of the args dictionary is set, only the differences in
ancestry between the 'priorObj' and the current obj will be
computed. The 'priorObj' is typically set by Orca to be the
previous object with focus.
Rp t requireTextt TextN( R# R R R0 t findCommonAncestorRq R$ R% Rr t isLayoutOnlyR t listInterfacesRK RY t stript ROLE_FILLERR' R( R, t reverse( R R R R) Rp R# t commonAncestorRq RU ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateAncestors_ s<
"c K s3 g } | i d d o | i | | } n | S( sw Returns an array of strings (and possibly voice and audio
specifications) that represent the text of the ancestors for
the object. This is typically used to present the context for
an object (e.g., the names of the window, the panels, etc.,
that the object is contained in). If the 'priorObj' attribute
of the args dictionary is set, only the differences in
ancestry between the 'priorObj' and the current obj will be
computed. Otherwise, no ancestry will be computed. The
'priorObj' is typically set by Orca to be the previous object
with focus.
Rp N( R# R R, ( R R R R) ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateNewAncestors s c K s | i d | i t i j o' | i d d d j o t d g S| i i t i j o
| i } n | i | i S( s Returns an array of strings (and possibly voice and audio
specifications) containing the role name of the parent of obj.
R" t
formatTypet
basicWhereAmIt detailedWhereAmIs
Icon panelN( R/ R0 ( R# R$ R% R R R Rq Rr R( ( R R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateParentRoleName s "
c K se g } | i i | t i g t i g } | o0 | i | i | | i | i | n | S( s Returns an array of strings (and possibly voice and audio
specifications) containing the name and role of the toolbar
which contains obj.
( R0 R R% t
ROLE_TOOL_BARR R' R R( ( R R R R) t ancestor( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateToolbar s c
K s g } d } d } | i } xy | D]q } | i t i j oU | i } xF t d | D]1 } | i | } | | j o | | } Pq] q] Wq% q% W| d j o; | i | i i i
d d d d h | d 6| d 6 n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the relative position of an
object in a group.
ii R: R
R; t
groupindexRz R ( R R R% R R R R R, R0 R@ RA (
R R R R) t positionR R R R R
( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generatePositionInGroup s*
c K s g } d } d } d } | i | } | i d | i } | t i j o | d } n | t i t i t i t i t i g j o
| i
} n | t i j ou | i
} x_ | i D]Q }
|
i
t i j o5 |
i d } y | i
i Wn n X| } Pq q W| } n
| i
} | i i | } t | } xF t d | D]5 }
| i | |
} | | j o |
d } PqQqQW| p x | D] } | i | } | i } | p% | d d j p | i t i o qn | d 7} | d 7} | | j o
| } qqWn t i p | i d t oH | d j o; | i | i i i d d
d d h | d
6| d 6 n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the relative position of an
object in a list.
ii R" i R_ t Emptyt separatort forceListR: R
R; R5 Rz R ( R_ R8 R9 ( R2 R# R$ R% t ROLE_COMBO_BOXt
ROLE_PAGE_TABt ROLE_MENUt ROLE_MENU_ITEMt ROLE_CHECK_MENU_ITEMt ROLE_RADIO_MENU_ITEMRq t ROLE_LIST_ITEMR R t RELATION_NODE_CHILD_OFR Rt R0 R RY R R= R> t
STATE_VISIBLER t enablePositionSpeakingR R, R@ RA ( R R R R) R6 Rz R R5 R" Rq R R
R
R t childNameR t nextR ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generatePositionInList st
c K su g } | i i | } | oR | i i t i o9 | i | } | o | i t d | d qq n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the default button in a dialog.
This method should initially be called with a top-level window.
s Default button is %si ( R0 t findDefaultButtonR= R> R% t STATE_SENSITIVER2 R, R ( R R R R) t buttonR5 ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateDefaultButton& s #c K s | i | | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the default button of the window
containing the object.
( RK ( R R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt generateDefaultButton7 s c K su g } | i i | } | oR | i | } | o | i | qq x( | D] } | i | i | qM Wn | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the status bar of a window.
This method should initially be called with a top-level window.
( R0 t
findStatusBarR2 R' ( R R R R) t statusBarR5 R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateStatusBar> s c K s | i | | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the status bar of the window
containing the object.
( RO ( R R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt generateStatusBarN s c K s g } | i i | \ } } | o | i | i | n | o | i | i | n | i i | } | d j o! | i t d d | | n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the title of the window, obj.
containing the object, along with information associated with
any unfocused dialog boxes.
i s %d unfocused dialogs %d unfocused dialogs( R0 t findFrameAndDialogR, R R R ( R R R R) R t dialogR! ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt
generateTitleU s
c K s= g } | i i | \ } } } | o | i | n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the accelerator for the object,
or an empty array if no accelerator can be found.
( R0 t
getKeyBindingR, ( R R R R) t mnemonict shortcutt accelerator( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateAcceleratorr s
c K s g } t i p | i d t oa | i i | \ } } } | o | d } n | o | o
| } n | o
| g } q n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the mnemonic for the object, or
an empty array if no mnemonic can be found.
t
forceMnemonici( R t enableMnemonicSpeakingR# R R0 RT ( R R R R) RU RV RW ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateMnemonic} s
c K s g } | i d t } | i d t } | i | i i i | | | | i d | i t i j ob | i d d d j oI | i i | \ } } | o& | i | i i i | | | q n | S( s Returns an array of strings (and possibly voice and audio
specifications) that represent the tutorial for the object.
The tutorial will only be generated if the user has requested
tutorials, and will then be generated according to the
tutorial generator. A tutorial can be forced by setting the
'forceTutorial' attribute of the args dictionary to True.
t alreadyFocusedt
forceTutorialR" R. t unfocusedR/ (
R# R R' R0 t tutorialGeneratort getTutorialR$ R% R RQ ( R R R R) R\ R] R RR ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateTutorial s
"c K s t S( N( t PAUSE( R R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generatePause s c K s t S( N( t
LINE_BREAK( R R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt _generateLineBreak s c C s2 y t i | } Wn t i t i } n X| g S( s Returns an array containing a voice. The key is a value
to be used to look up the voice in the settings.py:voices
dictionary.
( R t voicest
DEFAULT_VOICE( R R R ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyR s
N(; R R R R R R R! R* R( R/ R6 R9 RB RV R^ Rl Ro R} R R R R R R R R R R R R R R R R R R R R R R R" R, R- R1 R4 R7 RG RK RL RO RP RS RX R[ Ra Rc Re R R ( ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyR C sp
3 / ) . . 1 " 9 B * $ * + R ( ( ( R t __id__t __version__t __date__t
__copyright__t __license__RL R` R R R% R- R R R t orca_i18nR R R R Rb R
Rd t
METHOD_PREFIXR R ( ( ( s9 /usr/lib/python2.6/site-packages/orca/speech_generator.pyt <module> s,