| Server IP : 93.86.61.54 / Your IP : 216.73.216.60 Web Server : Apache/2.4.62 (Ubuntu) System : Linux rasin.ddns.net 6.8.0-124-generic #124~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Tue May 26 21:05:19 UTC x86_64 User : www-data ( 33) PHP Version : 8.4.22 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/lib/python3/dist-packages/orca/__pycache__/ |
Upload File : |
o
S�b& � @ 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 �!� 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.�LGPL� 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 Zej�d�Ze�� ZdZ dZ
g d�Z g d�Z e
jZe
�de�Ze
�dd�e � e�Ze
�dd�e � e�Ze
�d e�Zd
Zd Zd Zd
ZdZdZdd� Z dd� Z e dd� �Z �dYdd�Z dd� Z!e dd � �Z"�dZd 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+�dZd0d1�Z,d2d3� Z-d4d5� Z.�d[d7d8�Z/d9d:� Z0e d;d<� �Z1d=d>� Z2d?d@� Z3dAdB� Z4dCdD� Z5�d[dEdF�Z6�d[dGdH�Z7dIdJ� Z8dKdL� Z9dMdN� Z:dOdP� Z;dQdR� Z<dSdT� Z=dUdV� Z>dWdX� Z?dYdZ� Z@d[d\� ZAd]d^� ZBd_d`� ZCdadb� ZDdcdd� ZEdedf� ZFdgdh� ZGdidj� ZHdkdl� ZIdmdn� ZJdodp� ZKdqdr� ZLdsdt� ZMdudv� ZNdwdx� ZOdydz� ZPd{d|� ZQd}d~� ZRdd�� 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�� Zbd�d�� Zcd�d�� Zdd�d�� 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�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 � 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+�d,�Z��d[�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��dG�dH� Z��dI�dJ� Z��dK�dL� Z��dM�dN� Z��dY�dO�dP�Z��dQ�dR� Z��dS�dT� Z��dU�dV� Z��dW�dX� Z��dY�dZ� Z�e �d[�d\� �Z��d]�d^� Zd_�d`� ZÐda�db� ZĐdc�dd� ZŐde�df� ZƐd\�dg�dh�Zǐdi�dj� Z�e �dk�dl� �Zɐdm�dn� Zʐdo�dp� Z�e �dq�dr� �Z�e �ds�dt� �Z͐du�dv� Zΐdw�dx� Zϐd[�dy�dz�ZАd{�d|� Zѐd}�d~� ZҐd�d�� ZӐd��d�� ZԐd��d�� ZՐd[�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��d��Z�e �d]�d��d���Z�e �d��d�� �Z�e �d��d�� �Z�e �d��d�� �Z�d��d�� Z�d��d�� Z�d��d�� Z�d��d�� Z�d^�d��d��Z�d_�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�e �ddÄ �Z�dĐdń Z��dƐdDŽ 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אdZ��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�d��Z
�da�d�d��Z �d�d� �Z �d��d�� �Z
�d��d�� �Z�d`�d��d���Z�d��d�� �Z�dZ�d��d���Z�d��d � �Z�d�d� �Z�d�d� �Ze �d�d� ��Ze �d�d� ��Z�d �d
� �Z�d �d � �Z�d
�d� �Z�d�d� �Ze �d�d� ��Ze �db�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#e �d$�d%� ��Z$e �d&�d'� ��Z%e �d(�d)� ��Z&e �d*�d+� ��Z'�d,�d-� �Z(e �d.�d/� ��Z)�d0�d1� �Z*e �d2�d3� ��Z+�dc�d4�d5��Z,�dd�d6�d7��Z-�de�d8�d9��Z.�de�d:�d;��Z/�d<�d=� �Z0�d>�d?� �Z1�d@�dA� �Z2�dB�dC� �Z3�dD�dE� �Z4�dF�dG� �Z5�dH�dI� �Z6�dJ�dK� �Z7�dL�dM� �Z8�dN�dO� �Z9�dP�dQ� �Z:�d[�dR�dS��Z;�d[�dT�dU��Z<�dV�dW� �Z=�dX�dY� �Z>�dZ�d[� �Z?�d\�d]� �Z@�d^�d_� �ZA�d`�da� �ZB�db�dc� �ZC�dd�de� �ZD�df�dg� �ZE�dh�di� �ZF�dj�dk� �ZG�dl�dm� �ZH�dn�do� �ZI�dp�dq� �ZJ�dr�ds� �ZK�dt�du� �ZL�dv�dw� �ZM�dx�dy� �ZN�dz�d{� �ZO�d|�d}� �ZP�d~�d� �ZQ�d��d�� �ZR�d��d�� �ZS�d��d�� �ZT�d��d�� �ZU�d��d�� �ZV�d��d�� �ZW�dZ�d��d���ZX�d��d�� �ZY�dZ�d��d���ZZ�d��d�� �Z[�d��d�� �Z\�df�d��d���Z]�d��d�� �Z^�d��d�� �Z_�d��d�� �Z`�d[�d��d���Za�d[�d��d���Zb�d��d�� �Zc�d��d�� �Zd�d[�d��d���Ze�d[�d��d���Zf�d^�d��d���Zg�d��d�� �Zh�d��d�� �Zi�d��d�� �Zj�dY�d��d���Zk�dY�d��d���Zl�d��d�� �Zm�d��d�� �Zn�d��d�� �Zo�d��d�� �Zp�d��d�� �Zq�d��d �Zr�dÐdĄ �Zs�dŐdƄ �Zt�dǐdȄ �Zu�dɐdʄ �Zv�dːd̄ �Zw�dY�d͐d΄�Zx�dϐdЄ �Zy�dѐd҄ �Zze �dӐdԄ ��Z{�dՐdք �Z|�dאd �Z}�dِdڄ �Z~�dېd܄ �Z�dݐdބ �Z��dg�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� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d�d� �Z��d �d � �Z��dh�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/�d0� �Z��d1�d2� �Z��d3�d4� �Z��d5�d6� �Z��d7�d8� �Z��d[�d9�d:��Z��d;�d<� �Z��d=�d>� �Z��d?�d@� �Z��dA�dB� �Z��dC�dD� �Z��dE�dF� �Z��dG�dH� �Z��dI�dJ� �Z��dK�dL� �Z��dZ�dM�dN��Z��dO�dP� �Z��dQ�dR� �Z��dZ�dS�dT��Z��dU�dV� �Z��dW�dX� �Z�d6S (i � Utilitiesr u u )
u ⁰� ¹� ²� ³u ⁴u ⁵u ⁶u ⁷u ⁸u ⁹)
u ₀u ₁u ₂u ₃u ₄u ₅u ₆u ₇u ₈u ₉z(\W+)z[%s]+� z[^\w\s]�displayedDescription�displayedLabel�
displayedText�
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& �7/usr/lib/python3/dist-packages/orca/script_utilities.py�__init___ s
zUtilities.__init__c C s� z|� � }W n d| }t�tj|d� Y dS |�tj�s-d| }t�tj|d� dS |�tj�rAd| }t�tj|d� dS |�tj�sUd| }t�tj|d� dS dS )N�$ERROR: Exception getting state of %sTFzINFO: %s lacks state activez INFO: %s has state iconifiedz INFO: %s lacks state showing) �getStater �println�
LEVEL_INFO�contains�pyatspi� STATE_ACTIVE�STATE_ICONIFIED�
STATE_SHOWING�r$ �obj�state�msgr& r& r' �"_isActiveAndShowingAndNotIconifiedp s& z,Utilities._isActiveAndShowingAndNotIconifiedc C sf | sdS z| � � }W n d| }t�tj|d� Y dS z t�d| �}W n Y dS |�dd�S )Nr z:ERROR: Exception getting process id of %s. May be defunct.Tzcat /proc/%s/cmdline� � )�get_process_idr r+ r, �
subprocess� getoutput�replace)�app�pidr5 �cmdliner& r& r' �_getAppCommandLine� s z Utilities._getAppCommandLineFc C s� |sdS z|� � }W n d }Y d||| �|�f }t�tj|d� |r)|�� | �|�s<d| }t�tj|d� dS d| }t�tj|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)�getApplicationr@ r r+ r, �
clearCacher6 )r$ �windowrB r= r5 r& r& r' �canBeActiveWindow� s"
zUtilities.canBeActiveWindowc s g }|p� � � }|D ]!}z|�� fdd�|D �� W q
d| }t�tj|d� Y q
|sAdttt|�� }t�tj|d� dS t|�dkrYd|d }t�tj|d� |d S t |t
� � j �d
�}d ttt|�� }t�tj|d� d |d }t�tj|d� |d S )
z:Tries to locate the active window; may or may not succeed.c � g | ] }� � |�r|�qS r& �rD ��.0�child�r$ r& r' �
<listcomp>� � 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$ �apps�
candidatesr= r5 r& rJ r' � activeWindow� s, zUtilities.activeWindowc C s� | sdS t |g j�s
|g}t |g j�s|g}d}| j} | rI| | jkrIz| �� }W n Y |S ||v r8| } |S ||v r? |S | j} | rI| | jks"|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)r3 �
ancestorRoles� stopRoles�ancestor�roler& r& r' �ancestorWithRole� s0 ����
zUtilities.ancestorWithRoleTc C s. zt dd� |�� D ��}W |S i }Y |S )Nc S � g | ]}|� d d��qS ��:r ��split�rH �attrr& r& r' rK � z.Utilities.objectAttributes.<locals>.<listcomp>)�dict�
getAttributes)r$ r3 �useCache�rvr& r& r' �objectAttributes� s �zUtilities.objectAttributesc sD � � |�}|�d�}|rt|�S � fdd�}t�||�p |}|�� 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.
ztable-cell-indexc s | o | � � � �� v S �N)r_ � getCellRoles��xrJ r& r' �<lambda> � z%Utilities.cellIndex.<locals>.<lambda>)rq �get�intr. � findAncestor�getIndexInParent)r$ r3 �attrs�index�isCellr& rJ r' � cellIndex s
zUtilities.cellIndexc C sb z|j �� }W n g Y S |�� �tj�sg S g }|�� }z.|D ])}|�� tjkrKt |�
� �D ]}|� |�}|rE|� � dkrE|�
|� q1| W S q"W n Y | �|�}|�|�} |�|�}
| �|�} d} t | d |j�D ]>}
|�|
|
�}|s{qp|�� }|D ]'}|�� tjkr�|� d�}| �||�r�|�
|� n | �|�}|| kr�d} nq�| r� |S qp|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
���Fr r T)r^ �
queryTabler* r- r. �STATE_EXPANDED�getRelationSet�getRelationType�RELATION_NODE_PARENT_OF�range� getNTargets� getTargetr{ �appendr �
getRowAtIndex�getColumnAtIndexr �nRows�getAccessibleAt�RELATION_NODE_CHILD_OF� isSameObject)r$ r3 �table�nodes� relations�relation�target�noder} �row�colr �done�i�cell�nodeOf� currentLevelr& r& r' �
childNodes sd
�
�
��
�
�
�zUtilities.childNodesc
C s\ d||f }t �t j|d� |r|sdS ||kr|S |g}z |j}|r7|j|kr7|�|� |j}|r7|j|ks(|�� W n
t �t j� Y |g}z |j}|rd|j|krd|�|� |j}|rd|j|ksU|�� W n
t �t j� Y d}tt |�t |��}d} | |k r�| �
|| || �r�|| }| d7 } nn| |k s�d|||f }t �t 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, r^ r� �reverse�printException� LEVEL_FINEST�minrT r� )
r$ �a�br5 �aParentsr^ �bParents�commonAncestor� maxSearchr� r& r& r' r� ] sL
�
�
�zUtilities.commonAncestorc C s� t jt jt jg}|�� �t j�s|�� |v rdS d}t|j d dd�D ].}|| �� t j
kr=|| �� �t j �r=|| }n|| �� |vrL| � || �}|rQ |S q#|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. � ROLE_TREE�ROLE_TREE_TABLE�
ROLE_TABLEr* r- �STATE_MANAGES_DESCENDANTSr_ r� �
childCount�ROLE_PUSH_BUTTON�STATE_IS_DEFAULT�
defaultButton)r$ r3 � skipRolesr� r� r& r& r' r� � s(
� �
�zUtilities.defaultButtonc C s� z
| j j| j | W S | j| j jvr i | j j| j< d}Y | �|�}|D ] }| �|| �|��}q&|| 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$ r3 � labelString�labels�labelr& r& r' r � s
�zUtilities.displayedLabelc C � dS �NFr& �r$ r3 r& r& r' �preferDescriptionOverName� � z#Utilities.preferDescriptionOverNamec C s` z|� � }W n ttfy d| }t�tj|d� g Y S w dd� }t||�}dd� |D �S )z(Return a list of objects describing obj.�+ERROR: Exception getting relationset for %sTc S � | � � tjkS rr )r� r. �RELATION_DESCRIBED_BYrt r& r& r' rv � � z1Utilities.descriptionsForObject.<locals>.<lambda>c S �( g | ]}t |�� �D ]}|�|��q
qS r& �r� r� r� �rH �rr� r& r& r' rK � � ( z3Utilities.descriptionsForObject.<locals>.<listcomp>)r� � LookupError� RuntimeErrorr r+ r, �filter)r$ r3 r� r5 � describedByr� r& r& r' �descriptionsForObject� s �
z Utilities.descriptionsForObjectc C s | � |�}tt| j|��S rr )�detailsForObjectrQ rR r )r$ r3 �detailsr& r& r' �detailsContentForObject� s
z!Utilities.detailsContentForObjectc C s� z|� � }|�� }|�� }W n ttfy' d| }t�tj|d� g Y S w dd� }t||�}dd� |D �} | sL|t j
krL|� t j �rLdd� |D �} |sP| S g }
| D ] } |
�
| �| | j�� qT|
S )z4Return a list of objects containing details for obj.z<ERROR: Exception getting relationset, role, and state for %sTc S r� rr )r� r. �RELATION_DETAILSrt r& r& r' rv � r� z,Utilities.detailsForObject.<locals>.<lambda>c S r� r& r� r� r& r& r' rK � r� z.Utilities.detailsForObject.<locals>.<listcomp>c S � g | ]}|�qS r& r& rG r& r& r' rK � � )r� r_ r* r� r� r r+ r, r� r. �ROLE_TOGGLE_BUTTONr- r� rP �findAllDescendants�queryNonEmptyText) r$ r3 �textOnlyr� rc r4 r5 �
hasDetailsr� r� � textObjects�detailr& r& r' r� � s( �
zUtilities.detailsForObjectc C sv z
| j j| j | W S | j| j jvr i | j j| j< Y d�t| j| �|���}|| j j| j |< | j j| j | S )z?Returns the text being displayed for the object describing obj.r8 )r! r� �DISPLAYED_DESCRIPTION�joinrR r r� �r$ r3 �stringr& r& r' r � s �z Utilities.displayedDescriptionc C sf z
| j j| j | W S d}Y z |�� }|j}W n d| }t�tj|d� d}d}Y |tj tj
fv r;|r;|S dt� |�v rT|� � }|�
d|j�}| j|v rTd}|so|tjtjfvroz|j}W n ttfyn Y nw |s�|tj tjfv r�| j|dd�}|s�| j|d dd
�}d �t| j|��}| j| j jvr�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 �Textr r )� minimumWordsF)� onlyShowingr� r8 )r! r� �DISPLAYED_TEXTr_ �namer r+ r, r. r� �
ROLE_LABEL�listInterfaces� queryText�getText�characterCount�EMBEDDED_OBJECT_CHARACTER�ROLE_COMBO_BOX�ROLE_SPIN_BUTTONr� r� �ROLE_LIST_ITEM�unrelatedLabelsr� rR r )r$ r3 r rc r� r5 �textr� r& r& r' r sD
�zUtilities.displayedTextNc C sh |s| � � \}}tjtjtjtjtjtjg}tjtj g}| �
|||�}|s2t j r2t j �
� |v r2t 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_PANErd r � locusOfFocusr_ )r$ r3 �offset�docRolesra �documentr& r& r' �
documentFrameC s �
zUtilities.documentFramec C r� )z5Returns the URI of the document frame that is active.Nr& rJ r& r& r' �documentFrameURIW s zUtilities.documentFrameURIc C sP | sdS | � � �tj�r| S | D ]}zt�|�}|r |W S W q Y qdS )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)�rootrI � candidater& r& r' r� \ s
�zUtilities.focusedObjectc C s� ddg}|pt j}|sd}t�tj|d� |S |�� tjkr"||d< |j}|rO|j|krO|�� tjkr7||d< |�� tj tj
fv rE||d< |j}|rO|j|ks,|S )z;Returns the frame and (possibly) the dialog containing obj.Nz3ERROR: frameAndDialog() called without valid objectTr r ) r r� r r+ r, r_ r. r� r^ � ROLE_DIALOG�ROLE_FILE_CHOOSER)r$ r3 �resultsr5 r^ r& r& r' �frameAndDialog} s&
��zUtilities.frameAndDialogc C s |j tjkrdS dS �NTF)�sourcer r� �r$ �eventr& r& r' � presentEventFromNonShowingObject� s z*Utilities.presentEventFromNonShowingObjectc C s( |r|� � tjkr| �|tj�sdS 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)r_ r. r� r� r r� �r$ r3 r� r& r& r' �grabFocusBeforeRouting� s
�z Utilities.grabFocusBeforeRoutingc C sz |}|D ]6}|du r
dS t |t�s|g}zt |d t�r"|�� }n|�� }W n d}Y ||vr5 dS | �|�}qdS )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)r\ rQ rS � getRoleNamer_ � validParent)r$ r3 � rolesList�currentrc � current_roler& r& r' �hasMatchingHierarchy� s"
� z Utilities.hasMatchingHierarchyc C sN |st j}z|�� }W n Y dS |tjkrdS dd� }t�||�}|d uS )NFc S � | o| � � tjkS rr )r_ r. �
ROLE_TOOL_BARrt r& r& r' rv � � z+Utilities.inFindContainer.<locals>.<lambda>)r r� r_ r. �
ROLE_ENTRYrz )r$ r3 rc � isToolbar�toolbarr& r& r' �inFindContainer� s
zUtilities.inFindContainerc C r� �Nr r& �r$ r� r& r& r' �getFindResultsCount� r� z Utilities.getFindResultsCountc C r� r� r& r� r& r& r' �isAnchor� r� zUtilities.isAnchorc C r� r� r& r� r& r& r' �isCode� r� zUtilities.isCodec C r� r� r& r� r& r& r' �isCodeDescendant� r� zUtilities.isCodeDescendantc C sX z|� � }W n d| }t�tj|d� Y dS |tjkr dS | �|�}|�d�dkS )N�#ERROR: Exception getting role of %sTFz
is-desktop�true)r_ r r+ r, r. r� rq rx )r$ r3 rc r5 r| r& r& r' � isDesktop� s
zUtilities.isDesktopc C r� r� r& r� r& r& r' � isComboBoxWithToggleDescendant r� z(Utilities.isComboBoxWithToggleDescendantc C r� r� r& r� r& r& r' � isToggleDescendantOfComboBox r� z&Utilities.isToggleDescendantOfComboBoxc C r� r� r& r� r& r& r' � isTypeahead r� zUtilities.isTypeaheadc s |� krdS t �|� fdd��S )NTc s | o| � kS rr r& rt �rb r& r' rv � z,Utilities.isOrDescendsFrom.<locals>.<lambda>�r. rz �r$ r3 rb r& r# r' �isOrDescendsFrom s zUtilities.isOrDescendsFromc C r� )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' �isFunctionalDialog s z Utilities.isFunctionalDialogc C r� r� r& r� r& r& r' � isComment r� zUtilities.isCommentc C r� r� r& r� r& r& r' �isContentDeletion r� zUtilities.isContentDeletionc C r� r� r& r� r& r& r' �isContentError r� zUtilities.isContentErrorc C r� r� r& r� r& r& r' �isContentInsertion" r� z Utilities.isContentInsertionc C r� r� r& r� r& r& r' �isContentMarked% r� zUtilities.isContentMarkedc C r� r� r& r� r& r& r' �isContentSuggestion( r� z Utilities.isContentSuggestionc C r� r� r& r� r& r& r' �isInlineSuggestion+ r� z Utilities.isInlineSuggestionc C r� r� r& r� r& r& r' �$isFirstItemInInlineContentSuggestion. r� z.Utilities.isFirstItemInInlineContentSuggestionc C r� r� r& r� r& r& r' �#isLastItemInInlineContentSuggestion1 r� z-Utilities.isLastItemInInlineContentSuggestionc C r� r� r& r� r& r& r' �isEmpty4 r� zUtilities.isEmptyc C r� r� r& r� r& r& r' �isHidden7 r� zUtilities.isHiddenc C r� r� r& r� r& r& r' �isDPub: r� zUtilities.isDPubc C r� r� r& r� r& r& r' �isDPubAbstract= r� zUtilities.isDPubAbstractc C r� r� r& r� r& r& r' �isDPubAcknowledgments@ r� z Utilities.isDPubAcknowledgmentsc C r� r� r& r� r& r& r' �isDPubAfterwordC r� zUtilities.isDPubAfterwordc C r� r� r& r� r& r& r' �isDPubAppendixF r� zUtilities.isDPubAppendixc C r� r� r& r� r& r& r' �isDPubBibliographyI r� z Utilities.isDPubBibliographyc C r� r� r& r� r& r& r' �isDPubBacklinkL r� zUtilities.isDPubBacklinkc C r� r� r& r� r& r& r' �isDPubBibliorefO r� zUtilities.isDPubBibliorefc C r� r� r& r� r& r& r' �
isDPubChapterR r� zUtilities.isDPubChapterc C r� r� r& r� r& r& r' �isDPubColophonU r� zUtilities.isDPubColophonc C r� r� r& r� r& r& r' �isDPubConclusionX r� zUtilities.isDPubConclusionc C r� r� r& r� r& r& r' � isDPubCover[ r� zUtilities.isDPubCoverc C r� r� r& r� r& r& r' � isDPubCredit^ r� zUtilities.isDPubCreditc C r� r� r& r� r& r& r' �
isDPubCreditsa r� zUtilities.isDPubCreditsc C r� r� r& r� r& r& r' �isDPubDedicationd r� zUtilities.isDPubDedicationc C r� r� r& r� r& r& r' �
isDPubEndnoteg r� zUtilities.isDPubEndnotec C r� r� r& r� r& r& r' �isDPubEndnotesj r� zUtilities.isDPubEndnotesc C r� r� r& r� r& r& r' �isDPubEpigraphm r� zUtilities.isDPubEpigraphc C r� r� r& r� r& r& r' �isDPubEpiloguep r� zUtilities.isDPubEpiloguec C r� r� r& r� r& r& r' � isDPubErratas r� zUtilities.isDPubErratac C r� r� r& r� r& r& r' �
isDPubExamplev r� zUtilities.isDPubExamplec C r� r� r& r� r& r& r' �isDPubFootnotey r� zUtilities.isDPubFootnotec C r� r� r& r� r& r& r' �isDPubForeword| r� zUtilities.isDPubForewordc C r� r� r& r� r& r& r' �isDPubGlossary r� zUtilities.isDPubGlossaryc C r� r� r& r� r& r& r' �isDPubGlossref� r� zUtilities.isDPubGlossrefc C r� r� r& r� r& r& r' � isDPubIndex� r� zUtilities.isDPubIndexc C r� r� r& r� r& r& r' �isDPubIntroduction� r� z Utilities.isDPubIntroductionc C r� r� r& r� r& r& r' �isDPubPagelist� r� zUtilities.isDPubPagelistc C r� r� r& r� r& r& r' �isDPubPagebreak� r� zUtilities.isDPubPagebreakc C r� r� r& r� r& r& r' �
isDPubPart� r� zUtilities.isDPubPartc C r� r� r& r� r& r& r' �
isDPubPreface� r� zUtilities.isDPubPrefacec C r� r� r& r� r& r& r' �isDPubPrologue� r� zUtilities.isDPubProloguec C r� r� r& r� r& r& r' �isDPubPullquote� r� zUtilities.isDPubPullquotec C r� r� r& r� r& r& r' � isDPubQna� r� zUtilities.isDPubQnac C r� r� r& r� r& r& r' �isDPubSubtitle� r� zUtilities.isDPubSubtitlec C r� r� r& r� r& r& r' � isDPubToc� r� zUtilities.isDPubTocc C r� r� r& r� r& r& r' �isFeed� r� zUtilities.isFeedc C r� r� r& r� r& r& r' �isFigure� r� zUtilities.isFigurec C r� r� r& r� r& r& r' �isGrid� r� zUtilities.isGridc C r� r� r& r� r& r& r' �
isGridCell� r� zUtilities.isGridCellc C r� r� r& rJ r& r& r' �supportsLandmarkRole� r� z Utilities.supportsLandmarkRolec C r� r� r& r� r& r& r' �
isLandmark� r� zUtilities.isLandmarkc C r� r� r& r� r& r& r' �isLandmarkWithoutType� r� z Utilities.isLandmarkWithoutTypec C r� r� r& r� r& r& r' �isLandmarkBanner� r� zUtilities.isLandmarkBannerc C r� r� r& r� r& r& r' �isLandmarkComplementary� r� z!Utilities.isLandmarkComplementaryc C r� r� r& r� r& r& r' �isLandmarkContentInfo� r� z Utilities.isLandmarkContentInfoc C r� r� r& r� r& r& r' �isLandmarkForm� r� zUtilities.isLandmarkFormc C r� r� r& r� r& r& r' �isLandmarkMain� r� zUtilities.isLandmarkMainc C r� r� r& r� r& r& r' �isLandmarkNavigation� r� z Utilities.isLandmarkNavigationc C r� r� r& r� r& r& r' �
isDPubNoteref� r� zUtilities.isDPubNoterefc C r� r� r& r� r& r& r' �isLandmarkRegion� r� zUtilities.isLandmarkRegionc C r� r� r& r� r& r& r' �isLandmarkSearch� r� zUtilities.isLandmarkSearchc C r� r� r& r� r& r& r' �speakMathSymbolNames� r� z Utilities.speakMathSymbolNamesc C r� r� r& rJ r& r& r' �isInMath� r� zUtilities.isInMathc C r� r� r& r� r& r& r' �isMath� r� zUtilities.isMathc C r� r� r& r� r& r& r' �isMathLayoutOnly� r� zUtilities.isMathLayoutOnlyc C r� r� r& r� r& r& r' �isMathMultiline� r� zUtilities.isMathMultilinec C r� r� r& r� r& r& r' �isMathEnclosed� r� zUtilities.isMathEnclosedc C r� r� r& r� r& r& r' � isMathFenced� r� zUtilities.isMathFencedc C r� r� r& r� r& r& r' �isMathFractionWithoutBar� r� z"Utilities.isMathFractionWithoutBarc C r� r� r& r� r& r& r' �
isMathPhantom� r� zUtilities.isMathPhantomc C r� r� r& r� r& r& r' �isMathMultiScript� r� zUtilities.isMathMultiScriptc C r� r� r& r� r& r& r' �isMathSubOrSuperScript� r� z Utilities.isMathSubOrSuperScriptc C r� r� r& r� r& r& r' �isMathUnderOrOverScript� r� z!Utilities.isMathUnderOrOverScriptc C r� r� r& r� r& r& r' �isMathSquareRoot� r� zUtilities.isMathSquareRootc C r� r� r& r� r& r& r' � isMathTable� r� zUtilities.isMathTablec C r� r� r& r� r& r& r' �isMathTableRow r� zUtilities.isMathTableRowc C r� r� r& r� r& r& r' �isMathTableCell r� zUtilities.isMathTableCellc C r� r� r& r� r& r& r' � isMathToken r� zUtilities.isMathTokenc C r� r� r& r� r& r& r' �isMathTopLevel r� zUtilities.isMathTopLevelc C � d S rr r& r� r& r& r' �getMathDenominator r� z Utilities.getMathDenominatorc C rz rr r& r� r& r& r' �getMathNumerator r� zUtilities.getMathNumeratorc C rz rr r& r� r& r& r' �getMathRootBase r� zUtilities.getMathRootBasec C rz rr r& r� r& r& r' �getMathRootIndex r� zUtilities.getMathRootIndexc C rz rr r& r� r& r& r' �getMathScriptBase r� zUtilities.getMathScriptBasec C rz rr r& r� r& r& r' �getMathScriptSubscript r� z Utilities.getMathScriptSubscriptc C rz rr r& r� r& r& r' �getMathScriptSuperscript r� z"Utilities.getMathScriptSuperscriptc C rz rr r& r� r& r& r' �getMathScriptUnderscript! r� z"Utilities.getMathScriptUnderscriptc C rz rr r& r� r& r& r' �getMathScriptOverscript$ r� z!Utilities.getMathScriptOverscriptc C � g S rr r& r� r& r& r' �getMathPrescripts' r� zUtilities.getMathPrescriptsc C r� rr r& r� r& r& r' �getMathPostscripts* r� z Utilities.getMathPostscriptsc C r� rr r& r� r& r& r' �getMathEnclosures- r� zUtilities.getMathEnclosuresc C s dgS r r& r� r& r& r' �getMathFencedSeparators0 � z!Utilities.getMathFencedSeparatorsc C s ddgS r r& r� r& r& r' �
getMathFences3 � zUtilities.getMathFencesc C r� �Nr r& )r$ r3 �testr& r& r' �getMathNestingLevel6 r� z Utilities.getMathNestingLevelc C s g d�S )N)�banner�
complementary� 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-toc�form�main�
navigation�region�searchr& rJ r& r& r' �getLandmarkTypes9 r� zUtilities.getLandmarkTypesc C s� |r |� � tjks dS z|�� }W n' ty' d| }t�tj|d� Y dS d| }t�tj|d� Y dS z|j|j krOd| }t�tj|d� W dS W dS d| }t�tj|d� Y dS )NF�&ERROR: %s doesn't implement AtspiValueT�%ERROR: Exception getting value for %szINFO: %s is busy indicatorz+INFO: %s is either busy indicator or broken)
r_ r. �ROLE_PROGRESS_BAR�
queryValue�NotImplementedErrorr r+ r, � maximumValue� minimumValue)r$ r3 �valuer5 r& r& r' �
isProgressBarV s. � �zUtilities.isProgressBarc C s� t �d�st �d�st �d�sdS | �|�sdS | �|�r dS t �d�r0dd � }t�||�r0d
S t �d �}|tjkr<d S |tjkrV| � |�}|t
j krMd
S dd|t
j f fS |tj krw|ra|j
}n|�� }|t
jjkrmdS dd|t
jjf fS dS )N�speakProgressBarUpdates�brailleProgressBarUpdates�beepProgressBarUpdates)FzUpdates not enabled)FzIs not progress bar)Fz Has no size�ignoreStatusBarProgressBarsc S r rr �r_ r. �ROLE_STATUS_BARrt r& r& r' rv ~ r z/Utilities.isProgressBarUpdate.<locals>.<lambda>)FzIs status bar descendant�progressBarVerbosity)TzVerbosity is all)TzVerbosity is windowFzWindow %s is not %s)TzVerbosity is appzApp %s is not %s)Tz Not handled by any other case)�_settingsManager�
getSettingr� � hasNoSizer. rz r �PROGRESS_BAR_ALL�PROGRESS_BAR_WINDOW�topLevelObjectr r[ �PROGRESS_BAR_APPLICATION�host_applicationrA � activeScriptr= )r$ r3 r � isStatusBar� verbosity�topLevelr= r& r& r' �isProgressBarUpdateq s<
��
z Utilities.isProgressBarUpdatec C s� z|� � }|j|j|j}}}W n' ty' d| }t�tj|d� Y d S d| }t�tj|d� Y d S |�� � t
j �rUd||f }t�tj|d� |dkrUd S || kr_|krsn nd| krndkrqt |�S d S d S t ||| d �S )Nr� Tr� z0INFO: %s has state indeterminate and value of %sr r �d )
r� r� � currentValuer� r� r r+ r, r* r- r. �STATE_INDETERMINATEry )r$ r3 r� �minval�val�maxvalr5 r& r& r' �getValueAsPercent� s, �zUtilities.getValueAsPercentc C s |o|� � tjkS rr )r_ r. �ROLE_BLOCK_QUOTEr� r& r& r' � isBlockquote� s zUtilities.isBlockquotec C �R |r |� � tjks dS z t�|| j�}W |d uS d| }t�tj|� Y dS �NF�'ERROR: Exception finding ancestor of %s)r_ r. � ROLE_LISTrz �
isDocumentr r+ r, �r$ r3 r� r5 r& r& r' �isDocumentList� � �zUtilities.isDocumentListc C r� r� )r_ r. �
ROLE_PANELrz r� r r+ r, r� r& r& r' �isDocumentPanel� r� zUtilities.isDocumentPanelc C s, t jt jt jt jt jt jg}|o|�� |v S rr )r. r� r� r� r� r� r� r_ )r$ r3 �
documentRolesr& r& r' r� � s �zUtilities.isDocumentc C s |pt j}| �|�d uS rr )r r� �getDocumentForObjectr� r& r& r' �inDocumentContent� s
zUtilities.inDocumentContentc C s | � tj�S rr )� getTopLevelDocumentForObjectr r� )r$ rC r& r& r' �activeDocument� � zUtilities.activeDocumentc C s | � |�o t�|| j � S rr )r� r. rz r� r& r& r' �isTopLevelDocument� s z Utilities.isTopLevelDocumentc C s | � |�r|S t�|| j �S rr )r� r. rz r� r& r& r' r� � s
z&Utilities.getTopLevelDocumentForObjectc C sP |sd S | � |�r |S z
t�|| j �}W |S d| }t�tj|d� Y d S )Nr� T)r� r. rz r r+ r, )r$ r3 �docr5 r& r& r' r� � s
�z Utilities.getDocumentForObjectc sh |sd S t jt jt jg� � fdd�}||�r|S z t �||�}W |S d| }t�tj|d� Y d S )Nc s | o| � � � v odt�| �v S �N�Table)r_ r. r� rt ��
tableRolesr& r' rv � � z$Utilities.getTable.<locals>.<lambda>r� T)r. r� r� r� rz r r+ r, )r$ r3 �isTabler� r5 r& r� r' �getTable� s �zUtilities.getTablec C s6 |r |� � tjks dS | �|�}|sdS |� � tjkS r� )r_ r. r� r� r� )r$ r3 r� r& r& r' �isTextDocumentTable s
z Utilities.isTextDocumentTablec C s$ |r |� � tjks dS | �|�d u S r� )r_ r. r� r� r� r& r& r' �
isGUITable s zUtilities.isGUITablec C s� |sdS z|� � }W n d| }t�tj|d� Y dS |tjks$dS | �|�}|s-dS |� � tjkr6dS z|�� }W n' t yR d| }t�tj|d� Y dS d| }t�tj|d� Y dS |j
dkS )NFr T�2ERROR: Table %s does not implement table interface�/ERROR: Exception querying table interface of %si ) r_ r r+ r, r. r� r� r� r� r� r� )r$ r3 rc r5 r� r� r& r& r' �isSpreadSheetTable s4
�
�z Utilities.isSpreadSheetTablec C s t jt jt jt jt jgS rr )r. �ROLE_TABLE_CELL�ROLE_TABLE_COLUMN_HEADER�ROLE_TABLE_ROW_HEADER�ROLE_COLUMN_HEADER�ROLE_ROW_HEADERrJ r& r& r' rs ; s �zUtilities.getCellRolesc C �X |sdS z|� � }W n d| }t�tj|d� Y dS || �� vr%dS t�|| j�S �NFr T)r_ r r+ r, rs r. rz r� �r$ r3 rc r5 r& r& r' �isTextDocumentCellB � z Utilities.isTextDocumentCellc C r� r� )r_ r r+ r, rs r. rz r� r� r& r& r' �isSpreadSheetCellR r� zUtilities.isSpreadSheetCellc C s0 | � |�\}}|dkr
dS | jj�d�}||kS )Nr� F�
lastColumn��coordinatesForCellr! �pointOfReferencerx )r$ r� r� �columnr� r& r& r' �cellColumnChangedb �
zUtilities.cellColumnChangedc C s0 | � |�\}}|dkr
dS | jj�d�}||kS )Nr� F�lastRowr� )r$ r� r� r� r� r& r& r' �cellRowChangedj r� zUtilities.cellRowChangedc C s` | j �� rdS | �|�sdS | �|�}|sdS | �|�s!t�d�S | �|�r+t�d�S t�d�S )NF�readFullRowInGUITable�readFullRowInSpreadSheet�readFullRowInDocumentTable)r! �inSayAllr� r� r� r� r� r� )r$ r3 r� r& r& r' �shouldReadFullRowr s
zUtilities.shouldReadFullRowc C r� r� r& r� r& r& r' �isSorted� r� zUtilities.isSortedc C r� r� r& r� r& r& r' � isAscending� r� zUtilities.isAscendingc C r� r� r& r� r& r& r' � isDescending� r� zUtilities.isDescendingc C sX |r| � |�s dS | �|�rtj}n | �|�rtj}ntj}|r*|jr*d|j|f }|S )Nr z%s. %s)r� r� r �SORT_ORDER_ASCENDINGr� �SORT_ORDER_DESCENDING�SORT_ORDER_OTHERr� )r$ r3 � includeName�resultr& r& r' �getSortOrderDescription� s
z!Utilities.getSortOrderDescriptionc C sl z
|� � }|�� }W n Y dS |tjkrdS |�tj�r dS |�tj�r4d| }t�tj |d� dS dS )NFT�-INFO: %s is focused but lacks state focusable)
r_ r* r. r� r- �STATE_FOCUSABLEr� r r+ r, �r$ r3 rc r4 r5 r& r& r' �isFocusableLabel� �
zUtilities.isFocusableLabelc C sl z
|� � }|�� }W n Y dS |tjkrdS |�tj�r dS |�tj�r4d| }t�tj |d� dS dS )NFr� T)
r_ r* r. r� r- r� r� r r+ r, r r& r& r' �isNonFocusableList� r z Utilities.isNonFocusableListc C s2 |r |� � tjks dS dd� }t�||�rdS dS )NFc S r rr r� rt r& r& r' rv � r z3Utilities.isStatusBarNotification.<locals>.<lambda>T)r_ r. �ROLE_NOTIFICATIONrz �r$ r3 r� r& r& r' �isStatusBarNotification� s z!Utilities.isStatusBarNotificationc C sL |sdS z|� � }W n Y dS |tjkrdS dd� }t�||�r$dS dS )NFTc S � | o | � � tjtjfv S rr )r_ r. r� r� rt r& r& r' rv � rl z,Utilities.isTreeDescendant.<locals>.<lambda>)r_ r. �ROLE_TREE_ITEMrz )r$ r3 rc �isTreer& r& r' �isTreeDescendant� s
zUtilities.isTreeDescendantc C sH d}| � |�s | �|�rdS | �|�}z|�� }W n d}Y z|j�� }W n d}Y z|d }W n d}Y | �� }tjtjtj tj
g}|tj kr�|� d�dkr�z|�
� } W n+ tys d| }
t�tj|
d� d}Y �n� d| }
t�tj|
d� d}Y �n�| jr�| js�|�� �tj� }�n{|� d �d
ks�|� d �d
kr�d}�ni|js�| �|�s�| �d�p�| �d� }�nT|tjkr�|j r�|tj kr�d}�nC|�� tjkr�d}�n8|tj kr�| � |j�}�n+|tj kr�| � |� }�n |tj!kr�d}�n|tj"k�rd}�n |tj#k�rd}�n|tj$k�r!| �%| �&|��}n�|tj'k�r*d}n�|tj(tj)fv �r6d}n�|tj*tj fv �rBd}n�||v �rJd}n�|tjk�rV|tj+k}n�|tj+k�r_d}n�|tj,k�rhd}n�|tj-k�rqd}n�|tj.tj/fv �r}d}n�|tj0tj1tj2fv �r�d}n�|tj k�r�|tj*k�r�d}ny|tj3tj4fv �r�d}nm| �5|��r�|�� } | �tj6��p�| �tj7� }nT|tj8k�r�|j �r�|�r�|�� |v �r�d}n=|tj8k�r�|j|�9� jk�r�d}n+|j d k�r�|j�r�|j|jk�r�d}n| �:|��rd}n| �;|��s| �|��sd}|�r"d
| }
t�tj|
d� |S )z�Returns True if the given object is a container which has
no presentable information (label, name, displayed text, etc.).FTNr z layout-guessr r� r� z xml-rolesr� �tagr z$INFO: %s is deemed to be layout only)<�isDead�isZombierq r_ r^ �_topLevelRolesr. � ROLE_MENU�ROLE_MENU_ITEMr� r r� rx r� r� r r+ r, r� �nColumnsr* r- r� r� r �getColumnHeader� getRowHeaderr� r� r� � isLayoutOnly� ROLE_SECTIONr� r� � ROLE_FILLERr� �ROLE_LAYERED_PANEr r� �ROLE_AUTOCOMPLETE�ROLE_TEAROFF_MENU_ITEM�ROLE_SEPARATOR�
ROLE_LIST_BOXr� r� � ROLE_FORMr� r� � ROLE_TEXT�ROLE_PASSWORD_TEXTr �ROLE_REDUNDANT_OBJECT� ROLE_UNKNOWN�
isTableRowr� �STATE_SELECTABLEr� rA r3 r ) r$ r3 �
layoutOnlyr| rc �
parentRole�
firstChild�
topLevelRoles�ignorePanelParentr� r5 r4 r& r& r' r � s�
�
�
�
� " zUtilities.isLayoutOnlyc C s | rt jsdS t 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� rA �r3 r& r& r' �
isInActiveAppT s
zUtilities.isInActiveAppc C sP |sdS z|� � }W n ttfy" d| }t�tj|d� Y dS w |tjkS )z Returns True if obj is a link.F�$ERROR: Exception getting role for %sT)r_ r� r� r r+ r, r. � ROLE_LINKr� r& r& r' �isLinkb s �
zUtilities.isLinkc C s4 | � |�sdS |�� }|�tj�o|�tj� }|S )z;Returns True if obj is a text entry area that is read only.F)�
isTextArear* r- r. r� �STATE_EDITABLE)r$ r3 r4 �readOnlyr& r& r' �isReadOnlyTextAreaq s
�z Utilities.isReadOnlyTextAreac C r� r� r& r� r& r& r' �isSwitch| r� zUtilities.isSwitchc C sB | j j}d }|D ]}|dkrqz|| }W q Y |S |}|S �Nr� )r! r= )r$ �path�startrp �pr& r& r' �getObjectFromPath s �zUtilities.getObjectFromPathc C s� t j�|�}t j�|�}t|�t|�krdS |dd � }|dd � }|�d�r.|�d�r.dS z|�d�}W n tyS z|�d�}W n
tyP t|�}Y nw Y nw |d|� |d|� kS )NFr r� r )r. �utils�getPathrT �countr} �
ValueError)r$ �obj1�obj2�path1�path2r} r& r& r' � _hasSamePath� s& ���zUtilities._hasSamePathc C s� ||krdS |r
|s dS z[|� � |� � krW dS |j|jkr#|s#W dS |r.| �||�r.W dS |�� �tj�}|�� �tj�}||krEW dS |jdkr\|jdkr_|j dkrb|j
dkreW dS W dS W dS W dS W dS Y dS )NTFr ) r_ r� r? �queryComponent�
getExtentsr. �DESKTOP_COORDSru �y�width�height)r$ r; r< � comparePaths� ignoreNames�extents1�extents2r& r& r' r� � s> ��
�����zUtilities.isSameObjectc C s* | � |�rdS |o|�� tjtjtjfv S )z{Returns True if obj is a GUI component that is for entering text.
Arguments:
- obj: an accessible
F)r, r_ r. r r �ROLE_PARAGRAPHr� r& r& r' r- � 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 ur|�qS rr r& �rH ru r& r& r' rK � rl z/Utilities.knownApplications.<locals>.<listcomp>)r �_desktopr& r& r& r' rO � s zUtilities.knownApplicationsc s� z� � � }W n ttfy d� }t�tj|d� g Y S w dd� }tt|� � � ��}|s1g S |d �t�fdd�t ��
� �D ��}� |v rYd� }t�tj|d� |� � � � fd d
�}tt||��S ) z,Return a list of the labels for this object.r� Tc S r� rr )r� r. �RELATION_LABELLED_BY�r� r& r& r' rv � r� z+Utilities.labelsForObject.<locals>.<lambda>r c � g | ]}� � |��qS r& �r� �rH r� rN r& r' rK � � z-Utilities.labelsForObject.<locals>.<listcomp>z+WARNING: %s claims to be labelled by itselfc s t ��� fdd�� S )Nc � | � kS rr r& rt ��accr& r' rv � � zBUtilities.labelsForObject.<locals>.isNotAncestor.<locals>.<lambda>r% rT r( rT r' �
isNotAncestor� s z0Utilities.labelsForObject.<locals>.isNotAncestor) r� r� r� r r+ r, rQ r� �setr� r� �remove)r$ r3 r� r5 �predr� rW r& )r3 r� r' r� � s& �
zUtilities.labelsForObjectc C sD | � |�}|s dS t�dd|�}|�� }|D ] }|�� s dS q|S )Nr z[-_]r8 )� linkBasename�re�subri �isalpha)r$ r3 �basename�tokens�tokenr& r& r' �linkBasenameToName� s
�z Utilities.linkBasenameToNamec C sN d}z| � � }W n Y |S |�d�}|r�t|�r�|�d�}t|�dkrM|D ]%}|�d�dkrL|d �� s<|dd� }|d �� sH|dd� }|} nq'|�d�d }|sX|S |d dkrm|dd� }|�d�d }|S |�d�sv|}|S |�d�d }|�d �r�|�d�d }|�d
�d }|�d �d }|�d �d }|�d
�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} �.�?�#�%)�queryHyperlink�getURIrT ri �find�isalnumr9 �
startswith)r3 r_ � hyperlink�uri�
expression�itemr& r& r' r[
sJ /
�
�
�
�
zUtilities.linkBasenamec C s� | sdS z| � � W n
ty Y dS w z| �� }W n
ty% Y dS w t|�� �D ]}|�|�}||jkrA||jkrA| S q,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� �queryHypertextr� � getNLinks�getLink�
startIndex�endIndex)r3 �characterIndex� hypertextr� �linkr& r& r' � linkIndexF s& � �
�zUtilities.linkIndexc s� |sdS z
�j j�j | W S �j�j jvr i �j j�j< Y ��|�r-�fdd�}n|�� tjkr9dd� }n
|�� � � fdd�}g }t�||�}|rZ|�|� t�||�}|sMt |�}|�j j�j |< �j j�j | S )zmDetermines the nesting level of this object.
Arguments:
-obj: the Accessible object
r c s
� � | �S rr )r� rt rJ r& r' rv x s
z(Utilities.nestingLevel.<locals>.<lambda>c S s | o | j o | j �� tjkS rr )r^ r_ r. r� rt r& r& r' rv z rL c s | o| � � � kS rr �r_ rt )rc r& r' rv } r� )
r! r� �
NESTING_LEVELr� r_ r. r� rz r� rT )r$ r3 rZ � ancestorsrb r r& )rc r$ r' r g s. �
�zUtilities.nestingLevelc C sX | � |�sdS z
| jj| j | W S | j| jjvr#i | jj| j< Y g }|}d}|s�z|�� }W n ttfyJ d| }t�tj |d� Y dS w d}|D ]}|�
� t j kr_|�
d�} nqO|�|�rud||f }t�tj |d� d}t|�dkr�d | }t�tj |d� d}n
|r�|�|� nd}|r,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� Fr� TNr z0ERROR: %s is already in the list of nodes for %sr� z&INFO: More than 100 nodes found for %sr )r
r! r� �
NODE_LEVELr� r� r� r r+ r, r� r. r� r� r9 rT r� )r$ r3 r� r� r� r� r5 r� r& r& r' r � sR
� ��
�
� zUtilities.nodeLevelc C s� | � |�rdS | �|�rdS | �|�s!d| }t�tj|d� dS z
|�� �tj �}W n d| }t�tj|d� Y dS d||f }t�tj|d� |j
dksV|j dkrdd| }t�tj|d� dS |j
dk r�|j dk r�t |�d kr�d
| }t�tj|d� dS |j
s�|js�|js�d | }t�tj|d� dS |�� tjkr�d | }t�tj|d� dS dS |d u s�| �|j�s�dS | �||�s�t |�d kr�d
|||f }t�tj|d� dS dS )NFz#INFO: %s is not showing and visibleT�'ERROR: Exception getting extents for %sz INFO: Extents for %s are: %si' z(INFO: %s seems to have bogus coordinatesr )r� r� r� r� z!INFO: %s has negative coordinatesz$INFO: %s has no size and no childrenzINFO: %s has no sizezINFO: %s %s not in %s)r r3 �isShowingAndVisibler r+ r, r@ rA r. rB ru rC �tuplerD rE r� r_ r �_boundsIncludeChildrenr^ �containsRegion)r$ r3 � boundingboxr5 �boxr& r& r' �
isOnScreen� sR
zUtilities.isOnScreenc C s� z|� � }W n d| }t�tj|d� Y d S |tjkr d S dt�|�v r4| �|�}|r2|d S d S |D ].}z
|�� |� � }W n d| }t�tj|d� Y q6|�
tj �s`|�
tj �rd| S q6d S )Nr T� Selectionr r) )
r_ r r+ r, r. �
ROLE_MENU_BARr� �selectedChildrenrB r* r- r� �STATE_SELECTED)r$ �menubarrc r5 �selected�menur4 r& r& r' �selectedMenuBarMenu� s6
��z Utilities.selectedMenuBarMenuc sz |sdS dd� }t �||�}|d u rdS | j�t|��� � d u r%| �|�� � s)dS � fdd�}||�r5dS t �||�d uS )NFc S r rr )r_ r. r� rt r& r& r' rv r z/Utilities.isInOpenMenuBarMenu.<locals>.<lambda>c rS rr r& rt �� selectedMenur& r' rv % rV T)r. rz r# rx �hashr� )r$ r3 � isMenuBarr� �inSelectedMenur& r� r' �isInOpenMenuBarMenu s
z Utilities.isInOpenMenuBarMenuc C r� r� r& r� r& r& r' �isStaticTextLeaf+ r� zUtilities.isStaticTextLeafc C r� r� r& r� r& r& r' �isListItemMarker. r� zUtilities.isListItemMarkerc C s8 | � |�rdS | �|�}|sdS tt�d|�dd���S )NFz\w+r r� )r� r� �boolr\ r� r� )r$ r3 r� r& r& r' �hasPresentableText1 s
z Utilities.hasPresentableTextc C sz | � ||�sg S z|�� }W n d| }t�tj|d� g Y S |tjkr)g S |tjkr1|gS |tjkr9|gS |tj krA|gS |tj
krP| � |�| j t
|�< |jrc|j�� tj
krc| �|�sc|gS |tjkr�|js�d| }t�tj|d� |�� d||jf }t�tj|d� |d u r�z |�� }|�tj�}W n d| }t�tj|d� d}Y t�|�}d|v r�d|v r�| �|�}|r�|S g }|jp�|j} |tjtjfv r�| r�|� |� n
| � |�r�|� |� |D ]}
| � |
�s�|� | � |
|�� q�|tj
k�rd | j t
|�< |�r
|S |tj!k�r |j�s | �"|��s g S tj#tjtjtj$tj%tj&tj'tj(tj)g } || v �r:| �s:g S |gS ) Nr Tz)INFO: %s is empty filler. Clearing cache.z INFO: %s reports %i children�&ERROR: Exception getting extents of %s�r r r r r� r� )*r� r_ r r+ r, r. � ROLE_INVALIDr� r� r� r� r� r# r� r^ r� r r� rB r@ rA rB r� �getVisibleTableCellsr� � description�
ROLE_PAGE_TAB�
ROLE_IMAGEr� r� r� rP �getOnScreenObjectsr� r� � ROLE_CANVASr+ r r� r r� �
ROLE_VIEWPORT) r$ r� �extentsrc r5 � component�
interfaces� visibleCells�objects�hasNameOrDescriptionrI �
containersr& r& r' r� ; s�
�
� � z Utilities.getOnScreenObjectsc C s� z
| r | j r | js W dS W n d| }t�tj|d� Y dS | �� }|tjkr+dS |tjkr2dS | j �� tj ks<dS dd� }t
t |dd� | D ���}t |�| jkrUdS dS )z9Determines if obj is a table row -- real or functionally.Fz5ERROR: Exception getting parent and childCount for %sTc S s$ | o| � � tjtjtjtjtjfv S rr )r_ r. r� r� r� r� r� rt r& r& r' rv � s �z&Utilities.isTableRow.<locals>.<lambda>c S r� r& r& rK r& r& r' rK � r� z(Utilities.isTableRow.<locals>.<listcomp>)
r^ r� r r+ r, r_ r. �ROLE_TABLE_ROWr� r� rQ r� rT )r3 r5 rc r~ � cellChildrenr& r& r' r! � s( �
zUtilities.isTableRowc s` |� � �tj�r
|S tjtjtjtjtjtj g� t�
|� fdd��}|r.| j j �
|j�s.|}|S )Nc � | o| � � � v S rr r| rt ��rolesr& r' rv � r� z.Utilities.realActiveAncestor.<locals>.<lambda>)r* r- r. r� r� r� r� r� r� r� rz r! � utilitiesr r^ r& r& r� r' �realActiveAncestor� s �z Utilities.realActiveAncestorc s\ � � |�rdS |�� tjkr|S � fdd�|D �}� fdd�|D �}t|�dkr,|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 | ] }� � |�s|�qS r& )r� rK rJ r& r' rK � rL z2Utilities.realActiveDescendant.<locals>.<listcomp>c s g | ] }� � |��� r|�qS r& )r �striprK rJ r& r' rK � r� r r )r r_ r. r� rT )r$ r3 �children�
hasContentr& rJ r' �realActiveDescendant� s
z Utilities.realActiveDescendantc C s |sdS dd� }t �||�d uS )NFc S r rr r� rt r& r& r' rv � r z1Utilities.isStatusBarDescendant.<locals>.<lambda>r% r r& r& r' �isStatusBarDescendant� s z Utilities.isStatusBarDescendantc C s� |r |� � tjks g S t�� }| jj�d�}|s,dd� }tt|| � |���}|| jjd< t�� }d|| }t
� t
j |d� |S )N�statusBarItemsc S s | o| � � tjkS rr r� rt r& r& r' rv � r z*Utilities.statusBarItems.<locals>.<lambda>z)INFO: Time getting status bar items: %.4fT)
r_ r. r� �timer! r� rx rQ r� r� r r+ r, )r$ r3 r4 �items�include�endr5 r& r& r' r� � s zUtilities.statusBarItemsc C s� |� � tjkr |S tjtjtjg}|�� �tj�s |� � |v r!dS d}t |j
d dd�D ])}|| � � tjkr<|| }n|| � � |vrK| � || �}|rU| � |�rU |S q,|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- r� r� r� � statusBarr� )r$ r3 r� r� r� r& r& r' r� � s( �
� zUtilities.statusBarc C rz rr r& r r& r& r' �infoBar r� zUtilities.infoBarc C � t jt jt jt jgS rr )r. �
ROLE_ALERTr� r� � ROLE_WINDOWrJ r& r& r' r s
�zUtilities._topLevelRolesc C sn t jsdS zt j�� }W n dt j }t�tj|d� Y dS || �� v }dt j|f }t�tj|d� |S )NFr* Tz INFO: %s is top-level object: %s)r r� r_ r r+ r, r )r$ rc r5 rp r& r& r' � _locusOfFocusIsTopLevelObject s
z'Utilities._locusOfFocusIsTopLevelObjectc C sz |sdS | � � }|r;|jr;||jkr;|�� |vr;|j�� tjks;|j}|r;|jr;||jkr;|�� |vr;|j�� tjkr |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)r r^ r_ r. �ROLE_APPLICATION)r$ r3 � stopAtRolesr& r& r' r� / s � zUtilities.topLevelObjectc C s� |pt j}| �|�}|sdS |�� z|�� }W n d| }t�tj|d� Y dS |�t j
�r7|�t j �r9dS | � |t j
�sBdS dS )NFz-ERROR: Exception getting state of topLevel %sT)r r� r� rB r* r r+ r, r- r. r/ �
STATE_DEFUNCTr� r[ )r$ r3 r� r4 r5 r& r& r' � topLevelObjectIsActiveAndCurrentC s$
�z*Utilities.topLevelObjectIsActiveAndCurrentc C sb z| � � �tj�}|� � �tj�}W n Y dS |j|jd }|j|jd }t|| �|kS )z1Determines if obj1 and obj2 are on the same line.F� )r@ rA r. rB rC rE �abs)r; r< �delta�bbox1�bbox2�center1�center2r& r& r' �
onSameLine[ s zUtilities.onSameLinec C s� | |krdS t t| �t|��}| dg| d|� } |dg| d|� }ttt| �t|���D ]}| | || k r= dS | | || krH dS q0dS )zpCompares the two paths and returns -1, 0, or 1 to indicate if path1
is before, the same, or after path2.r r� Nr )�maxrT r� r� )r= r> �sizeru r& r& r' �pathComparisonj s �zUtilities.pathComparisonc C sx z| � � �tj�}|j|j}}W n d\}}Y z|� � �tj�}|j|j}}W n d\}}Y || || S �N�r r )r@ rA r. rB rD rE )r; r< �bbox�width1�height1�width2�height2r& r& r' rX ~ s
zUtilities.sizeComparisonc C s� z| � � �tj�}|j|j}}W n d\}}Y z|� � �tj�}|j|j}}W n d\}}Y || p;|| }|sL| j|jkrL| �� |�� }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@ rA r. rB ru rC r^ r{ r� r� )r; r< r� �x1�y1�x2�y2rp r& r& r' �spatialComparison� s
zUtilities.spatialComparisonc C s@ z
|� � �||tj�}W |S d| }t�tj|d� Y dS )Nz,ERROR: Exception getting range extents of %sT�r� r� r r )r� �getRangeExtentsr. rB r r+ r, )r$ r3 r4 r� r� r5 r& r& r' �getTextBoundingBox� s �z Utilities.getTextBoundingBoxc C sN z
|� � �tj�}W n d| }t�tj|d� Y dS |j|j|j |j
fS )Nr� Tr� ) r@ rA r. rB r r+ r, ru rC rD rE �r$ r3 r� r5 r& r& r' �getBoundingBox� s zUtilities.getBoundingBoxc C sb |sdS |� � tjkr
dS z
|�� �tj�}W n d| }t�tj|d� Y dS |j o/|j
S )NFr� T) r_ r. r� r@ rA rB r r+ r, rD rE r� r& r& r' r� � s zUtilities.hasNoSizec C s� |sd S z|j }W n d| }t�tj|d� Y d S t|�D ]8}z|| }W n d||f }t�tj|d� Y d S |rE||�rEq |rP||�rP|�|� | �||||� q d S )N�*ERROR: Exception getting childCount for %sTz(ERROR: Exception getting %i child for %s)r� r r+ r, r� r� �_findAllDescendants) r$ r� � includeIf� excludeIf�matchesr� r5 r� rI r& r& r' r� � s*
�z Utilities._findAllDescendantsc C s g }| � ||||� |S rr )r� )r$ r� r� r� r� r& r& r' r� � s z Utilities.findAllDescendants� c s | j jr
| j j�|�r
g S tjtjg� tjtjtjtj tj
tj tj tj
tjg �� �fdd�}��fdd�}�fdd�}| �|||�}|j}i } |D ]*}
|
jpR| �|
�} | r^| ||
jjfv r^qIt| �� �|k rgqI|�| �dkroqI|
| | < qIt| �� �}t|t�| 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< | r| � � � v s
dS | �� rdS �r | �� �tj�s dS dS �NFT)r_ r� r* r- r. r1 rt )�
labelRolesr� r& r' �_include
s z+Utilities.unrelatedLabels.<locals>._includec s0 | r| � � �v r
dS � r| �� �tj�sdS dS r )r_ r* r- r. r1 rt )r� r� r& r' �_exclude
s
z+Utilities.unrelatedLabels.<locals>._excludec r� rr r| rt )r� r& r' rv
r� z+Utilities.unrelatedLabels.<locals>.<lambda>r rM ) r! �
spellcheck�
isCheckWindowr. r� � ROLE_STATICr� r r r� r� �ROLE_SPLIT_PANEr� r� r� r� r� r r^ rT ri rl rQ �valuesrU rV rW r� ) r$ r� r� r� r� r� r� r� �rootName�dr� r� r& )r� r� r� r' r� � s<
�
zUtilities.unrelatedLabelsc C r� )NTr& rJ r& r& r' �_treatAlertsAsDialogs/
r� z Utilities._treatAlertsAsDialogsc s� t jg���� r��t j� ��fdd�� � fdd�|�� D �}|�� fdd���|�D �� �fdd�}tt |t
|���}tt �fdd�|��}t |�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.
c s | r| � � � v p ��| �S rr )r_ r( rt )r� r$ r& r' rv B
rL z8Utilities.unfocusedAlertAndDialogCount.<locals>.<lambda>c � g | ]}� |�r|�qS r& r& rK ��isDialogr& r' rK C
rl z:Utilities.unfocusedAlertAndDialogCount.<locals>.<listcomp>c r� r& r& rK r� r& r' rK D
rl c s � � | �o
| jp
| jS rr )r� r� r� rt rJ r& r' rv F
rR c s � � | � S rr rF rt rJ r& r' rv I
r$ ) r. r� r� r� r� rA rP r� rQ r� rX rT )r$ r3 �dialogs�
isPresentable� presentable� unfocusedr& )r� r� r$ r' � unfocusedAlertAndDialogCount2
s z&Utilities.unfocusedAlertAndDialogCountc C s z|� � �d�W S Y dS )zjReturn the URI for a given link object.
Arguments:
- obj: the Accessible object.
r N)rj rk r� r& r& r' rp L
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)r^ r� r& r& r' r X
s zUtilities.validParentc C s� z| � � }W n Y dS |�� dkr(|j}t||�}t||�}|�||� dS |�d�\}}||k r6|}n|}|�d||� 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� � addSelection� getSelection� setSelection)r3 r� r� r� � startOffset� endOffsetr& r& r' �adjustTextSelectionk
s
z Utilities.adjustTextSelectionc C s� |r| � |�r dS |�� D ]}|�� tjkr |�d� S q
|�� d }|jrRd| kr5|jjd k sRn |j}|�� d }|jrRd| krP|jjd k r6n q6z|j| }W n d}Y ||krfd}|S )z!Finds the object before this one.Nr r ) r
r� r� r. �RELATION_FLOWS_FROMr� r{ r^ r� )r$ r3 r� r} �prevObjr& r& r' �findPreviousObject�
s$ � $ &�z Utilities.findPreviousObjectc C s� |r| � |�r dS |�� D ]}|�� tjkr |�d� S q
|�� d }|jrNd| k r3|jjk sNn |j}|�� d }|jrNd| k rL|jjk r4n q4z|j| }W n d}Y ||krbd}|S )z Finds the object after this one.Nr r ) r
r� r� r. �RELATION_FLOWS_TOr� r{ r^ r� )r$ r3 r� r} �nextObjr& r& r' �findNextObject�
s$ � "�zUtilities.findNextObjectc
C s� | � |�\}}}|r| jj�d�r|||fS | �|�r |||fS | �|�}|rD| �|�r=| � |�\}}}|s7n
d||f }| �|�}|s'| �|�} | rh| �| �ra| � | �\}}}|s[n
d||f }| �| �} | sK|||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.
�entireDocumentSelected�%s %s)� selectedTextr! r� rx r� r r� r )
r$ r3 � textContentsr r r � selectionr4 r� r r& r& r' �allSelectedText�
s0
�
�
zUtilities.allSelectedTextc C s\ z| � � }W n g Y S g }z|�� }W n d}Y t|�D ]
}|�|�|�� q!|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� r� r� r� )r3 r� rp � nSelectionsr� r& r& r' �allTextSelections�
s
zUtilities.allTextSelectionsc C s� z|� � }W n' ty d| }t�tj|d� Y d S d| }t�tj|d� Y d S |�|�}|dkr9d S |�|�}|sPd||f }t�tj|d� d S |�d�}d|||f }t�tj|d� ||jkrxd|j|f }t�tj|d� |S ) Nz3INFO: %s does not implement the hypertext interfaceTz3INFO: Exception querying hypertext interface for %sr� z,INFO: No hyperlink object at index %i for %sr z/INFO: Hyperlink object at index %i for %s is %szBERROR: The hyperlink start index (%i) should match the offset (%i)) rs r� r r+ r, � getLinkIndexru � getObjectrv )r$ r3 r� ry r5 r} ro rI r& r& r' �getChildAtOffset�
s6
�zUtilities.getChildAtOffsetc C s� d}z|� � }W n ty d| }t�tj|d� Y |S w z
|j�� |j}W n d||jf }t�tj|d� Y |S d||f }t�tj|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� �3INFO: %s does not implement the hyperlink interfaceTz7ERROR: Exception getting startIndex for %s in parent %sz INFO: startIndex of %s is %i)rj r� r r+ r, r^ r� rv )r$ r3 r� ro r5 r& r& r' �characterOffsetInParent s$
�
�z!Utilities.characterOffsetInParentc C s: z|� � }W n Y dS t|�� �D ]}|�|� qdS )zwClears the text selection if the object supports it.
Arguments:
- obj: the Accessible object.
N)r� r� r� �removeSelection)r$ r3 r� r� r& r& r' �clearTextSelection@ s �z Utilities.clearTextSelectionc C s4 z
|� � �dd�}W n Y dS |ot�d|� S )Nr r� Fz [^\ufffc])r� r� r\ r� r� r& r& r' �containsOnlyEOCsO s
zUtilities.containsOnlyEOCsr� c C s� z | � |||�}W n Y dS | j|vr|S tjtjtjtjtjtjtj tj
g}t |�}t |�D ]&\}}|| jkrW| �
||| �} | �| �}
| rS| �� |v rS|
d7 }
|
||< q1d�|�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 r8 )� substringr� r. � ROLE_HEADINGr� r� rJ r r� r� r� rQ � enumerater �
expandEOCsr_ r� ) r$ r3 r r r� �
blockRoles�toBuildr� �charrI r� r& r& r' r W s2
�
�
zUtilities.expandEOCsc C sN | � ||d�\}}}|�d�dkrdS |�d�dkr dS |�d�dv r%dS 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.
T�invalid�spellingz
text-spelling�
misspelled� underline)�errorr" F)�textAttributesrx )r$ r3 r� �
attributesr4 r� r& r& r' �isWordMisspelled s zUtilities.isWordMisspelledc C s |� � �tj�S rr )r* r- r. �STATE_INVALID_ENTRYr� r& r& r' �getError� � zUtilities.getErrorc C r� r r& r� r& r& r' �getErrorMessage� r� zUtilities.getErrorMessagec C r� r� r& r� r& r& r' �isErrorMessage� r� zUtilities.isErrorMessagec C s0 | � |�}|r|d u r|j}|�||d �S dS )Nr r )r� r� r� )r$ r3 r� r� r& r& r' �getCharacterAtOffset� s
z Utilities.getCharacterAtOffsetc C sV z |� � }|j}W n ty Y dS d| }t�tj|d� Y dS |r)|S dS )z�Get the text interface associated with an object, if it is
non-empty.
Arguments:
- obj: an accessible object
z.ERROR: Exception getting character count of %sTN)r� r� r� r r+ r, )r$ r3 r� � charCountr5 r& r& r' r� � s
��zUtilities.queryNonEmptyTextc C s |j S rr )�any_datar r& r& r' � deletedText� r� zUtilities.deletedTextc C s� |j r|j S z|j�� }W n d|j }t�tj|d� d }Y d}t�tj|d� |tjkrP| �|j�}|rP|� dd�}|rPd| }t�tj|d� |d S d}t�tj|d� dS ) Nr Tz"ERROR: Broken text insertion eventr r� z!HACK: Returning last char in '%s'z3FAIL: Unable to correct broken text insertion eventr )
r0 r r_ r r+ r, r. r r� r� )r$ r rc r5 r� r� r& r& r' � insertedText� s*
zUtilities.insertedTextc C s� d}d }}z|� � }W n d}Y n|�� }td|�D ]!}|�|�\}}||kr+q | �|||�}|dkr:|d7 }||7 }q |||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 r8 )r� r� r� r� r ) r$ r3 r
r r �textObjr r� r r& r& r' r � s
zUtilities.selectedTextc C sJ t j}z
|�� j}W ||fS ty d}Y ||fS d}Y ||fS )Nr r� )r r� r� r� r� r r& r& r' r� � s ��zUtilities.getCaretContextc C s |dfS r� r& r� r& r& r' �getFirstCaretPosition r� z Utilities.getFirstCaretPositionc C s t �d |d� | �||� d S r� )r �setLocusOfFocus�setCaretOffset)r$ r3 r� r� r& r& r' �setCaretPosition s zUtilities.setCaretPositionc C s( z|� � }W n Y dS |�|� 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� r6 )r$ r3 r� �textir& r& r' r6
s
zUtilities.setCaretOffsetc C s& z|� � }W n Y dS |�||�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$ r3 r r r� r& r& r' r s
zUtilities.substringc C s* | j j�� D ] \}}||kr| S q|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! �attributeNamesDictr� )r$ �
attribNamerN r� r& r& r' �getAppNameForAttribute- s
�z Utilities.getAppNameForAttributec C s | j j�||�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! r9 rx )r$ r: r& r& r' �getAtkNameForAttribute@ s z Utilities.getAtkNameForAttributec C s* z|� � }W n g Y S |dkr|j}d|||f }t�tj|d� t�� }g }|}||k r}z|�|�\} }
} d|| |
| f }t�tj|d� W n d| }t�tj|d� | Y S tdd� | D ��} |�t |
|�| | f� t | |d �}||k s0t�� }
d t
|�|
| f }t�tj|d� |S )
z9Returns a list of (start, end, attrsDict) tuples for obj.r� z3INFO: Getting text attributes for %s (chars: %i-%i)Tz"INFO: Attributes at %i: %s (%i-%i)z)ERROR: Exception getting attributes at %ic S re rf rh rj r& r& r' rK g rl z;Utilities.getAllTextAttributesForObject.<locals>.<listcomp>r z(INFO: %i attribute ranges found in %.4fs) r� r� r r+ r, r� �getAttributeRunrm r� r� rT )r$ r3 r r r� r5 � startTimerp r� �attrListr4 r� �attrDict�endTimer& r& r' � getAllTextAttributesForObjectM s8 �z'Utilities.getAllTextAttributesForObjectc
C s� i }z|� � }W n
|ddf Y S |r#| �|�� �}|�|d � |du r*|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� �stringToKeysAndDict�getDefaultAttributes�updater� rn r� r� )
r$ rU r� � get_defaultsrp r� �
stringAndDict�
attrStringr4 r� r& r& r' r& p s
zUtilities.textAttributesc C s |dkr|dkst |�dkrtjS |�d�s|dkr tjS t�|| j�}|dkr5|�d�d � � � d�}nM|r[|�d �r[|�d �d }t
� � d
|v rSt� t
|��}n/t� t |��}n'|�d �r{| �|�\}}}tjrst�|||�}nd |||f }nt�|| j�}d
||f S )N�weight�boldi� r" z family-namerc r �"�px�
decimal_point�colorz%i %i %iz%s: %s)ry r �BOLD�endswith�
MISSPELLEDr �getTextAttributeNamer! ri r� �locale�
localeconv�
pixelCount�float�
rgbFromStringr �
useColorNamesr � rgbToName)r$ rN r� � localizedKey�localizedValuer� �gr� r& r& r' �localizeTextAttribute� s&
z Utilities.localizeTextAttributec C sv g }| � |||�}|D ]-\}}}} ||krq ||kr |S t||�}t||�}| �|||�}
|�|||
|| g� q |S )zAReturns a list of (start, end, string, language, dialect) tuples.)�'getLanguageAndDialectFromTextAttributesr� r� r r� ) r$ r3 r4 r� rp �
allSubstringsr r �language�dialectr� r& r& r' �splitSubstringByLanguage� s
�
z"Utilities.splitSubstringByLanguagec C s@ | � |||�}|D ]\}}}}||kr ||kr ||f S q dS )z�Returns a (language, dialect) tuple. If multiple languages apply to
the substring, language and dialect will be empty strings. Callers must
do any preprocessing to avoid that condition.)r r )r^ ) r$ r3 r4 r� r_ r r r` ra r& r& r' �!getLanguageAndDialectForSubstring� s �z+Utilities.getLanguageAndDialectForSubstringc
C s� g }| � |||�}d }}|D ]>\}} }
|
�dd�} d} d| v r(| �dd�\} } |r?|| kr?|| kr?|d d | | | f|d< n |�|| | | f� | | }}q|S )zvReturns a list of (start, end, language, dialect) tuples for obj
based on what is exposed via text attributes.r r` �-r r� r )rB rx ri r� )
r$ r3 r r rp � attributeSet� lastLanguage� lastDialectr4 r� r| r` ra r& r& r' r^ � s z1Utilities.getLanguageAndDialectFromTextAttributesc C sb t jrtjsdS t|j�dks|jtj@ rdS t j}|� � }|t
j kr%dS |� � �
t
j�r/dS 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 �enableEchoByCharacterrT � event_string� modifiersr �ORCA_CTRL_MODIFIER_MASKr_ r. r r* r- r. )r$ r r3 rc r& r& r' �willEchoCharacter� s
�
zUtilities.willEchoCharacterc C s� ddl m} tj}d}z |�|d �\}}W n d}Y t|�} | tjkrQ|d | jjvrQ|r6|rK||krKt �
|d �}
t � |
| �} d|| f }|S ||7 }|S ||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_settingsTr Fr )
r rn r �verbalizePunctuationStyle�getPunctuationInforT �repeatCharacterLimitr! �
whitespacer �getCharacterNamer �repeatedCharCount) r$ �segment�line�respectPunctuationrn �style� isPunctChar�level�actionr9 �
repeatChar�
repeatSegmentr& r& r' �_addRepeatSegment� s,
� ��zUtilities._addRepeatSegmentc C s: | � |�s | �|�s dS t�d�}|tjtjfv rdS dS )NFro T)r r r� r� r �PUNCTUATION_STYLE_ALL�PUNCTUATION_STYLE_NONE)r$ r3 rx r& r& r' � shouldVerbalizeAllPunctuation"
s
z'Utilities.shouldVerbalizeAllPunctuationc C s@ |}t t�| j|��D ]}dt�|� }t�d| ||�}q |S )Nz %s z\%s)rX r\ �findall� PUNCTUATIONr rs r] )r$ r� r� �symbol�charNamer& r& r' �verbalizeAllPunctuation/
s
z!Utilities.verbalizeAllPunctuationc C s ddl m} |t|� }z
|�� }|�� }W n d}Y t|�}t|dd�D ]a} |�| d �}
|
s3q'||
j k r>|krFn n|
j| } n ||
j krQ|k ran nt|�} |
j|k r`| d8 } nq'dt
j } d}
| t|�k rs|| }
|
| j j
v s�|�|
�s�| d7 } | || | �< q'd�|�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 rm r r� r8 r )r rn rT rs rt rQ r� ru rw rv r �LINKr! rr rp r� )r$ r3 rv r rn r � hyperText�nLinks� adjustedLine�nrz r} �
linkString�nextCharr& r& r' �adjustForLinks7
s<
�
�
zUtilities.adjustForLinksc C s t �dd| �S )Nz(?<=[a-z])(?=[A-Z])r8 )r\ r] )r� r& r& r' �_processMultiCaseStringl
s z!Utilities._processMultiCaseStringc C s | � � s| S d�t| ��S )Nr8 )� isnumericr� rQ )�wordr& r& r' �_convertWordToDigitsp
s z Utilities._convertWordToDigitsc C s� t jr| �|�}| �� rt�|�}t jr#| j�|�}d� t
| j |��}t |�dkr4t
�|�}||kr4|S t js9|S d}| j�|�}d� t
tj|��}t jrR| �|�}|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 )r � speakMultiCaseStringsAsWordsr� rh r
�adjustForSpeech�speakNumbersAsDigits�WORDS_REri r� rR r� rT r rs �usePronunciationDictionaryr �getPronunciation)r$ rv �words�charname�newLiner& r& r' �adjustForPronunciationw
s&
z Utilities.adjustForPronunciationc C s� t |�dk s tjdk r
|S d}|d }}d}tdt |��D ] }|| |kr-||| 7 }n d}| �||�}|| }|| }q | �|||�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)rT r rq r� r~ )r$ rv r� ru �lastChar�
multipleCharsr� r& r& r' �adjustForRepeats�
s
zUtilities.adjustForRepeatsc s� t t�� j|��}t t�� j|��}|D ]}� fdd�|D �}tjd�|� }t�|||�}q|D ]}� fdd�|D �}tj d�|� }t�|||�}q1|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 � g | ]
}t � j�|���qS r& )rS �SUPERSCRIPT_DIGITSr} �rH r� rJ r& r' rK �
� z-Utilities.adjustForDigits.<locals>.<listcomp>r c r� r& )rS �SUBSCRIPT_DIGITSr} r� rJ r& r' rK �
r� )
rX r\ r� �
SUBSCRIPTS_RE�SUPERSCRIPTS_REr �DIGITS_SUPERSCRIPTr� r] �DIGITS_SUBSCRIPT)r$ r� � subscripted�
superscripted�number�new� newStringr& rJ r' �adjustForDigits�
s
zUtilities.adjustForDigitsc C s� t �d�s
t �d�s dS |�dd�}t�d|�}|r"|d |�� � }d}dd� t�d |�D �}d
d� t�d |�D �}t|| �}|D ]!\}}||f|v rX|d t� || � 7 }qB|d t�
|| � 7 }qB|S )
N�onlySpeakDisplayedText�enableSpeechIndentationr � r8 z[^ ]c S � g | ]}|� � �qS r& ��span�rH �mr& r& r' rK �
rw z4Utilities.indentationDescription.<locals>.<listcomp>z +c S r� r& r� r� r& r& r' rK �
rw z +z%s ) r� r� r< r\ r� r4 �finditerrU r � spacesCount� tabsCount)r$ rv r� r� �spaces�tabs�spansr4 r& r& r' �indentationDescription�
s"
� z Utilities.indentationDescriptionc C s4 ddl m} | �� �� �� }|�� \}}}}||fS )z0Gets the absolute position of the mouse pointer.r r )�
gi.repositoryr �Window�
get_screen�get_root_window� get_pointer)r �
rootWindowrC ru rC rj r& r& r' �absoluteMouseCoordinates�
s z"Utilities.absoluteMouseCoordinatesr8 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� �newText� delimiterr& r& r' r� �
s
zUtilities.appendStringc C sT |r|sdS ||kr dS |j |j ko)|j|jko)|j|jko)|j|jko)|j|jkS r� )r �type�detail1�detail2r0 )r$ �event1�event2r& r& r' �treatAsDuplicateEvent s
�
�
�
�z Utilities.treatAsDuplicateEventc
C sH |j �d�r�|jr |jsdS |j�� }|�tj�sdS |�tj�s#dS |�tj �r;|j�
� |j�� }|�tj �s;dS | � � \}}|dkrL|jdkrLdS |dkrW|jdkrWdS |dv ra| �
|j�S | �� sgdS |j�� �d d
�}|�|j�r�| �|j�\}}}||jkr�dS ||jkr�|�|�r�|d |�|�� } | �� �|�� �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
�object:text-changed:insertF�Tab� T�Return�
)�Up�Down�Page_Up� Page_Downr r� N)r� rn r0 r r* r- r. r. r1 r� rB r� �lastKeyAndModifiers� isEditableDescendantOfComboBox� lastInputEventWasPrintableKeyr� r� rP r rl �lower)
r$ r r4 �lastKey�modsr� r r4 r� � beginningr& r& r' �isAutoTextEvent s>
zUtilities.isAutoTextEventc C s( |dks|dkr
dS || j jv o|dv S )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.
�
r� Tz!.?:;)r! rr )r$ � currentChar� previousCharr& r& r' �isSentenceDelimiterC s
�z Utilities.isSentenceDelimiterc C s || j jv p|dv p|| 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! rr �NO_BREAK_SPACE_CHARACTER)r$ � characterr& r& r' �isWordDelimiterV s
�
�zUtilities.isWordDelimiterc C sH |du rt j}z|�� �|�}|�� �|�}W n Y dS | �||�S )z9Returns the extents of the intersection of obj1 and obj2.Nr� )r. rB r@ rA � intersection)r$ r; r< � coordTyperH rI r& r& r' �intersectingRegionc s z Utilities.intersectingRegionc C s� |\}}}}|\}}} }
t ||| d �} t ||| d �} tt| ��t| ���}
t ||| d �}t |||
d �}tt|��t|���}|
rJ|sLdS |
d }|d }|
d | }|d | }||||fS )Nr r� r r� )r� rU rX r� )r$ rH rI r� r� r� r� r� r� r� r� �xPoints1�xPoints2�
xIntersection�yPoints1�yPoints2�
yIntersectionru rC rD rE r& r& r' r� q s zUtilities.intersectionc C s | � ||�dkS )Nr� )r� )r$ rH rI r& r& r' r� � r+ zUtilities.containsRegionc C s, t j�� }|�| �d }ttt jt|���S r2 )r �Keymap� get_default�get_entries_for_keycoderQ rR � keyval_namerX )�keycode�keymap�entriesr& r& r' �_allNamesForKeyCode� s
z Utilities._allNamesForKeyCodec C s, t tjtj�s dS tj} | r| j| jfS dS r� )r\ r �lastInputEventr �
KeyboardEvent�lastNonModifierKeyEvent�hw_coderj )r r& r& r' �_lastKeyCodeAndModifiers� s z"Utilities._lastKeyCodeAndModifiersc C sR t tjtj�r!tjr!tj} | jdv r| j}n| j}tjj}||fS d}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 r� r r� r� r� ri rj )r �eventStrr� r& r& r' r� � s �
�z Utilities.lastKeyAndModifiersc C s� z#ddl m} |�| �\}}|�||�}|r"|�d�r |�d�r"|} W n | �d�r3| t�d�7 } | �dd�} | �dd��� } Y t �
| �S ) z3Turns a key sequence into a user-presentable label.r r �+z++r8 �<r �>) r� r �accelerator_parse�accelerator_get_labelrP r rs r< r� r
�localizeKeySequence)�sequencer rN r� � newSequencer& r& r' �labelFromKeySequence� s" ���
z Utilities.labelFromKeySequencec C s� z
| j j| j | W S | j| j jvr i | j j| j< Y z|�� }W n ty@ g d�| j j| j |< | j j| j | Y S w z
|�d��d�}W n g d�| j j| j |< | j j| j | Y S t|�dkrx|d }|d }|d }n t|�dkr�d}|d }z|d }W n
d}Y nd}d}d}|�dd �� � }| �
|�}| �
|�}| �
|�}| j| j jvr�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 �;r� r r� r rg r8 ) r! r� � KEY_BINDING� queryActionr� �
getKeyBindingri rT r< r� r )r$ r3 r{ �bindingStrings�mnemonic� fullShortcut� acceleratorr& r& r' �mnemonicShortcutAccelerator� sP � �
�z%Utilities.mnemonicShortcutAcceleratorc C s` z&dd� | � d�D �}dd� |D �}dd� |D �}tdd� |D ��}W ||gS g i f Y S )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 r� r& �r� )rH �sr& r& r' rK rw z1Utilities.stringToKeysAndDict.<locals>.<listcomp>r c S s" g | ]
}t |�d ��dkr|�qS )rg r� )rT ri �rH rr r& r& r' rK s " c S s g | ] }|� d �d �� �qS )rg r )ri r� r r& r& r' rK r� c S s g | ]}|� d ��qS )rg rh r r& r& r' rK rR )ri rm )r� r� �keys�
dictionaryr& r& r' rC s � z Utilities.stringToKeysAndDictc C s� | � |d�}|�d�}|r|S z|�� }W n
ty Y dS w |j}z|j}W n ttfyA d}d| }t� tj
|d� Y nw z|j }W n ttfy` d}d| }t� tj
|d� Y nw z|j } W n ttfy� || d } d | }t� tj
|d� Y nw | dkr�zt
�td
t
�| � ��}
W n! ty� d | }t� tj
|d� Y dS w t|�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.
F� valuetextr � 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)rq rx r� r� r� r� r� r� r r+ r, r� �minimumIncrement�math�ceilr� �log10r: r� ) r$ r3 r| r r� r� �maxValuer5 �minValue� minIncrement�
decimalPlaces� formatterr& r& r' � textForValue sX
�
�
�
� � zUtilities.textForValuec C s( zdt | � W S t�tj� Y 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 )�ordr r� �
LEVEL_WARNING)r� r& r& r' �unicodeValueStringR s
z Utilities.unicodeValueStringc C r� rr r& )r$ r3 r� �
layoutModero r& r& r' �getLineContentsAtOffsetb r� z!Utilities.getLineContentsAtOffsetc C r� rr r& )r$ r3 r� ro r& r& r' �getObjectContentsAtOffsete r� z#Utilities.getObjectContentsAtOffsetc C s |s| � � \}}||d fS �Nr �r� �r$ r3 r� � skipSpacer& r& r' �previousContexth � zUtilities.previousContextc C s |s| � � \}}||d fS r( r) r* r& r& r' � nextContextn r- zUtilities.nextContextc C s$ d}| � |�}|r|jd }||fS �Nr r )r� r� )r$ r� r� r� r& r& r' � lastContextt s
zUtilities.lastContextc C sp z|� � }|j|j}}W ||fS ty& d| }t�tj|d� Y dS d| }t�tj|d� Y dS )z5Returns the text range in parent associated with obj.r T�r� r� z0INFO: Exception getting hyperlink indices for %s)rj rv rw r� r r+ r, )r$ r3 ro r4 r� r5 r& r& r' �getHyperlinkRange| s
�zUtilities.getHyperlinkRangec
sh z � � � }|j}W n) ty d� }t�tj|d� g Y S d� }t�tj|d� g Y S d� |f }t�tj|d� g }t|�D ] }|�|�}d||f }t�tj|d� | �|�sf|� |� qG|ru|sud}t�tj|d� � �
� }|t j kr�|s�dd� } | �
� | �}|t jkr�|r�|d �
� t j kr�| �|d �}|s�� jr�� fd
d�} | �
� | �}|S ) N�3INFO: %s does not implement the selection interfaceT�4ERROR: Exception querying selection interface for %sz'INFO: %s reports %i selected child(ren)zINFO: Child %i: %sz>INFO: Selected children not retrieved via selection interface.c S � | o | � � �tj�S rr )r* r- r. r� rt r& r& r' rv � rw z,Utilities.selectedChildren.<locals>.<lambda>r c s | o| j � j kS rr )r� rt r( r& r' rv � r� )�querySelection�nSelectedChildrenr� r r+ r, r� �getSelectedChildr
r� r_ r. r r� r� r� r� )
r$ r3 r r9 r5 r� ru rI rc rZ r& r( r' r� � sJ
�
�
zUtilities.selectedChildrenc
s� |sd S dd� � � |�r|S t jt jgt jt jgt jt jgt jt jt jgt j t j
t jgt j t j
t jgi�|� � �� ��fdd�}t �
||�S )Nc S � | odt �| �v S )Nr� �r. r� rt r& r& r' rv � r z1Utilities.getSelectionContainer.<locals>.<lambda>c s � | �o | � � ����v S rr �r_ rx rt �� isSelectionrc �rolemapr& r' rv � rL )r. r� r � ROLE_ICONr� r r r� r� r� r� r� r_ rz )r$ r3 �isMatchr& r< r' �getSelectionContainer� s
� z Utilities.getSelectionContainerc s� |r dt �|�v s dS dt �|�v r | �|�\}}td|�S t jt jgt jt jgi�|�� � � �vr5|j S � �fdd�}t
| � ||��S )Nr� r r� c s | � � ��� �v S rr r; rt �rc r> r& r' rv � r z0Utilities.selectableChildCount.<locals>.<lambda>) r. r� �rowAndColumnCountr� r r� r� r r_ r� rT r� )r$ r3 �rows�colsr@ r& rB r' �selectableChildCount� s
�z Utilities.selectableChildCountc C s� dt �|�v r|�� }|jr|jS z |�� }|j}W n' ty0 d| }t�tj |d� Y dS d| }t�tj |d� Y dS d||f }t�tj |d� |S )Nr� r3 Tr r4 z%INFO: %s reports %i selected children)
r. r� r� �
nSelectedRowsr6 r7 r� r r+ r, )r$ r3 r� r r9 r5 r& r& r' �selectedChildCount� s$
z Utilities.selectedChildCountc C sz z |� � }|j}W n' ty d| }t�tj|d� Y dS d| }t�tj|d� Y dS |�d�|�|d �fS )Nr3 T�NNr4 r r )r6 r7 r� r r+ r, r8 )r$ r3 r r9 r5 r& r& r' � firstAndLastSelectedChildren� s
z&Utilities.firstAndLastSelectedChildrenc C s@ dd� }t �||�}||kr d||f }t�tj|d� d S |S )Nc S r5 rr )r* r- r. r� rt r& r& r' rv rw z(Utilities.focusedChild.<locals>.<lambda>z ERROR: focused child of %s is %sT)r. �findDescendantr r+ r, )r$ r3 � isFocusedrI r5 r& r& r' � focusedChild s zUtilities.focusedChildc C s� |sd S z|j }W n d| }t�tj|d� Y d S dd� |D �}|D ]$}z|�� }W n d| }t�tj|d� Y q%|�tj�rI| S q%d S )Nr� Tc S s g | ] }|� � tjkr|�qS r& )r_ r. r rG r& r& r' rK r� z*Utilities.popupMenuFor.<locals>.<listcomp>�%ERROR: Exception getting state for %s)r� r r+ r, r* r- r. �
STATE_ENABLED)r$ r3 r� r5 �menusr� r4 r& r& r' � popupMenuFor s(
�zUtilities.popupMenuForc C sX |sdS z
|� � }|�� }W n d| }t�tj|d� Y dS |tjko+|�tj�S )NF�.ERROR: Exception getting role and state for %sT) r_ r* r r+ r, r. r� r- �STATE_HAS_POPUPr r& r& r' �isButtonWithPopup' s zUtilities.isButtonWithPopupc C s\ |sdS z|� � }W n d| }t�tj|d� Y dS |tjtjfvr'dS | �|�d uS �NFr* T)r_ r r+ r, r. r� r� rQ r� r& r& r' � isMenuButton5 s zUtilities.isMenuButtonc C s� |pt j}|s dS z|�� }W n d| }t�tj|d� Y dS tjtjtj tj
tj g}||v r4dS |tj tj
fv rF|joE|j�� |v S dS rU )r r� r_ r r+ r, r. r r �ROLE_CHECK_MENU_ITEM�ROLE_RADIO_MENU_ITEMr r� r r^ )r$ r3 rc r5 � menuRolesr& r& r' �inMenuE s(
�zUtilities.inMenuc C s* |pt j}| �|�s dS t�|| j�d uS r� )r r� rZ r. rz �
isContextMenur� r& r& r' �
inContextMenu^ s
zUtilities.inContextMenuc C s t jt jfS rr )r. r� r� rJ r& r& r' �_contextMenuParentRolese r� z!Utilities._contextMenuParentRolesc C s. |r |� � tjks dS |jo|j� � | �� v S r� )r_ r. r r^ r] r� r& r& r' r[ h s zUtilities.isContextMenuc C s" |� � tjkr|j| �|�kS dS r� )r_ r. r r^ r� r� r& r& r' �isTopLevelMenun s zUtilities.isTopLevelMenuc C s` z
|� � }|�� }W n d| }t�tj|d� Y dS |tjkr$dS |�tj�o/|�tj �S )NrR TF)
r_ r* r r+ r, r. r r- � STATE_SUPPORTS_AUTOCOMPLETION�STATE_SINGLE_LINEr r& r& r' � isSingleLineAutocompleteEntryt s
�z'Utilities.isSingleLineAutocompleteEntryc C r� r� r& r� r& r& r' �isEntryCompletionPopupItem� r� z$Utilities.isEntryCompletionPopupItemc sr |sd S z|� � }W n d| }t�tj|d� Y d S |tjkr$d S � fdd�|D �}t|�dkr7|d S d S )Nr* Tc rE r& )�isEditableTextArearK rJ r& r' rK � rL z9Utilities.getEntryForEditableComboBox.<locals>.<listcomp>r r )r_ r r+ r, r. r� rT )r$ r3 rc r5 r� r& rJ r' �getEntryForEditableComboBox� s
z%Utilities.getEntryForEditableComboBoxc C s | � |�d uS rr )rd r� r& r& r' �isEditableComboBox� � z Utilities.isEditableComboBoxc C sb |sdS z|� � }W n d| }t�tj|d� Y dS |�tj�s%dS dd� }t�||�d uS )NFrN Tc S r rr )r_ r. r� rt r& r& r' rv � r z:Utilities.isEditableDescendantOfComboBox.<locals>.<lambda>)r* r r+ r, r- r. r. rz )r$ r3 r4 r5 �
isComboBoxr& r& r' r� � s z(Utilities.isEditableDescendantOfComboBoxc C sz |j s| �|�S | �|�}|r| �|�S | jj�|�}|p%| jj�|d �}t|�dkr8|d jp7| �|d �S | �|�S r/ )r� r rd r! r� r� rT r� )r$ r3 �entryr� r& r& r' �getComboBoxValue� s
zUtilities.getComboBoxValuec C r� r� r& r� r& r& r' � isPopOver� r� zUtilities.isPopOverc C sN | � |�sdS z|�� }W n d| }t�tj|d� Y dS |�tj� S )NFrN T)rj r* r r+ r, r- r. � STATE_MODALr2 r& r& r' �isNonModalPopOver� s
zUtilities.isNonModalPopOverc C r� r� r& r� r& r& r' �isUselessPanel� r� zUtilities.isUselessPanelc C sB t �dt j�}t �|d|�}|�d�\}}}t|�t|�t|�fS )Nz
rgb|[^\w,]r rc )r\ �compile�
IGNORECASEr] ri ry )r$ �attributeValue�regexr� �red�green�bluer& r& r' rW � s zUtilities.rgbFromStringc C r� r� r& r� r& r& r' �isClickableElement� r� z Utilities.isClickableElementc C r� r� r& r� r& r& r' � hasLongDesc� r� zUtilities.hasLongDescc C r� r� r& r� r& r& r' r� � r� zUtilities.hasDetailsc C r� r� r& r� r& r& r' � isDetails� r� zUtilities.isDetailsc C r� rr r& r� r& r& r' �
detailsFor� r� zUtilities.detailsForc C r� r� r& r� r& r& r' �hasVisibleCaption� r� zUtilities.hasVisibleCaptionc C r� r r& r� r& r& r' � popupType� r� zUtilities.popupTypec C sh |r |� � tjks dS | �|�}z t|�dd��}W |S ty3 d||f }t�tj |d� Y dS w )Nr rz �0z*ERROR: Exception getting value for %s (%s)T)
r_ r. r rq ry rx r: r r+ r, )r$ r3 r| r� r5 r& r& r' � headingLevel� s
� �zUtilities.headingLevelc C sT z|� � }W n
ty Y dS w dtjg}t|j�D ] }|�|�|v r' dS qdS )NF�toggleT)r
r� r �
ACTION_TOGGLEr� �nActions�getName)r$ r3 r{ �toggleActionNamesr� r& r& r' �hasMeaningfulToggleAction� s �
�z#Utilities.hasMeaningfulToggleActionc s@ |sd S t jt jt jt jg� � fdd�}||�r|S t �||�S )Nc r� rr r| rt r� r& r' rv r� z1Utilities.containingTableHeader.<locals>.<lambda>)r. r� r� r� r� rz )r$ r3 �isHeaderr& r� r' �containingTableHeader s � z Utilities.containingTableHeaderc C s� |r |� � tjks g S dd� }t�||�}z|�� }W n g Y S | �|�}|�|�|�|�}}|�||�}g } t ||| �D ]
}
| �
|� |
�� qB| S )Nc S r9 r� r: rt r& r& r' rv r z0Utilities.columnHeadersForCell.<locals>.<lambda>) r_ r. r� rz r� r r� r� �getColumnExtentAtr� r� r ) r$ r3 r� r^ r� r} r� r� �colspan�headers�cr& r& r' �columnHeadersForCell �
z Utilities.columnHeadersForCellc C s� |r |� � tjks g S dd� }t�||�}z|�� }W n g Y S | �|�}|�|�|�|�}}|�||�}g } t ||| �D ]
}
| �
|� |
�� qB| S )Nc S r9 r� r: rt r& r& r' rv / r z-Utilities.rowHeadersForCell.<locals>.<lambda>) r_ r. r� rz r� r r� r� �getRowExtentAtr� r� r ) r$ r3 r� r^ r� r} r� r� �rowspanr� r� r& r& r' �rowHeadersForCell+ r� zUtilities.rowHeadersForCellc C �b |r |� � tjks d S dd� }t�||�}z|�� }W n Y d S | �|�}|�|�}|�|�S )Nc S r9 r� r: rt r& r& r' rv D r z/Utilities.columnHeaderForCell.<locals>.<lambda>)r_ r. r� rz r� r r� r )r$ r3 r� r^ r� r} � columnIndexr& r& r' �columnHeaderForCell@ �
z Utilities.columnHeaderForCellc C r� )Nc S r9 r� r: rt r& r& r' rv S r z,Utilities.rowHeaderForCell.<locals>.<lambda>)r_ r. r� rz r� r r� r )r$ r3 r� r^ r� r} �rowIndexr& r& r' �rowHeaderForCellO r� zUtilities.rowHeaderForCellc C sx t jt jt jt jt jg}|r|�� |v sdS dd� }t �||�}z|�� }W n Y dS | � |�}|�
|�|� |�fS )Nr1 c S r9 r� r: rt r& r& r' rv g r z.Utilities.coordinatesForCell.<locals>.<lambda>) r. r� r� r� r� r� r_ rz r� r r� r� )r$ r3 �preferAttributer� r� r^ r� r} r& r& r' r� ^ s �
z Utilities.coordinatesForCellc C s| |r |� � tjks dS dd� }t�||�}z|�� }W n Y dS | �|�}|�|�|�|�}}|�||�|� ||�fS )Nr1 c S r9 r� r: rt r& r& r' rv u r z,Utilities.rowAndColumnSpan.<locals>.<lambda>)
r_ r. r� rz r� r r� r� r� r� )r$ r3 r� r^ r� r} r� r� r& r& r' �rowAndColumnSpanq s
zUtilities.rowAndColumnSpanc C s& z|� � }W n Y dS |j|jfS )Nr1 )r� r� r )r$ r3 r� r� r& r& r' rC � s
zUtilities.rowAndColumnCountc C r� r� r& r� r& r& r' �_objectBoundsMightBeBogus� r� z#Utilities._objectBoundsMightBeBogusc C r� r� r& r� r& r& r' �_objectMightBeBogus� r� z Utilities._objectMightBeBogusr� c
C s� | � |�r| �||||�dkrdS | �|�rdS z|�� }W n Y dS |d u r,tj}|�|||�r5dS || || }}|�|||�rXd|||||f } t�tj | d� dS dS )N�r r r FTz&INFO: %s contains (%i,%i); not (%i,%i))
r� � textAtPointr� r@ r. rB r- r r+ r, )
r$ r3 ru rC r� �marginr� r� r� r5 r& r& r' �
containsPoint� s&
zUtilities.containsPointc C s. |sdS | � |�r dS tjtjg}|�� |vS r� )r� r. r r� r_ )r$ r3 r� r& r& r' r� � s
� z Utilities._boundsIncludeChildrenc C r� r� r& r� r& r& r' � treatAsEntry� r� zUtilities.treatAsEntryc C s� |r| � |�r dS |jsdS |�� }tjtjg}||v r dS |tjkr/t�|dd� �}|d u S |tjkr9|j r9dS |�
� }|� tj �rJ|� tj
� S tjtjg}||v S )NFTc S r rr )r_ r. r rt r& r& r' rv � r z,Utilities._treatAsLeafNode.<locals>.<lambda>)r r� r_ r. r r� r� rK r+ r� r* r- �STATE_EXPANDABLEr� r� r� )r$ r3 rc r� rh r4 r& r& r' �_treatAsLeafNode� s, �
�zUtilities._treatAsLeafNodec C sr | � |�rd S z|�� }W n d| }t�tj|d� Y d S |�|||�}d||||f }t�tj|d� |S )Nz(INFO: Exception querying component of %sTz(INFO: %s is descendant of %s at (%i, %i))r3 r@ r r+ r, �getAccessibleAtPoint)r$ r� ru rC r� r� r5 r� r& r& r' �accessibleAtPoint� s
zUtilities.accessibleAtPointc C sb |sd S | � |�s d S |d u rtj}| �||||�r'| �|�s$| �|�s&|S n | �|�s1| �|�r3d S dt�|�v rV| �||||�}|rV||krV| �||||�}|rT|S |S g }g }|D ]>}| �||||�} | rl| S | �||||�suq\| � |�r�|�
� � dd�}
t �
d|
�r�|�|� |�� �tj�r�|�|� q\t|�dkr�|d S t|�dkr�|d S d S )Nr� r r� u [^\s]r )r� r. rB r� r� r� r� r� �descendantAtPointr� r� r� r\ r� r� r* r- r1 rT ) r$ r� ru rC r� rI r� �candidates_showingrZ r3 r� r& r& r' r� � sN
�
� zUtilities.descendantAtPointc C s ||fS rr r& )r$ r3 ru rC r� r& r& r' �_adjustPointForObj r� z Utilities._adjustPointForObjc C sR |sdS dt �|�vr
dS |�� }|�dd�}ttdd� |�d���}t|�dkS ) NFr� r r� c S s | � � S rr r rt r& r& r' rv rV z2Utilities.isMultiParagraphObject.<locals>.<lambda>z
r )r. r� r� r� rQ r� ri rT )r$ r3 r� r� �chunksr& r& r' �isMultiParagraphObject s z Utilities.isMultiParagraphObjectc C s� z
|� � }|d u r |j}W n Y dS | �||�\}}}| jj�dd�\}}||kr0|||fS | �||�\} }
} | jj�d�dkrr| �� rK|}|}n| �� rS|}|}|�||�}d||� dd�||f } t
� t
j | d � |||fS | �� r�|}|d
�
� s�|d
�� s�|d 8 }n,| �� r�|}|| kr�|
| k r�| kr�n n|
}|�|d |�}
|
�
� s�|
�� s�|d }|�||�}d|v r�|| kr�|�d�r�|d 7 }n |�d�r�|d 8 }|�||�}|�||�}d ||� dd�||f } t
� t
j | d � |||fS )
Nr� �penultimateCursorPositionr2 �lastTextUnitSpokenr� zEINFO: Adjusted word at offset %i for ongoing word nav is '%s' (%i-%i)r� �\nTr� r zAINFO: Adjusted word at offset %i for new word nav is '%s' (%i-%i))r� r� �getWordAtOffsetr! r� rx � lastInputEventWasPrevWordNav� lastInputEventWasNextWordNavr� r< r r+ r, �isspacerm rn rP )r$ r3 r� r� r� r4 r� r �
prevOffset�prevWord� prevStart�prevEndr5 r� r& r& r' �$getWordAtOffsetAdjustedForNavigation# sd �
�
�
�
z.Utilities.getWordAtOffsetAdjustedForNavigationc C sn z
|� � }|d u r |j}W n Y dS |�|tj�\}}}d||�dd�||f }t�tj|d� |||fS )Nr� z INFO: Word at %i is '%s' (%i-%i)r� r� T) r� r� �getTextAtOffsetr. �TEXT_BOUNDARY_WORD_STARTr< r r+ r, )r$ r3 r� r� r� r4 r� r5 r& r& r' r� o s �
zUtilities.getWordAtOffsetc
C sD | � |�}|s dS |d u rtj}|d u rtj}| �||||�\}}|�|||�}d| kr4|jk s7dS dS |�||�\}} }
|sGd| |
fS |tjkrR|� � sRdS |�
| |
|�} | � | ||ddf�si|dkridS |� d�rr|dkrw|| |
fS |tj
kr�|| |
fS | �||||tj
�} | d dkr�| d | d dkr�| S || |
fS )Nr� r r r r� r� )r� r. rB �TEXT_BOUNDARY_LINE_STARTr� �getOffsetAtPointr� r� r� r� r� r� rP �TEXT_BOUNDARY_CHARr� )
r$ r3 ru rC r� �boundaryr� r� r� r4 r� r� r r& r& r' r� | s:
�
zUtilities.textAtPointc C sv z |� � }|j}W n g Y S d||f }t�tj|d� |\}}}} | �|||d �}
| �|
�\} } td| �}
d|
| f }t�tj|d� z
|
�� � t
j �}W n |
}Y n&| �||||j d �}
| �|
�\} } t|
| �}d|
| f }t�tj|d� | �|||| d �}
| �|
�\} } d|
| f }t�tj|d� | dkr�|} | }t
t||��}|
|vr�|�d|
� |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� r� r r+ r, r� r� r� r@ rA r. rB rE rQ r� �insert)r$ r3 r� r� r� r5 ru rC rD rE r� r� r� rv r� � nextIndexrw rD r& r& r' � visibleRows� sB
zUtilities.visibleRowsc C s� z|� � }W n g Y S z |�� }|�tj�}W n d| }t�tj|d� g Y S | �||�}|s8g S | � |�\}}||krEg S g } t
||�D ]-}
|� |
�} | rZ| � | � |D ] } z|�
| |
�}
W n Y q\|
rx| �|
�rx| � |
� q\qL| S )Nr� T)r� r@ rA r. rB r r+ r, r� �_getTableRowRanger� r r� r� r� )r$ r3 r� r� r� r5 rD �
colStartIndex� colEndIndex�cellsr� � colHeaderr� r� r& r& r' r� � s@
��z Utilities.getVisibleTableCellsc C s� | � |�\}}d|}}| �|�s||fS | �|�}z|�� }W n d| }t�tj|d� ||f Y S |�tj �\} }
} } |�
| d |
tj �}
|
rU| � |
�\}}|}|�
| | d |
tj �}
|
rn| � |
�\}}|d }||fS )Nr z3ERROR: Exception querying component interface of %sTr ) rC r� r� r@ r r+ r, rA r. rB r� r� )r$ r3 �rowCount� columnCountrv rw r^ r� r5 ru rC rD rE r� r� r� r& r& r' r� � s*
zUtilities._getTableRowRangec C s� | � |�}z|�� }W n d| }t�tj|d� g Y S | �|d�\}}|dkr-g S |r6d|j}} n| �|�\}} || krCg S g }
t|| �D ] } |� || �} z
| �
� � t j
�}
W n Y qJ|
ri|
�| � qJ|
S )Nr� TFr� r )r� r� r r+ r, r� r r� r� r� r* r- r. r1 r� )r$ r3 � forceFullRowr^ r� r5 r� r� rv rw r� r� r� �showingr& r& r' �getShowingCellsInSameRow s4
�z"Utilities.getShowingCellsInSameRowc C sv z|� � }W n Y d S |�||�}|s|S z|�� }W n d| }t�tj|d� Y d S |� �tj�s9d S |S )Nr) T) r� r� r* r r+ r, r- r. r1 ) r$ r3 r� r� � showingOnlyr� r� r4 r5 r& r& r' �cellForCoordinates/ s z Utilities.cellForCoordinatesc
C s� z|� � }W n d| }t�tj|d� Y dS |tjks dS dd� }t�||�}z|�� }W n Y dS | �|�}|� |�|�
|�}} |d |j koT| d |j kS )Nr TFc S r9 r� r: rt r& r& r' rv P r z&Utilities.isLastCell.<locals>.<lambda>r )
r_ r r+ r, r. r� rz r� r r� r� r� r )
r$ r3 rc r5 r� r^ r� r} r� r� r& r& r' �
isLastCellE s"
zUtilities.isLastCellc C sf z|� � }W n Y dS t|j�D ] }t|j�D ]}|�||�dks+|�||�dkr/ dS qqdS )NFr T)r� r� r� r r� r� )r$ r3 r� r� r� r& r& r' �isNonUniformTable[ s ��zUtilities.isNonUniformTablec C sj z|� � }W n d| }t�tj|d� Y dS |�tj�s%|�tj�r'dS d| }t�tj|d� dS )Nr) TFz'INFO: %s is neither showing nor visible)r* r r+ r, r- r. r1 �
STATE_VISIBLEr2 r& r& r' �isShowingOrVisiblei s
�z Utilities.isShowingOrVisiblec C s� z
|� � }|�� }W n d| }t�tj|d� Y dS |�tj�r+|�tj�r+dS tj tj
tj tj tj
g}||v rN| �|�rNd| }t�tj|d� dS dS )Nz-ERROR: Exception getting state and role of %sTFz(HACK: Treating %s as showing and visible)r* r_ r r+ r, r- r. r1 r� r r rW rX r r� )r$ r3 r4 rc r5 rY r& r& r' r� y s,
��z Utilities.isShowingAndVisiblec C s. z|j }W dS t�tjd| d� Y dS )NzDEAD: %sTF)r� r r+ r, )r$ r3 r� r& r& r' r � s �zUtilities.isDeadc C s� z|� � }|�� }|�� }W n t�tjd| d� Y dS tjtjtj tj
tj tj tj
tjg}|dkrE||vrEt�tjd| d� dS |�tj�rWt�tjd| d� dS |�tj�rit�tjd| d� dS dS )NzZOMBIE: %s is null or deadTr� zZOMBIE: %s's index is -1zZOMBIE: %s is defunctzZOMBIE: %s is invalidF)r{ r* r_ r r+ r, r. r� r� r� r� r� � ROLE_PAGEr� r� r- r� �
STATE_INVALID)r$ r3 r} r4 rc r& r& r& r' r
� s4 � zUtilities.isZombiec s� d� |f }t �t j|d� |r� sd S |�� tjtjfv r d S � �fdd�}||�r.|}nzt�||�}W n d| }t �t j|d� d }Y d|� f }t �t j|d� |S )Nz*INFO: Searching for replicant for %s in %sTc s | o
�j | � ddd�S )NT)rF rG )r� rt �r3 r$ r& r' rv � s �z)Utilities.findReplicant.<locals>.<lambda>z*INFO: Exception from findDescendant for %sz-HACK: Returning %s as replicant for Zombie %s)r r+ r, r_ r. r� �
ROLE_EMBEDDEDrK )r$ r� r3 r5 �isSame� replicantr& r� r' �
findReplicant� s$ zUtilities.findReplicantc C s< |sd S g }dd� }t t||�� ��}|r|d �� S |jS )Nc S r� rr �r� r. r� rN r& r& r' rv � r� z3Utilities.getFunctionalChildCount.<locals>.<lambda>r )rQ r� r� r� r� �r$ r3 r� rZ r� r& r& r' �getFunctionalChildCount� s z!Utilities.getFunctionalChildCountc s^ |sd S g }dd� }t t||�� ��}|r&|d � � fdd�t� �� �D �}|p.dd� |D �S )Nc S r� rr r� rN r& r& r' rv � r� z1Utilities.getFunctionalChildren.<locals>.<lambda>r c rO r& rP rQ rN r& r' rK � rR z3Utilities.getFunctionalChildren.<locals>.<listcomp>c S r� r& r& rG r& r& r' rK � r� )rQ r� r� r� r� r� r& rN r' �getFunctionalChildren� s z Utilities.getFunctionalChildrenc C sB |sd S d }dd� }t t||�� ��}|r |d �d�}|p |jS )Nc S r� rr )r� r. r� rN r& r& r' rv � r� z/Utilities.getFunctionalParent.<locals>.<lambda>r )rQ r� r� r� r^ r� r& r& r' �getFunctionalParent� s
z Utilities.getFunctionalParentc sr |sdS |� � tjkr%|�d�r%��|�\}}����|��\}}||fS |� � tjk}|rP��|�}|r:|d }ndd� } ��t� || ��}|rN|d }ndS ��
|�}
�� |
�} | dkri|
|j kri|�
� | fS ��|
�} t| �dk r�tj�||�s�tjtjg� � �fdd�}
tt|
| ��} | r�|| v s�dS ��|�r�tt�j| ��} t| �dkr�dS | �|�}t| �}||fS ) Nr1 �
readingRowr c S r rr )r_ r. r r rt r& r& r' rv
rl z1Utilities.getPositionAndSetSize.<locals>.<lambda>r� c s �� | �p
| �� � v S rr )r
r_ rt �� layoutRolesr$ r& r' rv rl r )r_ r. r� rx r� rC r� r� r� rK r� r� r^ r{ r� rT r7 rz r r rQ r� r r} )r$ r3 �argsr� r� �rowcount�colcountrg r� �isMenur^ r� �siblings�isNotLayoutOnly�position�setSizer& r� r' �getPositionAndSetSize� sD
z Utilities.getPositionAndSetSizec C r� r r& )r$ r3 � isBrailler& r& r' �getRoleDescription+ r� z Utilities.getRoleDescriptionc C sP | j j�di �}|�t|�d�\}}}d||||f }t�tj|d� |||fS )N�textSelections�r r r z.INFO: Cached selection for %s is '%s' (%i, %i)T)r! r� rx r� r r+ r, )r$ r3 r� r4 r� r� r5 r& r& r' �getCachedTextSelection. s
z Utilities.getCachedTextSelectionc s� z|� � }W n( ty d| }t�tj|d� d }Y n d| }t�tj|d� d }Y | jj�d�rL| �|�\}}}|sLd| jjd< i | jjd< | jj�di �� t |�� v ru� �
t |���� �fdd�� � � D �D ]}� �
|� qmd \}} }
|r�z |� d
�\}} W n d | }t�tj|d� d
}} Y || kr�|�
|| �}
d ||
|| f }t�tj|d� || |
f� t |�< � | jjd< d S )
Nz%ERROR: %s doesn't implement AtspiTextTz/ERROR: Exception querying text interface for %sr
Fr� c s g | ] }� � |��kr|�qS r& )rx )rH �k�r� r� r& r' rK M r� z7Utilities.updateCachedTextSelection.<locals>.<listcomp>r� r z-ERROR: Exception getting selected text for %sz+INFO: New selection for %s is '%s' (%i, %i))r� r� r r+ r, r! r� rx r r� �popr r� r� ) r$ r3 r� r5 r �
selectedStart� selectedEndru r4 r� r� r& r� r' �updateCachedTextSelection5 sD
z#Utilities.updateCachedTextSelectionc G sP t j}|sd S t�� tj dk r d}t�tj|d� d S t�� t_|j| � d S )Ng�������?zEINFO: Clipboard contents change notification believed to be duplicateT) r r� r� r �_last_clipboard_updater r+ r, �onClipboardContentsChanged)r� r% r5 r& r& r' r� b s
z$Utilities.onClipboardContentsChangedc C s8 | j d urd S tj�tj�dd��}|�d| j�| _ d S )N� CLIPBOARDFz owner-change) r" r � Clipboardrx r �Atom�intern�connectr� �r$ � clipboardr& r& r' �connectToClipboardp s
�z Utilities.connectToClipboardc C s4 | j d u rd S tj�tj�dd��}|�| j � d S �Nr� F)r" r r� rx r r� r� �
disconnectr� r& r& r' �disconnectFromClipboardx s
z!Utilities.disconnectFromClipboardc C s t j�tj�dd��}|�� S r� )r r� rx r r� r� �
wait_for_textr� r& r& r' �getClipboardContents s z Utilities.getClipboardContentsc C s& t j�tj�dd��}|�|d� d S )Nr� Fr� )r r� rx r r� r� �set_text�r$ r� r� r& r& r' �setClipboardText� s zUtilities.setClipboardTextc C s( t j�tj�dd��}|�| j|� d S r� )r r� rx r r� r� � request_text� _appendTextToClipboardCallbackr� r& r& r' �appendTextToClipboard� s z Utilities.appendTextToClipboardr� c C s( |� d�}d|||f }|�|d� d S )Nr� z%s%s%sr� )�rstripr� )r$ r� r� r� � separatorr& r& r' r � s
z(Utilities._appendTextToClipboardCallbackc C s* t tjtj�s dS tj}|o|�| jj�S r� ) r\ r r� r r� r� �isFromApplicationr! r= r r& r& r' � lastInputEventCameFromThisApp� s z'Utilities.lastInputEventCameFromThisAppc C s t j}t|tj�s dS |�� S r� )r r� r\ r r� �isPrintableKeyr r& r& r' r� � s z'Utilities.lastInputEventWasPrintableKeyc C s | � � \}}|tj@ S rr �r� r �CTRL_MODIFIER_MASK�r$ � keyStringr� r& r& r' �lastInputEventWasCommand� s
z"Utilities.lastInputEventWasCommandc C s4 | � � \}}|�� r|tj@ S |dv r|tj@ S dS �N)r� r� F)r� r� r �ALT_MODIFIER_MASKr r
r& r& r' �lastInputEventWasPageSwitch� s
z%Utilities.lastInputEventWasPageSwitchc C sH | � � \}}|dvr dS |tj@ s |tj@ s |tj@ s |tj@ r"dS dS )N)�Left�Rightr� r� FT)r� r r �SHIFT_MODIFIER_MASKr �ORCA_MODIFIER_MASKr
r& r& r' � lastInputEventWasUnmodifiedArrow� s
���z*Utilities.lastInputEventWasUnmodifiedArrowc C s | � � p| �� p| �� p| �� S rr )�lastInputEventWasCharNav�lastInputEventWasWordNav�lastInputEventWasLineNav� lastInputEventWasLineBoundaryNavrJ r& r& r' �lastInputEventWasCaretNav� s ���z#Utilities.lastInputEventWasCaretNavc C �$ | � � \}}|dvr dS |tj@ S �N)r r Fr r
r& r& r' r � � z"Utilities.lastInputEventWasCharNavc C �" | � � \}}|dvr dS |tj@ S r r r
r& r& r' r � �
z"Utilities.lastInputEventWasWordNavc C �" | � � \}}|dks dS |tj@ S )Nr Fr r
r& r& r' r� � r z&Utilities.lastInputEventWasPrevWordNavc C r )Nr Fr r
r& r& r' r� � r z&Utilities.lastInputEventWasNextWordNavc C �4 | � � \}}|dvr dS | �tj�rdS |tj@ S )N)r� r� F�r� r� r r� r r r
r& r& r' r � � z"Utilities.lastInputEventWasLineNavc C r �N)�Home�EndFr r
r& r& r' r � r z*Utilities.lastInputEventWasLineBoundaryNavc C r r
r! r
r& r& r' �lastInputEventWasPageNav� r" z"Utilities.lastInputEventWasPageNavc C r r# r r
r& r& r' � lastInputEventWasFileBoundaryNav� r z*Utilities.lastInputEventWasFileBoundaryNavc C s" | � � \}}|tj@ r|dv S dS )N)r$ r% r� r� r r F)r� r r r
r& r& r' �&lastInputEventWasCaretNavWithSelection� s
z0Utilities.lastInputEventWasCaretNavWithSelectionc C �< | � � \}}| �|�}d|vrdS |tj@ r |tj@ S dS �N�zF�r� r� r r r �r$ r� r� r
r& r& r' �lastInputEventWasUndo �
z Utilities.lastInputEventWasUndoc C s: | � � \}}| �|�}d|vrdS |tj@ r|tj@ S dS r* r, r- r& r& r' �lastInputEventWasRedo s
z Utilities.lastInputEventWasRedoc C r) )Nru Fr, r- r& r& r' �lastInputEventWasCut r/ z Utilities.lastInputEventWasCutc C r) )Nr� Fr, r- r& r& r' �lastInputEventWasCopy% r/ z Utilities.lastInputEventWasCopyc C r) )N�vFr, r- r& r& r' �lastInputEventWasPaste0 r/ z Utilities.lastInputEventWasPastec C r) )Nr� Fr, r- r& r& r' �lastInputEventWasSelectAll; r/ z$Utilities.lastInputEventWasSelectAllc C sD | � � \}}|dkr dS | �� \}}| �|�}d|vr dS |tj@ S )Nr� Tr� F)r� r� r� r r )r$ r r� r� r
r& r& r' �lastInputEventWasDeleteF s
z!Utilities.lastInputEventWasDeletec C s> | � � \}}|dvr dS |tj@ s|tj@ s|tj@ r dS dS )N)r� � ISO_Left_TabFT)r� r r r r r
r& r& r' �lastInputEventWasTabR s
��z Utilities.lastInputEventWasTabc C s t tjtj�S rr )r\ r r� r �MouseButtonEventrJ r& r& r' � lastInputEventWasMouseButton^ rf z&Utilities.lastInputEventWasMouseButtonc C �& t j}t|tj�r|jdko|jS dS �N�1F�r r� r\ r r9 �button�pressedr r& r& r' �"lastInputEventWasPrimaryMouseClicka � z,Utilities.lastInputEventWasPrimaryMouseClickc C r; �N�2Fr> r r& r& r' �!lastInputEventWasMiddleMouseClickh rB z+Utilities.lastInputEventWasMiddleMouseClickc C r; �N�3Fr> r r& r& r' �$lastInputEventWasSecondaryMouseClicko rB z.Utilities.lastInputEventWasSecondaryMouseClickc C �( t j}t|tj�r|jdko|j S dS r< r> r r& r& r' �$lastInputEventWasPrimaryMouseReleasev � z.Utilities.lastInputEventWasPrimaryMouseReleasec C rI rC r> r r& r& r' �#lastInputEventWasMiddleMouseRelease} rK z-Utilities.lastInputEventWasMiddleMouseReleasec C rI rF r> r r& r& r' �&lastInputEventWasSecondaryMouseRelease� rK z0Utilities.lastInputEventWasSecondaryMouseRelease� �?c
C s� t j}|sdS t�� }||j |krdS | jj�dd�}|| |k r$dS t|tj�r1| � � s0dS nt|tj
�rJ|� | jj �sJ| �
� \}}|dvrJdS zt j�� }W n dt j }t�tj|d� Y dS tjtjtjtjg} || v S )NFzlast-table-sort-timer )r� �spacer8 r* T)r r� r� r! r� rx r\ r r9 rJ r� � isHandledBy�leftClickReviewItemr� r� r_ r r+ r, r. r� r� r� r� )
r$ r� r �now� lastSortTimer r� rc r5 r� r& r& r' �lastInputEventWasTableSort� s< �
�z$Utilities.lastInputEventWasTableSortc C s� | � |jtj�r
dS z |j�� }|j�� }W n d|j }t�tj|d� Y dS |t j
t j fv r4dS |t j kr?|�
t j�S |t jkrJ|�
t j�S dS )NT�-ERROR: Exception getting role and state of %sF)r� r r r� r_ r* r r+ r, r. r� r r� r- r� r� �r$ r rc r4 r5 r& r& r' �!isPresentableExpandedChangedEvent� s
z+Utilities.isPresentableExpandedChangedEventc C s@ |j �d�s|j �d�sdS z |j�� }|j�� }W n d|j }t�tj|d� Y dS tj tj
tj tj tj
g}||v rJd}t�tj|d� dS |tjkrg|�tj�sg|�tj�sgd}t�tj|d� dS | �|j�rs|�tj�S |tjkr�|�tj�r�dS tj|j|jjfv r�dS | �tj�r�dS d}t�tj|d� dS ) Nzobject:text-changed:z object:text-attributes-changedFrU Tz.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)r� rn r r_ r* r r+ r, r. r� r r � ROLE_SLIDERr� r� r- r� r� r" r r r� r^ r )r$ r rc r4 r5 � ignoreRolesr& r& r' �,isPresentableTextChangedEventForLocusOfFocus� sP
�
�
�
� z6Utilities.isPresentableTextChangedEventForLocusOfFocusc C s< |j �d�sdS | �|j�rdS | �� \}}|dkr dS dS )N�object:text-changed:deleteFr� T)r� rn r3 r r� )r$ r r r� r& r& r' �#isBackSpaceCommandTextDeletionEvent� s z-Utilities.isBackSpaceCommandTextDeletionEventc C � |j �d�sdS | �� S �Nr[ F)r� rn r6 r r& r& r' � isDeleteCommandTextDeletionEvent � z*Utilities.isDeleteCommandTextDeletionEventc C s4 |j �d�sdS | �� sdS | �|j�\}}}| S r^ )r� rn r. r� r �r$ r r4 r� r� r& r& r' � isUndoCommandTextDeletionEvent s z(Utilities.isUndoCommandTextDeletionEventc C sD |j �d�sdS | �� rdS | �|j�\}}}|o!|�� |j�� kS r^ )r� rn r4 r� r r� r0 ra r& r& r' �isSelectedTextDeletionEvent s z%Utilities.isSelectedTextDeletionEventc C sF |j �d�sdS | �|j� | �|j�\}}}|o"||jko"||jkS �Nr� F)r� rn r� r r� r0 r� ra r& r& r' � isSelectedTextInsertionEvent s
z&Utilities.isSelectedTextInsertionEventc C s | � � sdS | �|�r
dS dS r� )r. re r r& r& r' �isSelectedTextRestoredEvent# s
z%Utilities.isSelectedTextRestoredEventc C r] rd )r� rn rE r r& r& r' �%isMiddleMouseButtonTextInsertionEvent, r` z/Utilities.isMiddleMouseButtonTextInsertionEventc C s� |j �d�sdS z |j�� }|j�� }W n d|j }t�tj|d� Y dS |�t j
�rF|�t j �sF|jt j
krFd}t�tj|d� dS |t jkrPt�d�S t|j�� �dkr^t�d�S dS ) Nr� FrU TzHINFO: Not echoable text insertion event: focusable source is not focused�
enableKeyEchor rh )r� rn r r_ r* r r+ r, r- r. r� r� r r� r r� r� rT r0 r� rV r& r& r' � isEchoableTextInsertionEvent2 s&
z&Utilities.isEchoableTextInsertionEventc C sL | � |�sdS z|�� }W n d| }t�tj|d� Y dS |�tj�S )NFr) T)r- r* r r+ r, r- r. r. r2 r& r& r' rc L s
z Utilities.isEditableTextAreac C s� |j �d�sdS | �� r| �� rdS | �|�rdS d|j v r$| �� r$dS | �|j�s,dS | �� }|s4dS |j |kr;dS t
t � d|j ��t
t � d|��krNdS d|v r[|j �
� |v r[dS dS )Nzobject:text-changedF�deleteTz\wr� )r� rn r r. r\ r4 rc r r� r0 r� r\ r� r )r$ r �contentsr& r& r' �isClipboardTextChangedEventY s(
"z%Utilities.isClipboardTextChangedEventc C sv |pt j}|r | �|�rdS | �� }|sdS | �|�\}}}|r&||v r&dS | �|�p,|}| �|�r4dS |o:|j|v S r� )r r� r r� r r� r� )r$ r3 rk r� r4 r� r& r& r' � objectContentsAreInClipboardy s
z&Utilities.objectContentsAreInClipboardc C s4 d| j jd< d| j jd< d| j jd< d| j jd< d S )NF�undo�redo�paster �last-selection-message)r! r� rJ r& r& r' �clearCachedCommandState� s z!Utilities.clearCachedCommandStatec C s� | � � r | jj�d�s| j�tj� d| jjd< | �|j� dS | � � r@| jj�d�s8| j�tj
� d| jjd< | �|j� dS dS )Nrn Tro F) r. r! r� rx �presentMessager �UNDOr� r r0 �REDOr r& r& r' �handleUndoTextEvent� s z Utilities.handleUndoTextEventc C sx | � � rdS | �� r | jj�d�s | j�tj� d| jjd< dS | �� r:| jj�d�s8| j�tj � d| jjd< dS dS )NFrn Tro )
r� r. r! r� rx rs r rt r0 ru rJ r& r& r' � handleUndoLocusOfFocusChange� s z&Utilities.handleUndoLocusOfFocusChangec C sH | � � rdS | �� r"| jj�d�s | j�tjtj� d| jjd< dS dS )NFrp T) r� r4 r! r� rx rs r �CLIPBOARD_PASTED_FULL�CLIPBOARD_PASTED_BRIEFrJ r& r& r' � handlePasteLocusOfFocusChange� s � z'Utilities.handlePasteLocusOfFocusChangec C sx t jsd}t�tj|d� dS t�� t jj }|dkr)d| }t�tj|d� dS | �|�r:d}t�tj|d� dS dS )Nz.INFO: Not user triggered: No last input event.TFr z5INFO: Not user triggered: Last input event %.2fs ago.zCINFO: Last key was consumed. Probably a bogus event from a key grab)r r� r r+ r, r� �isKeyGrabEvent)r$ r r5 r� r& r& r' �eventIsUserTriggered� s
z Utilities.eventIsUserTriggeredc C s$ t tjtj�s dS tj�� otj S )zT Returns True if this event appears to be a side-effect of an
X11 key grab. F)r\ r r� r r� �
didConsume�
openingDialogr r& r& r' r{ � s zUtilities.isKeyGrabEventc C s | � � rdS | �� r dS dS r )rw rz rJ r& r& r' �presentFocusChangeReason� s
z"Utilities.presentFocusChangeReasonc C s t �|�}d|vr dS |�� }|�t j�r |�t j�s dS |�� }|t jt jfv r+dS |� � }|j
s4dS | � |�|j krV|�
d�}||vrGdS d|j }t�tj|d� dS d|vr\dS |�� }|j|jkrud|j }t�tj|d� dS |j|jkr�d|j }t�tj|d� dS dS ) Nr� Fr z-INFO: All %i children believed to be selectedTr� z)INFO: All %i rows believed to be selectedz,INFO: All %i columns believed to be selected)r. r� r* r- r� r� r_ r� r r6 r7 rH r� r8 r r+ r, r� rG r� �nSelectedColumnsr ) r$ r3 r� r4 rc r rI r5 r� r& r& r' �allItemsSelected� sB
�
zUtilities.allItemsSelectedc C s` | j j�d�}| �|�}|r|rdS || j jd< | �� r.|r.| j �tj� t� d |d� dS dS )Nr� TF)
r! r� rx r� r5 rs r �CONTAINER_SELECTED_ALLr r5 )r$ r3 �allAlreadySelected�allCurrentlySelectedr& r& r' � handleContainerSelectionChange s
z(Utilities.handleContainerSelectionChangec C s� z |� � }|j}W n d| }t�tj|d� Y d S |�� s"d S |�d�\}}|�||�}|s3d S |r=|�| j �s=|S |sG|�
| j �sG|S t t |��} |sS| �
� | D ]}
| �||
|�} | re| S qUd S )Nz<ERROR: Exception querying text and getting childCount for %sTr )r� r� r r+ r, r� r� r� rn r� rP rQ r� r� � _findSelectionBoundaryObject) r$ r� � findStartr� r� r5 r4 r� r� �indicesr� r� r& r& r' r� s4
�z&Utilities._findSelectionBoundaryObjectc C s | � |d�}| � |d�}||fS r )r� )r$ r� r; r< r& r& r' �_getSelectionAnchorAndFocus@ s z%Utilities._getSelectionAnchorAndFocusc
C s |r|sg S dd� }| j }g }t|�� |jj�D ]"}|j| }| � |�r%q|�|� |�| �|||�� ||v r: nq||krA|S ||vrT|�|� |�| �|||�� z |j|�� d }W n |}Y z|�|�} W n
t yw Y |S w ||kr�| d7 } |d | � }|S )Nc S s | S rr r& rt r& r& r' rv K s z'Utilities._getSubtree.<locals>.<lambda>r )
r� r� r{ r^ r� r� rP r� r} r: )
r$ �startObj�endObjr� r� �subtreer� rI �lastObjrw r& r& r' � _getSubtreeG sB
�
� zUtilities._getSubtreec C s" |r dt �|�v s dS | �|�\}}}| �|� | �|�\}}}| �t|��r)dS | �� s:|r:|s:| j�t j
� dS g } t t ||��}
t t ||��} |
�
| �sQdS |
rm| rm|
�| �sm| �||t jg� | �||t jg� nYt|
�| ��} | sxdS | d | d d }
}|
| k r�| �|
|t jg� |�| j�r�||
kr�| �||d �}| �|d� n | �|
|t jg� |�| j�r�| �||d �}| �|d� |o�t�d� }|�� }| D ]:\}}}|�||�}|�| j�}|r�|d8 }| j� |||� |r�|s�| jj|dd� |�r| �||�}| �||� q�dS ) Nr� FTr r� r r� )� interrupt) r. r� r� r� �_speakTextSelectionStaterT r( r! � speakMessager �SELECTION_REMOVEDrX r� �unionr� r� �TEXT_UNSELECTED�
TEXT_SELECTEDrU �symmetric_differencerP r� r �handleTextSelectionChanger� r� r� r� � sayPhrase)r$ r3 r� �oldStart�oldEnd� oldString�newStart�newEndr� �changes�oldChars�newChars�change� changeStart� changeEndrI r� r4 r� �messager� �
endsWithChildr& r& r' r� o s^
� �z#Utilities.handleTextSelectionChangec C r� )�!Hacky and to-be-obsoleted method.)r �PARAGRAPH_SELECTED_DOWN�PARAGRAPH_UNSELECTED_DOWN�PARAGRAPH_SELECTED_UP�PARAGRAPH_UNSELECTED_UPrJ r& r& r' � _getCtrlShiftSelectionsStrings� s
�z(Utilities._getCtrlShiftSelectionsStringsc C s� t �d�rdS | �� \}}|tj@ }|tj@ }|dk}d}|dkr)|r)|r)tj}n�|dkr5|r5|r5tj}n�|dkrG|rG|sG|rCtj }n�tj
}n|dkrY|rY|sY|rUtj }nqtj }nm|dkrq|rq|rq| �
� }|rl|d }nZ|d }nU|d kr�|r�|r�| �
� }|r�|d
}nB|d }n=|d kr�|r�|r�|r�tj}n/tj}n+|d
kr�|r�|r�|r�tj}n tj}n| �� r�|r�| jj�d�s�d| jjd< tj}ndS |s�dS || jj�d�kr�|| jjd< | j�|� dS )r� r� Fr Nr� r� r� r r� r� r� r$ r% r
Trq )r� r� r� r r r r �LINE_SELECTED_RIGHT�LINE_SELECTED_LEFT�PAGE_SELECTED_DOWN�PAGE_UNSELECTED_DOWN�PAGE_SELECTED_UP�PAGE_UNSELECTED_UPr� �DOCUMENT_SELECTED_UP�DOCUMENT_UNSELECTED_UP�DOCUMENT_SELECTED_DOWNr5 r! r� rx �DOCUMENT_SELECTED_ALLr� ) r$ r r� r� � isControlKey�
isShiftKeyr rv �stringsr& r& r' r� � s`
z"Utilities._speakTextSelectionState)F)Trr )FF)r rI )Tr� )r r� r� )r8 )TT)r T)Nr� F)r� )r� )rN (� �__name__�
__module__� __qualname__r. �Registry�
getDesktoprL r� r� r� �ZERO_WIDTH_NO_BREAK_SPACEr� r� r\ �UNICODE�flagsrn r� r� r� r� r� r� r� r� r r} r r( r6 � staticmethodr@ rD r[ rd rq 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 r2 r3 r4 r5 r6 r7 r8 r9 r: r; r< r= r> r? r@ rA rB rC rD rE rF rG rH rI rJ rK rL rM rN rO rP rQ rR rS rT rU rV rW rX rY rZ r[ r\ r] r^ r_ r` ra rb rc rd re rf rg rh ri rj rk rl rm rn ro rp rq rr rs rt ru rv rw rx ry 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� rs r� r� r� r� r� r� r� r� r� r r r r
r r) r, r0 r1 r6 r? r� r- rO r� rb r[ r{ r r r� r� r� r� r� r� r� r! r� r� r� r� r� r� r r� r� r� r� r� rX r� r� r� r� r� r� r� r� r� rp r r r r r r r r r r r r( r* r, r- r. r� r1 r2 r r� r4 r7 r6 r r; r< rB r& r] rb rc r^ rl r~ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r rC r! r$ r& r' r, r. r0 r2 r� rA rF rH rJ rM rQ rT rV rZ r\ r] r[ r^ ra rb rd re r� ri rj rl rm rW ru rv r� rw rx ry rz r| r� r� r� r� r� r� r� r� rC 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 r2 r4 r5 r6 r8 r: rA rE rH rJ rL rM rT rW rZ r\ r_ rb rc re rf rg ri rc rl rm rr rv rw rz r| r{ r r� r� r� r� r� r� r� r� r& r& r& r' r B s� ��
#
&E6!
7
)
&
"
r
&
; "6 6
V #
? ' ! # (
#% $
5&& ,
@7*
/ L
',%
--
$.
-"(Fr )$�__doc__�__id__� __version__�__date__�
__copyright__� __license__rV �girS r r. r\ r: r� r� r r r r r r r
r r r
r r r r r r r r �
getManagerr� r r& r& r& r' �<module> sB