Mini Shell
3
�p5[�z � @ s> d Z dZdZdZdZdZddlZddlZddlZddl Z ddl
Z
ddl Z ddl Z ddl
Z
ddlmZ dd lmZ d
d lmZ d
d lmZ d
d
lmZ d
dlmZ d
dlmZ d
dlmZ d
dlmZ d
dlmZ d
dlmZ d
dlmZ d
dlm Z d
dlm Z d
dlm Z d
dlm Z d
dlm Z e j!� Z"G dd� d�Z#dS ) z�Commonly-required utility methods needed by -- and potentially
customized by -- application and toolkit scripts. They have
been pulled out from the scripts because certain scripts had
gotten way too large as a result of including these methods.z$Id$z
$Revision$z$Date$z#Copyright (c) 2010 Joanmarie Diggs.ZLGPL� N)�Gdk)�Gtk� )�chnames)�
colornames)�debug)�keynames)� keybindings)� input_event)� mathsymbols)�messages)�orca)�
orca_state)�object_properties)�pronunciation_dict)�settings)�settings_manager)�text_attribute_namesc
@ s� e Zd Zejjd�ZdZddddddd d
d d g
Zd
dddddddddg
Z e
j Z e
j
de �Ze
j
ddje� e �Ze
j
ddje � e �ZdZdZd Zd Zd Zd d � Zd!d"� Zed#d$� �Zd%d&� Zd'd(� Z ed)d*� �Z d+d,� Z d-d.� Z d/d0� Z d1d2� Z!d3d4� Z"d5d6� Z#�d�d8d9�Z$d:d;� Z%ed<d=� �Z&d>d?� Z'd@dA� Z(dBdC� Z)dDdE� Z*�d�dFdG�Z+dHdI� Z,dJdK� Z-dLdM� Z.dNdO� Z/dPdQ� Z0dRdS� Z1dTdU� Z2dVdW� Z3dXdY� Z4dZd[� Z5d\d]� Z6d^d_� Z7d`da� Z8dbdc� Z9ddde� Z:dfdg� Z;dhdi� Z<djdk� Z=dldm� Z>dndo� Z?dpdq� Z@drds� ZAdtdu� ZBdvdw� ZCdxdy� ZDdzd{� ZEd|d}� ZFd~d� ZGd�d�� ZHd�d�� ZId�d�� ZJd�d�� ZKd�d�� ZLd�d�� ZMd�d�� ZNd�d�� ZOd�d�� ZPd�d�� ZQd�d�� ZRd�d�� ZSd�d�� ZTd�d�� ZUd�d�� ZVd�d�� ZWd�d�� ZXd�d�� ZYd�d�� ZZd�d�� Z[d�d�� Z\d�d�� Z]d�d�� Z^d�d�� Z_d�d�� Z`d�d�� Zad�d�� Zb�d�d�d��Zcd�d�� Zdd�d�� Zed�d�� Zfd�d�� Zgd�d�� Zhd�dÄ Zid�dń Zjd�dDŽ Zkd�dɄ Zld�d˄ Zmd�d̈́ Znd�dτ Zod�dф Zpd�dӄ Zqd�dՄ Zrd�dׄ Zsd�dل Ztd�dۄ Zud�d݄ Zvd�d߄ Zwd�d� Zxd�d� Zyd�d� Zzd�d� Z{d�d� Z|d�d� Z}d�d� Z~d�d� Zd�d� Z�d�d� Z�d�d�� Z��d�d�d��Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z��d �d� Z��d�d� Z��d�d� Z��d�d� Z��d��d�d �Z��d
�d � Z��d �d
� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d �d � Z��d �d � Z��d �d!� Z��d"�d#� Z��d$�d%� Z��d&�d'� Z�e�d(�d)� �Z��d*�d+� Z��d,�d-� Z��d.�d/� Z��d0�d1� Z��d��d3�d4�Z��d5�d6� Z�e�d7�d8� �Z��d9�d:� Z�e�d;�d<� �Z�e�d=�d>� �Z��d?�d@� Z��dA�dB� Z��d��dC�dD�Z��dE�dF� Z��dG�dH� Z��d��dI�dJ�Z�e�dK�dL� �Z��dM�dN� Z��dO�dP� Z��dQ�dR� Z��dS�dT� Z��dU�dV� Z��dW�dX� Z��dY�dZ� Z��d��d[�d\�Z�e�d��d]�d^��Z�e�d��d_�d`��Z�e�da�db� �Z�e�dc�dd� �Z��de�df� Z��dg�dh� Z��d��dj�dk�Z��dl�dm� Z��dn�do� Z��dp�dq� Z�e�dr�ds� �Z��dt�du� Z��dv�dw� Zdx�dy� Z�e�dz�d{� �ZĐd|�d}� Z�e�d~�d� �ZƐd��d��d��Zǐd��d�� ZȐd��d�� Zɐd��d�� Zʐd��d�� Zːd��d��d��Z̐d��d�� Z͐d��d�� Zΐd��d�� Zϐd��d�� ZАd��d�� Zѐd��d�� ZҐd��d��d��ZӐd��d�� ZԐd��d�� ZՐd��d�� Zd��d�� Zאd��d��d��Zؐd��d�� Zِd��d�� Zڐd��d��d��Zېd��d�� Z�e�d��d�� �Z�e�d��d�� �Zސd��d�� Zߐd��d�� Z�d��d�� Z�d��d�� Z�e�d��d�� �Z�e�d��d��d���Z�d��d�� Z�d��d�� Z�ddÄ Z�d��dĐdńZ�dƐdDŽ Z�dȐdɄ Z�e�dʐd˄ �Z�e�d̐d̈́ �Z�e�dΐdτ �Z�e�dАdф �Z�dҐdӄ Z�e�dԐdՄ �Z�ddׄ Z�e�dؐdل �Z�d��dڐdۄZ�d��dܐd݄Z�dÐdސd߄Z��dŐd�d�Z��d�d� Z�e�d�d� �Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d�� �Z �d��d�� �Z�d��d�� �Z�d��d�� �Z�d��d�� �Z�d��d�� �Z�d �d� �Z�d�d� �Z�d�d� �Z�d�d� �Z �d�d � �Z
�d
�d � �Z �d �d
� �Z �d�d� �Z
�d�d� �Z�d�d� �Z�d�d� �Z�dƐd�d��Z�d�d� �Z�d�d � �Z�dǐd �d ��Z�d �d � �Z�dȐd!�d"��Z�d#�d$� �Z�d%�d&� �Z�d'�d(� �Z�d)�d*� �Z�dɐd+�d,��Z�d-�d.� �Z �d/�d0� �Z �d1�d2� �Z �d3�d4� �Z �d5�d6� �Z �d7�d8� �Z!�d9�d:� �Z"�d;�d<� �Z#�d=�d>� �Z$�d?�d@� �Z%�dA�dB� �Z&�dC�dD� �Z'�dE�dF� �Z(e�dG�dH� ��Z)�dI�dJ� �Z*�dK�dL� �Z+�dM�dN� �Z,�dO�dP� �Z-�dQ�dR� �Z.�dS�dT� �Z/�dU�dV� �Z0�dW�dX� �Z1�dY�dZ� �Z2�d[�d\� �Z3�d]�d^� �Z4�d_�d`� �Z5�da�db� �Z6�dc�dd� �Z7�de�df� �Z8�dg�dh� �Z9�di�dj� �Z:�dk�dl� �Z;�dm�dn� �Z<�do�dp� �Z=�dq�dr� �Z>�ds�dt� �Z?�du�dv� �Z@�dw�dx� �ZA�dy�dz� �ZB�d{�d|� �ZC�d}�d~� �ZD�d�d�� �ZE�dʐd��d���ZF�d��d�� �ZG�d��d�� �ZH�d��d�� �ZI�d��d�� �ZJ�d��d�� �ZK�d��d�� �ZL�d��d�� �ZM�d��d�� �ZN�d��d�� �ZO�d��d�� �ZP�d��d�� �ZQ�dːd��d���ZR�d��d�� �ZS�d��d�� �ZT�d��d�� �ZU�d��d�� �ZV�d��d�� �ZW�d��d�� �ZX�d��d�� �ZY�d��d�� �ZZd7S (� � Utilitiesr u u ⁰� ¹� ²� ³u ⁴u ⁵u ⁶u ⁷u ⁸u ⁹u ₀u ₁u ₂u ₃u ₄u ₅u ₆u ₇u ₈u ₉z(\W+)z[%s]+� �displayedLabel�
displayedTextZ
keyBinding� nestingLevel� nodeLevelc C s || _ d| _i | _dS )z�Creates an instance of the Utilities class.
Arguments:
- script: the script with which this instance is associated.
N)�_script�_clipboardHandlerId�_selectedMenuBarMenu)�self�script� r" �&/usr/lib/python3.6/script_utilities.py�__init__[ s zUtilities.__init__c
C s\ y |j � }W n" d| }tjtj|d� dS |jtj�s@dS |jtj�rPdS |jtj�S )Nz$ERROR: Exception getting state of %sTF) �getStater �println�
LEVEL_INFO�contains�pyatspi� STATE_ACTIVEZSTATE_ICONIFIED�
STATE_SHOWING)r �obj�state�msgr" r" r# �"_isActiveAndShowingAndNotIconifiedl s z,Utilities._isActiveAndShowingAndNotIconifiedc C s: | sdS | j � }ytjd| �}W n
dS |jdd�S )Nr zcat /proc/%s/cmdline� � )Zget_process_id�
subprocessZ getoutput�replace)�app�pidZcmdliner" r" r# �_getAppCommandLine| s z Utilities._getAppCommandLinec C s� |sdS y |j � }W n d }Y nX d||| j|�f }tjtj|d� |j� | j|�sxd| }tjtj|d� dS d| }tjtj|d� dS )NFz INFO: Looking at %s from %s %sTz3INFO: %s is not active and showing, or is iconifiedz INFO: %s can be active window)�getApplicationr6 r r& r' �
clearCacher/ )r �windowr4 r. r" r" r# �canBeActiveWindow� s
zUtilities.canBeActiveWindowc s g }|p� j � }xN|D ]F}y |j� fdd�|D �� W q d| }tjtj|d� Y qX qW |s�dttt|�� }tjtj|d� dS t|�dkr�d|d }tjtj|d� |d S t |t
j � j �d
�}d ttt|�� }tjtj|d� d |d }tjtj|d� |d S )
z:Tries to locate the active window; may or may not succeed.c s g | ]}� j |�r|�qS r" )r: )�.0�child)r r" r# �
<listcomp>� s z*Utilities.activeWindow.<locals>.<listcomp>z)ERROR: Exception examining children of %sTz+ERROR: Unable to find active window from %sNr zINFO: Active window is %sr )�keyz1WARNING: These windows all claim to be active: %sz%INFO: Active window is (hopefully) %s)
�knownApplications�extendr r& r' �list�map�str�len�sorted� functools�
cmp_to_key�sizeComparison)r ZappsZ
candidatesr4 r. r" )r r# � activeWindow� s,
zUtilities.activeWindowc C s� | sdS t |g j�s|g}t |g j�s,|g}d}| j} xP| r�| | jkr�y | j� }W n P Y nX ||krr| }P q8||kr~P q8| j} q8W |S )ac Returns the object of the specified roles which contains the
given object, or None if the given object is not contained within
an object the specified roles.
Arguments:
- obj: the Accessible object
- ancestorRoles: the list of roles to look for
- stopRoles: the list of roles to stop the search at
N)�
isinstance� __class__�parent�getRole)r, Z
ancestorRoles� stopRoles�ancestor�roler" r" r# �ancestorWithRole� s(
zUtilities.ancestorWithRolec C sJ yt dd� |j� D ��}W n i }Y nX |jd�}|rBt|�S |j� S )a Returns the index of the cell which should be used with the
table interface. This is necessary because in some apps we
cannot count on getIndexInParent() returning the index we need.
Arguments:
-obj: the table cell whose index we need.
c S s g | ]}|j d d��qS )�:r )�split)r; �attrr" r" r# r= � s z'Utilities.cellIndex.<locals>.<listcomp>ztable-cell-index)�dict�
getAttributes�get�int�getIndexInParent)r r, �attrs�indexr" r" r# � cellIndex� s
zUtilities.cellIndexc C sp y|j j� }W n
g S |j� jtj�s.g S g }|j� }y^xX|D ]P}|j� tjkrBx8t |j
� �D ](}|j |�}|rb|j � dkrb|j
|� qbW |S qBW W n Y nX | j|�}|j|�} |j|�}
| j|�} d} x�t | d |j�D ]�}
|j|
|
�}|� s�q�|j� }x\|D ]T}|j� tjk�r
|j d�}| j||��rB|j
|� n| j|�}|| k�rZd} P �q
W | r�P q�W |S )z�Gets all of the children that have RELATION_NODE_CHILD_OF pointing
to this expanded table cell.
Arguments:
-obj: the Accessible Object
Returns: a list of all the child nodes
r Fr T���)rL �
queryTabler% r( r) �STATE_EXPANDED�getRelationSet�getRelationType�RELATION_NODE_PARENT_OF�range� getNTargets� getTargetrY �appendr\ �
getRowAtIndex�getColumnAtIndexr �nRows�getAccessibleAt�RELATION_NODE_CHILD_OF� isSameObject)r r, �table�nodes� relations�relation�target�noder[ �row�colr �done�i�cellZnodeOfZ currentLevelr" r" r# �
childNodes� sT
zUtilities.childNodesc
C sV d||f }t jt j|d� |o"|s(dS ||kr4|S |g}y6|j}x"|rd|j|krd|j|� |j}qDW |j� W n t jt j� Y nX |g}y6|j}x"|r�|j|kr�|j|� |j}q�W |j� W n t jt j� Y nX d}tt |�t |��}d} x8| |k �r2| j
|| || ��r.|| }| d7 } q�P q�W d|||f }t jt j|d� |S )z�Finds the common ancestor between Accessible a and Accessible b.
Arguments:
- a: Accessible
- b: Accessible
z.INFO: Looking for common ancestor of %s and %sTNr r z(INFO: Common ancestor of %s and %s is %s) r r& r' rL rf �reverse�printExceptionZ LEVEL_FINEST�minrD rl )
r �a�br. ZaParentsrL ZbParents�commonAncestorZ maxSearchrv r" r" r# r~ C sF
zUtilities.commonAncestorc C s� t jt jt jg}|j� jt j�s,|j� |kr0dS d}xnt|j d dd�D ]X}|| j� t j
kr||| j� jt j �r||| }n || j� |kr�| j || �}|rHP qHW |S )z�Returns the default button in the dialog which contains obj.
Arguments:
- obj: the top-level object (e.g. window, frame, dialog) for
which the status bar is sought.
Nr r] r] )
r) � ROLE_TREE�ROLE_TREE_TABLE�
ROLE_TABLEr% r( �STATE_MANAGES_DESCENDANTSrM rc �
childCount�ROLE_PUSH_BUTTONZSTATE_IS_DEFAULT�
defaultButton)r r, � skipRolesr� rv r" r" r# r� y s
zUtilities.defaultButtonc C s� y| j j| j | S | j| j jkr6i | j j| j< d}Y nX | j|�}x |D ]}| j|| j|��}qPW || j j| j |< | j j| j | S )aX If there is an object labelling the given object, return the
text being displayed for the object labelling this object.
Otherwise, return None.
Argument:
- obj: the object in question
Returns the string of the object labelling this object, or None
if there is nothing of interest here.
N)r �generatorCache�DISPLAYED_LABEL�labelsForObject� appendStringr )r r, Z labelString�labels�labelr" r" r# r � s
zUtilities.displayedLabelc C s^ y| j j| j | S d}Y nX y|j� }|j}W n, d| }tjtj|d� d}d}Y nX |tj krv|rv|S y|j
� }|j d|j �}W n Y nX | j
|kr�d}|s�y
|j}W n ttfk
r� Y nX | o�|tj tjgk�r | j|�}|�s
| j|dd�}djt| j|��}| j| j jk�r:i | j j| j< || j j| j |< | j j| j | S ) z�Returns the text being displayed for an object.
Arguments:
- obj: the object
Returns the text being displayed for an object or None if there isn't
any text being shown.
Nz,ERROR: Exception getting role and name of %sTr r F)� onlyShowingr1 )r r� �DISPLAYED_TEXTrM �namer r& r' r) r� � queryText�getText�characterCount�EMBEDDED_OBJECT_CHARACTER� LookupError� RuntimeError�ROLE_LIST_ITEM�unrelatedLabels�joinrB r )r r, r rP r� r. �textr� r" r" r# r � sF
zUtilities.displayedTextNc C sj |s| j � \}}tjtjtjtjtjtjg}tjtj g}| j
|||�}| rft j rft j j
� |krft j S |S )zyReturns the document frame which is displaying the content.
Note that this is intended primarily for web content.)�getCaretContextr) �ROLE_DOCUMENT_EMAIL�ROLE_DOCUMENT_FRAME�ROLE_DOCUMENT_PRESENTATION�ROLE_DOCUMENT_SPREADSHEET�ROLE_DOCUMENT_TEXT�ROLE_DOCUMENT_WEB�
ROLE_FRAME�ROLE_SCROLL_PANErQ r � locusOfFocusrM )r r, �offsetZdocRolesrN �documentr" r" r# �
documentFrame� s zUtilities.documentFramec C s dS )z5Returns the URI of the document frame that is active.Nr" )r r" r" r# �documentFrameURI s zUtilities.documentFrameURIc
C sR | sdS | j � jtj�r | S x0| D ](}ytj|�}|r:|S W q" Y q"X q"W dS )a* Returns the accessible that has focus under or including the
given root.
TODO: This will currently traverse all children, whether they are
visible or not and/or whether they are children of parents that
manage their descendants. At some point, this method should be
optimized to take such things into account.
Arguments:
- root: the root object where to start searching
Returns the object with the FOCUSED state or None if no object with
the FOCUSED state can be found.
N)r% r( r) �
STATE_FOCUSEDr �
focusedObject)�rootr< � candidater" r" r# r� s
zUtilities.focusedObjectc C s^ ddg}|j }xJ|rX|j |krX|j� tjkr4||d< |j� tjtjgkrP||d< |j }qW |S )z;Returns the frame and (possibly) the dialog containing obj.Nr r )rL rM r) r� � ROLE_DIALOGZROLE_FILE_CHOOSER)r r, �resultsrL r" r" r# �frameAndDialog( s
zUtilities.frameAndDialogc C s dS )NFr" )r �eventr" r" r# � presentEventFromNonShowingObject8 s z*Utilities.presentEventFromNonShowingObjectc C s* |r&|j � tjkr&| j|tj� r&dS dS )ay Whether or not we should perform a grabFocus before routing
the cursor via the braille cursor routing keys.
Arguments:
- obj: the accessible object where the cursor should be routed
- offset: the offset to which it should be routed
Returns True if we should do an explicit grabFocus on obj prior
to routing the cursor.
TF)rM r) �ROLE_COMBO_BOXrl r r� )r r, r� r" r" r# �grabFocusBeforeRouting; s z Utilities.grabFocusBeforeRoutingc
C s~ |}xt|D ]l}|dkrdS t |t�s*|g}y$t |d t�rD|j� }n|j� }W n d}Y nX ||krldS | j|�}q
W dS )a� Called to determine if the given object and it's hierarchy of
parent objects, each have the desired roles. Please note: You
should strongly consider an alternative means for determining
that a given object is the desired item. Failing that, you should
include only enough of the hierarchy to make the determination.
If the developer of the application you are providing access to
does so much as add an Adjustment to reposition a widget, this
method can fail. You have been warned.
Arguments:
- obj: the accessible object to check.
- rolesList: the list of desired roles for the components and the
hierarchy of its parents.
Returns True if all roles match.
NFr T)rJ rA rC Z getRoleNamerM � validParent)r r, Z rolesListZcurrentrP Z current_roler" r" r# �hasMatchingHierarchyM s
z Utilities.hasMatchingHierarchyc C sL |s
t j}y |j� }W n
dS |tjkr0dS dd� }tj||�}|dk S )zyReturns True if the given object is in the Find toolbar.
Arguments:
- obj: an accessible object
Fc S s | o| j � tjkS )N)rM r) Z
ROLE_TOOL_BAR)�xr" r" r# �<lambda>� s z)Utilities.inFindToolbar.<locals>.<lambda>N)r r� rM r) �
ROLE_ENTRY� findAncestor)r r, rP Z isToolbarZtoolbarr" r" r# �
inFindToolbarv s
zUtilities.inFindToolbarc C s dS )NFr" )r r, r" r" r# �isAnchor� s zUtilities.isAnchorc C s dS )NFr" )r r, r" r" r# � isComboBoxWithToggleDescendant� s z(Utilities.isComboBoxWithToggleDescendantc C s dS )NFr" )r r, r" r" r# � isToggleDescendantOfComboBox� s z&Utilities.isToggleDescendantOfComboBoxc C s dS )NFr" )r r, r" r" r# � isTypeahead� s zUtilities.isTypeaheadc C s dS )z�Returns True if the window is a functioning as a dialog.
This method should be subclassed by application scripts as
needed.
Fr" )r r, r" r" r# �isFunctionalDialog� s z Utilities.isFunctionalDialogc C s dS )NFr" )r r, r" r" r# �isEmpty� s zUtilities.isEmptyc C s dS )NFr" )r r, r" r" r# �isHidden� s zUtilities.isHiddenc C s dS )NFr" )r r, r" r" r# �isDPub� s zUtilities.isDPubc C s dS )NFr" )r r, r" r" r# �isDPubAbstract� s zUtilities.isDPubAbstractc C s dS )NFr" )r r, r" r" r# �isDPubAcknowledgments� s z Utilities.isDPubAcknowledgmentsc C s dS )NFr" )r r, r" r" r# �isDPubAfterword� s zUtilities.isDPubAfterwordc C s dS )NFr" )r r, r" r" r# �isDPubAppendix� s zUtilities.isDPubAppendixc C s dS )NFr" )r r, r" r" r# �isDPubBibliography� s z Utilities.isDPubBibliographyc C s dS )NFr" )r r, r" r" r# �isDPubBacklink� s zUtilities.isDPubBacklinkc C s dS )NFr" )r r, r" r" r# �isDPubBiblioref� s zUtilities.isDPubBibliorefc C s dS )NFr" )r r, r" r" r# �
isDPubChapter� s zUtilities.isDPubChapterc C s dS )NFr" )r r, r" r" r# �isDPubColophon� s zUtilities.isDPubColophonc C s dS )NFr" )r r, r" r" r# �isDPubConclusion� s zUtilities.isDPubConclusionc C s dS )NFr" )r r, r" r" r# � isDPubCover� s zUtilities.isDPubCoverc C s dS )NFr" )r r, r" r" r# � isDPubCredit� s zUtilities.isDPubCreditc C s dS )NFr" )r r, r" r" r# �
isDPubCredits� s zUtilities.isDPubCreditsc C s dS )NFr" )r r, r" r" r# �isDPubDedication� s zUtilities.isDPubDedicationc C s dS )NFr" )r r, r" r" r# �
isDPubEndnote� s zUtilities.isDPubEndnotec C s dS )NFr" )r r, r" r" r# �isDPubEndnotes� s zUtilities.isDPubEndnotesc C s dS )NFr" )r r, r" r" r# �isDPubEpigraph� s zUtilities.isDPubEpigraphc C s dS )NFr" )r r, r" r" r# �isDPubEpilogue� s zUtilities.isDPubEpiloguec C s dS )NFr" )r r, r" r" r# � isDPubErrata� s zUtilities.isDPubErratac C s dS )NFr" )r r, r" r" r# �
isDPubExample� s zUtilities.isDPubExamplec C s dS )NFr" )r r, r" r" r# �isDPubFootnote� s zUtilities.isDPubFootnotec C s dS )NFr" )r r, r" r" r# �isDPubForeword� s zUtilities.isDPubForewordc C s dS )NFr" )r r, r" r" r# �isDPubGlossary� s zUtilities.isDPubGlossaryc C s dS )NFr" )r r, r" r" r# �isDPubGlossref� s zUtilities.isDPubGlossrefc C s dS )NFr" )r r, r" r" r# � isDPubIndex� s zUtilities.isDPubIndexc C s dS )NFr" )r r, r" r" r# �isDPubIntroduction� s z Utilities.isDPubIntroductionc C s dS )NFr" )r r, r" r" r# �isDPubPagelist� s zUtilities.isDPubPagelistc C s dS )NFr" )r r, r" r" r# �isDPubPagebreak� s zUtilities.isDPubPagebreakc C s dS )NFr" )r r, r" r" r# �
isDPubPart� s zUtilities.isDPubPartc C s dS )NFr" )r r, r" r" r# �
isDPubPreface s zUtilities.isDPubPrefacec C s dS )NFr" )r r, r" r" r# �isDPubPrologue s zUtilities.isDPubProloguec C s dS )NFr" )r r, r" r" r# �isDPubPullquote s zUtilities.isDPubPullquotec C s dS )NFr" )r r, r" r" r# � isDPubQna
s zUtilities.isDPubQnac C s dS )NFr" )r r, r" r" r# �isDPubSubtitle
s zUtilities.isDPubSubtitlec C s dS )NFr" )r r, r" r" r# � isDPubToc s zUtilities.isDPubTocc C s dS )NFr" )r r, r" r" r# �isFeed s zUtilities.isFeedc C s dS )NFr" )r r, r" r" r# �isFigure s zUtilities.isFigurec C s dS )NFr" )r r, r" r" r# �
isLandmark s zUtilities.isLandmarkc C s dS )NFr" )r r, r" r" r# �isLandmarkBanner s zUtilities.isLandmarkBannerc C s dS )NFr" )r r, r" r" r# �isLandmarkComplementary s z!Utilities.isLandmarkComplementaryc C s dS )NFr" )r r, r" r" r# �isLandmarkContentInfo" s z Utilities.isLandmarkContentInfoc C s dS )NFr" )r r, r" r" r# �isLandmarkForm% s zUtilities.isLandmarkFormc C s dS )NFr" )r r, r" r" r# �isLandmarkMain( s zUtilities.isLandmarkMainc C s dS )NFr" )r r, r" r" r# �isLandmarkNavigation+ s z Utilities.isLandmarkNavigationc C s dS )NFr" )r r, r" r" r# �
isDPubNoteref. s zUtilities.isDPubNoterefc C s dS )NFr" )r r, r" r" r# �isLandmarkRegion1 s zUtilities.isLandmarkRegionc C s dS )NFr" )r r, r" r" r# �isLandmarkSearch4 s zUtilities.isLandmarkSearchc C s dS )NFr" )r r, r" r" r# �speakMathSymbolNames7 s z Utilities.speakMathSymbolNamesc C s dS )NFr" )r r" r" r# �isInMath: s zUtilities.isInMathc C s dS )NFr" )r r, r" r" r# �isMath= s zUtilities.isMathc C s dS )NFr" )r r, r" r" r# �isMathLayoutOnly@ s zUtilities.isMathLayoutOnlyc C s dS )NFr" )r r, r" r" r# �isMathMultilineC s zUtilities.isMathMultilinec C s dS )NFr" )r r, r" r" r# �isMathEnclosedF s zUtilities.isMathEnclosedc C s dS )NFr" )r r, r" r" r# � isMathFencedI s zUtilities.isMathFencedc C s dS )NFr" )r r, r" r" r# �isMathFractionWithoutBarL s z"Utilities.isMathFractionWithoutBarc C s dS )NFr" )r r, r" r" r# �
isMathPhantomO s zUtilities.isMathPhantomc C s dS )NFr" )r r, r" r" r# �isMathMultiScriptR s zUtilities.isMathMultiScriptc C s dS )NFr" )r r, r" r" r# �isMathSubOrSuperScriptU s z Utilities.isMathSubOrSuperScriptc C s dS )NFr" )r r, r" r" r# �isMathUnderOrOverScriptX s z!Utilities.isMathUnderOrOverScriptc C s dS )NFr" )r r, r" r" r# �isMathSquareRoot[ s zUtilities.isMathSquareRootc C s dS )NFr" )r r, r" r" r# � isMathTable^ s zUtilities.isMathTablec C s dS )NFr" )r r, r" r" r# �isMathTableRowa s zUtilities.isMathTableRowc C s dS )NFr" )r r, r" r" r# �isMathTableCelld s zUtilities.isMathTableCellc C s dS )NFr" )r r, r" r" r# � isMathTokeng s zUtilities.isMathTokenc C s dS )NFr" )r r, r" r" r# �isMathTopLevelj s zUtilities.isMathTopLevelc C s d S )Nr" )r r, r" r" r# �getMathDenominatorm s z Utilities.getMathDenominatorc C s d S )Nr" )r r, r" r" r# �getMathNumeratorp s zUtilities.getMathNumeratorc C s d S )Nr" )r r, r" r" r# �getMathRootBases s zUtilities.getMathRootBasec C s d S )Nr" )r r, r" r" r# �getMathRootIndexv s zUtilities.getMathRootIndexc C s d S )Nr" )r r, r" r" r# �getMathScriptBasey s zUtilities.getMathScriptBasec C s d S )Nr" )r r, r" r" r# �getMathScriptSubscript| s z Utilities.getMathScriptSubscriptc C s d S )Nr" )r r, r" r" r# �getMathScriptSuperscript s z"Utilities.getMathScriptSuperscriptc C s d S )Nr" )r r, r" r" r# �getMathScriptUnderscript� s z"Utilities.getMathScriptUnderscriptc C s d S )Nr" )r r, r" r" r# �getMathScriptOverscript� s z!Utilities.getMathScriptOverscriptc C s g S )Nr" )r r, r" r" r# �getMathPrescripts� s zUtilities.getMathPrescriptsc C s g S )Nr" )r r, r" r" r# �getMathPostscripts� s z Utilities.getMathPostscriptsc C s g S )Nr" )r r, r" r" r# �getMathEnclosures� s zUtilities.getMathEnclosuresc C s dgS )Nr r" )r r, r" r" r# �getMathFencedSeparators� s z!Utilities.getMathFencedSeparatorsc C s ddgS )Nr r" )r r, r" r" r# �
getMathFences� s zUtilities.getMathFencesc C s dS )Nr r" )r r, Ztestr" r" r# �getMathNestingLevel� s z Utilities.getMathNestingLevelc C s: ddddddddd d
d d d
ddddddddddddddgS ) NZbannerZ
complementaryZ contentinfozdoc-acknowledgmentsz
doc-afterwordz doc-appendixzdoc-bibliographyz doc-chapterzdoc-conclusionz doc-creditsz doc-endnotesz doc-epiloguez
doc-errataz doc-forewordz doc-glossaryz doc-indexzdoc-introductionz doc-pagelistzdoc-partz doc-prefacez doc-prologuezdoc-tocZform�mainZ
navigationZregion�searchr" )r r" r" r# �getLandmarkTypes� s6 zUtilities.getLandmarkTypesc C s� |o|j � tjksdS y |j� }W nL tk
rN d| }tjtj|d� dS d| }tjtj|d� dS y,|j|j kr�d| }tjtj|d� dS W n" d| }tjtj|d� dS dS )NFz&ERROR: %s doesn't implement AtspiValueTz%ERROR: Exception getting value for %szINFO: %s is busy indicatorz+INFO: %s is either busy indicator or broken)
rM r) ZROLE_PROGRESS_BAR�
queryValue�NotImplementedErrorr r& r' � maximumValue� minimumValue)r r, �valuer. r" r" r# �
isProgressBar� s, zUtilities.isProgressBarc C s� t jd� r(t jd� r(t jd� r(dS | j|�s6dS | j|�rDdS t jd�rfd d
� }tj||�rfdS t jd �}|tjkr~dS |tjkr�| j |�}|t
j kr�dS dd|t
j f fS |tj k� r�|r�|j
}n|j� }|t
jjk� r�dS dd|t
jjf fS dS ) NZspeakProgressBarUpdatesZbrailleProgressBarUpdatesZbeepProgressBarUpdatesF�Updates not enabled�Is not progress bar� Has no sizeZignoreStatusBarProgressBarsc S s | o| j � tjkS )N)rM r) �ROLE_STATUS_BAR)r� r" r" r# r� � s z/Utilities.isProgressBarUpdate.<locals>.<lambda>�Is status bar descendantZprogressBarVerbosityT�Verbosity is all�Verbosity is windowzWindow %s is not %s�Verbosity is appzApp %s is not %s� Not handled by any other case)Fr )Fr )Fr )Fr )Tr )Tr! )Tr" )Tr# )�_settingsManager�
getSettingr � hasNoSizer) r� r ZPROGRESS_BAR_ALLZPROGRESS_BAR_WINDOW�topLevelObjectr rI ZPROGRESS_BAR_APPLICATIONZhost_applicationr7 � activeScriptr4 )r r, r� � isStatusBar� verbosity�topLevelr4 r" r" r# �isProgressBarUpdate� s8
z Utilities.isProgressBarUpdatec C s� y"|j � }|j|j|j }}}W nL tk
rN d| }tjtj|d� d S d| }tjtj|d� d S || ko�|kn r�d| ko�dkn r�t|�S d S t||| d �S )Nz&ERROR: %s doesn't implement AtspiValueTz%ERROR: Exception getting value for %sr �d ) r r � currentValuer r r r& r' rX )r r, r Zminval�valZmaxvalr. r" r" r# �getValueAsPercent� s zUtilities.getValueAsPercentc C s |o|j � tjkS )N)rM r) ZROLE_BLOCK_QUOTE)r r, r" r" r# � isBlockquote s zUtilities.isBlockquotec C sR |o|j � tjksdS ytj|| j�}W n d| }tjtj|� dS |d k S )NFz'ERROR: Exception finding ancestor of %s)rM r) � ROLE_LISTr� �
isDocumentr r& r' )r r, r� r. r" r" r# �isDocumentList s zUtilities.isDocumentListc C sR |o|j � tjksdS ytj|| j�}W n d| }tjtj|� dS |d k S )NFz'ERROR: Exception finding ancestor of %s)rM r) �
ROLE_PANELr� r3 r r& r' )r r, r� r. r" r" r# �isDocumentPanel s zUtilities.isDocumentPanelc C s, t jt jt jt jt jt jg}|o*|j� |kS )N)r) r� r� r� r� r� r� rM )r r, Z
documentRolesr" r" r# r3 ) s zUtilities.isDocumentc C s |pt j}| j|�d k S )N)r r� �getContainingDocument)r r, r" r" r# �inDocumentContent2 s
zUtilities.inDocumentContentc
C s^ |sd S yt j|| j�}W n" d| }tjtj|d� d S d||f }tjtj|d� |S )Nz'ERROR: Exception finding ancestor of %sTz"INFO: Document containing %s is %s)r) r� r3 r r& r' )r r, �docr. r" r" r# r7 6 s z Utilities.getContainingDocumentc
sd |sd S t jt jg� � fdd�}||�r,|S yt j||�}W n" d| }tjtj|d� d S |S )Nc s | o| j � � kS )N)rM )r� )�
tableRolesr" r# r� J s z$Utilities.getTable.<locals>.<lambda>z'ERROR: Exception finding ancestor of %sT)r) r� r� r� r r& r' )r r, �isTablerm r. r" )r: r# �getTableE s zUtilities.getTablec C s6 |o|j � tjksdS | j|�}|s(dS |j � tjkS )NF)rM r) r� r7 r� )r r, r9 r" r" r# �isTextDocumentTableW s
z Utilities.isTextDocumentTablec C s$ |o|j � tjksdS | j|�d kS )NF)rM r) r� r7 )r r, r" r" r# �
isGUITablea s zUtilities.isGUITablec C s� |sdS y |j � }W n" d| }tjtj|d� dS |tjksFdS | j|�}|sXdS |j � tjkrjdS y |j� }W nN t k
r� d| }tjtj|d� Y n. d| }tjtj|d� Y n X |j
dkS dS )NFz#ERROR: Exception getting role of %sTz2ERROR: Table %s does not implement table interfacez/ERROR: Exception querying table interface of %si ) rM r r& r' r) r� r7 r� r^ r ri )r r, rP r. r9 rm r" r" r# �isSpreadSheetTableg s2
z Utilities.isSpreadSheetTablec
C sb |sdS y |j � }W n" d| }tjtj|d� dS tjtjtjg}||krTdS tj|| j �S )NFz#ERROR: Exception getting role of %sT)
rM r r& r' r) �ROLE_TABLE_CELL�ROLE_COLUMN_HEADER�ROLE_ROW_HEADERr� r= )r r, rP r. � cellRolesr" r" r# �isTextDocumentCell� s z Utilities.isTextDocumentCellc
C sb |sdS y |j � }W n" d| }tjtj|d� dS tjtjtjg}||krTdS tj|| j �S )NFz#ERROR: Exception getting role of %sT)
rM r r& r' r) r@ rA rB r� r? )r r, rP r. rC r" r" r# �isSpreadSheetCell� s zUtilities.isSpreadSheetCellc C s0 | j |�\}}|dkrdS | jjjd�}||kS )Nr F�
lastColumnr] )�coordinatesForCellr �pointOfReferencerW )r rw rs �columnrF r" r" r# �cellColumnChanged� s
zUtilities.cellColumnChangedc C s0 | j |�\}}|dkrdS | jjjd�}||kS )Nr F�lastRowr] )rG r rH rW )r rw rs rI rK r" r" r# �cellRowChanged� s
zUtilities.cellRowChangedc C sR | j j� rdS | j|�}|s dS | j|�s4tjd�S | j|�rHtjd�S tjd�S )NFZreadFullRowInGUITableZreadFullRowInSpreadSheetZreadFullRowInDocumentTable)r ZinSayAllr< r7 r$ r% r? )r r, rm r" r" r# �shouldReadFullRow� s
zUtilities.shouldReadFullRowc
C sj y|j � }|j� }W n
dS |tjkr.dS |jtj�r>dS |jtj�rfd| }tjtj |d� dS dS )NFTz-INFO: %s is focused but lacks state focusable)
rM r% r) �
ROLE_LABELr( �STATE_FOCUSABLEr� r r& r' )r r, rP r- r. r" r" r# �isFocusableLabel� s
zUtilities.isFocusableLabelc
C sj y|j � }|j� }W n
dS |tjkr.dS |jtj�r>dS |jtj�rfd| }tjtj |d� dS dS )NFz-INFO: %s is focused but lacks state focusableT)
rM r% r) r2 r( rO r� r r& r' )r r, rP r- r. r" r" r# �isNonFocusableList� s
z Utilities.isNonFocusableListc C s2 |o|j � tjksdS dd� }tj||�r.dS dS )NFc S s | o| j � tjkS )N)rM r) r )r� r" r" r# r� � s z3Utilities.isStatusBarNotification.<locals>.<lambda>T)rM r) ZROLE_NOTIFICATIONr� )r r, r) r" r" r# �isStatusBarNotification� s z!Utilities.isStatusBarNotificationc C s6 |sdS |j � tjkrdS dd� }tj||�r2dS dS )NFTc S s | o| j � tjtjgkS )N)rM r) r r� )r� r" r" r# r� s z,Utilities.isTreeDescendant.<locals>.<lambda>)rM r) �ROLE_TREE_ITEMr� )r r, ZisTreer" r" r# �isTreeDescendant s zUtilities.isTreeDescendantc # C s
d}| j |�s| j|�r dS ytdd� |j� D ��}W n i }Y nX y |j� }W n d}Y nX y|jj� }W n d}Y nX y |d }W n d}Y nX | j� }tjtj tj
tj g}|tj ko�|j
d�dk�r�y |j� } W nX tk
�r d | }
tjtj|
d� d}Y nx d
| }
tjtj|
d� d}Y nRX | j�oL| j�sd|j� jtj� }n,|j�pt| j|��s�| jd��p�| jd� }�nT|tj k�r�|j �r�|tj k�r�d}n.|j� tj k�r�d}n|tj k�r�| j |j�}�n�|tj k�r| j!|� }�n�|tj"k�r d}�n�|tj#k�r0d}�n�|tj$k�rDd}�n�|tj%tj&gk�r^d}�n�|tj'tj gk�rxd}�np||k�r�d}�n^|tjk�r�|tj(k}�nD|tj(k�r�d}�n0|tj)k�r�d}�n |tj*k�r�d}�n|tj+tj,gk�r�d}n�|tj-tj.tj/gk�rd}n�|tj
k�r2|tj'k�r2d}n�| j0|��rd|j� } | jtj1��p^| jtj2� }n�|tj3k�r�|j �r�|�r�|j� |k�r�d}nV|j d k�r�|j�r�|j|jk�r�d}n.| j4|��r�d}n | j5|��p�| j|��s�d}|�rd | }
tjtj|
d� |S )
z�Returns True if the given object is a container which has
no presentable information (label, name, displayed text, etc.).FTc S s g | ]}|j d d��qS )rR r )rS )r; rT r" r" r# r= s z*Utilities.isLayoutOnly.<locals>.<listcomp>Nr z layout-guess�truez2ERROR: Table %s does not implement table interfacez/ERROR: Exception querying table interface of %sr z$INFO: %s is deemed to be layout only)6�isDead�isZombierU rV rM rL �_topLevelRolesr) � ROLE_MENU�ROLE_MENU_ITEMr� rS r� rW r^ r r r& r' ri �nColumnsr% r( r� r� r �getColumnHeader� getRowHeaderr@ r� r� � isLayoutOnlyZ ROLE_SECTIONr1 � ROLE_FILLERr� ZROLE_AUTOCOMPLETE�ROLE_TEAROFF_MENU_ITEM�ROLE_SEPARATOR�
ROLE_LIST_BOXr� r2 Z ROLE_FORMr� �ROLE_TOGGLE_BUTTON� ROLE_TEXT�ROLE_PASSWORD_TEXTr� �
isTableRowrO ZSTATE_SELECTABLEr5 r� r ) r r, Z
layoutOnlyrZ rP Z
parentRoleZ
firstChild�
topLevelRolesZignorePanelParentrm r. r- r" r" r# r^ s�
" zUtilities.isLayoutOnlyc C s$ | st j rdS t jj� | j� kS )z�Returns True if the given object is from the same application that
currently has keyboard focus.
Arguments:
- obj: an Accessible object
F)r r� r7 )r, r" r" r# �
isInActiveAppx s zUtilities.isInActiveAppc C sP |sdS y |j � }W n0 ttfk
rD d| }tjtj|d� dS X |tjkS )z Returns True if obj is a link.Fz$ERROR: Exception getting role for %sT)rM r� r� r r& r' r) Z ROLE_LINK)r r, rP r. r" r" r# �isLink� s zUtilities.isLinkc C s4 | j |�sdS |j� }|jtj�o.|jtj� }|S )z;Returns True if obj is a text entry area that is read only.F)�
isTextArear% r( r) rO �STATE_EDITABLE)r r, r- ZreadOnlyr" r" r# �isReadOnlyTextArea� s
z Utilities.isReadOnlyTextAreac C s dS )NFr" )r r, r" r" r# �isSwitch� s zUtilities.isSwitchc C s� t jj|�}t jj|�}t|�t|�kr,dS |dd � }|dd � }|jd�r\|jd�r\dS y|jd�}W n@ tk
r� y|jd�}W n tk
r� t|�}Y nX Y nX |d|� |d|� kS )NFr r r] r] r] r] )r) �utilsZgetPathrD �countr[ �
ValueError)r �obj1�obj2�path1�path2r[ r" r" r# � _hasSamePath� s zUtilities._hasSamePathFc C s� ||kr dS | s| r dS y�|j � |j � kr2dS |j|jkrH| rHdS |r\| j||�r\dS |j� jtj�}|j� jtj�}||kr�dS |jdkr�|jdkr�|j dkr�|j
dkr�dS W n Y nX dS )NTFr ) rM r� ru �queryComponent�
getExtentsr) �DESKTOP_COORDSr� �y�width�height)r rq rr � comparePaths� ignoreNames�extents1�extents2r" r" r# rl � s*
zUtilities.isSameObjectc C s* | j |�rdS |o(|j� tjtjtjfkS )z{Returns True if obj is a GUI component that is for entering text.
Arguments:
- obj: an accessible
F)ri rM r) rd r� ZROLE_PARAGRAPH)r r, r" r" r# rj � s
zUtilities.isTextAreac C s dd� t jD �S )znRetrieves the list of currently running apps for the desktop
as a list of Accessible objects.
c S s g | ]}|d k r|�qS )Nr" )r; r� r" r" r# r= � s z/Utilities.knownApplications.<locals>.<listcomp>)r �_desktopr" r" r" r# r? � s zUtilities.knownApplicationsc C s� g }y |j � }W n0 ttfk
r@ d| }tjtj|d� |S X g }xX|D ]P}|j� tjkrLx<t d|j
� �D ]*}|j |�}||krn|j |� |j |� qnW qLW |S )z�Return a list of the objects that are labelling this object.
Argument:
- obj: the object in question
Returns a list of the objects that are labelling this object.
z+ERROR: Exception getting relationset for %sTr )
r` r� r� r r& r' ra r) ZRELATION_LABELLED_BYrc rd re rf ) r r, r� ro r. Z
allTargetsrp rv rq r" r" r# r� � s
zUtilities.labelsForObjectc
C sT d}y | j � }W n Y �n2X |jd�}|o4t|��rP|jd�}t|�dkr�xP|D ]H}|jd�dkrT|d j� s~|dd
� }|d j� s�|dd� }|}P qTW |jd�d }|s�|S |d dkr�|dd� }|jd�d }nr|jd�� s�|}n`|jd�d }|jd��r|jd�d }|jd �d }|jd
�d }|jd �d }|jd �d }|S )z�Returns the relevant information from the URI. The idea is
to attempt to strip off all prefix and suffix, much like the
basename command in a shell.Nr �,r z://� �/r[ �.�?�#�%r] r] ���r] r] r] r] r] r� )�queryHyperlink�getURIrD rS �find�isalnumro �
startswith)r, �basename� hyperlink�uriZ
expression�itemr" r" r# � linkBasename sB
zUtilities.linkBasenamec C s� | sdS y | j � W n tk
r( dS X y | j� }W n tk
rJ dS X x6t|j� �D ]&}|j|�}||jkrZ||jkrZ|S qZW dS )a� A brute force method to see if an offset is a link. This
is provided because not all Accessible Hypertext implementations
properly support the getLinkIndex method. Returns an index of
0 or greater of the characterIndex is on a hyperlink.
Arguments:
-obj: the object with the Accessible Hypertext specialization
-characterIndex: the text position to check
r r] r] r] r] )r� r �queryHypertextrc � getNLinks�getLink�
startIndex�endIndex)r, ZcharacterIndexZ hypertextrv �linkr" r" r# � linkIndexY s
zUtilities.linkIndexc s� |sdS y�j j�j | S �j�j jkr>i �j j�j< Y nX �j|�r\�fdd�}n,|j� tjkrtdd� }n|j� � � fdd�}g }tj||�}x |r�|j|� tj||�}q�W t |�}|�j j�j |< �j j�j | S )zmDetermines the nesting level of this object.
Arguments:
-obj: the Accessible object
r c s
� j | �S )N)r1 )r� )r r" r# r� � s z(Utilities.nestingLevel.<locals>.<lambda>c S s | o| j o| j j� tjkS )N)rL rM r) r2 )r� r" r" r# r� � s c s | o| j � � kS )N)rM )r� )rP r" r# r� � s )
r r� �
NESTING_LEVELr1 rM r) r� r� rf rD )r r, �predZ ancestorsrO r r" )rP r r# r z s*
zUtilities.nestingLevelc C sf | j |�sd
S y| jj| j | S | j| jjkrDi | jj| j< Y nX g }|}d}x�|�s8y |j� }W n0 ttfk
r� d| }tjtj |d� d S X d}x&|D ] }|j
� t j kr�|j
d�}P q�W |j|�� r�d||f }tjtj |d� d}t|�dk�r d | }tjtj |d� d}qX|�r2|j|� qXd}qXW t|�d | jj| j |< | jj| j | S ) z�Determines the node level of this object if it is in a tree
relation, with 0 being the top level node. If this object is
not in a tree relation, then -1 will be returned.
Arguments:
-obj: the Accessible object
r Fz+ERROR: Exception getting relationset for %sTNr z0ERROR: %s is already in the list of nodes for %sr- z&INFO: More than 100 nodes found for %sr] r] )rT r r� �
NODE_LEVELr` r� r� r r& r' ra r) rk re ro rD rf )r r, rn rr ru ro r. rp r" r" r# r � sH
zUtilities.nodeLevelc
C s\ | j |�rdS | j|�r dS | j|�sBd| }tjtj|d� dS y|j� jtj �}W n" d| }tjtj|d� dS |j
dk r�|j dk r�d| }tjtj|d� dS |j p�|j
�s
|js�d| }tjtj|d� dS |j� tjk�rd| }tjtj|d� dS dS |d k�s$| j|j� �r(dS | j||��sXd |||f }tjtj|d� dS dS )
NFz#INFO: %s is not showing and visibleTz'ERROR: Exception getting extents for %sr z!INFO: %s has negative coordinatesz$INFO: %s has no size and no childrenzINFO: %s has no sizezINFO: %s %s not in %s)rV r� �isShowingAndVisibler r& r' rv rw r) rx r� ry rz r{ r� rM rY �_boundsIncludeChildrenrL �containsRegion)r r, � boundingboxr. Zboxr" r" r# �
isOnScreen� sF
zUtilities.isOnScreenc C s� y |j � }W n" d| }tjtj|d� d S |tjkr>d S dtj|�krf| j|�}|rb|d S d S xd|D ]\}y|j� |j � }W n& d| }tjtj|d� wlY nX |j
tj �s�|j
tj �rl|S qlW d S )Nz#ERROR: Exception getting role of %sT� Selectionr z$ERROR: Exception getting state of %s)
rM r r& r' r) �
ROLE_MENU_BAR�listInterfaces�selectedChildrenr8 r% r( r_ �STATE_SELECTED)r �menubarrP r. �selected�menur- r" r" r# �selectedMenuBarMenu s2
z Utilities.selectedMenuBarMenuc sz |sdS dd� }t j||�}|d kr(dS | jjt|��� � d krJ| j|�� � sRdS � fdd�}||�rjdS t j||�d k S )NFc S s | o| j � tjkS )N)rM r) r� )r� r" r" r# r� $ s z/Utilities.isInOpenMenuBarMenu.<locals>.<lambda>c s | � kS )Nr" )r� )� selectedMenur" r# r� 0 s T)r) r� r rW �hashr� )r r, Z isMenuBarr� ZinSelectedMenur" )r� r# �isInOpenMenuBarMenu s
z Utilities.isInOpenMenuBarMenuc C s� | j ||�sg S y |j� }W n" d| }tjtj|d� g S |tjkrNg S |tjkr^|gS |tjkr|| j |�| j
t |�< |j r�|j j� tjkr�| j
|� r�|gS |d kr�y|j� }|jtj�}W n( d| }tjtj|d� d}Y nX tj|�}d|k�r d|k�r | j|�}|�r |S tjtjg}g } |tjk�rD|j�s^||k�rhdtj|�k�rh| j|� x |D ]}
| j| j|
|�� �qnW |tjk�r�d | j
t |�< | �r�| S tjtjtj tj tj g} || k�r�g S |gS ) Nz#ERROR: Exception getting role of %sTz&ERROR: Exception getting extents of %sr �Tabler� ZText)r r r r ) r� rM r r& r' r) Z ROLE_INVALIDr� r� r� r r� rL r� rv rw rx r� �getVisibleTableCellsr Z ROLE_UNKNOWN�
ROLE_PAGE_TABr� rf r@ �getOnScreenObjectsr_ rb r5 r� Z
ROLE_VIEWPORT) r r� �extentsrP r. � componentZ
interfacesZ visibleCellsZnonTextZobjectsr< Z
containersr" r" r# r� 6 sb
z Utilities.getOnScreenObjectsc C s� y| o| j o| jsdS W n" d| }tjtj|d� dS | j� }|tjkrRdS |tjkr`dS | j j� tj kstdS dd� }t
t |dd� | D ���}t |�| jkr�dS dS )z9Determines if obj is a table row -- real or functionally.Fz5ERROR: Exception getting parent and childCount for %sTc S s | o| j � tjtjtjgkS )N)rM r) r@ rB rA )r� r" r" r# r� � s z&Utilities.isTableRow.<locals>.<lambda>c S s g | ]}|�qS r" r" )r; r� r" r" r# r= � s z(Utilities.isTableRow.<locals>.<listcomp>)
rL r� r r& r' rM r) �ROLE_TABLE_ROWr@ r� rA �filterrD )r, r. rP ZisCellZ cellChildrenr" r" r# rf v s&
zUtilities.isTableRowc sZ |j � jtj�r|S tjtjtjtjg� tj|� fdd��}|rV| j j
j |j � rV|}|S )Nc s | o| j � � kS )N)rM )r� )�rolesr" r# r� � s z.Utilities.realActiveAncestor.<locals>.<lambda>)
r% r( r) r� r@ rA rB r� r� r Z utilitiesr^ rL )r r, rO r" )r� r# �realActiveAncestor� s z Utilities.realActiveAncestorc sJ � j |�rdS |j� tjkr |S � fdd�|D �}t|�dkrF|d S |S )a2 Given an object that should be a child of an object that
manages its descendants, return the child that is the real
active descendant carrying useful information.
Arguments:
- obj: an object that should be a child of an object that
manages its descendants.
Nc s g | ]}� j |�j� r|�qS r" )r �strip)r; r� )r r" r# r= � s z2Utilities.realActiveDescendant.<locals>.<listcomp>r r )rV rM r) r@ rD )r r, Z
hasContentr" )r r# �realActiveDescendant� s
z Utilities.realActiveDescendantc C s� t jt jt jg}|j� jt j�s,|j� |kr0dS d}xZt|j d dd�D ]D}|| j� t j
krh|| }n || j� |kr�| j || �}|rHP qHW |S )z�Returns the status bar in the window which contains obj.
Arguments:
- obj: the top-level object (e.g. window, frame, dialog) for which
the status bar is sought.
Nr r] r] ) r) r r� r� r% r( r� rM rc r� r � statusBar)r r, r� r� rv r" r" r# r� � s
zUtilities.statusBarc C s d S )Nr" )r r� r" r" r# �infoBar� s zUtilities.infoBarc C s t jt jt jt jgS )N)r) �
ROLE_ALERTr� r� � ROLE_WINDOW)r r" r" r# rX � s zUtilities._topLevelRolesc
C sl t js
dS yt jj� }W n$ dt j }tjtj|d� dS || j� k}dt j|f }tjtj|d� |S )NFz$ERROR: Exception getting role for %sTz INFO: %s is top-level object: %s)r r� rM r r& r' rX )r rP r. �rvr" r" r# � _locusOfFocusIsTopLevelObject� s
z'Utilities._locusOfFocusIsTopLevelObjectc C sH |sdS | j � }x2|rB|jrB|j� |krB|jj� tjk rB|j}qW |S )z�Returns the top-level object (frame, dialog ...) containing obj,
or None if obj is not inside a top-level object.
Arguments:
- obj: the Accessible object
N)rX rL rM r) �ROLE_APPLICATION)r r, Z stopAtRolesr" r" r# r' � s
zUtilities.topLevelObjectc
C s� |pt j}| j|�}|s dS |j� y |j� }W n" d| }tjtj|d� dS |jt j
� sn|jt j �rrdS | j |t j
�s�dS dS )NFz-ERROR: Exception getting state of topLevel %sT)r r� r' r8 r% r r& r' r( r) r* �
STATE_DEFUNCTrl rI )r r, r+ r- r. r" r" r# � topLevelObjectIsActiveAndCurrent s"
z*Utilities.topLevelObjectIsActiveAndCurrentc C s` y$| j � jtj�}|j � jtj�}W n
dS |j|jd }|j|jd }t|| �|kS )z1Determines if obj1 and obj2 are on the same line.Fr� )rv rw r) rx ry r{ �abs)rq rr �deltaZbbox1Zbbox2Zcenter1Zcenter2r" r" r# �
onSameLine s zUtilities.onSameLinec C s| | |kr dS xFt tt| �t|���D ],}| | || k r<dS | | || kr$dS q$W |r\dS t| �t|� }tt|d�d�S )zpCompares the two paths and returns -1, 0, or 1 to indicate if path1
is before, the same, or after path2.r r r] r] )rc r{ rD �max)rs rt ZtreatDescendantAsSamer� r� r" r" r# �pathComparison/ s zUtilities.pathComparisonc C s� y"| j � jtj�}|j|j }}W n d\}}Y nX y"|j � jtj�}|j|j }}W n d\}}Y nX || || S )Nr )r r )r r )rv rw r) rx rz r{ )rq rr �bbox�width1�height1�width2�height2r" r" r# rH C s zUtilities.sizeComparisonc C s� y"| j � jtj�}|j|j }}W n d\}}Y nX y"|j � jtj�}|j|j }}W n d\}}Y nX || p~|| }| r�| j|jkr�| j� |j� }t|d�}t |d�}|S )z�Compares the physical locations of obj1 and obj2 and returns -1,
0, or 1 to indicate if obj1 physically is before, is in the same
place as, or is after obj2.r r )r r )r r r] )
rv rw r) rx r� ry rL rY r� r{ )rq rr r� �x1�y1�x2�y2r� r" r" r# �spatialComparisonS s
zUtilities.spatialComparisonc
C sN |sdS y|j � jtj�}W n" d| }tjtj|d� dS |joJ|j S )NFz'ERROR: Exception getting extents for %sT) rv rw r) rx r r& r' rz r{ )r r, r� r. r" r" r# r& s s zUtilities.hasNoSizec sP t jt jt jg� � fdd�}t j||�}|rLd||f }tjtj|d� dS dS )Nc sF | sdS | j � � krdS dtj| �kr0| jdkS dtj| �krBdS d S )NFTr� �2 ZDocument)rM r) r� r� )r� )r� r" r# �isMatch� s
z7Utilities._hasNonDescendableDescendant.<locals>.isMatchzINFO: %s has descendant %sTF)r) ZROLE_PAGE_TAB_LISTZROLE_SPLIT_PANEr� �findDescendantr r& r' )r r� r� �matchr. r" )r� r# � _hasNonDescendableDescendant� s
z&Utilities._hasNonDescendableDescendantTc C s� | j |�rg S | jjr(| jjj|�r(g S dd� }ytj||�}W n
g S y$dd� |D �}|rndd� |D �}W n
g S i }x2|D ]*}|jr�|j|j|jjgkr�q�|||j< q�W t|j � �}t
|t j | j
�d�S )a� Returns a list containing all the unrelated (i.e., have no
relations to anything and are not a fundamental element of a
more atomic component like a combo box) labels under the given
root. Note that the labels must also be showing on the display.
Arguments:
- root: the Accessible object to traverse
- onlyShowing: if True, only return labels with STATE_SHOWING
Returns a list of unrelated labels under the given root.
c S s | o| j � tjkS )N)rM r) rN )r� r" r" r# r� � s z+Utilities.unrelatedLabels.<locals>.<lambda>c S s g | ]}|j � s|�qS r" )r` )r; r� r" r" r# r= � s z-Utilities.unrelatedLabels.<locals>.<listcomp>c S s g | ]}|j � jtj�r|�qS r" )r% r( r) r+ )r; r� r" r" r# r= � s )r> )r� r Z
spellcheckZ
isCheckWindowr) �findAllDescendantsr� rL rA �valuesrE rF rG r� )r r� r� ZhasRoleZ allLabelsr� �dr� r" r" r# r� � s,
zUtilities.unrelatedLabelsc C s� d}|j � }| j|�}|r~|j� tjkr~|j� tjkr~| j|� r~x:|D ]2}|j� tjksr|j� tjksr| j|�rH|d7 }qHW |S )ac If the current application has one or more alert or dialog
windows and the currently focused window is not an alert or a dialog,
return a count of the number of alert and dialog windows, otherwise
return a count of zero.
Arguments:
- obj: the Accessible object
Returns the alert and dialog count.
r r )r7 r' rM r) r� r� r� )r r, ZalertAndDialogCountr4 r9 r< r" r" r# � unfocusedAlertAndDialogCount� s
z&Utilities.unfocusedAlertAndDialogCountc C s y|j � jd�S dS dS )zjReturn the URI for a given link object.
Arguments:
- obj: the Accessible object.
r N)r� r� )r r, r" r" r# r� � s z
Utilities.uric C s |sdS |j S )z�Returns the first valid parent/ancestor of obj. We need to do
this in some applications and toolkits due to bogus hierarchies.
Arguments:
- obj: the Accessible object
N)rL )r r, r" r" r# r� � s zUtilities.validParentc
C sz y | j � }W n
dS |j� sH|j}t||�}t||�}|j||� n.|jd�\}}||k rd|}n|}|jd||� dS )z�Adjusts the end point of a text selection
Arguments:
- obj: the Accessible object.
- offset: the new end point - can be to the left or to the right
depending on the direction of selection
Nr )r� �getNSelections� caretOffsetr{ r� Z addSelection� getSelectionZ setSelection)r, r� r� r� � startOffset� endOffsetr" r" r# �adjustTextSelection� s
z Utilities.adjustTextSelectionc C s� |sdS x(|j � D ] }|j� tjkr|jd�S qW |j� d }|jrxd| ko^|jjd k n rx|j}|j� d }y|j| }W n d}Y nX ||kr�d}|S )z!Finds the object before this one.Nr r )r` ra r) ZRELATION_FLOWS_FROMre rY rL r� )r r, rp r[ �prevObjr" r" r# �findPreviousObject s (
z Utilities.findPreviousObjectc C s� |sdS x(|j � D ] }|j� tjkr|jd�S qW |j� d }|jrtd| k oZ|jjk n rt|j}|j� d }y|j| }W n d}Y nX ||kr�d}|S )z Finds the object after this one.Nr r )r` ra r) ZRELATION_FLOWS_TOre rY rL r� )r r, rp r[ �nextObjr" r" r# �findNextObject1 s $
zUtilities.findNextObjectc
C s� | j |�\}}}|r,| jjjd�r,|||fS | j|�r@|||fS | j|�}x>|r�| j|�r|| j |�\}}}|spP d||f }| j|�}qLW | j|�} x>| r�| j| �r�| j | �\}}}|s�P d||f }| j| �} q�W |||fS )a� Get all the text applicable text selections for the given object.
including any previous or next text objects that also have
selected text and add in their text contents.
Arguments:
- obj: the text object to start extracting the selected text from.
Returns: all the selected text contents plus the start and end
offsets within the text for the given object.
�entireDocumentSelectedz%s %s)� selectedTextr rH rW rE r� �queryNonEmptyTextr� )
r r, � textContentsr� r� r� � selection�start�endr� r" r" r# �allSelectedTextJ s,
zUtilities.allSelectedTextc C s` y | j � }W n
g S g }y |j� }W n d}Y nX x t|�D ]}|j|j|�� qDW |S )an Get a list of text selections in the given accessible object,
equivalent to getNSelections()*texti.getSelection()
Arguments:
- obj: An accessible.
Returns list of start and end offsets for multiple selections, or an
empty list if nothing is selected or if the accessible does not support
the text interface.
r )r� r� rc rf r� )r, r� r� � nSelectionsrv r" r" r# �allTextSelectionsq s
zUtilities.allTextSelectionsc C s� d}y |j � }W n, tk
r< d| }tjtj|d� Y n^X y|jj� |j}W n* d||jf }tjtj|d� Y n X d||f }tjtj|d� |S )a� Returns the character offset of the embedded object
character for this object in its parent's accessible text.
Arguments:
- obj: an Accessible that should implement the accessible
hyperlink specialization.
Returns an integer representing the character offset of the
embedded object character for this hyperlink in its parent's
accessible text, or -1 something was amuck.
r z3INFO: %s does not implement the hyperlink interfaceTz7ERROR: Exception getting startIndex for %s in parent %sz INFO: startIndex of %s is %ir] )r� r r r& r' rL r� r� )r r, r� r� r. r" r" r# �characterOffsetInParent� s
z!Utilities.characterOffsetInParentc C s< y | j � }W n
dS x t|j� �D ]}|jd� q&W dS )zwClears the text selection if the object supports it.
Arguments:
- obj: the Accessible object.
Nr )r� rc r� ZremoveSelection)r, r� rv r" r" r# �clearTextSelection� s z Utilities.clearTextSelectionr c
C s� y| j |||�}W n
dS | j|kr�d}x$|D ] }| j|�|krFP |d7 }q2W t|�}|j| j�}xBt|�D ]6} |j| j�}
|| | }| j|�} | s�d} | ||
< qpW dj|�}|S )ar Expands the current object replacing EMBEDDED_OBJECT_CHARACTERS
with their text.
Arguments
- obj: the object whose text should be expanded
- startOffset: the offset of the first character to be included
- endOffset: the offset of the last character to be included
Returns the fully expanded text for the object.
r r r ) � substringr� r� rA ro rc r[ �
expandEOCsr� ) r r, r� r� �stringZ childOffsetr< ZtoBuildro rv r[ Z childTextr" r" r# r� � s*
zUtilities.expandEOCsc C sN | j ||d�\}}}|jd�dkr&dS |jd�dkr8dS |jd�dkrJdS dS ) a Identifies if the current word is flagged as misspelled by the
application. Different applications and toolkits flag misspelled
words differently. Thus each script will likely need to implement
its own version of this method.
Arguments:
- obj: An accessible which implements the accessible text interface.
- offset: Offset in the accessible's text for which to retrieve the
attributes.
Returns True if the word is flagged as misspelled.
TZinvalid�spellingz
text-spellingZ
misspelledZ underline�errorF)�textAttributesrW )r r, r� �
attributesr� r� r" r" r# �isWordMisspelled� s zUtilities.isWordMisspelledc C s |j � jtj�S )N)r% r( r) ZSTATE_INVALID_ENTRY)r r, r" r" r# �getError
s zUtilities.getErrorc C s dS )Nr r" )r r, r" r" r# �getErrorMessage
s zUtilities.getErrorMessagec C s dS )NFr" )r r, r" r" r# �isErrorMessage
s zUtilities.isErrorMessagec C s0 | j |�}|r,|d kr |j}|j||d �S dS )Nr r )r� r� r� )r r, r� r� r" r" r# �getCharacterAtOffset
s
z Utilities.getCharacterAtOffsetc C s( y |j � }W n Y n X |jr$|S dS )z�Get the text interface associated with an object, if it is
non-empty.
Arguments:
- obj: an accessible object
N)r� r� )r r, r� r" r" r# r�
s zUtilities.queryNonEmptyTextc C s |j S )N)�any_data)r r� r" r" r# � deletedText&
s zUtilities.deletedTextc
C s� |j r |j S y|jj� }W n* d|j }tjtj|d� d }Y nX d}tjtj|d� |tjkr�| j|j�}|r�|j dd �}|r�d| }tjtj|d� |d
S d}tjtj|d� dS ) Nz#ERROR: Exception getting role of %sTz"ERROR: Broken text insertion eventr r z!HACK: Returning last char in '%s'z3FAIL: Unable to correct broken text insertion eventr r] r] )
r� �sourcerM r r& r' r) re r� r� )r r� rP r. r� r� r" r" r# � insertedText)
s*
zUtilities.insertedTextc C s� d}d }}y |j � }W n d}Y n
X |j� }xPtd|�D ]B}|j|�\}}||krZq>| j|||�}|dkrx|d7 }||7 }q>W |||gS )z�Get the text selection for the given object.
Arguments:
- obj: the text object to extract the selected text from.
Returns: the selected text contents plus the start and end
offsets within the text.
r r r1 )r� r� rc r� r� ) r r, r� r� r� ZtextObjr� rv r� r" r" r# r� D
s
zUtilities.selectedTextc C sD t j}y|j� j}W n& tk
r, d}Y n d}Y nX ||fS )Nr r r] )r r� r� r� r )r r, r� r" r" r# r� b
s
zUtilities.getCaretContextc C s |dfS )Nr r" )r r, r" r" r# �getFirstCaretPositionm
s z Utilities.getFirstCaretPositionc C s t jd |d� | j||� d S )NF)r
ZsetLocusOfFocus�setCaretOffset)r r, r� r� r" r" r# �setCaretPositionp
s zUtilities.setCaretPositionc C s& y |j � }W n
dS |j|� dS )z�Set the caret offset on a given accessible. Similar to
Accessible.setCaretOffset()
Arguments:
- obj: Given accessible object.
- offset: Offset to hich to set the caret.
N)r� r )r r, r� Ztextir" r" r# r t
s
zUtilities.setCaretOffsetc C s$ y |j � }W n
dS |j||�S )aT Returns the substring of the given object's text specialization.
Arguments:
- obj: an accessible supporting the accessible text specialization
- startOffset: the starting character position
- endOffset: the ending character position. Note that an end offset
of -1 means the last character
r )r� r� )r r, r� r� r� r" r" r# r� �
s
zUtilities.substringc C s* x$| j jj� D ]\}}||kr|S qW |S )a� Converts the given Atk attribute name into the application's
equivalent. This is necessary because an application or toolkit
(e.g. Gecko) might invent entirely new names for the same text
attributes.
Arguments:
- attribName: The name of the text attribute
Returns the application's equivalent name if found or attribName
otherwise.
)r �attributeNamesDict�items)r �
attribNamer> r r" r" r# �getAppNameForAttribute�
s
z Utilities.getAppNameForAttributec C s | j jj||�S )aa Converts the given attribute name into the Atk equivalent. This
is necessary because an application or toolkit (e.g. Gecko) might
invent entirely new names for the same attributes.
Arguments:
- attribName: The name of the text attribute
Returns the Atk equivalent name if found or attribName otherwise.
)r r rW )r r r" r" r# �getAtkNameForAttribute�
s z Utilities.getAtkNameForAttributec
C s� i }y |j � }W n |ddfS |rB| j|j� �}|j|d � |dkrP|j}|j|�\}}} | j|�}|j|d � t||�}t| |d �} ||| fS )a
Get the text attributes run for a given offset in a given accessible
Arguments:
- acc: An accessible.
- offset: Offset in the accessible's text for which to retrieve the
attributes.
- get_defaults: Get the default attributes as well as the unique ones.
Default is True
Returns a dictionary of attributes, a start offset where the attributes
begin, and an end offset. Returns ({}, 0, 0) if the accessible does not
supprt the text attribute.
r r N)r� �stringToKeysAndDictZgetDefaultAttributes�updater� rV r{ r� )
r Zaccr� Z get_defaultsr� r� Z
stringAndDictZ
attrStringr� r� r" r" r# r� �
s
zUtilities.textAttributesc C s |dkr"|dks t |�dkr"tjS |jd�s4|dkr:tjS tj|| j�}|dkrj|jd�d j � j d�}n�|r�|jd �r�|jd �d }t
j � d
|kr�tj t
|��}ntj t |��}nN|jd �r�| j|�\}}}tjr�tj|||�}nd |||f }ntj|| j�}d
||f S )NZweightZboldi� r� z family-namer� r �"ZpxZ
decimal_pointZcolorz%i %i %iz%s: %s)rX r ZBOLD�endswithZ
MISSPELLEDr ZgetTextAttributeNamer rS r� �locale�
localeconvZ
pixelCount�float�
rgbFromStringr Z
useColorNamesr Z rgbToName)r r> r Z localizedKeyZlocalizedValue�r�gr} r" r" r# �localizeTextAttribute�
s&
z Utilities.localizeTextAttributec C sf t j stj rdS t|j�dks.|jtj@ r2dS t j}|j � }|t
j krNdS |j � j
t
j�rbdS dS )z�Given a keyboard event containing an alphanumeric key,
determine if the script is likely to echo it as a character.
Fr T)r r� r �enableEchoByCharacterrD � event_string� modifiersr ZORCA_CTRL_MODIFIER_MASKrM r) re r% r( rk )r r� r, rP r" r" r# �willEchoCharacter�
s
zUtilities.willEchoCharacterc
C s� ddl m} ddl m} tj}d}y|j|d �\}} W n d}Y nX t|�}
|
tjkr�|d | jj kr�| s~|r�||kr�|j
|d �} t j | |
�} d|| f }q�||7 }n||7 }|S )a� Add in the latest line segment, adjusting for repeat characters
and punctuation.
Arguments:
- segment: the segment of repeated characters.
- line: the current built-up line to characters to speak.
- respectPunctuation: if False, ignore punctuation level.
Returns: the current built-up line plus the new segment, after
adjusting for repeat character counts and punctuation.
r )�punctuation_settings)r Tr Fz%s %s)
r r r r ZverbalizePunctuationStyle�getPunctuationInforD �repeatCharacterLimitr �
whitespace�getCharacterNamer ZrepeatedCharCount)
r �segment�lineZrespectPunctuationr r ZstyleZ isPunctChar�level�actionro Z
repeatCharZ
repeatSegmentr" r" r# �_addRepeatSegment s&
zUtilities._addRepeatSegmentc C s( ddl m} |t|� }y|j� }|j� }W n d}Y nX t|�}x�t|dd�D ]�} |j| d �}
|
slqT||
j k o�|kn r�|
j| } n8||
j ko�|k n rTt|�} |
j|k r�| d8 } nqTdt
j } d}
| t|�k r�|| }
|
| j j
k�p|j|
��s| d7 } | || | �< qTW dj|�S )a| Adjust line to include the word "link" after any hypertext links.
Arguments:
- obj: the accessible object that this line came from.
- line: the string to adjust for links.
- startOffset: the caret offset at the start of the line.
Returns: a new line adjusted to add the speaking of "link" after
text which is also a link.
r )r r r1 r r] )r r rD r� r� rA rc r� r� r� r ZLINKr r r r� )r r, r r� r r� Z hyperTextZnLinksZ adjustedLine�nr� r[ Z
linkStringZnextCharr" r" r# �adjustForLinks6 s8
zUtilities.adjustForLinksc C s t jdd| �S )Nz(?<=[a-z])(?=[A-Z])r1 )�re�sub)r� r" r" r# �_processMultiCaseStringk s z!Utilities._processMultiCaseStringc C s | j � s | S djt| ��S )Nr1 )� isnumericr� rA )Zwordr" r" r# �_convertWordToDigitso s z Utilities._convertWordToDigitsc C s� t jr| j|�}| j� r"tj|�}t jrF| jj|�}dj t
| j |��}t j sP|S d}| jj|�}dj t
t
j|��}t jr�| j|�}|S )a@ Adjust the line to replace words in the pronunciation dictionary,
with what those words actually sound like.
Arguments:
- line: the string to adjust for words in the pronunciation dictionary.
Returns: a new line adjusted for words found in the pronunciation
dictionary.
r )r Z speakMultiCaseStringsAsWordsr& r� r ZadjustForSpeechZspeakNumbersAsDigits�WORDS_RErS r� rB r( ZusePronunciationDictionaryr ZgetPronunciation)r r Zwords�newLiner" r" r# �adjustForPronunciationv s
z Utilities.adjustForPronunciationc C s� t |�dk stjdk r|S d}|d }}d}xPtdt |��D ]>}|| |kr\||| 7 }nd}| j||�}|| }|| }q>W | j|||�S )a� Adjust line to include repeat character counts. As some people
will want this and others might not, there is a setting in
settings.py that determines whether this functionality is enabled.
repeatCharacterLimit = <n>
If <n> is 0, then there would be no repeat characters.
Otherwise <n> would be the number of same characters (or more)
in a row that cause the repeat character count output.
If the value is set to 1, 2 or 3 then it's treated as if it was
zero. In other words, no repeat character count is given.
Arguments:
- line: the string to adjust for repeat character counts.
Returns: a new line adjusted for repeat character counts (if enabled).
� r r Fr T)rD r r rc r! )r r r* r ZlastCharZ
multipleCharsrv r" r" r# �adjustForRepeats� s zUtilities.adjustForRepeatsc s� t tj� j|��}t tj� j|��}x<|D ]4}� fdd�|D �}tjdj|� }tj|||�}q*W x<|D ]4}� fdd�|D �}tj dj|� }tj|||�}qhW |S )z�Adjusts the string to convert digit-like text, such as subscript
and superscript numbers, into actual digits.
Arguments:
- string: the string to be adjusted
Returns: a new string which contains actual digits.
c s g | ]}t � jj|���qS r" )rC �SUPERSCRIPT_DIGITSr[ )r; r� )r r" r# r= � s z-Utilities.adjustForDigits.<locals>.<listcomp>r c s g | ]}t � jj|���qS r" )rC �SUBSCRIPT_DIGITSr[ )r; r� )r r" r# r= � s )
�setr$ �findall�
SUBSCRIPTS_RE�SUPERSCRIPTS_REr ZDIGITS_SUPERSCRIPTr� r% ZDIGITS_SUBSCRIPT)r r� Z subscriptedZ
superscriptedZnumber�new� newStringr" )r r# �adjustForDigits� s
zUtilities.adjustForDigitsc C s� t jd�st jd� rdS |jdd�}tjd|�}|rF|d |j� � }d}dd� tjd |�D �}d
d� tjd |�D �}t|| �}xJ|D ]B\}}||f|kr�|d tj || � 7 }q�|d tj
|| � 7 }q�W |S )
N�onlySpeakDisplayedTextZenableSpeechIndentationr � r1 z[^ ]c S s g | ] }|j � �qS r" )�span)r; �mr" r" r# r= � s z4Utilities.indentationDescription.<locals>.<listcomp>z +c S s g | ] }|j � �qS r" )r9 )r; r: r" r" r# r= � s z +z%s ) r$ r% r3 r$ r r� �finditerrE r Z spacesCountZ tabsCount)r r r� �resultZspacesZtabsZspansr� r" r" r# �indentationDescription� s
z Utilities.indentationDescriptionc C s4 ddl m} | j� j� j� }|j� \}}}}||fS )z0Gets the absolute position of the mouse pointer.r )r )�
gi.repositoryr ZWindowZ
get_screenZget_root_windowZ get_pointer)r Z
rootWindowr9 r� ry r r" r" r# �absoluteMouseCoordinates� s z"Utilities.absoluteMouseCoordinatesr1 c C s |s| S | s|S | | | S )z�Appends the newText to the given text with the delimiter in between
and returns the new string. Edge cases, such as no initial text or
no newText, are handled gracefully.r" )r� �newTextZ delimiterr" r" r# r� � s
zUtilities.appendStringc C s� |j jd�r�|j s |j r dS |jj� }|jtj�s:dS |jtj�sJdS |jtj �rz|jj
� |jj� }|jtj �szdS | j � \}}|dkr�|jdkr�dS |dkr�|jdkr�dS |d kr�| j
|j�S dS )
z�Returns True if event is associated with text being autocompleted
or autoinserted or autocorrected or autosomethingelsed.
Arguments:
- event: the accessible event being examined
zobject:text-changed:insertFZTab� T�Return�
�Up�Down�Page_Up� Page_Down)rD rE rF rG )�typer� r� r� r% r( r) rk r+ rO r8 r� �lastKeyAndModifiers� isEditableDescendantOfComboBox)r r� r- ZlastKey�modsr" r" r# �isAutoTextEvent s*
zUtilities.isAutoTextEventc C s( |dks|dkrdS || j jko&|dkS )a� Returns True if we are positioned at the end of a sentence.
This is determined by checking if the current character is a
white space character and the previous character is one of the
normal end-of-sentence punctuation characters.
Arguments:
- currentChar: the current character
- previousChar: the previous character
Returns True if the given character is a sentence delimiter.
�
rC Tz!.?:;)r r )r Z currentCharZ previousCharr" r" r# �isSentenceDelimiter$ s
z Utilities.isSentenceDelimiterc C s || j jkp |dkp || j jkS )z�Returns True if the given character is a word delimiter.
Arguments:
- character: the character in question
Returns True if the given character is a word delimiter.
z!*+,-./:;<=>?@[\]^_{|})r r ZNO_BREAK_SPACE_CHARACTER)r � characterr" r" r# �isWordDelimiter7 s zUtilities.isWordDelimiterc
C sF |dkrt j}y |j� j|�}|j� j|�}W n
dS | j||�S )z9Returns the extents of the intersection of obj1 and obj2.Nr )r r r r )r) rx rv rw � intersection)r rq rr � coordTyper~ r r" r" r# �intersectingRegionD s z Utilities.intersectingRegionc C s� |\}}}}|\}}} }
t ||| d �} t ||| d �} tt| �jt| ���}
t ||| d �}t |||
d �}tt|�jt|���}|
o�|s�dS |
d }|d }|
d | }|d | }||||fS )Nr r )r r r r r] r] )rc rE r0 rQ )r r~ r r� r� r� r� r� r� r� r� ZxPoints1ZxPoints2Z
xIntersectionZyPoints1ZyPoints2Z
yIntersectionr� ry rz r{ r" r" r# rQ R s zUtilities.intersectionc C s | j ||�dkS )Nr )r r r r )rQ )r r~ r r" r" r# r� h s zUtilities.containsRegionc C s, t jj� }|j| �d }ttt jt|���S )Nr r] )r ZKeymapZ get_defaultZget_entries_for_keycoderA rB � keyval_namer0 )�keycodeZkeymapZentriesr" r" r# �_allNamesForKeyCodek s
z Utilities._allNamesForKeyCodec C s, t tjtj�sdS tj} | r(| j| jfS dS )Nr )r r )r r )rJ r �lastInputEventr
�
KeyboardEvent�lastNonModifierKeyEventZhw_coder )r� r" r" r# �_lastKeyCodeAndModifiersq s z"Utilities._lastKeyCodeAndModifiersc C sL t tjtj�r<tjr<tj} | jdkr,| j}n| j}tjj}nd}d}||fS )z�Convenience method which returns a tuple containing the event
string and modifiers of the last non-modifier key event or ("", 0)
if there is no such event.� BackSpace�Deleter r )r[ r\ ) rJ r rW r
rX rY rT r r )r� �eventStrrK r" r" r# rI | s
z Utilities.lastKeyAndModifiersc C s� yHddl m} |j| �\}}|j||�}|rF|jd� sB|jd�rF|} W n@ | jd�rh| tjd�7 } | jdd�} | jdd�j� } Y nX t j
| �S ) z3Turns a key sequence into a user-presentable label.r )r �+z++r1 �<r �>) r> r Zaccelerator_parseZaccelerator_get_labelr r r r3 r� r ZlocalizeKeySequence)Zsequencer r> rK Z newSequencer" r" r# �labelFromKeySequence� s
z Utilities.labelFromKeySequencec C s� y| j j| j | S | j| j jkr6i | j j| j< Y nX y |j� }W n: tk
r� dddg| j j| j |< | j j| j | S X y|jd�jd�}W n0 dddg| j j| j |< | j j| j | S t|�dkr�|d }|d }|d }nFt|�dk�r*d}|d }y |d }W n d}Y nX n d}d}d}|jdd�j � }| j
|�}| j
|�}| j
|�}| j| j jk�r�i | j j| j< |||g| j j| j |< | j j| j | S ) a2 Gets the mnemonic, accelerator string and possibly shortcut
for the given object. These are based upon the first accessible
action for the object.
Arguments:
- obj: the Accessible object
Returns: list containing strings: [mnemonic, shortcut, accelerator]
r r �;� r r� rR r1 ) r r� � KEY_BINDING� queryActionr Z
getKeyBindingrS rD r3 r� ra )r r, r ZbindingStringsZmnemonicZ fullShortcutZ acceleratorr" r" r# �mnemonicShortcutAccelerator� sJ
z%Utilities.mnemonicShortcutAcceleratorc C s^ yFdd� | j d�D �}dd� |D �}dd� |D �}tdd� |D ��}W n g i fS ||gS )a� Converts a string made up of a series of <key>:<value>; pairs
into a dictionary of keys and values. Text before the colon is the
key and text afterwards is the value. The final semi-colon, if
found, is ignored.
Arguments:
- string: the string of tokens containing <key>:<value>; pairs.
Returns a list containing two items:
A list of the keys in the order they were extracted from the
string and a dictionary of key/value items.
c S s g | ] }|j � �qS r" )r� )r; �sr" r" r# r= � s z1Utilities.stringToKeysAndDict.<locals>.<listcomp>rb c S s" g | ]}t |jd ��dkr|�qS )rR r� )rD rS )r; r� r" r" r# r= � s c S s g | ]}|j d �d j� �qS )rR r )rS r� )r; r� r" r" r# r= � s c S s g | ]}|j d ��qS )rR )rS )r; r� r" r" r# r= � s )rS rU )r� r �keysZ
dictionaryr" r" r# r � s z Utilities.stringToKeysAndDictc 1 C s� y |j � }W n
dS x"|D ]}|jd�r |dd� S q W y |j� }W n tk
r\ dS X |j}y
|j}W n4 ttfk
r� d}d| }tj tj
|d� Y nX y
|j }W n4 ttfk
r� d}d| }tj tj
|d� Y nX y
|j } W n> ttfk
�r, || d } d
| }tj tj
|d� Y nX | dk�r�y t
jtd t
j| � ��}
W n. tk
�r� d | }tj tj
|d� dS X nt|�d
k �r�d
}
nd }
d|
} | | S )z�Returns the text to be displayed for the object's current value.
Arguments:
- obj: the Accessible object that may or may not have a value.
Returns a string representing the value.
r Z valuetext�
Ng z,ERROR: Exception getting maximumValue for %sTz,ERROR: Exception getting minimumValue for %sg Y@z0ERROR: Exception getting minimumIncrement for %sr z2ERROR: Exception calculating decimal places for %sr z%%.%df)rV r� r r r. r r� r� r r& r' r ZminimumIncrement�mathZceilr� Zlog10rp r� ) r r, r� Z attributer r. ZmaxValuer. ZminValueZ minIncrementZ
decimalPlacesZ formatterr" r" r# � textForValue� sT
zUtilities.textForValuec C s( y dt | � S tjtj� dS dS )z� Returns a four hex digit representation of the given character
Arguments:
- The character to return representation
Returns a string representaition of the given character unicode vlue
z%04xr N)�ordr rz Z
LEVEL_WARNING)rO r" r" r# �unicodeValueString9
s
z Utilities.unicodeValueStringc C s g S )Nr" )r r, r� Z
layoutMode�useCacher" r" r# �getLineContentsAtOffsetI
s z!Utilities.getLineContentsAtOffsetc C s g S )Nr" )r r, r� rn r" r" r# �getObjectContentsAtOffsetL
s z#Utilities.getObjectContentsAtOffsetc C s |s| j � \}}||d fS )Nr )r� )r r, r� � skipSpacer" r" r# �previousContextO
s zUtilities.previousContextc C s |s| j � \}}||d fS )Nr )r� )r r, r� rq r" r" r# � nextContextU
s zUtilities.nextContextc C s$ d}| j |�}|r |jd }||fS )Nr r )r� r� )r r� r� r� r" r" r# � lastContext[
s
zUtilities.lastContextc C s. y | j � }W n tk
r dS X |j|jfS )zSReturns the start and end indices associated with the embedded
object, obj.r )r r )r� r r� r� )r, r� r" r" r# �getHyperlinkRangec
s
zUtilities.getHyperlinkRangec
s� y� j � }|j}W nL tk
r> d� }tjtj|d� g S d� }tjtj|d� g S d� |f }tjtj|d� g }x.t|�D ]"}|j|�}| j|�s�|j |� q�W � j
� }|t j ko�| �rdd� } yt j
� | �}W n$ d� }tjtj|d� Y nX |t jk�r�|�r�|d j
� t j k�r�| j|d �}| �r�� j�r�� fd d�} yt j
� | �}W n$ d� }tjtj|d� Y nX |S )
Nz3INFO: %s does not implement the selection interfaceTz4ERROR: Exception querying selection interface for %sz%INFO: %s reports %i selected childrenc S s | o| j � jtj�S )N)r% r( r) r� )r� r" r" r# r� �
s z,Utilities.selectedChildren.<locals>.<lambda>z1ERROR: Exception calling findAllDescendants on %sr c s | o| j � j kS )N)r� )r� )r, r" r# r� �
s )�querySelection�nSelectedChildrenr r r& r' rc ZgetSelectedChildrW rf rM r) rY r� r� r� r� )
r r, r� ro r. �childrenr� r< rP r� r" )r, r# r� o
sJ
zUtilities.selectedChildrenc C s� y|j � }|j}W nL tk
r> d| }tjtj|d� dS d| }tjtj|d� dS d||f }tjtj|d� |S )Nz3INFO: %s does not implement the selection interfaceTr z4ERROR: Exception querying selection interface for %sz%INFO: %s reports %i selected children)rv rw r r r& r' )r r, r� ro r. r" r" r# �selectedChildCount�
s
z Utilities.selectedChildCountc C s@ dd� }t j||�}||kr<d||f }tjtj|d� d S |S )Nc S s | o| j � jtj�S )N)r% r( r) r� )r� r" r" r# r� �
s z(Utilities.focusedChild.<locals>.<lambda>z ERROR: focused child of %s is %sT)r) r� r r& r' )r r, Z isFocusedr< r. r" r" r# � focusedChild�
s zUtilities.focusedChildc C st | r|j rd S dd� |D �}xP|D ]H}y |j� }W n& d| }tjtj|d� w$Y nX |jtj�r$|S q$W d S )Nc S s g | ]}|j � tjkr|�qS r" )rM r) rY )r; r< r" r" r# r= �
s z*Utilities.popupMenuFor.<locals>.<listcomp>z%ERROR: Exception getting state for %sT)r� r% r r& r' r( r) Z
STATE_ENABLED)r r, Zmenusr� r- r. r" r" r# � popupMenuFor�
s
zUtilities.popupMenuForc
C sZ |sdS y |j � }W n" d| }tjtj|d� dS |tjtjgkrLdS | j|�d k S )NFz$ERROR: Exception getting role for %sT)rM r r& r' r) r� rc r{ )r r, rP r. r" r" r# � isMenuButton�
s zUtilities.isMenuButtonc C s dS )NFr" )r r, r" r" r# �isEntryCompletionPopupItem�
s z$Utilities.isEntryCompletionPopupItemc
sp |sd S y |j � }W n" d| }tjtj|d� d S |tjkrFd S � fdd�|D �}t|�dkrl|d S d S )Nz$ERROR: Exception getting role for %sTc s g | ]}� j |�r|�qS r" )�isEditableTextArea)r; r� )r r" r# r= �
s z9Utilities.getEntryForEditableComboBox.<locals>.<listcomp>r r )rM r r& r' r) r� rD )r r, rP r. rx r" )r r# �getEntryForEditableComboBox�
s
z%Utilities.getEntryForEditableComboBoxc C s | j |�d k S )N)r )r r, r" r" r# �isEditableComboBox�
s z Utilities.isEditableComboBoxc
C s` |sdS y |j � }W n" d| }tjtj|d� dS |jtj�sHdS dd� }tj||�d k S )NFz%ERROR: Exception getting state for %sTc S s | o| j � tjkS )N)rM r) r� )r� r" r" r# r� �
s z:Utilities.isEditableDescendantOfComboBox.<locals>.<lambda>)r% r r& r' r( r) rk r� )r r, r- r. �
isComboBoxr" r" r# rJ �
s z(Utilities.isEditableDescendantOfComboBoxc C s dS )NFr" )r r, r" r" r# � isPopOver s zUtilities.isPopOverc
C sL | j |�sdS y |j� }W n" d| }tjtj|d� dS |jtj� S )NFz%ERROR: Exception getting state for %sT)r� r% r r& r' r( r) Z STATE_MODAL)r r, r- r. r" r" r# �isNonModalPopOver s
zUtilities.isNonModalPopOverc C s dS )NFr" )r r, r" r" r# �isUselessPanel s zUtilities.isUselessPanelc C sB t jdt j�}t j|d|�}|jd�\}}}t|�t|�t|�fS )Nz
rgb|[^\w,]r r� )r$ �compile�
IGNORECASEr% rS rX )r ZattributeValueZregexr� ZredZgreenZbluer" r" r# r s zUtilities.rgbFromStringc C s dS )NFr" )r r, r" r" r# �isClickableElement s z Utilities.isClickableElementc C s dS )NFr" )r r, r" r" r# � hasLongDesc s zUtilities.hasLongDescc C s� |o|j � tjksdS ytdd� |j� D ��}W n" d| }tjtj|d� dS yt|j dd��}W n0 t
k
r� d||f }tjtj|d� dS X |S ) Nr c S s g | ]}|j d d��qS )rR r )rS )r; rT r" r" r# r= ' s z*Utilities.headingLevel.<locals>.<listcomp>z*ERROR: Exception getting attributes for %sTr �0z*ERROR: Exception getting value for %s (%s)) rM r) Z ROLE_HEADINGrU rV r r& r' rX rW rp )r r, rZ r. r r" r" r# � headingLevel" s zUtilities.headingLevelc C sV y |j � }W n tk
r dS X dtjg}x$t|j�D ]}|j|�|kr8dS q8W dS )NFZtoggleT)re r r Z
ACTION_TOGGLErc ZnActionsZgetName)r r, r ZtoggleActionNamesrv r" r" r# �hasMeaningfulToggleAction6 s
z#Utilities.hasMeaningfulToggleActionc
C s� |o|j � tjksg S dd� }tj||�}y |j� }W n
g S | j|�}|j|�|j|� }}|j||�}g } x&t ||| �D ]}
| j
|j |
�� q�W | S )Nc S s | odt j| �kS )Nr� )r) r� )r� r" r" r# r� G s z0Utilities.columnHeadersForCell.<locals>.<lambda>) rM r) r@ r� r^ r\ rg rh �getColumnExtentAtrc rf r\ ) r r, r; rL rm r[ rs rt Zcolspan�headers�cr" r" r# �columnHeadersForCellC s
z Utilities.columnHeadersForCellc
C s� |o|j � tjksg S dd� }tj||�}y |j� }W n
g S | j|�}|j|�|j|� }}|j||�}g } x&t ||| �D ]}
| j
|j |
�� q�W | S )Nc S s | odt j| �kS )Nr� )r) r� )r� r" r" r# r� \ s z-Utilities.rowHeadersForCell.<locals>.<lambda>) rM r) r@ r� r^ r\ rg rh �getRowExtentAtrc rf r] ) r r, r; rL rm r[ rs rt Zrowspanr� r r" r" r# �rowHeadersForCellX s
zUtilities.rowHeadersForCellc C s` |o|j � tjksd S dd� }tj||�}y |j� }W n
d S | j|�}|j|�}|j|�S )Nc S s | odt j| �kS )Nr� )r) r� )r� r" r" r# r� q s z/Utilities.columnHeaderForCell.<locals>.<lambda>)rM r) r@ r� r^ r\ rh r\ )r r, r; rL rm r[ Z columnIndexr" r" r# �columnHeaderForCellm s
z Utilities.columnHeaderForCellc C s` |o|j � tjksd S dd� }tj||�}y |j� }W n
d S | j|�}|j|�}|j|�S )Nc S s | odt j| �kS )Nr� )r) r� )r� r" r" r# r� � s z,Utilities.rowHeaderForCell.<locals>.<lambda>)rM r) r@ r� r^ r\ rg r] )r r, r; rL rm r[ ZrowIndexr" r" r# �rowHeaderForCell| s
zUtilities.rowHeaderForCellc C sn t jt jt jg}|o |j� |ks$dS dd� }t j||�}y |j� }W n
d S | j|�}|j|�|j |�fS )
Nr c S s | odt j| �kS )Nr� )r) r� )r� r" r" r# r� � s z.Utilities.coordinatesForCell.<locals>.<lambda>r] r] )r] r] r] r] )r] r] )
r) r@ rA rB rM r� r^ r\ rg rh )r r, r� r; rL rm r[ r" r" r# rG � s
z Utilities.coordinatesForCellc
C sz |o|j � tjksdS dd� }tj||�}y |j� }W n
d S | j|�}|j|�|j|� }}|j||�|j ||�fS )
Nr c S s | odt j| �kS )Nr� )r) r� )r� r" r" r# r� � s z,Utilities.rowAndColumnSpan.<locals>.<lambda>r] r] )r] r] r] r] )r] r] )
rM r) r@ r� r^ r\ rg rh r� r� )r r, r; rL rm r[ rs rt r" r" r# �rowAndColumnSpan� s
zUtilities.rowAndColumnSpanc C s$ y |j � }W n
dS |j|jfS )Nr r] r] )r] r] )r^ ri r[ )r r, rm r" r" r# �rowAndColumnCount� s
zUtilities.rowAndColumnCountr� c
C st y |j � }W n
dS |j|||�r*dS || || }}|j|||�rpd|||||f } tjtj| d� dS dS )NFTz&INFO: %s contains (%i,%i); not (%i,%i))rv r( r r& r' )
r r, r� ry rR Zmarginr� r� r� r. r" r" r# �
containsPoint� s zUtilities.containsPointc C s |sdS t jt jg}|j� |kS )NF)r) rY r� rM )r r, r� r" r" r# r� � s
z Utilities._boundsIncludeChildrenc C sj | s| j |�rdS |js dS |j� }|tjkr4dS |j� }|jtj�rV|jtj� S tj tj
g}||kS )NFT) rV r� rM r) r� r% r( ZSTATE_EXPANDABLEr_ r� r� )r r, rP r- r� r" r" r# �_treatAsLeafNode� s
zUtilities._treatAsLeafNodec
C sD |sd S |d krt j}| j||||�rB| j|�s<| j|� rZ|S n| j|�sV| j|�rZd S dt j|�k�ry |j� }W n( d| }tjtj |d� d }Y nxX |j
|||�}d||||f }tjtj |d� |o�||k�r| j ||||�}d||||f }tjtj |d� |�r|S x(|D ] }| j ||||�} | �r | S �q W d S )Nr� z)ERROR: Exception querying component of %sTz INFO: %s is at (%s, %s) in %s) r) rx r� r� r� r� rv r r& r' �getAccessibleAtPoint�descendantAtPoint)
r r� r� ry rR r� r. r< rw r, r" r" r# r� � s<
zUtilities.descendantAtPointc C s ||fS )Nr" )r r, r� ry rR r" r" r# �_adjustPointForObj s z Utilities._adjustPointForObjc C s� | j |�}|sdS |d kr tj}|d kr.tj}| j||||�\}}|j|||�}d| kod|jk n sndS |j||�\}} }
|s�d| |
fS |tjkr�|j � r�dS |j
| |
|�} | j | ||ddf�s�dS || |
fS )Nr r r )r r r )r r r )r r r )r r r ) r� r) rx ZTEXT_BOUNDARY_LINE_STARTr� ZgetOffsetAtPointr� ZgetTextAtOffsetZTEXT_BOUNDARY_WORD_STARTr� ZgetRangeExtentsr� ) r r, r� ry rR �boundaryr� r� r� r� r� r� r" r" r# � textAtPoint s(
zUtilities.textAtPointc C sx y|j � }|j}W n
g S d||f }tjtj|d� |\}}}} | j|||d �}
| j|
�\} } td| �}
d|
| f }tjtj|d� y|
j� j t
j �}W n |
}Y nNX | j||||j d �}
| j|
�\} } t|
| �}d|
| f }tjtj|d� | j|||| d �}
| j|
�\} } d|
| f }tjtj|d� | dk�rL|} | }t
t||��}|
|k�rt|jd|
� |S ) NzINFO: %s has %i rowsTr r z INFO: First cell: %s (row: %i)z INFO: Next cell: %s (row: %i)z INFO: Last cell: %s (row: %i)r] )r^ ri r r& r' r� rG r� rv rw r) rx r{ rA rc �insert)r r, r� rm ri r. r� ry rz r{ rw rs rt r� r� Z nextIndexr� �rowsr" r" r# � visibleRows( sB
zUtilities.visibleRowsc C s� y |j � }W n
g S y|j� }|jtj�}W n" d| }tjtj|d� g S | j||�}|shg S | j |�\}}||kr�g S g } xpt
||�D ]b}
|j |
�} | r�| j | � xD|D ]<} y|j
| |
�}
W n w�Y nX |
r�| j|
�r�| j |
� q�W q�W | S )Nz&ERROR: Exception getting extents of %sT)r^ rv rw r) rx r r& r' r� �_getTableRowRangerc r\ rf rj r� )r r, rm r� r� r. r� Z
colStartIndexZ colEndIndex�cellsrt Z colHeaderrs rw r" r" r# r� T s<
z Utilities.getVisibleTableCellsc
C s� | j |�\}}d| }}| j|�s*||fS | j|�}y |j� }W n& d| }tjtj|d� ||fS |jtj �\} }
} } |j
| d |
tj �}
|
r�| j |
�\}}|}|j
| | d |
tj �}
|
r�| j |
�\}}|d }||fS )Nr z3ERROR: Exception querying component interface of %sTr ) r� rE r< rv r r& r' rw r) rx r� rG )r r, ZrowCountZ columnCountr� r� rL r� r. r� ry rz r{ rw rs rI r" r" r# r� y s*
zUtilities._getTableRowRangec
C s� | j |�}y |j� }W n" d| }tjtj|d� g S | j|�\}}|dkrTg S | j|�\}}||krng S g } xPt||�D ]B}
|j||
�} y| j � j
t j �} W n w~Y nX | r~| j
| � q~W | S )Nz/ERROR: Exception querying table interface of %sTr r] )r< r^ r r& r' rG r� rc rj r% r( r) r+ rf )
r r, rL rm r. rs rI r� r� r� rv rw Zshowingr" r" r# �getShowingCellsInSameRow� s.
z"Utilities.getShowingCellsInSameRowc C sr y |j � }W n
d S |j||�}|s,|S y |j� }W n" d| }tjtj|d� d S |� jtj�snd S |S )Nz$ERROR: Exception getting state of %sT) r^ rj r% r r& r' r( r) r+ ) r r, rs rI Z showingOnlyrm rw r- r. r" r" r# �cellForCoordinates� s z Utilities.cellForCoordinatesc
C s� y |j � }W n" d| }tjtj|d� dS |tjks>dS dd� }tj||�}y |j� }W n
dS | j|�}|j |�|j
|� }} |d |j ko�| d |j kS )Nz#ERROR: Exception getting role of %sTFc S s | odt j| �kS )Nr� )r) r� )r� r" r" r# r� � s z&Utilities.isLastCell.<locals>.<lambda>r )
rM r r& r' r) r@ r� r^ r\ rg rh ri r[ )
r r, rP r. r; rL rm r[ rs rt r" r" r# �
isLastCell� s"
zUtilities.isLastCellc C sh y |j � }W n
dS xJt|j�D ]<}x6t|j�D ](}|j||�dksX|j||�dkr4dS q4W q$W dS )NFr T)r^ rc ri r[ r� r� )r r, rm r r� r" r" r# �isNonUniformTable� s zUtilities.isNonUniformTablec
C sh y |j � }W n" d| }tjtj|d� dS |jtj�sH|jtj�rLdS d| }tjtj|d� dS )Nz$ERROR: Exception getting state of %sTFz'INFO: %s is neither showing nor visible)r% r r& r' r( r) r+ �
STATE_VISIBLE)r r, r- r. r" r" r# �isShowingOrVisible� s z Utilities.isShowingOrVisiblec C s� y|j � }|j� }W n" d| }tjtj|d� dS |jtj�rT|jtj�rTdS tj tj
tj tj tj
g}||kr�| j|�r�d| }tjtj|d� dS dS )Nz-ERROR: Exception getting state and role of %sTFz(HACK: Treating %s as showing and visible)r% rM r r& r' r( r) r+ r� rY rZ ZROLE_CHECK_MENU_ITEMZROLE_RADIO_MENU_ITEMra r� )r r, r- rP r. Z menuRolesr" r" r# r� � s( z Utilities.isShowingAndVisiblec
C s. y
|j }W n tjtjd| d� dS dS )NzDEAD: %sTF)r� r r& r' )r r, r� r" r" r# rV s
zUtilities.isDeadc
C s� y |j � }|j� }|j� }W n tjtjd| d� dS tjtjtj tj
tj tj tj
g}|dkr�||kr�tjtjd| d� dS |jtj�r�tjtjd| d� dS |jtj�r�tjtjd| d� dS dS ) NzZOMBIE: %s is null or deadTr zZOMBIE: %s's index is -1zZOMBIE: %s is defunctzZOMBIE: %s is invalidFr] )rY r% rM r r& r' r) r� r� r� rN Z ROLE_PAGEr� r� r( r� Z
STATE_INVALID)r r, r[ r- rP rg r" r" r# rW " s0 zUtilities.isZombiec
s� |o� s d S |j � tjtjgkr$d S � �fdd�}||�r@|}n:ytj||�}W n( d| }tjtj|d� d }Y nX d|� f }tjtj|d� |S )Nc s | o�j | � ddd�S )NT)r| r} )rl )r� )r, r r" r# r� H s z)Utilities.findReplicant.<locals>.<lambda>z*INFO: Exception from findDescendant for %sTz-HACK: Returning %s as replicant for Zombie %s)rM r) r� Z
ROLE_EMBEDDEDr� r r& r' )r r� r, ZisSameZ replicantr. r" )r, r r# �
findReplicant> s
zUtilities.findReplicantc C s< |sd S g }dd� }t t||j� ��}|r6|d j� S |jS )Nc S s | j � tjkS )N)ra r) rb )r r" r" r# r� ] s z3Utilities.getFunctionalChildCount.<locals>.<lambda>r )rA r� r` rd r� )r r, r< r� ro r" r" r# �getFunctionalChildCountX s z!Utilities.getFunctionalChildCountc s^ |sd S g }dd� }t t||j� ��}|rL|d � � fdd�t� j� �D �}|p\dd� |D �S )Nc S s | j � tjkS )N)ra r) rb )r r" r" r# r� i s z1Utilities.getFunctionalChildren.<locals>.<lambda>r c s g | ]}� j |��qS r" )re )r; rv )r r" r# r= m s z3Utilities.getFunctionalChildren.<locals>.<listcomp>c S s g | ]}|�qS r" r" )r; r< r" r" r# r= o s )rA r� r` rc rd )r r, r< r� ro r" )r r# �getFunctionalChildrend s z Utilities.getFunctionalChildrenc C sB |sd S d }dd� }t t||j� ��}|r8|d jd�}|p@|jS )Nc S s | j � tjkS )N)ra r) rk )r r" r" r# r� v s z/Utilities.getFunctionalParent.<locals>.<lambda>r )rA r� r` re rL )r r, r< r� ro r" r" r# �getFunctionalParentq s z Utilities.getFunctionalParentc
s |sdS |j � tjk}|r0�j|�}|r0|d }�j|�}�j|�}|dkrb||jkrb|j� |fS �j|�}t |�dk r�tj
j ||� r�tj tj
g� � �fdd�}tt||��}|o�||ks�d S �j|�� r�tt�j|��}t |�dk� r�dS |j|�}t |�} || fS )Nr r r- c s �j | �p| j� � k S )N)rW rM )r� )� layoutRolesr r" r# r� � s z1Utilities.getPositionAndSetSize.<locals>.<lambda>r] r] )r] r] r] r] )r] r] r] r] )r] r] )rM r) r� r� r� r� rL rY r� rD rn r� ra r` rA r� rP r[ )
r r, r� r� rL r� ZsiblingsZisNotLayoutOnlyZpositionZsetSizer" )r� r r# �getPositionAndSetSize} s2
z Utilities.getPositionAndSetSizec C sP | j jjdi �}|jt|�d�\}}}d||||f }tjtj|d� |||fS )N�textSelectionsr r z.INFO: Cached selection for %s is '%s' (%i, %i)T)r r r )r rH rW r� r r& r' )r r, r� r� r� r� r. r" r" r# �getCachedTextSelection� s
z Utilities.getCachedTextSelectionc s� y |j � }W nV tk
r< d| }tjtj|d� d }Y n( d| }tjtj|d� d }Y nX | jjjd�r�| j|�\}}}|s�d| jjd< i | jjd< | jjjdi �� t |�� kr� j
t |���x*� �fdd�� j � D �D ]}� j
|� q�W d\}} }
|�r�y|j d �\}} W n, d | }tjtj|d� d }} Y nX || k�r�|j
|| �}
x(|
j| j��r�| d 8 } |
d d� }
�q\W d
||
|| f }tjtj|d� || |
f� t |�< � | jjd< d S )Nz%ERROR: %s doesn't implement AtspiTextTz/ERROR: Exception querying text interface for %sr� Fr� c s g | ]}� j |��kr|�qS r" )rW )r; �k)r� r r" r# r= � s z7Utilities.updateCachedTextSelection.<locals>.<listcomp>r r z-ERROR: Exception getting selected text for %sr z+INFO: New selection for %s is '%s' (%i, %i))r r r r] )r� r r r& r' r rH rW r� r� �poprh r� r� r r� ) r r, r� r. r� Z
selectedStartZ selectedEndr� r� r� r� r" )r� r r# �updateCachedTextSelection� sJ
z#Utilities.updateCachedTextSelectionc G s t j}|sd S |j| � d S )N)r r( �onClipboardContentsChanged)�argsr! r" r" r# r� � s z$Utilities.onClipboardContentsChangedc C s8 | j d k rd S tjjtjjdd��}|jd| j�| _ d S )N� CLIPBOARDFz owner-change) r r � ClipboardrW r �Atom�internZconnectr� )r � clipboardr" r" r# �connectToClipboard� s
z Utilities.connectToClipboardc C s4 | j d krd S tjjtjjdd��}|j| j � d S )Nr� F)r r r� rW r r� r� Z
disconnect)r r� r" r" r# �disconnectFromClipboard� s
z!Utilities.disconnectFromClipboardc C s t jjtjjdd��}|j� S )Nr� F)r r� rW r r� r� Z
wait_for_text)r r� r" r" r# �getClipboardContents� s z Utilities.getClipboardContentsc C s& t jjtjjdd��}|j|d� d S )Nr� Fr r] )r r� rW r r� r� �set_text)r r� r� r" r" r# �setClipboardText� s zUtilities.setClipboardTextc C s( t jjtjjdd��}|j| j|� d S )Nr� F)r r� rW r r� r� Z request_text� _appendTextToClipboardCallback)r r� r� r" r" r# �appendTextToClipboard� s z Utilities.appendTextToClipboardc C s& |j d�}d||f }|j|d� d S )NrC z%s
%sr r] )�rstripr� )r r� r� r@ r" r" r# r� � s
z(Utilities._appendTextToClipboardCallbackc C s t j}t|tj�sdS |j� S )NF)r rW rJ r
rX ZisPrintableKey)r r� r" r" r# � lastInputEventWasPrintableKey� s z'Utilities.lastInputEventWasPrintableKeyc C s | j � \}}|tj@ S )N)rI r �CTRL_MODIFIER_MASK)r � keyStringrK r" r" r# �lastInputEventWasCommand s z"Utilities.lastInputEventWasCommandc C s$ | j � \}}|dkrdS |tj@ S )N�Left�RightF)r� r� )rI r r� )r r� rK r" r" r# �lastInputEventWasCharNav s z"Utilities.lastInputEventWasCharNavc C s" | j � \}}|dkrdS |tj@ S )Nr� r� F)r� r� )rI r r� )r r� rK r" r" r# �lastInputEventWasWordNav s z"Utilities.lastInputEventWasWordNavc C s4 | j � \}}|dkrdS | jtj�r(dS |tj@ S )NrD rE F)rD rE )rI rJ r r� r r� )r r� rK r" r" r# �lastInputEventWasLineNav s z"Utilities.lastInputEventWasLineNavc C s$ | j � \}}|dkrdS |tj@ S )N�Home�EndF)r� r� )rI r r� )r r� rK r" r" r# � lastInputEventWasLineBoundaryNav s z*Utilities.lastInputEventWasLineBoundaryNavc C s4 | j � \}}|dkrdS | jtj�r(dS |tj@ S )NrF rG F)rF rG )rI rJ r r� r r� )r r� rK r" r" r# �lastInputEventWasPageNav& s z"Utilities.lastInputEventWasPageNavc C s" | j � \}}|dkrdS |tj@ S )Nr� r� F)r� r� )rI r r� )r r� rK r" r" r# � lastInputEventWasFileBoundaryNav0 s z*Utilities.lastInputEventWasFileBoundaryNavc C s" | j � \}}|tj@ r |dkS dS ) Nr� r� rD rE r� r� F)r� r� rD rE r� r� )rI r �SHIFT_MODIFIER_MASK)r r� rK r" r" r# �&lastInputEventWasCaretNavWithSelection7 s
z0Utilities.lastInputEventWasCaretNavWithSelectionc C s< | j � \}}| j|�}d|kr"dS |tj@ r8|tj@ S dS )N�zF)rZ rV r r� r� )r rU rK r r" r" r# �lastInputEventWasUndo> s
z Utilities.lastInputEventWasUndoc C s: | j � \}}| j|�}d|kr"dS |tj@ r6|tj@ S dS )Nr� F)rZ rV r r� r� )r rU rK r r" r" r# �lastInputEventWasRedoI s
z Utilities.lastInputEventWasRedoc C s< | j � \}}| j|�}d|kr"dS |tj@ r8|tj@ S dS )Nr� F)rZ rV r r� r� )r rU rK r r" r" r# �lastInputEventWasCutT s
z Utilities.lastInputEventWasCutc C s< | j � \}}| j|�}d|kr"dS |tj@ r8|tj@ S dS )Nr� F)rZ rV r r� r� )r rU rK r r" r" r# �lastInputEventWasCopy_ s
z Utilities.lastInputEventWasCopyc C s< | j � \}}| j|�}d|kr"dS |tj@ r8|tj@ S dS )N�vF)rZ rV r r� r� )r rU rK r r" r" r# �lastInputEventWasPastej s
z Utilities.lastInputEventWasPastec C s< | j � \}}| j|�}d|kr"dS |tj@ r8|tj@ S dS )Nr| F)rZ rV r r� r� )r rU rK r r" r" r# �lastInputEventWasSelectAllu s
z$Utilities.lastInputEventWasSelectAllc C sD | j � \}}|dkrdS | j� \}}| j|�}d|kr:dS |tj@ S )Nr\ Tr� F)rI rZ rV r r� )r r� rK rU r r" r" r# �lastInputEventWasDelete� s
z!Utilities.lastInputEventWasDeletec C s& t j}t|tj�r"|jdko |jS dS )N�1F)r rW rJ r
�MouseButtonEvent�button�pressed)r r� r" r" r# �"lastInputEventWasPrimaryMouseClick� s z,Utilities.lastInputEventWasPrimaryMouseClickc C s& t j}t|tj�r"|jdko |jS dS )N�2F)r rW rJ r
r� r� r� )r r� r" r" r# �!lastInputEventWasMiddleMouseClick� s z+Utilities.lastInputEventWasMiddleMouseClickc C s& t j}t|tj�r"|jdko |jS dS )N�3F)r rW rJ r
r� r� r� )r r� r" r" r# �$lastInputEventWasSecondaryMouseClick� s z.Utilities.lastInputEventWasSecondaryMouseClickc C s( t j}t|tj�r$|jdko"|j S dS )Nr� F)r rW rJ r
r� r� r� )r r� r" r" r# �$lastInputEventWasPrimaryMouseRelease� s z.Utilities.lastInputEventWasPrimaryMouseReleasec C s( t j}t|tj�r$|jdko"|j S dS )Nr� F)r rW rJ r
r� r� r� )r r� r" r" r# �#lastInputEventWasMiddleMouseRelease� s z-Utilities.lastInputEventWasMiddleMouseReleasec C s( t j}t|tj�r$|jdko"|j S dS )Nr� F)r rW rJ r
r� r� r� )r r� r" r" r# �&lastInputEventWasSecondaryMouseRelease� s z0Utilities.lastInputEventWasSecondaryMouseRelease� �?c
C s� t j}|sdS tj� }||j |kr(dS | jjjdd�}|| |k rHdS t|tj�rb| j � s�dS n2t|tj
�r�|j | jj �s�| j
� \}}|d kr�dS yt jj� }W n$ dt j }tjtj|d� dS tjtjtjtjg} || kS )
NFzlast-table-sort-timeg rB �spacer1 z$ERROR: Exception getting role for %sT)rB r� r1 )r rW �timer rH rW rJ r
r� r� rX Z isHandledByZleftClickReviewItemrI r� rM r r& r' r) rA rB ZROLE_TABLE_COLUMN_HEADERZROLE_TABLE_ROW_HEADER)
r r� r� ZnowZ lastSortTimer� rK rP r. r� r" r" r# �lastInputEventWasTableSort� s8
z$Utilities.lastInputEventWasTableSortc C sN |j jd� r |j jd� r dS y|jj� }|jj� }W n$ d|j }tjtj|d� dS tj tj
tj tj tj
g}||kr�d}tjtj|d� dS |tjkr�|jtj� r�|jtj� r�d}tjtj|d� dS | j|j�r�|jtj�S |tjk�r
|jtj��r
dS tj|j|jjgk�r$dS | jtj��r6dS d}tjtj|d� dS ) Nzobject:text-changed:z object:text-attributes-changedFz-ERROR: Exception getting role and state of %sTz.INFO: Event is not being presented due to rolez9INFO: Event is not being presented due to role and statesz7INFO: Event is not being presented due to lack of cause)rH r� r� rM r% r r& r' r) rN rY rZ Z ROLE_SLIDERZROLE_SPIN_BUTTONr@ r( r� r� r� re r r� rL rV )r r� rP r- r. Z ignoreRolesr" r" r# �,isPresentableTextChangedEventForLocusOfFocus� sH
z6Utilities.isPresentableTextChangedEventForLocusOfFocusc C s, |j jd�sdS | j� \}}|dkr(dS dS )Nzobject:text-changed:deleteFr[ T)rH r� rI )r r� r� rK r" r" r# �#isBackSpaceCommandTextDeletionEvent s z-Utilities.isBackSpaceCommandTextDeletionEventc C s |j jd�sdS | j� S )Nzobject:text-changed:deleteF)rH r� r� )r r� r" r" r# � isDeleteCommandTextDeletionEvent s z*Utilities.isDeleteCommandTextDeletionEventc C s4 |j jd�sdS | j� s dS | j|j�\}}}| S )Nzobject:text-changed:deleteF)rH r� r� r� r� )r r� r� r� r� r" r" r# � isUndoCommandTextDeletionEvent s z(Utilities.isUndoCommandTextDeletionEventc C sD |j jd�sdS | j� r dS | j|j�\}}}|oB|j� |jj� kS )Nzobject:text-changed:deleteF)rH r� r� r� r� r� r� )r r� r� r� r� r" r" r# �isSelectedTextDeletionEvent" s z%Utilities.isSelectedTextDeletionEventc C sF |j jd�sdS | j|j� | j|j�\}}}|oD||jkoD||jkS )Nzobject:text-changed:insertF)rH r� r� r� r� r� Zdetail1)r r� r� r� r� r" r" r# � isSelectedTextInsertionEvent, s
z&Utilities.isSelectedTextInsertionEventc C s | j � s dS | j|�rdS dS )NFT)r� r� )r r� r" r" r# �isSelectedTextRestoredEvent4 s
z%Utilities.isSelectedTextRestoredEventc C s |j jd�sdS | j� S )Nzobject:text-changed:insertF)rH r� r� )r r� r" r" r# �%isMiddleMouseButtonTextInsertionEvent= s z/Utilities.isMiddleMouseButtonTextInsertionEventc
C sx |j jd�sdS y|jj� }W n$ d|j }tjtj|d� dS |tjkrXt j
d�S t |j j
� �dkrtt j
d�S dS )Nzobject:text-changed:insertFz#ERROR: Exception getting role of %sTZ
enableKeyEchor r )rH r� r� rM r r& r' r) re r$ r% rD r� r� )r r� rP r. r" r" r# � isEchoableTextInsertionEventC s
z&Utilities.isEchoableTextInsertionEventc
C sJ | j |�sdS y |j� }W n" d| }tjtj|d� dS |jtj�S )NFz$ERROR: Exception getting state of %sT)rj r% r r& r' r( r) rk )r r, r- r. r" r" r# r~ V s
z Utilities.isEditableTextAreac C s� |j jd�sdS | j� s"| j� r&dS | j|�r4dS d|j krJ| j� rJdS | j|j�sZdS | j� }|sjdS |j |krxdS t
t j d|j ��t
t j d|��kr�dS d|kr�|j j
� |kr�dS dS )Nzobject:text-changedF�deleteTz\wrC )rH r� r� r� r� r� r~ r� r� r� �boolr$ r r� )r r� �contentsr" r" r# �isClipboardTextChangedEventc s(
"z%Utilities.isClipboardTextChangedEventc C sx |pt j}| s| j|�r dS | j� }|s.dS | j|�\}}}|rN||krNdS | j|�pZ|}| j|�rjdS |ov|j|kS )NFT)r r� rV r� r� r� r� )r r, r� r� r� r� r" r" r# � objectContentsAreInClipboard� s
z&Utilities.objectContentsAreInClipboardc C s4 d| j jd< d| j jd< d| j jd< d| j jd< d S )NF�undo�redo�paster zlast-selection-message)r rH )r r" r" r# �clearCachedCommandState� s z!Utilities.clearCachedCommandStatec C s� | j � r@| jjjd�s0| jjtj� d| jjd< | j|j� dS | j � r�| jjjd�sp| jjtj
� d| jjd< | j|j� dS dS )Nr� Tr� F) r� r rH rW �presentMessager �UNDOr� r� r� �REDO)r r� r" r" r# �handleUndoTextEvent� s z Utilities.handleUndoTextEventc C sx | j � r dS | j� r@| jjjd�s<| jjtj� d| jjd< dS | j� rt| jjjd�sp| jjtj � d| jjd< dS dS )NFr� Tr� )
r� r� r rH rW r� r r� r� r� )r r" r" r# � handleUndoLocusOfFocusChange� s z&Utilities.handleUndoLocusOfFocusChangec C sH | j � r dS | j� rD| jjjd�s@| jjtjtj� d| jjd< dS dS )NFr� T) r� r� r rH rW r� r ZCLIPBOARD_PASTED_FULLZCLIPBOARD_PASTED_BRIEF)r r" r" r# � handlePasteLocusOfFocusChange� s z'Utilities.handlePasteLocusOfFocusChangec C s | j � r dS | j� rdS dS )NTF)r r )r r" r" r# �presentFocusChangeReason� s
z"Utilities.presentFocusChangeReasonc C sf | j |�\}}}| j|� | j |�\}}}| jjjd�t|�krDdS | jt|��rVdS g }tt ||��} tt ||��}
| j
|
�s�dS | r�|
r�| j |
� r�|j ||t
jg� |j ||t
jg� n\t| j|
��} | s�dS | d | d d } }
| |
k �r|j | |
t
jg� n|j | |
t
jg� tjd� }x:|D ]2\}}}| jj|||� |�r,| jj|dd� �q,W dS ) NZlastAutoCompleteFTr r r7 )Z interruptr] )r� r� r rH rW r� �_speakTextSelectionStaterD r0 rc �unionrQ rf r ZTEXT_UNSELECTEDZ
TEXT_SELECTEDrE �symmetric_differencer$ r% Z sayPhrase� speakMessage)r r, ZoldStartZoldEndZ oldStringZnewStartZnewEndr5 ZchangesZoldCharsZnewCharsZchangeZ changeStartZ changeEndr r� r� �messager" r" r# �handleTextSelectionChange� s8
z#Utilities.handleTextSelectionChangec C s t jt jt jt jgS )z!Hacky and to-be-obsoleted method.)r ZPARAGRAPH_SELECTED_DOWNZPARAGRAPH_UNSELECTED_DOWNZPARAGRAPH_SELECTED_UPZPARAGRAPH_UNSELECTED_UP)r r" r" r# � _getCtrlShiftSelectionsStrings s z(Utilities._getCtrlShiftSelectionsStringsc C s� t jd�rdS | j� \}}|tj@ }|tj@ }|dk}d}|dkrT|rT|rTtj}�n\|dkrn|rn|rntj}�nB|dkr�|r�| r�|r�tj }ntj
}�n|dkr�|r�| r�|r�tj }ntj }n�|dkr�|r�|r�| j
� }|r�|d }n|d }n�|d ko�|o�|�r | j
� }|�r|d
}n|d }n�|d k�rL|�rL|�rL|�rDtj}ntj}nd|d
k�rx|�rx|�rx|�rptj}ntj}n8| j� �r�|�r�| jjjd��s�d| jjd< tj}ndS |�s�dS || jjjd�k�r�|| jjd< | jj|� dS )z!Hacky and to-be-obsoleted method.r7 Fr NrG rF rE r rD r� rc r� r� r� Tzlast-selection-message)r$ r% rI r r� r� r ZLINE_SELECTED_RIGHTZLINE_SELECTED_LEFTZPAGE_SELECTED_DOWNZPAGE_UNSELECTED_DOWNZPAGE_SELECTED_UPZPAGE_UNSELECTED_UPr
ZDOCUMENT_SELECTED_UPZDOCUMENT_UNSELECTED_UPZDOCUMENT_SELECTED_DOWNr� r rH rW ZDOCUMENT_SELECTED_ALLr ) r r� r] rK Z isControlKeyZ
isShiftKeyr� r Zstringsr" r" r# r s`
z"Utilities._speakTextSelectionState)N)N)N)N)N)FF)N)N)N)r )F)Tr] )r r] )N)N)NF)T)r1 )N)TT)r Tr] )Nr] Fr] )Nr] F)r� )N)NN)F)r� )N([ �__name__�
__module__� __qualname__r) ZRegistryZ
getDesktopr� r� r. r/ r$ �UNICODE�flagsr� r) r� r3 r2 r� r� rd r� r� r$ r/ � staticmethodr6 r: rI rQ r\ rx 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� 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� 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� 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, r0 r1 r4 r6 r3 r8 r7 r< r= r> r? rD rE rJ rL rM rP rQ rR rT r^ rh ri rl rm ru rl rj r? r� r� r� r r r� r� r� r� rf r� r� r� r� rX r� r' r� r� r� rH 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 r r r� r r r� r r r! r# r& r( r+ r- r6 r= r? r� rL rN rP rS rQ r� rV rZ rI ra rf r rk rm ro rp rr rs rt ru r� ry rz r{ r| r} r r� rJ r� r� r� r r� r� r� r� r� r� r� r� rG r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� rV rW 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� 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 r r r r
r r" r" r" r# r B s�
# 'E6!9 !) &
"
j & &<! " 6. @
) ' #*
% % 5 ! &
!
@ = ,
' ,%
0
$.
-r )$�__doc__Z__id__� __version__Z__date__Z
__copyright__Z __license__rF Zgir
rj r) r$ r2 r� r> r r r r r r r r r
r r r
r r r r r r Z
getManagerr$ r r" r" r" r# �<module> s@