Mini Shell
3
�p5[{ � @ s, d Z dZdZdZdZdZddlZddlZddlj Z ddl
j Z ddl j
Z
ddljZddljZddljZddljZddljZddljZddljZddl j Z ddl j Z ddl j!Z"ddl#j$Z$ddl%j&Z&ddl'j(Z(ddl)j*Z*ddl+j,Z,ddl-j.Z.ddl/j0Z0ddl1j2Z2ddl3j4Z4ddl5j6Z6e,j7� Z8G dd � d e(j9�Z9dS )
z�The default Script for presenting information to the user using
both speech and Braille. This is based primarily on the de-facto
standard implementation of the AT-SPI, which is the GAIL support
for GTK.z$Id$z
$Revision$z$Date$zOCopyright (c) 2004-2009 Sun Microsystems Inc.Copyright (c) 2010 Joanmarie DiggsZLGPL� Nc s� e Zd ZdZdZdZdZdZdZdZ dZ
d d
� Z d d � Z d
d� Z
dd� Zdd� Zdd� Zdd� Zdd� Zdd� Zdd � Z� fd d �Z� fd d �Zd!d"� Zd#d$� Zd%d&� Zd'd(� Z�dtd*d+�Z�dud,d-�Z �dvd.d/�Z �dwd0d1�Z �dxd2d3�Z �dyd4d5�Z d6d7� Z!d8d9� Z"d:d;� Z#d<d=� Z$d>d?� Z%d@dA� Z&dBdC� Z'�dzdEdF�Z(�d{dGdH�Z)�d|dIdJ�Z*�d}dKdL�Z+�d~dMdN�Z,�ddOdP�Z-�d�dQdR�Z.�d�dSdT�Z/�d�dUdV�Z0�d�dWdX�Z1dYdZ� Z2d[d\� Z3�d�d]d^�Z4�d�d_d`�Z5�d�dadb�Z6dcdd� Z7�d�dfdg�Z8dhdi� Z9djdk� Z:dldm� Z;dndo� Z<dpdq� Z=drds� Z>�d�dtdu�Z?dvdw� Z@dxdy� ZAdzd{� ZBd|d}� ZCd~d� ZDd�d�� ZEd�d�� ZFd�d�� ZG�d�d�d��ZHd�d�� ZId�d�� ZJd�d�� ZKd�d�� ZLd�d�� ZM�d�d�d��ZN�d�d�d��ZO�d�d�d��ZPd�d�� ZQd�d�� ZRd�d�� ZS�d�d�d��ZT�d�d�d��ZU�d�d�d��ZV�d�d�d��ZW�d�d�d��ZX�d�d�d��ZY�d�d�d��ZZ�d�d�d��Z[�d�d�d��Z\�d�d�d��Z]�d�d�d��Z^d�d�� Z_d�d�� Z`d�d�� Za�d�d�d��Zb�d�d�d��Zc�d�d�d��Zdd�d�� Zed�dÄ Zfd�dń Zgd�dDŽ 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�� Zd�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��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 �d �Z��d �d � Z��d��d!�d"�Z��d��d#�d$�Z��d��d%�d&�Z��d'�d(� Z��d)�d*� Z��d+�d,� Z��d-�d.� Z��d/�d0� Z��d1�d2� Z��d��d4�d5�Z�e��d��d6�d7��Z�e��d8�d9� �Z�e��d:�d;� �Z�e��d<�d=� �Z�e��d>�d?� �Z�e��d@�dA� �Z�e��d��dB�dC��Z�e��d��dD�dE��Z��dF�dG� Z�e��dH�dI� �Z�e��dJ�dK� �Z�e��d��dM�dN��Z�e��d��dP�dQ��Z�e��d��dR�dS��Z�e��d��dT�dU��Z�e��dV�dW� �Z�e��dX�dY� �Z�e��d��dZ�d[��Z�e��d\�d]� �Z�e��d^�d_� �Z��d`�da� Z�e��d��db�dc��Z�e��d��dd�de��Z�e��df�dg� �Z��dh�di� Z��d��dj�dk�Z�e��dl�dm� �Z��dn�do� Z��dp�dq� Z��dr�ds� Z�� Z�S (� �Scriptu � ZdisplayedLabel�
displayedText�
keyBindingZ nestingLevelZ nodeLevelZrealActiveDescendantc C s� t jj| |� d| _d| _d| _d| _d| _d| _i | _ d| _
ddg| _ d| _ d| _
d| _d| _d| _g | _|r�|jtjjtjjA tjjA tjjA � dS )z�Creates a new script for the given application.
Arguments:
- app: the application to create a script for.
NF�
0123456789z
r � )�scriptr �__init__�flatReviewContext�windowActivateTime�targetCursorCell�justEnteredFlatReviewModeZdigitsZ
whitespaceZattributeNamesDict�lastMouseRoutingTime�oldMouseCoordinates�currentReviewContents� _lastWord�_lastWordCheckedForSpelling� _inSayAll�_sayAllIsInterrupted�_sayAllContextsZ setCacheMask�pyatspi�cacheZDEFAULTZCHILDREN�NAMEZ DESCRIPTION)�self�app� r � /usr/lib/python3.6/default.pyr R s&
zScript.__init__c C s� t jtjtj�| jd< t jtjtj�| jd< t jtj tj
�| jd< t jtj tj �| jd< t jtj
tj�| jd< t jtjtj�| jd< t jtjtj�| jd< t jtjtj�| jd< t jtjtj�| jd < t jtjtj�| jd
< t jtjtj�| jd < t jtj tj �| jd < t jtj tj �| jd
< t jtj tj!�| jd< t jtj"tj#�| jd< t jtj$tj%�| jd< t jtj&tj'�| jd< t jtj(tj)�| jd< t jtj*tj+�| jd< t jtj,tj-�| jd< t jtj.tj/�| jd< t jtj0tj1�| jd< t jtj2tj3�| jd< t jtj4tj5�| jd< t jtj6tj7�| jd< t jtj8tj9�| jd< t jtj:tj;�| jd< t jtj<tj=�| jd < t jtj>tj?�| jd < t jtj@tjA�| jd < t jtjBtjC�| jd < t jtjDtjE�| jd < t jtjFtjG�| jd!< t jtjHtjI�| jd"< t jtjJtjK�| jd#< t jtjLtjM�| jd$< t jtjNtjO�| jd%< t jtjPtjQ�| jd&< t jtjRtjS�| jd'< t jtjTtjU�| jd(< t jtjVtjW�| jd)< t jtjXtjYd*�| jd+< t jtjZtj[d*�| jd,< t jtj\tj]�| jd-< t jtj^tj_�| jd.< t jtj`tja�| jd/< t jtjbtjc�| jd0< t jtjdtje�| jd1< t jtjftjg�| jd2< t jthjitjj�| jd3< t jthjktjl�| jd4< t jthjmtjn�| jd5< t jthjotjp�| jd6< t jthjqtjr�| jd7< t jthjstjt�| jd8< t jtjutjv�| jd9< t jtjwtjx�| jd:< t jtjytjz�| jd;< t jtj{tj|�| jd<< t jtj}tj~�| jd=< t jtjtj��| jd>< t jtj�tj��| jd?< t jtj�tj��| jd@< t jtj�tj��| jdA< t jtj�tj��| jdB< t jtj�tj��| jdC< t jtj�tj��| jdD< t jtj�tj��| jdE< t jtj�tj��| jdF< t jtj�tj��| jdG< t jtj�tj��| jdH< t jtj�tj��| jdI< t jt�j�j�tj��| jdJ< t jtj�tj��| jdK< t jtj�tj��| jdL< t jtj�tj��| jdM< | jj�t�j� dNS )OzlDefines InputEventHandler fields for this script that can be
called by the key and braille bindings.ZroutePointerToItemHandlerZleftClickReviewItemHandlerZrightClickReviewItemHandlerZ
sayAllHandlerZflatReviewSayAllHandlerZwhereAmIBasicHandlerZwhereAmIDetailedHandlerZwhereAmILinkHandlerZwhereAmISelectedTextHandlerZgetTitleHandlerZgetStatusBarHandlerZ findHandlerZfindNextHandlerZfindPreviousHandler�toggleFlatReviewModeHandlerZreviewPreviousLineHandler�reviewHomeHandlerZreviewCurrentLineHandlerZ reviewSpellCurrentLineHandlerZ reviewPhoneticCurrentLineHandlerZreviewNextLineHandlerZreviewEndHandlerZreviewPreviousItemHandler�reviewAboveHandlerZreviewCurrentItemHandlerZ reviewSpellCurrentItemHandlerZ reviewPhoneticCurrentItemHandlerZreviewNextItemHandlerZ reviewCurrentAccessibleHandler�reviewBelowHandlerZ reviewPreviousCharacterHandlerZreviewEndOfLineHandler�reviewBottomLeftHandlerZ reviewCurrentCharacterHandlerZ"reviewSpellCurrentCharacterHandlerZ$reviewUnicodeCurrentCharacterHandlerZreviewNextCharacterHandlerZflatReviewCopyHandlerZflatReviewAppendHandlerZ toggleTableCellReadModeHandlerZreadCharAttributesHandlerF�panBrailleLeftHandler�panBrailleRightHandler�goBrailleHomeHandler�contractedBrailleHandler�processRoutingKeyHandler� processBrailleCutBeginHandler� processBrailleCutLineHandlerZenterLearnModeHandlerZdecreaseSpeechRateHandlerZincreaseSpeechRateHandlerZdecreaseSpeechPitchHandlerZincreaseSpeechPitchHandlerZdecreaseSpeechVolumeHandlerZincreaseSpeechVolumeHandlerZshutdownHandlerZpreferencesSettingsHandlerZ appPreferencesSettingsHandlerZtoggleSilenceSpeechHandlerZ toggleSpeechVerbosityHandlerZ-toggleSpeakingIndentationJustificationHandlerZchangeNumberStyleHandlerZ$cycleSpeakingPunctuationLevelHandlerZcycleSettingsProfileHandlerZ cycleCapitalizationStyleHandlerZcycleKeyEchoHandlerZcycleDebugLevelHandler�goToPrevBookmark� goToBookmark�goToNextBookmark� addBookmark�
saveBookmarksZtoggleMouseReviewHandlerZpresentTimeHandlerZpresentDateHandlerZbypassNextCommandHandlerN)�� input_eventZInputEventHandlerr �routePointerToItem�cmdnamesZROUTE_POINTER_TO_ITEM�inputEventHandlers�leftClickReviewItemZLEFT_CLICK_REVIEW_ITEM�rightClickReviewItemZRIGHT_CLICK_REVIEW_ITEM�sayAllZSAY_ALL�flatReviewSayAllZSAY_ALL_FLAT_REVIEW�
whereAmIBasicZWHERE_AM_I_BASIC�whereAmIDetailedZWHERE_AM_I_DETAILED� whereAmILinkZWHERE_AM_I_LINK�whereAmISelectedTextZWHERE_AM_I_SELECTED_TEXT� presentTitleZ
PRESENT_TITLE�presentStatusBarZPRESENT_STATUS_BAR�orca� showFindGUIZ
SHOW_FIND_GUI�findNextZ FIND_NEXT� findPreviousZ
FIND_PREVIOUS�toggleFlatReviewModeZTOGGLE_FLAT_REVIEW�reviewPreviousLineZREVIEW_PREVIOUS_LINE�
reviewHomeZ REVIEW_HOME�reviewCurrentLineZREVIEW_CURRENT_LINE�reviewSpellCurrentLineZREVIEW_SPELL_CURRENT_LINE�reviewPhoneticCurrentLineZ REVIEW_PHONETIC_CURRENT_LINE�reviewNextLineZREVIEW_NEXT_LINE� reviewEndZ
REVIEW_END�reviewPreviousItemZREVIEW_PREVIOUS_ITEM� reviewAboveZ REVIEW_ABOVE�reviewCurrentItemZREVIEW_CURRENT_ITEM�reviewSpellCurrentItemZREVIEW_SPELL_CURRENT_ITEM�reviewPhoneticCurrentItemZ REVIEW_PHONETIC_CURRENT_ITEM�reviewNextItemZREVIEW_NEXT_ITEM�reviewCurrentAccessibleZREVIEW_CURRENT_ACCESSIBLE� reviewBelowZ REVIEW_BELOW�reviewPreviousCharacterZREVIEW_PREVIOUS_CHARACTER�reviewEndOfLineZREVIEW_END_OF_LINE�reviewBottomLeftZREVIEW_BOTTOM_LEFT�reviewCurrentCharacterZREVIEW_CURRENT_CHARACTER�reviewSpellCurrentCharacterZ REVIEW_SPELL_CURRENT_CHARACTER� reviewUnicodeCurrentCharacterZ REVIEW_UNICODE_CURRENT_CHARACTER�reviewNextCharacterZREVIEW_NEXT_CHARACTER�flatReviewCopyZFLAT_REVIEW_COPY�flatReviewAppendZFLAT_REVIEW_APPEND�toggleTableCellReadModeZTOGGLE_TABLE_CELL_READ_MODE�readCharAttributesZREAD_CHAR_ATTRIBUTES�panBrailleLeftZPAN_BRAILLE_LEFT�panBrailleRightZPAN_BRAILLE_RIGHT�
goBrailleHomeZGO_BRAILLE_HOME�setContractedBrailleZSET_CONTRACTED_BRAILLE�processRoutingKeyZPROCESS_ROUTING_KEY�processBrailleCutBeginZPROCESS_BRAILLE_CUT_BEGIN�processBrailleCutLineZPROCESS_BRAILLE_CUT_LINE�enterLearnModeZENTER_LEARN_MODE�speechZdecreaseSpeechRateZDECREASE_SPEECH_RATEZincreaseSpeechRateZINCREASE_SPEECH_RATEZdecreaseSpeechPitchZDECREASE_SPEECH_PITCHZincreaseSpeechPitchZINCREASE_SPEECH_PITCHZdecreaseSpeechVolumeZDECREASE_SPEECH_VOLUMEZincreaseSpeechVolumeZINCREASE_SPEECH_VOLUMEZquitOrcaZ QUIT_ORCAZshowPreferencesGUIZSHOW_PREFERENCES_GUIZshowAppPreferencesGUIZSHOW_APP_PREFERENCES_GUI�toggleSilenceSpeechZ
TOGGLE_SPEECH�toggleSpeechVerbosityZTOGGLE_SPEECH_VERBOSITY�&toggleSpeakingIndentationJustificationZ+TOGGLE_SPOKEN_INDENTATION_AND_JUSTIFICATION�changeNumberStyleZCHANGE_NUMBER_STYLE� cycleSpeakingPunctuationLevelZCYCLE_PUNCTUATION_LEVEL�cycleSettingsProfileZCYCLE_SETTINGS_PROFILE�cycleCapitalizationStyleZCYCLE_CAPITALIZATION_STYLE� cycleKeyEchoZCYCLE_KEY_ECHO�cycleDebugLevelZCYCLE_DEBUG_LEVELr) ZBOOKMARK_GO_TO_PREVIOUSr* ZBOOKMARK_GO_TOr+ ZBOOKMARK_GO_TO_NEXTr, Z BOOKMARK_ADDr- Z
BOOKMARK_SAVE� mouse_reviewZreviewerZtoggleZMOUSE_REVIEW_TOGGLE� presentTimeZPRESENT_CURRENT_TIME� presentDateZPRESENT_CURRENT_DATE�bypassNextCommandZBYPASS_NEXT_COMMAND�update�notification_messages)r r r r �setupInputEventHandlers� s� z Script.setupInputEventHandlersc C s( x"| j j� D ]\}}||kr |S q W dS )zaReturns the name of the key that contains an inputEventHadler
passed as argument
N)r1 �items)r ZinputEventHandlerZkeyName�handlerr r r �getInputEventHandlerKey s z Script.getInputEventHandlerKeyc C sF t jj| �}| j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j |d< | j
|d< | j |d < | j |d
< | j
|d < | j|d < | j|d
< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j |d< | j |d < | j |d < | j |d < | j |d < |S ) z<Sets up the AT-SPI event listeners for this script.
zfocus:zdocument:reloadzdocument:load-completezdocument:load-stoppedz mouse:buttonz&object:property-change:accessible-namezobject:text-caret-movedzobject:text-changed:deletezobject:text-changed:insertz object:active-descendant-changedzobject:children-changedzobject:state-changed:activezobject:state-changed:busyz object:state-changed:focusedz object:state-changed:showingz object:state-changed:checkedz object:state-changed:pressedz"object:state-changed:indeterminatez object:state-changed:expandedz object:state-changed:selectedz object:state-changed:sensitivez object:text-attributes-changedz object:text-selection-changedzobject:selection-changedz'object:property-change:accessible-valuezobject:value-changedzobject:column-reorderedzobject:row-reorderedzwindow:activatezwindow:deactivatez
window:create)!r r � getListeners�onFocus�onDocumentReload�onDocumentLoadComplete�onDocumentLoadStopped�
onMouseButton�
onNameChanged� onCaretMoved�
onTextDeleted�onTextInserted�onActiveDescendantChanged�onChildrenChanged�onActiveChanged�
onBusyChanged�onFocusedChanged�onShowingChanged�onCheckedChanged�onPressedChanged�onIndeterminateChanged�onExpandedChanged�onSelectedChanged�onSensitiveChanged�onTextAttributesChanged�onTextSelectionChanged�onSelectionChanged�onValueChanged�onColumnReordered�onRowReordered�onWindowActivated�onWindowDeactivated�onWindowCreated)r Z listenersr r r rw sB
zScript.getListenersc C s& ddl j}tj� }|j|j| j� |S )zReturns an instance of keybindings.KeyBindings that use the
numeric keypad for focus tracking and flat review.
r N)Zorca.desktop_keyboardmap�desktop_keyboardmap� keybindings� KeyBindings�load�keymapr1 )r r� � keyBindingsr r r Z__getDesktopBindings[ s
zScript.__getDesktopBindingsc C s& ddl j}tj� }|j|j| j� |S )z�Returns an instance of keybindings.KeyBindings that use the
the main keyboard keys for focus tracking and flat review.
r N)Zorca.laptop_keyboardmap�laptop_keyboardmapr� r� r� r� r1 )r r� r� r r r Z__getLaptopBindingse s
zScript.__getLaptopBindingsc
C s� t jj| �}| j� }x|jD ]}|j|� q W | j� }x|jD ]}|j|� q>W | j� }x|jD ]}|j|� q`W ytj | |�}W n0 d| }t
j t
j |d� t
j
t
j � Y nX |S )zkDefines the key bindings for this script.
Returns an instance of keybindings.KeyBindings.
z2ERROR: Exception when overriding keybindings in %sT)r r �getKeyBindings�getDefaultKeyBindingsr� �add�getToolkitKeyBindings�getAppKeyBindings�_settingsManagerZoverrideKeyBindings�debug�println�
LEVEL_WARNING�printException)r r� Zbindingsr �msgr r r r� o s" zScript.getKeyBindingsc C sx t j� }tjd�}|tjkr<x<| j� jD ]}|j|� q(W n x | j � jD ]}|j|� qHW ddl
j }|j |j
| j� |S )zyReturns the default script's keybindings, i.e. without any of
the toolkit or application specific commands added.ZkeyboardLayoutr N)r� r� r� �
getSetting�settingsZ GENERAL_KEYBOARD_LAYOUT_DESKTOP�_Script__getDesktopBindingsr� r� �_Script__getLaptopBindingsZorca.common_keyboardmap�common_keyboardmapr� r� r1 )r r� Zlayoutr r� r r r r� � s
z Script.getDefaultKeyBindingsc C sJ t jj| �}y�| jd |tjj< | jd |tjj< | jd |tjj< | jd |tjj < | jd |tjj
< | jd |tjj < | jd |tjj < | jd |tjj
< | jd |tjj< | jd
|tjj< | jd |tjj< | jd |tjj< W n\ tk
�r d
| }tjtj|d� Y n0 d| }tjtj|d� tjtj� Y nX |S )z�Defines the braille bindings for this script.
Returns a dictionary where the keys are BrlTTY commands and the
values are InputEventHandler instances.
r" r# r r r r r! r$ r% r& r' r( z+DEFAULT: Braille bindings unavailable in %sTz/ERROR: Exception getting braille bindings in %s)r r �getBrailleBindingsr1 �brailleZbrlapiZKEY_CMD_FWINLTZKEY_CMD_FWINRTZ KEY_CMD_LNUPZ KEY_CMD_LNDNZKEY_CMD_FREEZEZKEY_CMD_TOP_LEFTZKEY_CMD_BOT_LEFTZ KEY_CMD_HOMEZKEY_CMD_SIXDOTSZ
KEY_CMD_ROUTEZKEY_CMD_CUTBEGINZKEY_CMD_CUTLINE�AttributeErrorr� r� �
LEVEL_INFOr� �LEVEL_CONFIGURATION)r �brailleBindingsr� r r r r� � s, zScript.getBrailleBindingsc C s d| _ d| _i | _dS )z'Called when this script is deactivated.FN)r r �pointOfReference)r r r r �
deactivate� s zScript.deactivatec s t � j� | jj� d S )N)�super�registerEventListeners� utilitiesZconnectToClipboard)r )� __class__r r r� � s
z Script.registerEventListenersc s t � j� | jj� d S )N)r� �deregisterEventListenersr� ZdisconnectFromClipboard)r )r� r r r� � s
z Script.deregisterEventListenersc
C s, |sdS y|j � }|j� }|j}W n
dS | jjdi �}||t|�< tjr�ytjj|ttj�< W n& dtj }tj tj
|d� Y nX || jd< y |j � }W n Y n"X | j |t
d|j�� | jj|� | jj|�\}} | | jd< || jd< t|�|jtj�f| jd< t|�|jtj�f| jd < dS )
aF Saves some basic information about obj. Note that this method is
intended to be called primarily (if not only) by locusOfFocusChanged().
It is expected that accessible event callbacks will update the point
of reference data specific to that event. The goal here is to weed
out duplicate events.N�namesz$ERROR: Exception getting name for %sTr Z
lastColumnZlastRow�
checkedChange�selectedChange)�getRole�getState�namer� �get�hash�
orca_state� activeWindowr� r� r� � queryText�_saveLastCursorPosition�max� caretOffsetr� �updateCachedTextSelectionZcoordinatesForCell�containsr Z
STATE_CHECKED�STATE_SELECTED)
r �obj�role�stater� r� r� �text�row�columnr r r �_saveFocusedObjectInfo� s8
z Script._saveFocusedObjectInfoc
C s� | j j� |s tj� t_dS |j� jtj�r0dS | j j ||�rBdS y| j
rNdS W n Y nX | j rl| j � tj
s�|r�|jtjjkr�| j j|�t_
tj� | _| j|� | jo�tj� | j dk }| jj||d�}tj|| d� | j|� dS )a Called when the visual object with focus changes.
Arguments:
- event: if not None, the Event that caused the change
- oldLocusOfFocus: Accessible that is the old locus of focus
- newLocusOfFocus: Accessible that is the new locus of focus
N� )�priorObj)� interrupt)r� ZpresentFocusChangeReason�timer� ZnoFocusTimeStampr� r� r Z
STATE_DEFUNCT� isSameObject�findCommandRunr
r@ r� Zhost_applicationZ activeScriptr �topLevelObjectr �
updateBraille�speechGenerator�generateSpeechrc �speakr� )r �eventZoldLocusOfFocusZnewLocusOfFocusZshouldNotInterrupt�
utterancesr r r �locusOfFocusChanged
s4
zScript.locusOfFocusChangedc C s. t j| � tj| jj� � tj� tj� dS )z%Called when this script is activated.N) r� ZloadAppSettingsr� ZsetupKeyRangesr� �keysrc �updatePunctuationLevel�updateCapitalizationStyle)r r r r �activate? s
zScript.activatec K s� t jd� r,t jd� r,tjtjdd� dS |s4dS | jj|f|�\}}|sPdS | j� | j� }t j
|� | j ||� |j d�}|r�| j
||� | j|� n
| j|� | jd� dS )zoUpdates the braille display to show the give object.
Arguments:
- obj: the Accessible
�
enableBraille�enableBrailleMonitorzBRAILLE: update disabledTN� extraRegion)r� r� r� r� r� �brailleGenerator�generateBraille� clearBraille�getNewBrailleLiner� �addLine�addBrailleRegionsToLiner� �addBrailleRegionToLine�setBrailleFocus�refreshBraille)r r� �args�resultZ
focusedRegion�liner� r r r r� G s&
zScript.updateBrailleNc C s | j tj� dt_dS )z�Causes the next keyboard command to be ignored by Orca
and passed along to the current application.
Returns True to indicate the input event has been consumed.
T)�presentMessage�messagesZBYPASS_MODE_ENABLEDr� rp )r �
inputEventr r r rp n s zScript.bypassNextCommandc C s8 t jr
dS | jtj� | jtj� | jtj� dt _dS )z�Turns learn mode on. The user must press the escape key to exit
learn mode.
Returns True to indicate the input event has been consumed.
T) r� �learnModeEnabledr� r� �VERSION� speakMessageZLEARN_MODE_START_SPEECH�displayBrailleMessageZLEARN_MODE_START_BRAILLE)r r� r r r rb y s zScript.enterLearnModec C s< t js
dS t|tj�r&|jdk r&dS | jtj� dt _dS )zcTurns learn mode off.
Returns True to indicate the input event has been consumed.
FZEscapeT) r� r� �
isinstancer. �
KeyboardEvent� event_stringr� r� ZLEARN_MODE_STOP)r r� r r r �
exitLearnMode� s zScript.exitLearnModec C s t j� S )N)r< Z helpForOrca)r r� r r r �showHelp� s zScript.showHelpc C s |d krt j}tj| |�S )N)r� �lastNonModifierKeyEventrr ZlistNotificationMessages)r r� r r r �listNotifications� s zScript.listNotificationsc
C s� |dkrt j}| s |jdkr:| j� j� }tjt|��}nVy | jj }W n t
k
r` tj }Y nX | j � j� }|j
| j� j� � tjt|�|�}|s�| j|� dS | j� dd� |D �}t|dd� d� tj}tj}tj|d ||f|d
� dS ) z1Shows a simple gui listing Orca's bound commands.NZF2Tc S s" g | ]}|j j|j j|j� f�qS r )ru Zfunction� descriptionZasString)�.0Zkbr r r �
<listcomp>� s z,Script.listOrcaShortcuts.<locals>.<listcomp>c S s | d S )N� r )�cmdr r r �<lambda>� s z*Script.listOrcaShortcuts.<locals>.<lambda>)�keyr F)r� r� r� r� ZgetBoundBindingsr� ZshortcutsFoundOrca�lenr r� r� ZAPPLICATION_NO_NAMEr� �extendr� ZshortcutsFoundAppr� r� �sorted� guilabelsZKB_HEADER_FUNCTIONZKB_HEADER_KEY_BINDING� commandlistZshowUI)r r� Zbound�titleZappNameZrowsZheader1Zheader2r r r �listOrcaShortcuts� s.
zScript.listOrcaShortcutsc C s0 t j� }|r$d|_d|_| j |� ntj� dS )a Searches forward for the next instance of the string
searched for via the Orca Find dialog. Other than direction
and the starting point, the search options initially specified
(case sensitivity, window wrap, and full/partial match) are
preserved.
FN)�find� getLastQuery�searchBackwards�
startAtTopr< r= )r r� � lastQueryr r r r> � s zScript.findNextc C s0 t j� }|r$d|_d|_| j |� ntj� dS )a% Searches backwards for the next instance of the string
searched for via the Orca Find dialog. Other than direction
and the starting point, the search options initially specified
(case sensitivity, window wrap, and full/or partial match) are
preserved.
TFN)r r r r r< r= )r r� r r r r r? � s zScript.findPreviousc C s | j � }|j|� dS )zc Add an in-page accessible object bookmark for this key.
Delegates to Bookmark.addBookmark N)� getBookmarksr, )r r� � bookmarksr r r r, � s zScript.addBookmarkc C s | j � }|j|� dS )z_ Go to the bookmark indexed by inputEvent.hw_code. Delegates to
Bookmark.goToBookmark N)r r* )r r� r r r r r* � s zScript.goToBookmarkc C s | j � }|j|� dS )z� Go to the next bookmark location. If no bookmark has yet to be
selected, the first bookmark will be used. Delegates to
Bookmark.goToNextBookmark N)r r+ )r r� r r r r r+ � s zScript.goToNextBookmarkc C s | j � }|j|� dS )z� Go to the previous bookmark location. If no bookmark has yet to
be selected, the first bookmark will be used. Delegates to
Bookmark.goToPrevBookmark N)r r) )r r� r r r r r) � s zScript.goToPrevBookmarkc C s | j � }|j|� dS )zQ Save the bookmarks for this script. Delegates to
Bookmark.saveBookmarks N)r r- )r r� r r r r r- s zScript.saveBookmarksr c C s$ | j rn| j� r*| j jtjj� | j|� n| j|dd� | j� | j j tjj
�\}}}}}d| _ | j | j � n�| j� r�t
jr�| jjt
j�r�t
jj� }|j|jtj�\} }
} d} |
dkr�|j|
d �} | r�t
jj� tjkr�| j� }
|
jtjj� | j|� n$| j|dd� tj� | j ddd� dS )a� Pans the braille display to the left. If panAmount is non-zero,
the display is panned by that many cells. If it is 0, the display
is panned one full display width. In flat review mode, panning
beyond the beginning will take you to the end of the previous line.
In focus tracking mode, the cursor stays at its logical position.
In flat review mode, the review cursor moves to character
associated with cell 0.T)� panToLeftr� Fr )� stopFlash) r
�isBrailleBeginningShowing�goBegin� flat_review�Context�LINErP �panBrailleInDirection�0_setFlatReviewContextToBeginningOfBrailleDisplay�
getCurrent�CHARr �updateBrailleReviewr� � locusOfFocusr� �
isTextArear� �getTextAtOffsetr� r �TEXT_BOUNDARY_LINE_START�setCaretOffsetr� Z
ROLE_TERMINAL�getFlatReviewContextr� �resetFlashTimerr� )r r� � panAmount�
charString�x�y�width�heightr� �
lineString� startOffset� endOffsetZ
movedCaret�contextr r r r[ s8
zScript.panBrailleLeftc C s | j |d� dS )z�Nudges the braille display one character to the left.
In focus tracking mode, the cursor stays at its logical position.
In flat review mode, the review cursor moves to character
associated with cell 0.r� N)r[ )r r� r r r �panBrailleLeftOneCharF s z Script.panBrailleLeftOneCharc C s� | j rn| j� r*| j jtjj� | j|� n| j|dd� | j� | j j tjj
�\}}}}}d| _ | j | j � nv| j� r�t
jr�| jjt
j�r�t
jj� }|j|jtj�\} }
} | |jk r�|j| � n$| j|dd� tj� | jddd� dS )a� Pans the braille display to the right. If panAmount is non-zero,
the display is panned by that many cells. If it is 0, the display
is panned one full display width. In flat review mode, panning
beyond the end will take you to the beginning of the next line.
In focus tracking mode, the cursor stays at its logical position.
In flat review mode, the review cursor moves to character
associated with cell 0.F)r r� )r T)r
�isBrailleEndShowing�goEndr r r rV r r r r r r! r� r" r� r# r� r$ r� r r% �characterCountr& r� r( r� ) r r� r) r* r+ r, r- r. r� r/ r0 r1 r r r r\ O s*
zScript.panBrailleRightc C s | j |d� dS )z�Nudges the braille display one character to the right.
In focus tracking mode, the cursor stays at its logical position.
In flat review mode, the review cursor moves to character
associated with cell 0.r� N)r\ )r r� r r r �panBrailleRightOneChar� s z Script.panBrailleRightOneCharc C s | j r| j|�S tj|�S dS )z$Returns to the component with focus.N)r
r@ r� ZreturnToRegionWithFocus)r r� r r r r] � s
zScript.goBrailleHomec C s | j |� dS )zToggles contracted braille.T)�_setContractedBraille)r r� r r r r^ � s
zScript.setContractedBraillec C s t j|� dS )z Processes a cursor routing key.T)r� r_ )r r� r r r r_ � s
zScript.processRoutingKeyc C s4 | j |�\}}|dkr0| jj|� | jj||� dS )zcClears the selection and moves the caret offset in the currently
active text area.
r T)�getBrailleCaretContextr� ZclearTextSelectionr& )r r� r� r� r r r r` � s
z Script.processBrailleCutBeginc C sR | j |�\}}|dkrN| jj||� |j� }|jd�\}}| jj|j||�� dS )zExtends the text selection in the currently active text
area and also copies the selected text to the system clipboard.r T)r9 r� ZadjustTextSelectionr� Z getSelection�setClipboardText�getText)r r� r� r� Ztextir0 r1 r r r ra � s z Script.processBrailleCutLinec C s� | j j� | _tj� | _| jr(| jj� nTytjt j
� W nB ytj t j
� W n$ t j
}t j}| j||� Y nX Y nX dS )z,Moves the mouse pointer to the current item.T)r� ZabsoluteMouseCoordinatesr r� r r
ZrouteToCurrent�eventsynthesizerZrouteToCharacterr� r" Z
routeToObjectr� �LOCATION_NOT_FOUND_FULL�LOCATION_NOT_FOUND_BRIEFr� )r r� �full�briefr r r r/ � s
zScript.routePointerToItemc C sz t j}| j|� | jj|�\}}|rXtj| jj|�� | jj |�}|rXtj| jj
|�� |p^|}|rvtj| jj |�� dS )zsSpeaks and brailles the contents of the status bar and/or default
button of the window with focus.
N) r� r" r� r� �frameAndDialogrc r� r� ZgenerateStatusBarZinfoBarr� ZgenerateDefaultButton)r r� r� �frame�dialogZinfobar�windowr r r r; � s
zScript.presentStatusBarc C s2 | j jtj�}x |D ]\}}| j||d� qW dS )z7Speaks and brailles the title of the window with focus.)�voiceN)r� Z
generateTitler� r" r� )r r� r
�stringrE r r r r: � s zScript.presentTitlec C s� | j jtjdd�\}}}| j jtjd��\}}tt| j j |��}ddddg}xR|D ]J}|j
|�} |j
|�}
| |kr||
|kr|qR| rR| |
krR| j | j j || �� qRW dS )aS Reads the attributes associated with the current text character.
Calls outCharAttributes to speak a list of attributes. By default,
a certain set of attributes will be spoken. If this is not desired,
then individual application scripts should override this method to
only speak the subset required.
NTZenabledSpokenTextAttributes�0Z0mmZnoneZfalse)
r� ZtextAttributesr� r" ZstringToKeysAndDictr� r� �list�mapZgetAppNameForAttributer� r� ZlocalizeTextAttribute) r r� Zattrs�start�endZ userAttrListZ userAttrDictZ
nullValuesr �valueZ
ignoreIfValuer r r rZ � s
zScript.readCharAttributesc C sd | j r| j jd� nLytjtjd� W n8 ytjtjd� W n | jtj � Y nX Y nX dS )z7Performs a left mouse button click on the current item.r� T)
r
� clickCurrentr< �clickCharacterr� r" � clickObjectr� r� r= )r r� r r r r2 s zScript.leftClickReviewItemc C sp | j r| j jd� nXytjtjd� W nD ytjtjd� W n$ tj}tj }| j
||� Y nX Y nX dS )z8Performs a right mouse button click on the current item.� T) r
rM r< rN r� r" rO r� r= r> r� )r r� r? r@ r r r r3 s zScript.rightClickReviewItemc C s x|D ]}| j |� qW dS )zsSpell the current flat review word or line.
Arguments:
- itemString: the string to spell.
N)�speakCharacter)r �
itemString� characterr r r �spellCurrentItem) s
zScript.spellCurrentItemr� c C s" | j � }|jtjj�\}}}}} | jj|d�}
t|tj ��s| sTt
|� sT|dkrbt j t
j� n�|jtjj�\} }}}} | dkr�t j t
j� n~|j� r�t j t
j� nh|j� r�|dkr�t j ||
� nJ|dkr�| j|� n6|dkr�| j|� n"|dk�r| jj|�}t j ||
� | j|� || _dS )a, Presents the current item to the user.
Arguments:
- inputEvent - the current input event.
- targetCursorCell - if non-zero, the target braille cursor cell.
- speechType - the desired presentation: speak (1), spell (2), or
phonetic (3).
)rF �
r� r rP T)r' r r r �WORDr� rE r� r. � BrailleEventr rc r� r� �BLANKr �isspace� WHITE_SPACE�isupperrT �phoneticSpellCurrentItemr� �adjustForRepeatsr! r ) r r� r �
speechTyper2 �
wordStringr+ r, r- r. rE r/ r r r �_reviewCurrentItem3 s2
zScript._reviewCurrentItemc C sb | j � }|jtjj�\}}}}}t|tj�s^| jj |j
� �}|j | j j
|j
� d�� tj|� dS )NFT)r' r r r �ZONEr� r. rW r� r� ZgetCurrentAccessibler �tutorialGenerator� getTutorialrc r� ) r r� r2 Z
zoneStringr+ r, r- r. r� r r r rN b s
z Script.reviewCurrentAccessiblec C s8 | j � }|jtjjtjj�}|r4| j|� | j� | _dS )zxMoves the flat review context to the previous item. Places
the flat review cursor at the beginning of the item.T) r' �
goPreviousr r rV � WRAP_LINEr` �getBrailleCursorCellr )r r� r2 �movedr r r rH r s
zScript.reviewPreviousItemc C s8 | j � }|jtjjtjj�}|r4| j|� | j� | _dS )ztMoves the flat review context to the next item. Places
the flat review cursor at the beginning of the item.T) r' �goNextr r rV re r` rf r )r r� r2 rg r r r rM � s
zScript.reviewNextItemc C s | j |d� dS )z6Brailles and speaks the current flat review character.r� T)�_reviewCurrentCharacter)r r� r r r rS � s z Script.reviewCurrentCharacterc C s | j |d� dS )zXBrailles and 'spells' (phonetically) the current flat review
character.
r T)ri )r r� r r r rT � s z"Script.reviewSpellCurrentCharacterc C s | j |d� dS )zaBrailles and speaks unicode information about the current flat
review character.
rP T)ri )r r� r r r rU � s z$Script.reviewUnicodeCurrentCharacterc
C s� | j � }|jtjj�\}}}}}t|tj�s�| s<t|� rJt j
t j � nh|jtjj
�\} }}}}| dkr�|dkr�t j
t j � n2|dkr�| j|� n |dkr�| j|� n
| j|� | j� || _dS )a; Presents the current flat review character via braille and speech.
Arguments:
- inputEvent - the current input event.
- speechType - the desired presentation:
speak (1),
phonetic (2)
unicode value information (3)
rU rP r T)r' r r r r r� r. rW r rc r� r� rX r �speakUnicodeCharacterr\ rQ r! r )
r r� r^ r2 r* r+ r, r- r. r/ r r r ri � s
z Script._reviewCurrentCharacterc C s8 | j � }|jtjjtjj�}|r4| j|� | j� | _dS )zmMoves the flat review context to the previous character. Places
the flat review cursor at character.T) r' rd r r r re ri rf r )r r� r2 rg r r r rP � s
z Script.reviewPreviousCharacterc C s. | j � }|jtjj� | j|� | j� | _dS )ztMoves the flat review context to the end of the line. Places
the flat review cursor at the end of the line.T)r' r5 r r r rS rf r )r r� r2 r r r rQ � s
zScript.reviewEndOfLinec C s8 | j � }|jtjjtjj�}|r4| j|� | j� | _dS )ziMoves the flat review context to the next character. Places
the flat review cursor at character.T) r' rh r r r re ri rf r )r r� r2 rg r r r rV � s
zScript.reviewNextCharacterc C s2 | j � }|jtjjtjj�}|r.| j|| j� dS )z�Moves the flat review context to the character most directly
above the current flat review cursor. Places the flat review
cursor at character.T)r' ZgoAbover r r re r` r )r r� r2 rg r r r rI � s
zScript.reviewAbovec C s2 | j � }|jtjjtjj�}|r.| j|| j� dS )z�Moves the flat review context to the character most directly
below the current flat review cursor. Places the flat review
cursor at character.T)r' ZgoBelowr r r re r` r )r r� r2 rg r r r rO s
zScript.reviewBelowc C s | j |d� dS )z1Brailles and speaks the current flat review line.r� T)�_reviewCurrentLine)r r� r r r rC s zScript.reviewCurrentLinec C s | j |d� dS )z1Brailles and spells the current flat review line.r T)rk )r r� r r r rD s z Script.reviewSpellCurrentLinec C s | j |d� dS )z>Brailles and phonetically spells the current flat review line.rP T)rk )r r� r r r rE & s z Script.reviewPhoneticCurrentLinec
C s� | j � }|jtjj�\}}}}}| jj|d�} t|tj �s�| sRt
|� sR|dkr`t j t
j� n||j� rvt j t
j� nf|j� r�|dk s�|dkr�t j || � n@|dkr�| j|� n,|dkr�| j|� n| jj|�}t j || � | j� || _dS )z�Presents the current flat review line via braille and speech.
Arguments:
- inputEvent - the current input event.
- speechType - the desired presentation: speak (1), spell (2), or
phonetic (3)
)rF rU r rP T)r' r r r r r� rE r� r. rW r rc r� r� rX rY rZ r[ rT r\ r� r] r! r )
r r� r^ r2 r/ r+ r, r- r. rE r r r rk - s*
zScript._reviewCurrentLinec C s8 | j � }|jtjjtjj�}|r4| j|� | j� | _dS )zLMoves the flat review context to the beginning of the
previous line.T) r' rd r r r re rk rf r )r r� r2 rg r r r rA V s
zScript.reviewPreviousLinec C s( | j � }|j� | j|� | j� | _dS )zLMoves the flat review context to the top left of the current
window.T)r' r rk rf r )r r� r2 r r r rB e s
zScript.reviewHomec C s8 | j � }|jtjjtjj�}|r4| j|� | j� | _dS )z�Moves the flat review context to the beginning of the
next line. Places the flat review cursor at the beginning
of the line.T) r' rh r r r re rk rf r )r r� r2 rg r r r rF r s
zScript.reviewNextLinec C s< | j � }|jtjj� |jtjj� | j|� | j� | _ dS )z�Moves the flat review context to the beginning of the
last line in the window. Places the flat review cursor at
the beginning of the line.T)
r' r5 r r ZWINDOWr r rk rf r )r r� r2 r r r rR � s
zScript.reviewBottomLeftc C s( | j � }|j� | j|� | j� | _dS )z�Moves the flat review context to the end of the
last line in the window. Places the flat review cursor
at the end of the line.T)r' r5 rk rf r )r r� r2 r r r rG � s
zScript.reviewEndc C s | j ||d� dS )z1Brailles and speaks the current item to the user.r� T)r` )r r� r r r r rJ � s zScript.reviewCurrentItemc C s | j ||d� dS )z1Brailles and spells the current item to the user.r T)r` )r r� r r r r rK � s z Script.reviewSpellCurrentItemc C s | j ||d� dS )z>Brailles and phonetically spells the current item to the user.rP T)r` )r r� r r r r rL � s z Script.reviewPhoneticCurrentItemc C s2 | j r"| jj| j� | jtj� n | jtj� dS )z^Copies the contents of the item under flat review to and places
them in the clipboard.T)r
r� r: r r� r� ZFLAT_REVIEW_COPIED�FLAT_REVIEW_NOT_IN)r r� r r r rW � s
zScript.flatReviewCopyc C s2 | j r"| jj| j� | jtj� n | jtj� dS )zLAppends the contents of the item under flat review to
the clipboard.T)r
r� ZappendTextToClipboardr r� r� ZFLAT_REVIEW_APPENDEDrl )r r� r r r rX � s
zScript.flatReviewAppendc C sV | j � }|j� x@|jtjj�\}}}}}tj|� |jtjjtjj �}|sP qW dS )NT)
r' r r r r ra rc r� rh re ) r r� r2 r_ r+ r, r- r. rg r r r r5 � s
zScript.flatReviewSayAllc C s� |pt j}y |j� }W nP tk
rT | jj|�}|j| jj|d�� t j
|� Y n8 t k
rf Y n&X |d krv|j }t j
| j||�| j� dS )NFT)r� r" r� �NotImplementedErrorr� r� r rb rc rc r� r� r� r4 � textLines� _Script__sayAllProgressCallback)r r� r� �offsetr� r� r r r r4 � s
z
Script.sayAllc C s� t jd�}| jr>|r*|tjkr*| jtj� d| _| jt j
� nH|rX|tjkrX| jtj � | j � }|j
tjj�\}}}}}| j|| j� dS )z9Toggles between flat review mode and focus tracking mode.�speechVerbosityLevelNT)r� r� r
r� �VERBOSITY_LEVEL_BRIEFr� r� ZFLAT_REVIEW_STOPr� r� r" ZFLAT_REVIEW_STARTr' r r r rV r` r ) r r� � verbosityr2 r_ r+ r, r- r. r r r r@ � s
zScript.toggleFlatReviewModec C st t j� tjd�r,tjdd� | jtj� nDtjd�sXtjdd� t j� | jtj� n| jtj � tjdd� dS )zmToggle the silencing of speech.
Returns True to indicate the input event has been consumed.
Z
silenceSpeechF� enableSpeechT)
rc �stopr� r� �
setSettingr� r� ZSPEECH_ENABLED�initZSPEECH_DISABLED)r r� r r r rd � s
zScript.toggleSilenceSpeechc C sN t jd�}|tjkr0| jtj� t jdtj� n| jtj � t jdtj� dS )z9Toggles speech verbosity level between verbose and brief.rq T)
r� r� r� rr r� r� ZSPEECH_VERBOSITY_VERBOSErv ZVERBOSITY_LEVEL_VERBOSEZSPEECH_VERBOSITY_BRIEF)r r� rL r r r re s
z Script.toggleSpeechVerbosityc C sL t jd�}t jd| � t jd�r0tj}tj}n tj}tj}| j||� dS )z6Toggles the speaking of indentation and justification.ZenableSpeechIndentationT) r� r� rv r� Z!INDENTATION_JUSTIFICATION_ON_FULLZ"INDENTATION_JUSTIFICATION_ON_BRIEFZ"INDENTATION_JUSTIFICATION_OFF_FULLZ#INDENTATION_JUSTIFICATION_OFF_BRIEFr� )r r� rL r? r@ r r r rf s
z-Script.toggleSpeakingIndentationJustificationc C s� t jd�}|tjkr(tj}tj}tj}nN|tjkrFtj}tj }tj
}n0|tjkrdtj }tj }tj
}ntj}tj}tj}t jd|� | j||� tj� dS )z2 Cycle through the punctuation levels for speech. �verbalizePunctuationStyleT)r� r� r� �PUNCTUATION_STYLE_NONEZPUNCTUATION_STYLE_SOMEr� ZPUNCTUATION_SOME_FULLZPUNCTUATION_SOME_BRIEFZPUNCTUATION_STYLE_MOSTZPUNCTUATION_MOST_FULLZPUNCTUATION_MOST_BRIEFZPUNCTUATION_STYLE_ALLZPUNCTUATION_ALL_FULLZPUNCTUATION_ALL_BRIEFZPUNCTUATION_NONE_FULLZPUNCTUATION_NONE_BRIEFrv r� rc r� )r r� Z currentLevelZnewLevelr? r@ r r r rh , s(
z$Script.cycleSpeakingPunctuationLevelc C s� t j� }|o|d s$| jtj� dS dd� }tt||��d }y||j|�d \}}W n tk
rx |d \}}Y nX t j |dd� t
j � t
j � | j
� | jtj| |� dS )z4Cycle through the user's existing settings profiles.r Tc S s | d t j� kS )Nr� )r� Z
getProfile)r+ r r r r N s z-Script.cycleSettingsProfile.<locals>.<lambda>r� )Z updateLocale)r� ZavailableProfilesr� r� ZPROFILE_NOT_FOUNDrH �filter�index�
IndexErrorZ
setProfilerc Zshutdownrw rs ZPROFILE_CHANGED)r r� ZprofilesZisMatchZcurrentr� Z profileIDr r r ri F s zScript.cycleSettingsProfilec C s| t jd�}|tjkr(tj}tj}tj}n0|tjkrFtj}tj }tj
}ntj}tj }tj }t j
d|� | j||� tj� dS )z< Cycle through the speech-dispatcher capitalization styles. �capitalizationStyleT)r� r� r� �CAPITALIZATION_STYLE_NONEZCAPITALIZATION_STYLE_SPELLr� ZCAPITALIZATION_SPELL_FULLZCAPITALIZATION_SPELL_BRIEFZCAPITALIZATION_STYLE_ICONZCAPITALIZATION_ICON_FULLZCAPITALIZATION_ICON_BRIEFZCAPITALIZATION_NONE_FULLZCAPITALIZATION_NONE_BRIEFrv r� rc r� )r r� Z currentStyleZnewStyler? r@ r r r rj a s
z Script.cycleCapitalizationStylec
C s2 d\}}}t jd�}t jd�}t jd�}|||fdkrNd\}}}tj}tj} n�|||fd krtd
\}}}tj}tj} n�|||fd kr�d \}}}tj}tj} nd|||fd
kr�d\}}}tj }tj
} n>|||fdk� r�d\}}}tj }tj } nd\}}}tj
}tj} t jd|� t jd|� t jd|� | j|| � dS )NFZ
enableKeyEcho�enableEchoByWord�enableEchoBySentenceT)FFF)FFF)TFF)TFF)FTF)FTF)FFT)FFT)TTF)TTF)FTT)FFF)r� r� r� ZKEY_ECHO_KEY_FULLZKEY_ECHO_KEY_BRIEFZKEY_ECHO_WORD_FULLZKEY_ECHO_WORD_BRIEFZKEY_ECHO_SENTENCE_FULLZKEY_ECHO_SENTENCE_BRIEFZKEY_ECHO_KEY_AND_WORD_FULLZKEY_ECHO_KEY_AND_WORD_BRIEFZ KEY_ECHO_WORD_AND_SENTENCE_FULLZ KEY_ECHO_WORD_AND_SENTENCE_BRIEFZKEY_ECHO_NONE_FULLZKEY_ECHO_NONE_BRIEFrv r� )
r r� ZnewKeyZnewWordZ newSentencer �word�sentencer? r@ r r r rk w s@
zScript.cycleKeyEchoc C sF t jd�}|r tj}tj}n tj}tj}t jd| � | j||� dS )z5Changes spoken number style between digits and words.ZspeakNumbersAsDigitsT) r� r� r� ZNUMBER_STYLE_WORDS_BRIEFZNUMBER_STYLE_WORDS_FULLZNUMBER_STYLE_DIGITS_BRIEFZNUMBER_STYLE_DIGITS_FULLrv r� )r r� Z speakDigitsr@ r? r r r rg � s
zScript.changeNumberStylec C s� | j jtj�}|s"| jtj� dS | j j|�s4d}n| j j|�rFd}nd}t j
|�}t j || � |sntj }ntj
}| j|� dS )zjToggles an indicator for whether we should just read the current
table cell or read the whole row.TZreadFullRowInGUITableZreadFullRowInSpreadSheetZreadFullRowInDocumentTable)r� �getTabler� r" r� r� ZTABLE_NOT_IN_AZgetContainingDocumentZisSpreadSheetTabler� r� rv ZTABLE_MODE_ROWZTABLE_MODE_CELL)r r� �tableZ settingNameZspeakRowr� r r r rY � s
z Script.toggleTableCellReadModec C sn | j r | j j� r | j j| � tj}|s,dS | j|� |r@d}nd}tj| jj | j
j |�d|dddd�� dS )znPeforms the whereAmI operation.
Arguments:
- inputEvent: The original inputEvent
FZ
basicWhereAmIZdetailedWhereAmIT)�alreadyFocused�
formatTypeZ
forceMnemonicZ forceListZ
forceTutorial) Z
spellcheckZisActiveZpresentErrorDetailsr� r" r� rc r� r� r� r� ZrealActiveAncestor)r r� Z basicOnlyr� r� r r r �
doWhereAmI� s"
zScript.doWhereAmIc C s | j |d� dS )zGSpeaks basic information about the current object of interest.
TN)r� )r r� r r r r6 � s zScript.whereAmIBasicc C s | j |d� dS )zYSpeaks detailed/custom information about the current object of
interest.
FN)r� )r r� r r r r7 � s zScript.whereAmIDetailedc C s� t jdt jdt jdt jdt jdt jdt jdt jdt j d g}y|j
t j �d
}W n d }Y nX |t |�krpd }|| t _ ||d }d
| }| j
||� dS )N�allZfinestZfinerZfineZ
configuration�infoZwarningZsevereZoffr r r� zDebug level %s.T)r� Z LEVEL_ALLZ LEVEL_FINESTZ LEVEL_FINERZ
LEVEL_FINEr� r� r� Z LEVEL_SEVEREZ LEVEL_OFFr{ Z
debugLevelr r� )r r� ZlevelsZ
levelIndex� briefMessage� fullMessager r r rl � s(
zScript.cycleDebugLevelc C s: |pt j}| jj|�s$| jtj� ntj| j j
|�� dS )NT) r� r" r� ZisLinkr� r� Z
NOT_ON_A_LINKrc r� r� ZgenerateLinkInfo)r r� �linkr r r r8 s
zScript.whereAmILinkc C s@ |pt j}| jj|�\}}}|s(tj}n
tj| }| j|� dS )NT)r� r" r� ZallSelectedTextr� ZNO_SELECTED_TEXTZSELECTED_TEXT_ISr� )r r� r� r� r0 r1 r� r r r r9 s
zScript.whereAmISelectedTextc C s dS )zTJust here to capture events.
Arguments:
- event: the Event
Nr )r r� r r r �noOp$ s z Script.noOpc C s� t jt jt jt jg}|jj� |kr�|jr<| jj |j� r<dS | jj
|jt j �}|rx|j rxd}t
jt
j|d� dt _ dS | r�|jr�d}t
jt
j|d� tj� | _tj||j� |jt _ | jr�d| _| j� dS )z>Callback for object:state-changed:active accessibility events.Nz4DEFAULT: Event is for active window. Clearing state.Tz0DEFAULT: Updating active window to event source.F)r �
ROLE_FRAME� ROLE_DIALOGZROLE_FILE_CHOOSERZROLE_COLOR_CHOOSER�sourcer� �detail1r� �canBeActiveWindowr� r� r� r� r� r� r� r r< �setLocusOfFocusr� r )r r� ZframesZsourceIsActiveWindowr� r r r r� , s.
zScript.onActiveChangedc C sZ |j s
dS |jj� jtj� r6|j j� jtj� r6dS | j|�rHtj� t j
||j � dS )zCCallback for object:active-descendant-changed accessibility events.N) �any_datar� r� r� r �
STATE_FOCUSED�#stopSpeechOnActiveDescendantChangedrc ru r< r� )r r� r r r r� L s
z Script.onActiveDescendantChangedc C s dS )z<Callback for object:state-changed:busy accessibility events.Nr )r r� r r r r� [ s zScript.onBusyChangedc C s� |j }| jj|tj�sdS |j� }|jtj�r2dS |j � tj
krZ| jj � \}}|dkrZdS | j j
dd �\}}t|�t|�kr�||jkr�dS | j|� tj| jj|dd�� t|�|jf| j d< dS )
z?Callback for object:state-changed:checked accessibility events.N� �spacer� r T)r� )r� r� )Nr )r� r� r� r� r" r� r� r ZSTATE_EXPANDABLEr� ZROLE_RADIO_BUTTON�lastKeyAndModifiersr� r� r� r� r� rc r� r� r� )r r� r� r� � eventString�mods�oldObj�oldStater r r r� _ s
zScript.onCheckedChangedc C s dS )z]Called when a child node has changed.
Arguments:
- event: the Event
Nr )r r� r r r r� { s zScript.onChildrenChangedc
C s | j jdd�\}}||jkr>||jkr>d}tjtj|d� dS |jj� }|jt j
�sxd}tjtj|d� | j j |�sxdS |jt
jko�|jt j��r | j j|j�}| j jt
j|�r�dt
j|jf }tjtj|d� tj||jd� n d |t
jf }tjtj|d� |jt
jk�r2d
|jt
jf }tjtj|d� dS | j�rB| j� |jj� }y
|j}W n$ d |j }tjtj|d� dS | j|j|j� |j� �r�d }tjtj|d� | j j|j� dS | j j |�\} }
} | �r�| j j|��r�dS d
}tjtj|d� | j |� dS )z:Callback for object:text-caret-moved accessibility events.�lastCursorPositionNr� z0DEFAULT: Event is for last saved cursor positionTz$DEFAULT: Event source is not showingz,DEFAULT: Updating locusOfFocus from %s to %sFz4DEFAULT: Source window (%s) is not active window(%s)z3DEFAULT: Event source (%s) is not locusOfFocus (%s)z-DEFAULT: Exception getting caretOffset for %sz)DEFAULT: Event source has text selectionsz.DEFAULT: Presenting text at new caret position���)Nr� ) r� r� r� r� r� r� r� r� r� r Z
STATE_SHOWINGr� Z presentEventFromNonShowingObjectr� r" r� r� r� r� r< r� r
r@ r� r� r� �getNSelections�handleTextSelectionChange�getCachedTextSelection� _presentTextAtNewCaretPosition) r r� r� rp r� r� r� r� r� rJ rK rF r r r r~ � s`
zScript.onCaretMovedc C s dS )z2Callback for document:reload accessibility events.Nr )r r� r r r ry � s zScript.onDocumentReloadc C s dS )z9Callback for document:load-complete accessibility events.Nr )r r� r r r rz � s z Script.onDocumentLoadCompletec C s dS )z8Callback for document:load-stopped accessibility events.Nr )r r� r r r r{ � s z Script.onDocumentLoadStoppedc C s� |j }|j� }| jj|tj� r4|tjtjgkr4dS | j j
dd�\}}t |�t |�krd||j krddS | j
|� tj| jj|dd�� t |�|j f| j d< dS )z@Callback for object:state-changed:expanded accessibility events.NZexpandedChanger T)r� )Nr )r� r� r� r� r� r" r ZROLE_TABLE_ROW�ROLE_COMBO_BOXr� r� r� r� r� rc r� r� r� )r r� r� r� r� r� r r r r� � s
zScript.onExpandedChangedc C s� |j s
dS |j}| jj|tj�s$dS | jjdd�\}}t|�t|�krT||j krTdS | j |� t
j | j j
|dd�� t|�|j f| jd< dS )zECallback for object:state-changed:indeterminate accessibility events.NZindeterminateChanger T)r� )Nr )r� r� r� r� r� r" r� r� r� r� rc r� r� r� )r r� r� r� r� r r r r� � s
z Script.onIndeterminateChangedc C sz t j|�}|t_|jsdS | jj� }tj|k}|rF|t_tjd|d� t j
� |j }|rv|j � j
tj�rvtjd||� dS )z!Callback for mouse:button events.NF)r. ZMouseButtonEventr� �lastInputEventZpressedr� r� r< r� rc ru r� r� r� r r� )r r� Z
mouseEventrD Z
windowChangedr� r r r r| � s
zScript.onMouseButtonc C s |j }| jjdi �}|jt|��}||jkrHd| }tjtj|d� dS |j� }|t j
t j gkrxd}tjtj|d� dS |t j kr�|t
jkr�d}tjtj|d� dS n"|t
jkr�d}tjtj|d� dS |j|t|�< || jd< | j|� tj| jj|dd�� dS ) z;Callback for object:property-change:accessible-name events.r� z.DEFAULT: Old name (%s) is the same as new nameTNz6DEFAULT: Event is redundant notification for this rolez8DEFAULT: Event is for frame other than the active windowz8DEFAULT: Event is for object other than the locusOfFocus)r� )r� r� r� r� r� r� r� r� r� r r� �ROLE_TABLE_CELLr� r� r� r" r� rc r� r� r� )r r� r� r� �oldNamer� r� r r r r} s2
zScript.onNameChangedc C s� |j }| jj|tj�sdS | jjdd�\}}t|�t|�krJ||jkrJdS | j |� t
j | j j
|dd�� t|�|jf| jd< dS )z?Callback for object:state-changed:pressed accessibility events.NZ
pressedChanger T)r� )Nr )r� r� r� r� r" r� r� r� r� r� rc r� r� r� )r r� r� r� r� r r r r� ) s
zScript.onPressedChangedc C sF |j }|j� |j� }|jtj�s&dS | jjtj |�s:dS t
j d�rHdS |jtj �}||j
krvd}tjtj|d� dS | jjdd
�\}}t|�t|�kr�||j
kr�d}tjtj|d� dS d}| jj� \} }
| d kr�d}n | dko�|o�|j� tjk� r�d}|�sdS |j
�r | jtjdd � n| jtjdd � t|�|j
f| jd< dS )z@Callback for object:state-changed:selected accessibility events.N�onlySpeakDisplayedTextz1DEFAULT: Bogus event: detail1 doesn't match stateTr� r z DEFAULT: Duplicate or spam eventFr� �Down�Up)r� )Nr )r� r� )r� Z
clearCacher� r� r r� r� r� r� r" r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� Z
TEXT_SELECTEDZTEXT_UNSELECTED) r r� r� r� Z
isSelectedr� r� r� Z
announceState� keyStringr� r r r r� 8 s@
zScript.onSelectedChangedc
s |j }|j� }| jj� r*tj||j d� n|jtj�r:dS | jj � \}}|dkrTdS |j
� }|tj kr�|jtj � r�| jj
|j �}|r�|j� jtj�r�dS | jj|�}xX|D ]P� tjtj� fdd��r�d� } tjtj| d� dS | jj� �s�tj|� � P q�W dS )z;Callback for object:selection-changed accessibility events.FNr� c s | � kS )Nr )r+ )�childr r r � s z+Script.onSelectionChanged.<locals>.<lambda>z-DEFAULT: Child %s is ancestor of locusOfFocusT)r� r� r� Z handlePasteLocusOfFocusChanger< r� r� r ZSTATE_MANAGES_DESCENDANTSr� r� r� ZSTATE_EXPANDEDZgetEntryForEditableComboBoxr� �selectedChildrenZ findAncestorr� r" r� r� r� Z isLayoutOnly)
r r� r� r� r� r� r� �entryr� r� r )r� r r� j s.
zScript.onSelectionChangedc C s dS )zACallback for object:state-changed:sensitive accessibility events.Nr )r r� r r r r� � s zScript.onSensitiveChangedc C s dS )z)Callback for focus: accessibility events.Nr )r r� r r r rx � s zScript.onFocusc
C s� |j s
dS |j}|j� }|jtj�s(dS | jj|�\}}|rT| jj|� rT| rTdS y|j }|j
� }W n" d| }t j t j
|d� dS |r�|tjkr�| jj|�} | r�| d }tj||� dS )z?Callback for object:state-changed:focused accessibility events.Nz5DEFAULT: Exception getting childCount and role for %sTr )r� r� r� r� r r� r� rA r� �
childCountr� r� r� r� r� r� r< r� )
r r� r� r� rD rC r� r� r� r� r r r r� � s* zScript.onFocusedChangedc C s� |j }|j� }|tjkrxtj| jj|�� | jj |� }| jj
||�}dj t | jj
|��}| j|tjd� tj|� dS |tjkr�| jj� \}}|dkr�tjd� r�dS |jr�| j|� dS tjr�|dkr�tj}| j|� tj| jj||j d�� dS dS )z?Callback for object:state-changed:showing accessibility events.r )� flashTimeNZF1ZpresentToolTips)r� ) r� r� r ZROLE_NOTIFICATIONrc r� r� r� r� ZisStatusBarNotificationZunrelatedLabels�joinrI r r� r� �brailleFlashTimerr Z saveMessageZ
ROLE_TOOL_TIPr� r� r� r� �
presentObjectr� r" r� ) r r� r� r� Z visibleOnlyZlabelsr� r� r� r r r r� � s.
zScript.onShowingChangedc C s� | j j|�sdS | j j|j�}|s:d}tjtj|d� dS tjd�r�|j }|j
||d �j � sf|d8 }| j j |j|d �s�| j j |j|d �r�| j
tj� dS )zACallback for object:text-attributes-changed accessibility events.Nz.DEFAULT: Querying non-empty text returned NoneT�speakMisspelledIndicatorr� )r� �,isPresentableTextChangedEventForLocusOfFocusZqueryNonEmptyTextr� r� r� r� r� r� r� r; �isalnum�isWordMisspelledr� r� �
MISSPELLED)r r� r� r� rp r r r r� � s
z Script.onTextAttributesChangedc C sn | j j|�sdS | j j|� tj||jd� | j|j� d \}}| j j|�rpd}tj tj
|d� t j t j
}}n&| j j|�r�d}tj tj
|d� t j}|s�|r�| j||� | j j|j� dS | j j|�}| j j|�� r�d}tj tj
|d� | j j|j�}n<| j j|��r d}tj tj
|d� nd }tj tj
|d� dS t|�d
k�rP| j|� n| jj|d �}tj||� dS )
z=Callback for object:text-changed:delete accessibility events.NFr z8DEFAULT: Deletion is believed to be due to clipboard cutTzADEFAULT: Deletion is believed to be due to deleting selected textz9DEFAULT: Deletion is believed to be due to Delete commandz<DEFAULT: Deletion is believed to be due to BackSpace commandz7INFO: Event is not being presented due to lack of causer� )rF )r r ) r� r� �handleUndoTextEventr< r� r� r� �isClipboardTextChangedEventr� r� r� r� �CLIPBOARD_CUT_FULL�CLIPBOARD_CUT_BRIEFZisSelectedTextDeletionEventZSELECTION_DELETEDr� r� Z deletedTextZ isDeleteCommandTextDeletionEventZgetCharacterAtOffsetZ#isBackSpaceCommandTextDeletionEventr rQ r� rE rc r� )r r� r? r@ r� rF rE r r r r � sB zScript.onTextDeletedc C sP | j j|�sdS | j j|� |jtjkr@| j j|�r@| j|j� tj ||jd� | j
|j� d\}}| j j |�r�d}t j
t j|d� tjtj }}n&| j j|�r�d}t j
t j|d� tj}|s�|r�| j||� | j j|j� dS d}| j j|�}| j j� �rd}t j
t j|d� n�| j j|��r6d}t j
t j|d� n�| j j|��rZd }t j
t j|d� np| j j|��r~d
}t j
t j|d� nL| j j|��r�d }t j
t j|d� t|j�| j d < nd
}t j
t j|d� d}|�rt |�dk�r�| j |� n| j j |d�}t!j"||� t |�dk�rdS t#j$d��r4| j%|j��r4dS t#j$d��rL| j&|j� dS )z=Callback for object:text-changed:insert accessibility events.NFr z;DEFAULT: Insertion is believed to be due to clipboard pasteTzCDEFAULT: Insertion is believed to be due to restoring selected textz3DEFAULT: Insertion is believed to be due to commandz?DEFAULT: Insertion is believed to be due to middle mouse buttonz-DEFAULT: Insertion is believed to be echoablez4DEFAULT: Insertion is believed to be auto text eventz#DEFAULT: Insertion is also selectedZlastAutoCompletez:DEFAULT: Not speaking inserted string due to lack of causer� )rF r� r )r r )'r� r� r� r� r� r" ZisAutoTextEventr� r< r� r� r� r� r� r� r� ZCLIPBOARD_PASTED_FULLZCLIPBOARD_PASTED_BRIEFZisSelectedTextRestoredEventZSELECTION_RESTOREDr� r� Z insertedTextZlastInputEventWasCommandZ%isMiddleMouseButtonTextInsertionEventZ isEchoableTextInsertionEventZ isSelectedTextInsertionEventr� r� r rQ r� rE rc r� r� r� �echoPreviousSentence�echoPreviousWord)r r� r? r@ r� Z speakStringrF rE r r r r�
sj zScript.onTextInsertedc C s |j }| jj|� | j|� dS )z@Callback for object:text-selection-changed accessibility events.N)r� r� r� r� )r r� r� r r r r� \
s z Script.onTextSelectionChangedc C sD | j j� sdS |j| j jtj�kr&dS tj� | jd< | jt j
� dS )z:Callback for object:column-reordered accessibility events.Nzlast-table-sort-time) r� �lastInputEventWasTableSortr� r� r� r" r� r� r� r� ZTABLE_REORDERED_COLUMNS)r r� r r r r� h
s
zScript.onColumnReorderedc C sD | j j� sdS |j| j jtj�kr&dS tj� | jd< | jt j
� dS )z7Callback for object:row-reordered accessibility events.Nzlast-table-sort-time) r� r� r� r� r� r" r� r� r� r� ZTABLE_REORDERED_ROWS)r r� r r r r� t
s
zScript.onRowReorderedc C sJ |j }|j� }y|j� }|j}W nL tk
rL d| }tjtj|d� dS d| }tjtj|d� dS d| jkr�|| jd kr�dS | j j
||�\}}d||f }tjtj|d� | r�|t j kr�dt j }tjtj|d� dS |t
jk� r�| j|j � || jd< | j||d� tj| jj|d|d �� | j| jj|d|d �� dS )
z�Called whenever an object's value changes. Currently, the
value changes for non-focused objects are ignored.
Arguments:
- event: the Event
z&ERROR: %s doesn't implement AtspiValueTNz-ERROR: Exception getting current value for %sZoldValuez'DEFAULT: Is progress bar update: %s, %sz$DEFAULT: Source != locusOfFocus (%s))�isProgressBarUpdate)r� r� )r� r� Z
queryValue� currentValuerm r� r� r� r� r� r� r� r" r ZROLE_SPIN_BUTTONr� r� rc r� r� r� �
_Script__playZsoundGeneratorZ
generateSound)r r� r� r� rL r� r� r� r r r r� �
s>
zScript.onValueChangedc
C s� | j j|j�sdS | j j|jtj�r<d}tjtj|d� dS i | _ t
j
� | _ |jt_y|jj }|jd j
� }W n Y n*X |dkr�|tjkr�tj||jd � dS tj||j� dS )zgCalled whenever a toplevel window is activated.
Arguments:
- event: the Event
Nz$DEFAULT: Event is for active window.Tr r� )r� r� r� r� r� r� r� r� r� r� r� r r� r� r � ROLE_MENUr< r� )r r� r� r� Z childRoler r r r� �
s$
zScript.onWindowActivatedc C s dS )z0Callback for window:create accessibility events.Nr )r r� r r r r� �
s zScript.onWindowCreatedc C s� i | _ tjtjtjtjg}ytjj� }W n Y nX ||krBdS tjr�tjj � |j
j � kr�t j � | j
� | jr�d| _| jtj� |j
tjkr�tj|d� dt_dt_dt_dS )ziCalled whenever a toplevel window is deactivated.
Arguments:
- event: the Event
NF)r� r r� ZROLE_MENU_ITEMZROLE_CHECK_MENU_ITEMZROLE_RADIO_MENU_ITEMr� r" r� ZgetApplicationr� rc ru r� r
r� r� r< r� Z listNotificationsModeEnabledr� )r r� Z menuRolesr� r r r r� �
s0 zScript.onWindowDeactivatedc
G s� | j r
d S | jj� sd S | jj� s&d S | jj� rD| jtjtj� d S | jj � sRd S yt
j j � }W n& dt
j }t
jt
j|d� Y nX |jtj�r�d S | jtjtj� d S )Nz$ERROR: Exception getting state of %sT)r
r� Z objectContentsAreInClipboardZ topLevelObjectIsActiveAndCurrentZlastInputEventWasCopyr� r� ZCLIPBOARD_COPIED_FULLZCLIPBOARD_COPIED_BRIEFZlastInputEventWasCutr� r" r� r� r� r� r� r ZSTATE_EDITABLEr� r� )r r� r� r� r r r �onClipboardContentsChanged s&
z!Script.onClipboardContentsChangedc C st |p|j }| j|� | jr d S | jj� rJd}tjtj|d� | j|� d S | jj � rvd}tjtj|d� | j
|� d S | jj � r�d}tjtj|d� | j |� d S | jj
� r�d}tjtj|d� | j|� d S | jj� r�d}tjtj|d� | j |� d S | jj� �r(d}tjtj|d� | j|� d S | jj� �rp| jj|j �\}}}|�spd}tjtj|d� | j|� d S d S ) Nz&DEFAULT: Presenting result of line navTz&DEFAULT: Presenting result of word navz&DEFAULT: Presenting result of char navz&DEFAULT: Presenting result of page navz/DEFAULT: Presenting result of line boundary navz/DEFAULT: Presenting result of file boundary navz:DEFAULT: Presenting result of primary mouse button release)r� � updateBrailleForNewCaretPositionr r� ZlastInputEventWasLineNavr� r� r� �sayLineZlastInputEventWasWordNav�sayWordZlastInputEventWasCharNav� sayCharacterZlastInputEventWasPageNavZ lastInputEventWasLineBoundaryNavZ lastInputEventWasFileBoundaryNavZ$lastInputEventWasPrimaryMouseReleaser� )r r� ZotherObjr� r� rJ rK rF r r r r� 5 sR
z%Script._presentTextAtNewCaretPosition�
c C s� t jd�sdS | jj|�}| jd|� | _x&| jrP| jj� }|j|j |kr,P q,W y|jj� }W n Y n X t j
d |jdd� |j |j� | j d |j|j� dS )N� rewindAndFastForwardInSayAllFr )� notifyScriptT)
r� r� r r{ �popr1 r0 r� r� r< r� r& r4 )r r2 Z minCharCountr{ r� r r r �
_rewindSayAllg s
zScript._rewindSayAllc C s^ t jd�sdS y|jj� }W n Y n X tjd |jdd� |j|j� | jd |j|j� dS )Nr� F)r� T) r� r� r� r� r< r� r& r1 r4 )r r2 r� r r r �_fastForwardSayAll} s
zScript._fastForwardSayAllc C s y"|j j� }|j|j|jd �}W n
d S || jkr<d S |tjjkrLd S |tjjkr�t t
j t j
�r�d| _t
j j}|dkr�| j|�r�d S |dkr�| j|�r�d S d| _g | _|j|j� n*|tjjkr�tjd |j dd� |j|j� |j� �r |jd|j|j� d S )Nr� Tr� r� F)r� r )r� r� r; Z
currentOffset�EMBEDDED_OBJECT_CHARACTER� speechserver�
SayAllContextZPROGRESSZ INTERRUPTEDr� r� r� r. r� r r� r� r� r r r& Z COMPLETEDr< r� r� Z setSelection)r r2 Z progressTyper� �char�lastKeyr r r Z__sayAllProgressCallback� s2
z Script.__sayAllProgressCallbackc C sT | j r d}tjtj|d� dS | jr<d}tjtj|d� dS d}tjtj|d� dS )NzDEFAULT: In SayAllTz DEFAULT: SayAll is interruptedzDEFAULT: Not in SayAllF)r r� r� r� r )r r� r r r �inSayAll� s zScript.inSayAllc
C s4 y |j � }W n tk
r dS X |jd }|jd }|dk sF|dk rJdS |j|tj�\}}}|j|tj�\}}}| jj||�s�dS |jd } | }
xR|
dkr�|j|
tj�\}}}|j|
d tj�\}}}| jj||�r�P q�|
d8 }
q�W |
| kr�dS | jj||
d | d �} | j j
| d�} | jj | �} t j
| | � dS )a Speaks the sentence prior to the caret, as long as there is
a sentence prior to the caret and there is no intervening sentence
delimiter between the caret and the end of the sentence.
The entry condition for this method is that the character
prior to the current caret position is a sentence delimiter,
and it's what caused this method to be called in the first
place.
Arguments:
- obj: an Accessible object that implements the AccessibleText
interface.
Fr� r r )rF T)r� rm r� r$ r �TEXT_BOUNDARY_CHARr� ZisSentenceDelimiter� substringr� rE r] rc r� )
r r� r� rp ZpreviousOffsetZ currentCharr0 r1 Z previousCharZsentenceEndOffsetZsentenceStartOffsetr� rE r r r r� � s<
zScript.echoPreviousSentencec
C s y |j � }W n tk
r dS X |sB|jdkr8|j}n
|jd }|dk rNdS |j|tj�\}}}| jj|�srdS |d }|}x8|dkr�|j|tj�\}}}| jj|�r�P q�|d8 }q�W ||kr�dS | jj ||d |d �} | j
j | d�}
| jj | �} t
j| |
� dS )av Speaks the word prior to the caret, as long as there is
a word prior to the caret and there is no intervening word
delimiter between the caret and the end of the word.
The entry condition for this method is that the character
prior to the current caret position is a word delimiter,
and it's what caused this method to be called in the first
place.
Arguments:
- obj: an Accessible object that implements the AccessibleText
interface.
- offset: if not None, the offset within the text to use as the
end of the word.
Fr� r )rF Tr� )r� rm r� r6 r$ r r� r� �isWordDelimiterr� r� rE r] rc r� ) r r� rp r� r� r0 r1 Z
wordEndOffsetZwordStartOffsetr� rE r r r r� s@
zScript.echoPreviousWordc C s� |j � }|j}| jj� \}}|tj@ r6|d kr6|d8 }|j|tj�\}}}| sX|dkr\d}t j
d�} |dkr�|jt d|�tj �}
|
d s�|
d dkr�| r�| j
tjdd � d
S |d
kr�| r�| j
tjdd � d
S | j||� | j|� d
S )z�Speak the character at the caret.
Arguments:
- obj: an Accessible object that implements the AccessibleText
interface
�Rightr� r� �
rU �speakBlankLinesr F)r� N�
)r� r� )rU r� )r� r� r� r� r� ZSHIFT_MODIFIER_MASKr$ r r� r� r� r� r% r� r� rX r� rQ ) r r� r� rp r� r� rS r0 r1 r� r� r r r r� W s.
zScript.sayCharacterc C s� | j |�\}}}t|�r�|dkr�| jj|�}|r:| j|� | jj|d�}| jj|||�}| jj|�}|g}|j |� t
j |� n
| j |� dS )z�Speaks the line of an AccessibleText object that contains the
caret, unless the line is empty in which case it's ignored.
Arguments:
- obj: an Accessible object that implements the AccessibleText
interface
rU )rF N)
�getTextLineAtCaretr r� �indentationDescriptionr� r� rE �adjustForLinksr] r rc r� r� )r r� r� r� r0 r� rE � utterancer r r r� � s
zScript.sayLinec C s� | j j|||�}|sdS t|�dks,|j� r|| j j|�}|rF| j|� | jj|d�}| j j|�}|g}|j |� t
j |� n
| j |� dS )a^ Speaks the text of an Accessible object between the start and
end offsets, unless the phrase is empty in which case it's ignored.
Arguments:
- obj: an Accessible object that implements the AccessibleText
interface
- startOffset: the start text offset.
- endOffset: the end text offset.
Nr� )rF )
r� Z
expandEOCsr r� r� r� r� rE r] r rc r� r� )r r� r0 r1 �phraser� rE r� r r r � sayPhrase� s
zScript.sayPhrasec C s |j � }|j}| jj� \}}| j}|j|tj�\}}} |sH| j|� dS |dkr�t |�dkr�|t |�d }
|
dkr�||kr�| j
d� |dkr�t |�dkr�|t |�d }
|
dkr�||kr�| j
d� | j ||� | j j
|d�} | jj|�}|| _tj|| � dS )z�Speaks the word at the caret.
Arguments:
- obj: an Accessible object that implements the AccessibleText
interface
Nr� r r� rU ZLeft)rF )r� r� r� r� r r$ r �TEXT_BOUNDARY_WORD_STARTr� r rQ r� r� rE r] rc r� ) r r� r� rp r� r� ZlastWordr� r0 r1 ZlastCharrE r r r r� � s,
zScript.sayWordc K s< |j dd�}| j|f|� | jj|f|�}tj||d� d S )Nr� F)r� )r� r� r� r� rc r� )r r� r� r� r� r r r r� � s zScript.presentObjectc C st |j s
dS tj|j krL| jjdi �}|jttj�d�}| sH|j j|krLdS |jtj kof|j jkn rpdS dS )z�Whether or not speech should be stopped prior to setting the
locusOfFocus in onActiveDescendantChanged.
Arguments:
- event: the Event
Returns True if speech should be stopped; False otherwise.
Tr� r F) r� r� r" r� r� r� r� r� �parent)r r� r� r� r r r r� � s
z*Script.stopSpeechOnActiveDescendantChangedc C s( | j s"tj| �| _ d| _| j� | _| j S )z;Returns the flat review context, creating one if necessary.T)r
r r r
rf r )r r r r r'
s
zScript.getFlatReviewContextc C s� t jd� r,t jd� r,tjtjdd� dS | j� }|j� \}}|sLg }d}| j� }| j||� t j
|g� | j |d� |r�| j |j
|j � | jr�| jd| j� d| _n | jd|� dS )aA Obtains the braille regions for the current flat review line
and displays them on the braille display. If the targetCursorCell
is non-0, then an attempt will be made to position the review cursor
at that cell. Otherwise, we will pan in display-sized increments
to show the review cursor.r� r� z BRAILLE: update review disabledTNF)r� r� r� r� r� r' �getCurrentBrailleRegionsr� r� r� ZsetLinesr� �panBrailleToOffset�
brailleOffset� cursorOffsetr
r� r )r r r2 �regions�regionWithFocusr� r r r r!
s(
zScript.updateBrailleReviewc C s� | j � }|j� \}}x�|D ]�}|jt|j� tjd krt|tj�sPt|tj �rt
|jtjd �}||j }|jtjd | _ |j j
|�\}}|r�| jj|j jj|j j|j|� n | jj|j jj|j jdd� P qW dS )zqSets the character of interest to be the first character showing
at the beginning of the braille display.r N)r' r� r� r rF r� Zviewportr� Z
ReviewTextZReviewComponentr� r ZzoneZgetWordAtOffsetr
�
setCurrentr� r{ ) r r2 r� r� �regionZpositionrp r� Z
charOffsetr r r r ?
s0
z7Script._setFlatReviewContextToBeginningOfBrailleDisplayc C sh |s t j� }|rd| j� }|j|| j�}|s8| jtj� n,|j|j |j
|j |j � | j
d� | j� | _dS )z�Searches for the specified query. If no query is specified,
it searches for the query specified in the Orca Find dialog.
Arguments:
- query: The search query to find.
N)r r r' Z findQueryr
r� r� ZSTRING_NOT_FOUNDr� Z lineIndexZ zoneIndexZ wordIndex� charIndexrJ rf r )r Zqueryr2 �locationr r r r ]
s
z Script.findc c sT d| _ y |j� }W n d| _g | _dS d| _|j}|dkrD|j}tjd�}|tj kr`t
j }n|tj krrt
j
}nt
j
}|}d}�x�|�s&tj| jj||d�� d } �x||k �r�|j||�\}
} } |
s�t
j
}|j||�\}
} } | |jk�rd| |j|||f }
tjtj|
d� |j} | | k�r8t|d | d �}| } q�| } | }| jj|
d�}|�rht|t��rh|d }| jj||
| �}
| jj |
�}
t j ||
| | �}| jj |� ||gV q�W d}|j � }x`|D ]X}|j!� t
j"k�r�|}|j#d �}y |j� }W n t$k
�r dS X |j}d }d}P �q�W |s�d}q�W d| _g | _d
}
tjtj|
d� | j%� dS ) a� Creates a generator that can be used to iterate over each line
of a text object, starting at the caret offset.
Arguments:
- obj: an Accessible that has a text specialization
Returns an iterator that produces elements of the form:
[SayAllContext, acss], where SayAllContext has the text to be
spoken and acss is an ACSS instance for speaking the text.
FNT� sayAllStyle)r� r� z_WARNING: endOffset: %i > characterCount: %i resulting from text.getTextAtOffset(%i, %s) for %s)rF r z4DEFAULT: textLines complete. Verifying SayAll statusr� )&r r� r r r6 r� r� r� r� ZSAYALL_STYLE_SENTENCEr Z TEXT_BOUNDARY_SENTENCE_STARTZSAYALL_STYLE_LINEr% rc r� r� ZgenerateContextr$ r� r� r� r� rE r� rH r� r� r] r� r� �appendZgetRelationSetZgetRelationTypeZRELATION_FLOWS_TOZ getTargetrm r� )r r� rp r� Zlengthr� �moder� �doneZ
lastEndOffsetr/ r0 r1 r� rE r2 Z moreLinesZ relationsZrelationr r r rn r
s�
zScript.textLinesc C s� y |j � }W n tk
r& dddgS X |j|jkrVtd|jd �}|j||d �}n
|j}d}|j|jkr~|dkr~d}|}nl|jdkr�|j||d �}|}n8|dkr�|j}y|j|tj�\}}}W n dddgS |j d�}|j d�}||j|gS )z<To-be-removed. Returns the string, caretOffset, startOffset.r r r� NrU r� r� )
r� rm r� r6 r� r; r$ r r% �rstrip) r r� rp r0 r1 r� r� rS r/ r r r r� �
s4
zScript.getTextLineAtCaretc C sB x<t |�D ]0\}}| jj|d�}tj|j� �}tj||� q
W dS )z�Phonetically spell the current flat review word or line.
Arguments:
- itemString: the string to phonetically spell.
)rF N)� enumerater� rE � phonnamesZgetPhoneticName�lowerrc r� )r rR r� rS rE ZphoneticStringr r r r\ ) s z Script.phoneticSpellCurrentItemc C s ||g| j d< dS )z�Save away the current text cursor position for next time.
Arguments:
- obj: the current accessible
- caretOffset: the cursor position within this object
r� N)r� )r r� r� r r r r� 5 s z Script._saveLastCursorPositionc C s t d� dS )z�Rings the system bell. This is really a hack. Ideally, we want
a method that will present an earcon (any sound designated for the
purpose of representing an error, event etc)
�N)�print)r r r r �
systemBeep? s zScript.systemBeepc C s� t jd�r�y |j� }W n
dS |j|tj�}|d j� sN| jj|d �r\|d | _ dS |j|tj
�}| jj ||�r�|d | j kr�| j t
j� |d | _ dS )a Speaks an announcement indicating that a given word is misspelled.
Arguments:
- obj: An accessible which implements the accessible text interface.
- offset: Offset in the accessible's text for which to retrieve the
attributes.
r� Nr )r� r� r� r$ r r� �stripr� r� r r� r� r� r� r� )r r� rp r� ZcharAndOffsetsZwordAndOffsetsr r r r� G s
z Script.speakMisspelledIndicatorc C s t j� tj� dS )zbConvenience method to interrupt presentation of whatever is being
presented at the moment.N)rc ru r� Z killFlash)r r r r �presentationInterruptp s z Script.presentationInterruptc
C sP |j � sd| _| jj� tjs4|jdks0|j� r4dS ytjj � }W n
dS |t
j t
j t
j
gkr�| jjtj�}|r�tjd|d� |j � }|t
jkr�|j� r�dS |j � s�dS tj|� |j� o�|j � }|j� r�| r�dS tj�r
|j� �r
|j� dk�r
| j|j� dS d}|j� �r |j}d}t j t j |d� | j j |d�}t!j"||� dS )z{Convenience method to present the KeyboardEvent event. Returns True
if we fully present the event; False otherwise.FNr Tz"DEFAULT: Presenting keyboard event)rF )#Z isPressedKeyr r� ZclearCachedCommandStater� r� Z
shouldEchoZisOrcaModifiedr" r� r r� r� Z ROLE_WINDOW�
focusedObjectr� r< r� ZROLE_PASSWORD_TEXTZ isLockingKeyr� ZdisplayKeyEventZisOrcaModifierZisCharacterEchoableZisPrintableKeyZ
getClickCountr\ r� r� r� r� r� rE rc Z
speakKeyEvent)r r� r� r� ZorcaModifierPressedrF r� rE r r r �presentKeyboardEventw sF
zScript.presentKeyboardEventTc C s� |sdS |dkr|}t jd�rFt jd�s.|}n|}|rF| j|||d� t jd�sZt jd�r�t jd�r�t jd�st|}n|}|s�dS t|d t�r�|d }t|t�r�d
d � |D �}d j|�}t jd
�r�d}n
t jd�}tj||d� dS )a� Convenience method to speak a message and 'flash' it in braille.
Arguments:
- fullMessage: This can be a string or a list. This will be presented
as the message for users whose flash or message verbosity level is
verbose.
- briefMessage: This can be a string or a list. This will be presented
as the message for users whose flash or message verbosity level is
brief. Note that providing no briefMessage will result in the full
message being used for either. Callers wishing to present nothing as
the briefMessage should set briefMessage to an empty string.
- voice: The voice to use when speaking this message. By default, the
"system" voice will be used.
Nrt ZmessagesAreDetailed)rE � resetStylesr� r� ZenableFlashMessagesZflashIsDetailedr c S s g | ]}t |t�r|�qS r )r� �str)r �ir r r r � s z)Script.presentMessage.<locals>.<listcomp>r� ZflashIsPersistentr� r� )r� r� )r� r� r� r� rH r� r� �displayMessage)r r� r� rE r� �messageZdurationr r r r� � s6
zScript.presentMessagec C s^ | sd S t | t�s| g}tj� }|j| d |� x(tdt| ��D ]}tj| | dd� q@W d S )Nr r� F)r� )r� rH �soundZ getPlayerZplay�ranger )Zsoundsr� ZiconZ_playerr� r r r Z__play� s
z
Script.__playc C s |j | � dS )z�Adds the braille region to the line.
Arguments:
- region: a braille.Region (e.g. what is returned by the braille
generator's generateBraille() method.
- line: a braille.Line
N)� addRegion)r� r� r r r r� � s
z Script.addBrailleRegionToLinec C s |j | � dS )a Adds the braille region to the line.
Arguments:
- regions: a series of braille.Region instances (a single instance
being what is returned by the braille generator's generateBraille()
method.
- line: a braille.Line
N)Z
addRegions)r� r� r r r r� � s z Script.addBrailleRegionsToLinec C s |j tj| �� dS )z�Creates a Braille Region out of string and adds it to the line.
Arguments:
- string: the string to be displayed
- line: a braille.Line
N)r r� �Region)rF r� r r r �addToLineAsBrailleRegion s z Script.addToLineAsBrailleRegionc C s& g }x | D ]}|j tj|�� q
W |S )z�Creates a list of braille regions from the list of strings.
Arguments:
- strings: a list of strings from which to create the list of
braille Region instances
Returns the list of braille Region instances
)r� r� r )ZstringsZbrailleRegionsrF r r r �brailleRegionsFromStrings s
z Script.brailleRegionsFromStringsc C s t j� dS )zfClears the logical structure, but keeps the Braille display as is
(until a refresh operation).N)r� �clearr r r r r� s zScript.clearBraillec C s> t jd� r,t jd� r,tjtjdd� dS tj| ||� dS )a[ Displays a single line, setting the cursor to the given position,
ensuring that the cursor is in view.
Arguments:
- message: the string to display
- cursor: the 0-based cursor position, where -1 (default) means no
cursor
- flashTime: if non-0, the number of milliseconds to display the
regions before reverting back to what was there before. A 0 means
to not do any flashing. A negative number means to display the
message until some other message comes along or the user presses
a cursor routing key.
r� r� z!BRAILLE: display message disabledTN)r� r� r� r� r� r� r )r Zcursorr� r r r r� & s
z Script.displayBrailleMessagec C s< t jd� r,t jd� r,tjtjdd� dS tj| |� dS )a� Displays a list of regions on a single line, setting focus to the
specified region. The regionInfo parameter is something that is
typically returned by a call to braille_generator.generateBraille.
Arguments:
- regionInfo: a list where the first element is a list of regions
to display and the second element is the region with focus (must
be in the list from element 0)
- flashTime: if non-0, the number of milliseconds to display the
regions before reverting back to what was there before. A 0 means
to not do any flashing. A negative number means to display the
message until some other message comes along or the user presses
a cursor routing key.
r� r� z!BRAILLE: display regions disabledTN)r� r� r� r� r� r� ZdisplayRegions)Z
regionInfor� r r r �displayBrailleRegions= s
z Script.displayBrailleRegionsc C s | j j|�}| j|� dS )z�Convenience method for scripts combining the call to the braille
generator for the script with the call to displayBrailleRegions.
Arguments:
- obj: the accessible object to display in braille
N)r� r� r )r r� r� r r r �displayBrailleForObjectU s z Script.displayBrailleForObjectc C s
t j| �S )ah Gets the accesible and caret offset associated with the given
event. The event should have a BrlAPI event that contains an
argument value that corresponds to a cell on the display.
Arguments:
- event: an instance of input_event.BrailleEvent. event.event is
the dictionary form of the expanded BrlAPI event.
)r� ZgetCaretContext)r� r r r r9 ` s z Script.getBrailleCaretContextc C s t jS )zzReturns the value of position of the braille cell which has the
cursor. A value of 0 means no cell has the cursor.)r� Z
cursorCellr r r r rf m s zScript.getBrailleCursorCellFc C s& | r t j� t j� }|r"t j|� |S )z�Creates a new braille Line.
Arguments:
- clearBraille: Whether the display should be cleared.
- addLine: Whether the line should be added to the logical display
for painting.
Returns the new Line.
)r� r ZLiner� )r� r� r� r r r r� t s
zScript.getNewBrailleLiner c C s t j| ||||�S )aB Creates a new braille Component.
Arguments:
- accessible: the accessible associated with this region
- string: the string to be displayed
- cursorOffset: a 0-based index saying where to draw the cursor
for this Region if it gets focus
Returns the new Component.
)r� Z Component)�
accessiblerF r� Z indicator�expandOnCursorr r r �getNewBrailleComponent� s
z Script.getNewBrailleComponentc C s t j| ||�S )z�Creates a new braille Region.
Arguments:
- string: the string to be displayed
- cursorOffset: a 0-based index saying where to draw the cursor
for this Region if it gets focus
Returns the new Region.
)r� r )rF r� r r r r �getNewBrailleRegion� s zScript.getNewBrailleRegionc C s t j| ||||�S )a" Creates a new braille Text region.
Arguments:
- accessible: the accessible associated with this region and which
implements AtkText
- label: an optional label to display
- eol: the endOfLine indicator
Returns the new Text region.
)r� �Text)r ZlabelZeolr0 r1 r r r �getNewBrailleText� s zScript.getNewBrailleTextc C s t jS )zMIf True, the beginning of the line is showing on the braille
display.)r� ZbeginningIsShowingr r r r r � s z Script.isBrailleBeginningShowingc C s t jS )z?If True, the end of the line is showing on the braille display.)r� Z endIsShowingr r r r r4 � s zScript.isBrailleEndShowingc C s |rt j| �S t j| �S dS )ai Pans the display to the left, limiting the pan to the beginning
of the line being displayed.
Arguments:
- panAmount: the amount to pan. A value of 0 means the entire
width of the physical display.
- panToLeft: if True, pan to the left; otherwise to the right
Returns True if a pan actually happened.
N)r� ZpanLeftZpanRight)r) r r r r r � s
z Script.panBrailleInDirectionc C s t j| � dS )zSAutomatically pan left or right to make sure the current offset
is showing.N)r� Z panToOffset)rp r r r r� � s zScript.panBrailleToOffsetc C s6 t j� }x | D ]}|jt jd| �� qW t j� dS )z�Method to braille a list of items. Scripts should call this
method rather than handling the creation and displaying of a
braille line directly.
Arguments:
- items: a list of strings to be presented
r� N)r� �getShowingLiner r �refresh)rt r� �itemr r r �presentItemsInBraille� s
z Script.presentItemsInBraillec C s� t jd� r,t jd� r,tjtjdd� dS d}tj� }x<|jD ]2}t|tj �r@|j
|kr@|j � rp| j d� d}P q@W |r�| j
|� dS )z@Try to reposition the cursor without having to do a full update.r� r� z BRAILLE: update caret disabledTNF)r� r� r� r� r� r� r r� r� r r ZrepositionCursorr� r� )r r� ZbrailleNeedsRepaintingr� r� r r r r� � s
z'Script.updateBrailleForNewCaretPositionc C s t j| |||� dS )a� This is the method scripts should use to refresh braille rather
than calling self.refreshBraille() directly. The intent is to centralize
such calls into as few places as possible so that we can easily and
safely not perform braille-related functions for users who do not
have braille and/or the braille monitor enabled.
Arguments:
- panToCursor: if True, will adjust the viewport so the cursor is
showing.
- targetCursorCell: Only effective if panToCursor is True.
0 means automatically place the cursor somewhere on the display so
as to minimize movement but show as much of the line as possible.
A positive value is a 1-based target cell from the left side of
the display and a negative value is a 1-based target cell from the
right side of the display.
- getLinkMask: Whether or not we should take the time to get the
attributeMask for links. Reasons we might not want to include
knowing that we will fail and/or it taking an unreasonable
amount of time (AKA Gecko).
- stopFlash: if True, kill any flashed message that may be showing.
N)r� r )Z panToCursorr � getLinkMaskr r r r r� s zScript.refreshBraillec C s t j| ||� dS )a[ Specififes the region with focus. This region will be positioned
at the home position if panToFocus is True.
Arguments:
- region: the given region, which much be in a line that has been
added to the logical display
- panToFocus: whether or not to position the region at the home
position
- getLinkMask: Whether or not we should take the time to get the
attributeMask for links. Reasons we might not want to include
knowning that we will fail and/or it taking an unreasonable
amount of time (AKA Gecko).
N)r� ZsetFocus)r� Z
panToFocusr r r r r� s zScript.setBrailleFocusc C s t j| � dS )z�Turns contracted braille on or off based upon the event.
Arguments:
- event: an instance of input_event.BrailleEvent. event.event is
the dictionary form of the expanded BrlAPI event.
N)r� r^ )r� r r r r8 0 s z Script._setContractedBraillec C s( | j j|d�}tj|�}tj||� dS )z~Method to speak a single character. Scripts should use this
method rather than calling speech.speakCharacter directly.)rF N)r� rE �chnamesZgetCharacterNamerc rQ )r rS rE ZspokenCharacterr r r rQ B s
zScript.speakCharacterc C s� t jd� st jd�rdS t jd�}|jtj�}|p6|}||kr�|r�t jd�}t jdtj� tj� t jd�}t jdtj � tj
� tj |||� ||kr�|r�t jd|� tj� t jd|� tj
� dS )ar Method to speak a single string. Scripts should use this
method rather than calling speech.speak directly.
- string: The string to be spoken.
- voice: The voice to use. By default, the "system" voice will
be used.
- interrupt: If True, any current speech should be interrupted
prior to speaking the new text.
rt r� N�voicesr} rx ) r� r� r� r� Z SYSTEM_VOICErv r~ rc r� ry r� r� ) r rF rE r� r� r Z systemVoiceZcapStyleZ
punctStyler r r r� J s&
zScript.speakMessagec C s* g }x| D ]}|j |� q
W tj|� dS )z�Method to speak a list of items. Scripts should call this
method rather than handling the creation and speaking of
utterances directly.
Arguments:
- items: a list of strings to be presented
N)r� rc r� )rt r� r r r r �presentItemsInSpeecho s
zScript.presentItemsInSpeechc C s t jtj| jj|� � dS )a Speaks some information about an unicode character.
At the moment it just announces the character unicode number but
this information may be changed in the future
Arguments:
- character: the character to speak information of
N)rc r� r� �UNICODEr� ZunicodeValueString)r rS r r r rj s z Script.speakUnicodeCharacterc C s( t jd�}tj|tj� �}| j|� dS )z Presents the current time. ZpresentTimeFormatT)r� r� r� �strftime� localtimer� )r r� Z
timeFormatr r r r rn � s
zScript.presentTimec C s( t jd�}tj|tj� �}| j|� dS )z Presents the current date. ZpresentDateFormatT)r� r� r� r r r� )r r� Z
dateFormatr r r r ro � s
zScript.presentDate)N)N)N)N)N)N)Nr )N)Nr )N)N)N)N)N)N)N)N)N)N)r r� )r� )r� )r )r )r )NN)N)N)N)N)N)N)N)N)N)N)N)NN)NN)N)r� )N)r )N)N)NNN)NNT)Tr� )r� r )r )FF)r r F)r F)r r NN)r T)Tr TT)TT)NTT)��__name__�
__module__� __qualname__r� ZNO_BREAK_SPACE_CHARACTERZDISPLAYED_LABELZDISPLAYED_TEXTZ KEY_BINDINGZ
NESTING_LEVELZ
NODE_LEVELZREAL_ACTIVE_DESCENDANTr rs rv rw r� r� r� r� r� r� r� r� r� r� r� r� rp rb r� r� r r r> r? r, r* r+ r) r- r[ r3 r\ r7 r] r^ r_ r` ra r/ r; r: rZ r2 r3 rT r` rN rH rM rS rT rU ri rP rQ rV rI rO rC rD rE rk rA rB rF rR rG rJ rK rL rW rX r5 r4 r@ rd re rf rh ri rj rk rg rY r� r6 r7 rl r8 r9 r� r� r� r� r� r� r~ ry rz r{ r� r� r| r} r� r� r� r� rx r� r� r� r r� r� r� r� r� r� r� r� r� r� r� r� ro r� r� r� r� r� r� r� r� r� r' r! r r rn r� r\ r� r� r� r� r� r� � staticmethodr� r� r� r r r� r� r r
r9 rf r� r
r r r r4 r r� r r� r� r� r8 rQ r� r rj rn ro �
__classcell__r r )r� r r D s� 1 G
) 62' # @ 2
. ' )
% = 2% -H . @"2 ( HL . - ! x?
) 15
% r ):�__doc__Z__id__� __version__Z__date__Z
__copyright__Z __license__r� r Z orca.brailler� Z orca.chnamesr Z
orca.cmdnamesr0 Z
orca.debugr� Zorca.eventsynthesizerr< Z orca.findr Zorca.flat_reviewr Zorca.guilabelsr Zorca.input_eventr. Zorca.keybindingsr� Z
orca.messagesr� Z orca.orcar< Zorca.orca_gui_commandlistZorca_gui_commandlistr Zorca.orca_stater� Zorca.phonnamesr� Z orca.scriptr Z
orca.settingsr� Zorca.settings_managerZsettings_managerZ
orca.soundr Z orca.speechrc Zorca.speechserverr� Zorca.mouse_reviewrm Zorca.notification_messagesrr Z
getManagerr� r r r r r �<module> s@