g f7dZdZdZdZdZdZddlZddlZddlZddl Z ddl m Z ejd d dd l mZdd l mZdd l mZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z ddl!m"Z"ddl#m$Z$dd l%m&Z&dd!l'm(Z(dd"l)m*Z*dd#l+m,Z,dd$l-m.Z.dd%l/m0Z0Gd&d'Z1y)(zCommonly-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.LGPLN)SequenceMatcherAtspiz2.0)r)GdkGtk) colornames)debug) focus_manager)keynames) keybindings) input_event) mathsymbols)messages) orca_state)object_properties)pronunciation_dict)script_manager)settings)settings_manager)text_attribute_names) AXComponent) AXHypertext)AXObject) AXSelection)AXTable)AXText) AXUtilities)AXValuect eZdZejZdZdZgdZgdZe jZ e jde Z e jddjede Ze jddjede Ze jd e Zd Zd Zd Zd ZdZdZdZdZdZdZdZdZdZddZdZ dZ!ddZ"dZ#dZ$dZ%dZ&d Z'dd!Z(dd"Z)d#Z*d$Z+d%Z,d&Z-d'Z.d(Z/d)Z0d*Z1d+Z2d,Z3d-Z4d.Z5d/Z6d0Z7d1Z8d2Z9d3Z:d4Z;d5Zd8Z?d9Z@d:ZAd;ZBd<ZCd=ZDd>ZEd?ZFd@ZGdAZHdBZIdCZJdDZKdEZLdFZMdGZNdHZOdIZPdJZQdKZRdLZSdMZTdNZUdOZVdPZWdQZXdRZYdSZZdTZ[dUZ\dVZ]dWZ^dXZ_dYZ`dZZad[Zbd\Zcd]Zdd^Zed_Zfd`ZgdaZhdbZidcZjddZkdeZldfZmdgZndhZodiZpdjZqdkZrdlZsddmZtdnZudoZvdpZwdqZxdrZydsZzdtZ{duZ|dvZ}dwZ~dxZdyZdzZd{Zd|Zd}Zd~ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZddZdZdZdZdZdZdZdZdZdZdZdZdZddZddZdZdZdZdZdZdZdZdZdZdZdZdZddZddZddZdZdZdZddZdZdZdZdZdZdZedZdZdZdZdZdZ ddZdZdZdZdZǐddZdZd„ZdÄZdĄZdńZ͐ddƄZedDŽZdȄZdɄZdʄZd˄Zd̄Zd̈́Zd΄ZdτZdЄZؐddфZِdd҄ZedӄZېddԄZܐddՄZdքZdׄZd؄ZdلZdڄZddۄZd܄Zd݄ZdބZd߄ZdZdZdZddZdZdZdZdZddZdZdZdZddZdZdZdZdZdZedZedZdZdZdZdZedZeddZdZdZdZdZedZedZedZedZ dZ edZ edZ ddZ ddZddZddZd Zd Zd Zd Zd ZdZdZdZdZdZdZddZddZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'd Z(d!Z)d"Z*d#Z+d$Z,d%Z-d&Z.d'Z/d(Z0d)Z1d*Z2d+Z3d,Z4d-Z5d.Z6d/Z7d0Z8d1Z9d2Z:dd3Z;dd4Z<d5Z=d6Z>d7Z?dd8Z@d9ZAd:ZBdd;ZCd<ZDd=ZEd>ZFd?ZGd@ZHddAZIdBZJdCZKedDZLdEZMdFZNdGZOdHZPdIZQddJZRdKZSdLZTdMZUdNZVdOZWdPZXdQZYdRZZdSZ[dTZ\dUZ]dVZ^dWZ_dXZ`dYZadZZbd[Zcd\Zdd]Zed^Zfd_Zgd`ZhdaZidbZjdcZkddZldeZmdfZndgZodhZpddiZqdjZrdkZsdlZtdmZudnZvdoZwdpZxdqZydrZzdsZ{dtZ|duZ}ddvZ~dwZdxZdyZdzZd{Zd|Zd}Zd~ZdZdZddZdZdZddZddZy( Utilitiesuu) u⁰¹²³u⁴u⁵u⁶u⁷u⁸u⁹) u₀u₁u₂u₃u₄u₅u₆u₇u₈u₉z(\W+)[z]+z[^\w\s]displayedDescriptiondisplayedLabel displayedText keyBinding nestingLevel nodeLevelc.||_d|_i|_y)zCreates an instance of the Utilities class. Arguments: - script: the script with which this instance is associated. N)_script_clipboardHandlerId_selectedMenuBarMenu)selfscripts 7/usr/lib/python3/dist-packages/orca/script_utilities.py__init__zUtilities.__init__ds #' $&!cttj|sgStj|}|gSd}t j |t jj|}dt|d|dg}tjtj|d|r|Stj|d\}}|j|}t|dztj |dD]} tj"|| |} t j$| t jj&} | sK| j)d } |j+|| r|j-| |j| |ksndt|d|d g}tjtj|d|S) zGets 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 c2tj|dk\SNr)rget_index_in_parentxs r4predz"Utilities.childNodes..preds//2a7 7r6SCRIPT UTILITIES:zchild nodes forzvia node-parent-ofTFprefer_attributer rzvia node-child-of)r is_expandedr get_tablerget_relation_targetsr RelationTypeNODE_PARENT_OFlenr printTokens LEVEL_INFOget_cell_coordinatesr-range get_row_count get_cell_at get_relation NODE_CHILD_OF get_target isSameObjectappend) r2objparentr=nodestokensrowcolr-icellrelationnodeOfs r4 childNodeszUtilities.childNodesus&&s+I""3' >I  8--c53E3E3T3TVZ[%s5z3DcK_` %**FD9 L//eLSNN3' sQw 5 5fu UV A&&vq#6D,,T53E3E3S3STH((+F  f- T"'94 &s5z3DcK^_ %**FD9 r6cd|d|g}tjtj|d|r|sy||k(r|S|g}tj|}|r)|j |tj|}|r)|j |g}tj|}|r)|j |tj|}|r)|j d}tt|t|}d} | |kr*|j|| || r || }| dz } nn| |kr*d|d|d|g}tjtj|d|S) zFinds the common ancestor between Accessible a and Accessible b. Arguments: - a: Accessible - b: Accessible z0SCRIPT UTILITIES: Looking for common ancestor ofandTNrr z$SCRIPT UTILITIES: Common ancestor ofis) r rGrHrget_parent_checkedrQreverseminrFrP) r2abrUaParentsrSbParentscommonAncestor maxSearchrXs r4rgzUtilities.commonAncestors_EaPQR %**FD9a 6H3,,Q/ OOF #008F 3,,Q/ OOF #008F H s8}5 )m  !hqk:!)!Q )m9!UAt^\ %**FD9r6c |jj|j|S#t$rJ|j|jjvr#i|jj|j<d}YnwxYw|j |}|D]#}|j ||j |}%||jj|j|<|jj|j|S)aXIf 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/generatorCacheDISPLAYED_LABEL ExceptionlabelsForObject appendStringr*)r2rR labelStringlabelslabels r4r)zUtilities.displayedLabels <<..t/C/CDSI I ##4<<+F+FFDF ++D,@,@AK  %%c* JE!!+t/A/A%/HI  JBM ##D$8$89#>||**4+?+?@EEs%(AA;:A;cyNFr2rRs r4preferDescriptionOverNamez#Utilities.preferDescriptionOverNamer6c(tj|tjj}|sgStj|tjj }||k(r,d|dg}t jt j|dgS|S)z(Return a list of objects describing obj.r>z;'s described-by targets are the same as labelled-by targetsT) rrCrrD DESCRIBED_BY LABELLED_BYr rGrH)r2rR descriptionsrprUs r4descriptionsForObjectzUtilities.descriptionsForObjects 44S%:L:L:Y:YZ I..sE4F4F4R4RS 6 !)3SUF   e.. =Ir6cb|j|}tt|j|SN)detailsForObjectlistmapr*)r2rRdetailss r4detailsContentForObjectz!Utilities.detailsContentForObjects*'',C**G455r6cftj|tjj}|sLt j |r7t j|r"tj|Dcgc]}|}}|s|Sg}|D]$}|j|j|d&|Scc}w)z4Return a list of objects containing details for obj.c.tj| Sr~)ris_whitespace_or_emptyr;s r4z,Utilities.detailsForObject..sf&C&CA&F"Fr6) rrCrrDDETAILSris_toggle_buttonrA iter_childrenextendfindAllDescendants)r2rRtextOnlyrchild textObjectsdetails r4rzUtilities.detailsForObject s//U5G5G5O5OP;77<'',*2*@*@*EFuFGFN  IF   t66F H I I Gs2 B.c |jj|j|S#t$rH|j|jjvr#i|jj|j<YnwxYwdj t |j |j|}||jj|j|<|jj|j|S)z?Returns the text being displayed for the object describing obj. )r/rjDISPLAYED_DESCRIPTIONrljoinrr*r|)r2rRstrings r4r(zUtilities.displayedDescriptions M<<..t/I/IJ3O O M))1L1LLJL ++D,F,FG M#d00$2L2LS2QRSGM ##D$>$>?D||**4+E+EFsKKs%(AA98A9c& |jj|j|S#t$rd}YnwxYwt j |}t j |}|tjjtjjfvr|r|Stj|}|j|vrd}|s8|tjjtjjfvr|}|s|tjjtjj fvrN|j#|d}|s|j#|dd}dj%t'|j(|}|j|jjvr#i|jj|j<||jj|j|<|jj|j|S)zReturns 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. Nr ) minimumWordsF) onlyShowingrr)r/rjDISPLAYED_TEXTrlrget_nameget_rolerRole PUSH_BUTTONLABELr get_all_textEMBEDDED_OBJECT_CHARACTER COMBO_BOX SPIN_BUTTON LIST_ITEMunrelatedLabelsrrr*)r2rRr*namerolerps r4r*zUtilities.displayedText)s !<<..t/B/BCCH H ! M !  %  % EJJ**EJJ,<,<= =$K++C0  ) )] : Mejj.B.BEJJDZDZ-[![!M%***@*@%**BVBV)W!W))#A)>F--cuST-UHHS););V%DEM   dll&A&A A?ADLL ' '(;(; <@M ##D$7$78=||**4+>+>?DDs %( 66Nc|s|j\}}tj|tj}|r|St j j}tj|r|Sy)zyReturns the document frame which is displaying the content. Note that this is intended primarily for web content.N)getCaretContextr find_ancestorr is_documentr getManagerget_locus_of_focus)r2rRoffsetdocumentfocuss r4 documentFramezUtilities.documentFrameUsf..0KC))#{/F/FG O((*==?  " "5 )Lr6czddg}|xs"tjj}|s)d}tjtj |d|S|j |}|+d|g}tjtj |d|Stjjtjjg|jr)jtjjtj |}|vr||d<ng|tjj"tjj$fvr||d<fd}||r||d<ntj&|||d<d|d |dd |dg}tjtj |d|S) z;Returns the frame and (possibly) the dialog containing obj.Nz>SCRIPT UTILITIES: frameAndDialog() called without valid objectTz5SCRIPT UTILITIES: could not find top-level object forr rc2tj|vSr~)rr)r< dialog_roless r4isDialogz*Utilities.frameAndDialog..isDialogs((+|;;r6r>z is in framez and dialog)r rrr printMessagerHtopLevelObjectrGrrDIALOG FILE_CHOOSER_treatAlertsAsDialogsrQALERTrrFRAMEWINDOWr) r2rRresultsmsgtopLevelrUrrrs @r4frameAndDialogzUtilities.frameAndDialogfs,D]--/BBDRC   u//d ;N&&s+  MsSF   e.. =N ))5::+B+BC  % % '    0 0 1  * < !GAJ ((%***;*;<<%  <}  %33CB %sM71:|U\]^U_` %**FD9r6cd|jtjjk(ryyNTF)sourcer rrr2events r4 presentEventFromNonShowingObjectz*Utilities.presentEventFromNonShowingObjects& <<=335HHJ Jr6c,tj|Sr~)r is_focusablerus r4grabFocusWhenSettingCaretz#Utilities.grabFocusWhenSettingCarets'',,r6ctj|xr3|j|tjj  S)ayWhether 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. )r is_combo_boxrPr rrr2rRrs r4grabFocusBeforeRoutingz Utilities.grabFocusBeforeRoutingsC'',\%%c=+C+C+E+X+X+Z[[ \r6c|}|D]r}|yt|ts|g}t|dtrtj|}ntj |}||vrytj |}ty)aCalled 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. FrT) isinstancerstrr get_role_namerr`)r2rR rolesListcurrentr current_roles r4hasMatchingHierarchyzUtilities.hasMatchingHierarchys$ ;DdD)v$q'3''55g> '009 4'11':G ;"r6c|"tjj}tj|syt j |tjduSrs)r rrris_entryrr is_tool_barrus r4inFindContainerzUtilities.inFindContainersM ;**,??AC##C(%%c;+B+BC4OOr6cyNr'rtr2roots r4getFindResultsCountzUtilities.getFindResultsCountr6cyrsrtrus r4isAnchorzUtilities.isAnchorrwr6cyrsrtrus r4isCodezUtilities.isCoderwr6cyrsrtrus r4isCodeDescendantzUtilities.isCodeDescendantrwr6ctj|sytj|}|j ddk(S)NFz window-typedockris_framerget_attributes_dictgetr2rRattrss r4 isDockedFramezUtilities.isDockedFrames7##C(,,S1yy'611r6ctj|sytj|}|j ddk(S)NFz is-desktoptruerrs r4 isDesktopzUtilities.isDesktops7##C(,,S1yy&&00r6cyrsrtrus r4isComboBoxWithToggleDescendantz(Utilities.isComboBoxWithToggleDescendantrwr6cyrsrtrus r4isToggleDescendantOfComboBoxz&Utilities.isToggleDescendantOfComboBoxrwr6cyrsrtrus r4 isTypeaheadzUtilities.isTypeaheadrwr6cB|k(rytj|fdS)NTc|xr|k(Sr~rt)r<ancestors r4rz,Utilities.isOrDescendsFrom..sQ5H1=r6rr)r2rRrs `r4isOrDescendsFromzUtilities.isOrDescendsFroms! (?%%c+HIIr6cy)zReturns True if the window is a functioning as a dialog. This method should be subclassed by application scripts as needed. Frtrus r4isFunctionalDialogzUtilities.isFunctionalDialogs r6cyrsrtrus r4 isCommentzUtilities.isCommentrwr6cyrsrtrus r4isContentDeletionzUtilities.isContentDeletion rwr6cyrsrtrus r4isContentErrorzUtilities.isContentError rwr6cyrsrtrus r4isContentInsertionzUtilities.isContentInsertionrwr6cyrsrtrus r4isContentMarkedzUtilities.isContentMarkedrwr6cyrsrtrus r4isContentSuggestionzUtilities.isContentSuggestionrwr6cyrsrtrus r4isInlineSuggestionzUtilities.isInlineSuggestionrwr6cyrsrtrus r4$isFirstItemInInlineContentSuggestionz.Utilities.isFirstItemInInlineContentSuggestionrwr6cyrsrtrus r4#isLastItemInInlineContentSuggestionz-Utilities.isLastItemInInlineContentSuggestionrwr6cyrsrtrus r4isEmptyzUtilities.isEmpty!rwr6cyrsrtrus r4isHiddenzUtilities.isHidden$rwr6cyrsrtrus r4isDPubzUtilities.isDPub'rwr6cyrsrtrus r4isDPubAbstractzUtilities.isDPubAbstract*rwr6cyrsrtrus r4isDPubAcknowledgmentszUtilities.isDPubAcknowledgments-rwr6cyrsrtrus r4isDPubAfterwordzUtilities.isDPubAfterword0rwr6cyrsrtrus r4isDPubAppendixzUtilities.isDPubAppendix3rwr6cyrsrtrus r4isDPubBibliographyzUtilities.isDPubBibliography6rwr6cyrsrtrus r4isDPubBacklinkzUtilities.isDPubBacklink9rwr6cyrsrtrus r4isDPubBibliorefzUtilities.isDPubBiblioref<rwr6cyrsrtrus r4 isDPubChapterzUtilities.isDPubChapter?rwr6cyrsrtrus r4isDPubColophonzUtilities.isDPubColophonBrwr6cyrsrtrus r4isDPubConclusionzUtilities.isDPubConclusionErwr6cyrsrtrus r4 isDPubCoverzUtilities.isDPubCoverHrwr6cyrsrtrus r4 isDPubCreditzUtilities.isDPubCreditKrwr6cyrsrtrus r4 isDPubCreditszUtilities.isDPubCreditsNrwr6cyrsrtrus r4isDPubDedicationzUtilities.isDPubDedicationQrwr6cyrsrtrus r4 isDPubEndnotezUtilities.isDPubEndnoteTrwr6cyrsrtrus r4isDPubEndnoteszUtilities.isDPubEndnotesWrwr6cyrsrtrus r4isDPubEpigraphzUtilities.isDPubEpigraphZrwr6cyrsrtrus r4isDPubEpiloguezUtilities.isDPubEpilogue]rwr6cyrsrtrus r4 isDPubErratazUtilities.isDPubErrata`rwr6cyrsrtrus r4 isDPubExamplezUtilities.isDPubExamplecrwr6cyrsrtrus r4isDPubFootnotezUtilities.isDPubFootnotefrwr6cyrsrtrus r4isDPubForewordzUtilities.isDPubForewordirwr6cyrsrtrus r4isDPubGlossaryzUtilities.isDPubGlossarylrwr6cyrsrtrus r4isDPubGlossrefzUtilities.isDPubGlossreforwr6cyrsrtrus r4 isDPubIndexzUtilities.isDPubIndexrrwr6cyrsrtrus r4isDPubIntroductionzUtilities.isDPubIntroductionurwr6cyrsrtrus r4isDPubPagelistzUtilities.isDPubPagelistxrwr6cyrsrtrus r4isDPubPagebreakzUtilities.isDPubPagebreak{rwr6cyrsrtrus r4 isDPubPartzUtilities.isDPubPart~rwr6cyrsrtrus r4 isDPubPrefacezUtilities.isDPubPrefacerwr6cyrsrtrus r4isDPubProloguezUtilities.isDPubProloguerwr6cyrsrtrus r4isDPubPullquotezUtilities.isDPubPullquoterwr6cyrsrtrus r4 isDPubQnazUtilities.isDPubQnarwr6cyrsrtrus r4isDPubSubtitlezUtilities.isDPubSubtitlerwr6cyrsrtrus r4 isDPubToczUtilities.isDPubTocrwr6cyrsrtrus r4isFeedzUtilities.isFeedrwr6cyrsrtrus r4 isFeedArticlezUtilities.isFeedArticlerwr6cyrsrtrus r4isFigurezUtilities.isFigurerwr6cyrsrtrus r4isGridzUtilities.isGridrwr6cyrsrtrus r4 isGridCellzUtilities.isGridCellrwr6cyrsrtrus r4 isLandmarkzUtilities.isLandmarkrwr6cyrsrtrus r4isLandmarkWithoutTypezUtilities.isLandmarkWithoutTyperwr6cyrsrtrus r4isLandmarkBannerzUtilities.isLandmarkBannerrwr6cyrsrtrus r4isLandmarkComplementaryz!Utilities.isLandmarkComplementaryrwr6cyrsrtrus r4isLandmarkContentInfozUtilities.isLandmarkContentInforwr6cyrsrtrus r4isLandmarkFormzUtilities.isLandmarkFormrwr6cyrsrtrus r4isLandmarkMainzUtilities.isLandmarkMainrwr6cyrsrtrus r4isLandmarkNavigationzUtilities.isLandmarkNavigationrwr6cyrsrtrus r4 isDPubNoterefzUtilities.isDPubNoterefrwr6cyrsrtrus r4isLandmarkRegionzUtilities.isLandmarkRegionrwr6cyrsrtrus r4isLandmarkSearchzUtilities.isLandmarkSearchrwr6cyrsrtrus r4isSVGzUtilities.isSVGrwr6cyrsrtrus r4speakMathSymbolNameszUtilities.speakMathSymbolNamesrwr6cyrsrtr2s r4isInMathzUtilities.isInMathrwr6cyrsrtrus r4isMathzUtilities.isMathrwr6cyrsrtrus r4isMathLayoutOnlyzUtilities.isMathLayoutOnlyrwr6cyrsrtrus r4isMathMultilinezUtilities.isMathMultilinerwr6cyrsrtrus r4isMathEnclosedzUtilities.isMathEnclosedrwr6cyrsrtrus r4 isMathFencedzUtilities.isMathFencedrwr6cyrsrtrus r4isMathFractionWithoutBarz"Utilities.isMathFractionWithoutBarrwr6cyrsrtrus r4 isMathPhantomzUtilities.isMathPhantomrwr6cyrsrtrus r4isMathMultiScriptzUtilities.isMathMultiScriptrwr6cyrsrtrus r4isMathSubOrSuperScriptz Utilities.isMathSubOrSuperScriptrwr6cyrsrtrus r4isMathUnderOrOverScriptz!Utilities.isMathUnderOrOverScriptrwr6cyrsrtrus r4isMathSquareRootzUtilities.isMathSquareRootrwr6cyrsrtrus r4 isMathTablezUtilities.isMathTablerwr6cyrsrtrus r4isMathTableRowzUtilities.isMathTableRowrwr6cyrsrtrus r4isMathTableCellzUtilities.isMathTableCellrwr6cyrsrtrus r4 isMathTokenzUtilities.isMathTokenrwr6cyrsrtrus r4isMathTopLevelzUtilities.isMathTopLevelrwr6cyr~rtrus r4getMathDenominatorzUtilities.getMathDenominatorr6cyr~rtrus r4getMathNumeratorzUtilities.getMathNumeratorrr6cyr~rtrus r4getMathRootBasezUtilities.getMathRootBaserr6cyr~rtrus r4getMathRootIndexzUtilities.getMathRootIndexrr6cyr~rtrus r4getMathScriptBasezUtilities.getMathScriptBaserr6cyr~rtrus r4getMathScriptSubscriptz Utilities.getMathScriptSubscript rr6cyr~rtrus r4getMathScriptSuperscriptz"Utilities.getMathScriptSuperscriptrr6cyr~rtrus r4getMathScriptUnderscriptz"Utilities.getMathScriptUnderscriptrr6cyr~rtrus r4getMathScriptOverscriptz!Utilities.getMathScriptOverscriptrr6cgSr~rtrus r4getMathPrescriptszUtilities.getMathPrescripts r6cgSr~rtrus r4getMathPostscriptszUtilities.getMathPostscriptsrr6cgSr~rtrus r4getMathEnclosureszUtilities.getMathEnclosuresrr6cdgSrrtrus r4getMathFencedSeparatorsz!Utilities.getMathFencedSeparators s t r6c ddgSrrtrus r4 getMathFenceszUtilities.getMathFences#s Bxr6cyr9rt)r2rRtests r4getMathNestingLevelzUtilities.getMathNestingLevel&sr6c gdS)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-tocformmain navigationregionsearchrtrs r4getLandmarkTypeszUtilities.getLandmarkTypes)s  r6c\tj|sytj|duSrs)ris_progress_barr get_value_as_percentrus r4 isProgressBarzUtilities.isProgressBarFs)**3/++C0<&>&@&R&R&TV Vr6ctjjdsGtjjds$tjjdsy|j|syt j |rytjjdr%t j|tjrytjjd }|tjk(ry |tjk(r|j|ry y |tjk(r>t j|}t!jj#}||k(ry yy)NspeakProgressBarUpdatesbrailleProgressBarUpdatesbeepProgressBarUpdates)FzUpdates not enabled)FzIs not progress bar)Fz Has no sizeignoreStatusBarProgressBars)FzIs status bar descendantprogressBarVerbosity)TzVerbosity is all)TzVerbosity is window)Fz%Top-level object is not active window)TzVerbosity is app)FzApp is not active app)TzNot handled by any other case)rr getSettingrr has_no_sizerrr is_status_barrPROGRESS_BAR_ALLPROGRESS_BAR_WINDOWrPROGRESS_BAR_APPLICATIONget_applicationrgetActiveScriptApp)r2rR verbosityapp activeApps r4isProgressBarUpdatezUtilities.isProgressBarUpdateOs3**,778QR#..0;;t jj@fvrd}n|t jjBt jj"fvrd}n||vrd}n|t jjk(r|t jjDk(}n|t jjDk(rd}no|t jjFk(rd}nN|t jjHk(rd}n-|t jjJt jjLfvrd}n|t jjNt jjPt jjRfvrd}n|t jjk(r!|t jjBk(rd}nb|t jjTt jjVfvrd}n(|jY|r.t'jZ|xst'j\| }n|t jj^k(rtj||vrd}n|t jj^k(r,tj`|tjb|rd}nitj |dk(rtj`||rd}n8|je|rd}n$|jg|s|ji|sd}|r*d|dg}tkjltjjn|d|S)zReturns True if the given object is a container which has no presentable information (label, name, displayed text, etc.).FTrr r>zis deemed to be layout only)8ris_validr get_parent get_child_topLevelRolesrrMENU MENU_ITEMr TREE_ITEMTABLEris_layout_table TABLE_CELLget_child_count TREE_TABLErr is_table_cell isLayoutOnlySECTIONr BLOCK_QUOTEFILLER SCROLL_PANE LAYERED_PANErr AUTOCOMPLETETEAROFF_MENU_ITEM SEPARATORLIST_BOXrrFORMr TOGGLE_BUTTONTEXT PASSWORD_TEXTENTRYREDUNDANT_OBJECTUNKNOWN isTableRowr is_selectablePANELhas_same_non_empty_namerrr*r)r rGrH) r2rR layoutOnlyr parentRole firstChild topLevelRolesignorePanelParentrUs r4rkzUtilities.isLayoutOnlyRsi   %  %&&x':':3'?@ ''Q/ ++- "ZZ__"ZZ11"ZZ11"ZZ113 5::## # 005J UZZ** *x/G/G/LUZZ222!)!2!23!77 **:6! uzz///!..x/B/B3/GH UZZ'' '!..s33J UZZ++ +J UZZ&& &J UZZ++ +J UZZ,, ,(;(;C(@AJ UZZ,, ,J ejj22EJJ4H4HI IJ ejj))5::+@+@A AJ ] "J UZZ__ $#uzz';';;J UZZ)) )J UZZ__ $J UZZ__ $J ejj,,ejj.F.FG GJ ejjoouzz'?'?AQAQR RJ UZZ)) )jEJJ>ctj|}tj|}t|t|k7ry|r|sy|dd}|dd}|ddk(r|ddk(r |dd}|dd}|jdr|jdry |j d}|d||d|k(S#t $r0 |j d}n#t $rt|}YnwxYwYCwxYw)NFr r)r)rget_pathrFcountindex ValueError)r2obj1obj2path1path2rs r4 _hasSamePathzUtilities._hasSamePaths!!$'!!$' u:U #%ab ab  9?uRyB#2JE#2JE ;;r?u{{2 #KKOEQu~q//  # # B #E  # #s6B,, C%6CC%CC%CC%$C%c||k(ry||ytj||sy|s,tj|tj|k7ry|s,tj|tj|k7ry|r|j ||ryt j||syt j|syyr) rhave_same_rolerrrTrrobjects_have_same_rectr)r2rr comparePaths ignoreNamesignoreDescriptionss r4rPzUtilities.isSameObjects 4< <4<))$5x006(:K:KD:QQ!''-1I1I$1OO D--dD911$=&&t,r6c|j|rytj|xs,tj|xstj|S)z{Returns True if obj is a GUI component that is for entering text. Arguments: - obj: an accessible F)rr is_text_inputis_text is_paragraphrus r4rzUtilities.isTextAreasN ;;s ((--""3'-'', -r6cfd}tjtjj}t t ||S)z,Return a list of the labels for this object.c:tjfd S)Nc|k(Sr~rt)r<accs r4rzBUtilities.labelsForObject..isNotAncestor..,s Q#Xr6r)rrRs`r4 isNotAncestorz0Utilities.labelsForObject..isNotAncestor+s--c3EFF Fr6)rrCrrDrzrfilter)r2rRrrGs ` r4rmzUtilities.labelsForObject(s; G..sE4F4F4R4RSF=&122r6cDy jjjS#t$rHjjjvr#ijjj<YnwxYwfd}g}t j |}|r*|j |t j ||}|r*t|}|jjj<jjjS)zmDetermines the nesting level of this object. Arguments: -obj: the Accessible object rcjrj|Stjr(tjt j |Stj |Sr~)rr is_list_itemrMrr_rr<rRr2s r4r=z$Utilities.nestingLevel..predAs_  %((++'',"**8+>+>q+ABB--c15 5r6)r/rj NESTING_LEVELrlrrrQrF)r2rRr= ancestorsrr,s`` r4r,zUtilities.nestingLevel1s ; E<<..t/A/AB3G G E!!)D)DDBD ++D,>,>? E 6 ))#t4   X &--h=H9~ ?K ##D$6$67<||**4+=+=>sCCs%-AA>=A>c|j|sy |jj|j|S#t$rH|j|jjvr#i|jj|j<YnwxYwg}|}d}|st j |tjj}d}|r|jd}|j|r-d|d|g}tjtj|dd}t|dkDr,d |g}tjtj|dd}n|r|j!|nd}|st|d z |jj|j|<|jj|j|S) zDetermines 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)FNrr>z#is already in the list of nodes forTdz/SCRIPT UTILITIES: More than 100 nodes found forr )r\r/rj NODE_LEVELrlrrMrrDrNrOrr rGrHrFrQ)r2rRrTnodedonerZrUs r4r-zUtilities.nodeLevelRs$$S) B<<..t?D D Bdll&A&AA?A ++DOO< B,,T53E3E3S3STHD**1- {{4 -t5Z\_`!!%"2"2FDA5zCKSQ!!%"2"2FDA T"),=@JN ##DOO4S9||**4??;C@@s%:AB  B c6tj|ry|j|rytj|rtj |sd|dg}t jt j|dtj|rltj|ddtj|r@tj |r+d|dg}t jt j|dyytj|r+d|d g}t jt j|dytj|ry|ytj||s,d|d |g}t jt j|dyy) NFr>zis not showing and visibleTz(Suspecting filler might have wrong statez WARNING: Nowzis showing and visiblezSCRIPT UTILITIES: Rect ofz"is unhelpful. Treating as onscreenznot in)ris_deadrr is_showing is_visibler rGrH is_filler clear_cacherhas_no_size_or_invalid_rectobject_is_off_screenobject_intersects_rect)r2rR boundingboxrUs r4 isOnScreenzUtilities.isOnScreensU   C  == &&s+ 0F0Fs0K)30LMF   e.. =$$S)$$S%1[\))#.;3I3I#3N,c3KLF%%e&6&6E  2 23 7138\]F   e.. =  + +C 0  11#{C)3+FF   e.. =r6cJtj|sytj|r|j |}|r|dSytj |D]G}tj |ddtj|stj|sE|cSy)NrF#Ensuring we have the correct state.) r is_menu_barrsupports_selectionselectedChildrenrrrA is_selected)r2menubarselectedmenus r4selectedMenuBarMenuzUtilities.selectedMenuBarMenus&&w/  & &w /,,W5H{"**73 D  u.S T&&t, 0G0G0M   r6c|ytj|tj}|y|jj t ||j|yfd}||rytj||duS)NFc|k(Sr~rt)r< selectedMenus r4inSelectedMenuz5Utilities.isInOpenMenuBarMenu..inSelectedMenus $ $r6T)rrrrr1rhashr)r2rRrrrs @r4isInOpenMenuBarMenuzUtilities.isInOpenMenuBarMenus ;((k.E.EF ?0044T']C  33G:$FFr6cyrsrtrus r4isStaticTextLeafzUtilities.isStaticTextLeafrwr6cyrsrtrus r4isListItemMarkerzUtilities.isListItemMarkerrwr6c|j|ryttjdt j |S)NFz\w+)rboolrerrrrus r4hasPresentableTextzUtilities.hasPresentableTexts4   %BIIff&9&9#&>?@@r6c Bj||sgStj|tjj k(rgSt j|st j|r|gSt j|r'j|jt|<t jtj|rj|s|gSt j|rtj |stj"|ddtj |}d|d|dg}t%j&t$j(|d|s)d|g}t%j&t$j(|d|t+j,|}tj.|r*tj0|rj3|}|r|Sg}tj4|xstj6|}|rz now reports z childrenz"WARNING: unexpectedly empty fillerc4|duxrj| Sr~)rr<r2s r4r=z*Utilities.getOnScreenObjects..preds D=A)>)>q)A%A Ar6)/rrrrrINVALIDr is_buttonrrrr1rr_rrrhrr rGrHrget_rectrrgetVisibleTableCellsrrT is_page_tabis_imagerQrrrgetOnScreenObjectsrJrrCANVASrnIMAGELINKrtr~rlroVIEWPORT) r2rextentsrrU visibleCellsobjects hasNameOrDescr=r containerss ` r4rzUtilities.getOnScreenObjectss"tW-I   T "ejj&8&8 8I   &+*B*B4*H6M  " "4 (484L4LT4RD % %d4j 1  " "8#6#6t#< =++D16M   &x/G/G/M  t-D E,,T2E)4<wi1PQF   e.. =>E!!%"2"2FDA ?!**40G  " "4 (X-H-H-N44T:L## ))$/Q83K3KD3Q k55d;{?S?STX?Y NN4  $ $T * NN4  B++D$7 DE NN4225'B C D  " "4 (48D % %d4j 1 N    %m@]@]^b@cIjj''jj''jj&&jjoojj))jj&&jj((jj,,jj))+    T "j 0Iv r6ctj|}|sytj|ytj|rytj |rytj tj|sytj|tj Dcgc]}|}}t||k(ryycc}w)z9Determines if obj is a table row -- real or functionally.FT) rrhr_r is_table_rowr"rrrF)rR childCountr<cellss r4r|zUtilities.isTableRow s--c2    s # +  # #C (  . .s 3##H$7$7$<=$223 8[8[\]q]] u: # ^s* Cctj|r|Sd}tj||}|:|jj j tj|s|}|S)NcZtj|xstj|Sr~)rr"rr;s r4r=z*Utilities.realActiveAncestor..pred>s$66q9X[=U=UVW=X Xr6)r is_focusedrrr/ utilitiesrkr_)r2rRr=rs r4realActiveAncestorzUtilities.realActiveAncestor:sb  ! !# &J Y))#t4  <<))66x7J7J87TUC r6ctj|rytj|s|Stj|r|Sfd}tj ||}||S|S)a2Given 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. Ncr|xr3j| xrj|jSr~)rr*striprs r4r=z,Utilities.realActiveDescendant..pred[s5WT22155W$:L:LQ:O:U:U:W Wr6)rrrrjrfind_descendant)r2rRr=rs` r4realActiveDescendantzUtilities.realActiveDescendantHsf   C ((-J   S !J X((d3  L r6cT|ytj|tjduSrs)rrrrrus r4isStatusBarDescendantzUtilities.isStatusBarDescendantds( ;%%c;+D+DETQQr6ctj|sgStj}|jjj d}|s@d}t t||j|}||jjd<tj}d||z d}tjtj|d|S)NstatusBarItemsc.tj| Sr~)rrr;s r4includez)Utilities.statusBarItems..includers&44Q777r6z1SCRIPT UTILITIES: Time getting status bar items: z.4fT) rrtimer/r,rrrrr rrH)r2rRritemsrendrs r4rzUtilities.statusBarItemsjs((-I  --112BC 8)@)@)EFGE>CDLL ) )*: ;iikA#+cARS 5++S$7 r6cyr~rtrs r4infoBarzUtilities.infoBar~rr6cDtjjtjjtjjtjj g}|j r)|jtjj|Sr~) rrrrrrrrQr)r2roless r4razUtilities._topLevelRolessf""((!!""$  % % ' LL)) * r6ctjj}|sy||j|k(}d|d|g}t j tj |d|S)NFr>zis top-level object:T)r rrrr rGrH)r2rrrUs r4_locusOfFocusIsTopLevelObjectz'Utilities._locusOfFocusIsTopLevelObjects`((*==? d))%0 0%u.DbI %**FD9 r6ctj}|yttj|D]}tj||}tj |fd/d|dg}t jt j|d|cSd|dg}t jt j|dy)zSearches each frame/window/dialog of an application to find the one which contains child. This is extremely non-performant and should only be used to work around broken accessibility trees where topLevelObject fails.Nc|k(Sr~rt)r<rs r4rz5Utilities._findWindowWithDescendant..s !u*r6r>containsTzdoes not contain) rrrJrhr`rr rGrH)r2rrrXrrUs ` r4_findWindowWithDescendantz#Utilities._findWindowWithDescendants &&u- ;x//45 >A''Q/F''0DEQ-vz5I!!%"2"2FDA )63EuMF   e.. = >r6ctj||jvxrCtjtj|tj j k(Sr~)rrrar_rr APPLICATIONrus r4_isTopLevelObjectzUtilities._isTopLevelObjectsR  %)<)<)>>V!!("5"5c":;uzz?U?UU Vr6c<|j|r|}n tj||j}d|d|g}tjtj |d|:|r8d}tj tj |d|j|}|S)zReturns the top-level object (frame, dialog ...) containing obj, or None if obj is not inside a top-level object. Arguments: - obj: the Accessible object r>zis top-level object for:TzISCRIPT UTILITIES: Attempting to find top-level object via fallback search)rrrr rGrHrr)r2rRuseFallbackSearchrrUrs r4rzUtilities.topLevelObjects  ! !# &B''T-C-CDB%r+EsK %**FD9 :+]C   u//d ;//4B r6cb|xs"tjj}|j|}|syt j |ddt j|rt j|ry|j|tjjsyy)NFrT) r rrrrrr is_active is_defunctrPr)r2rRrs r4 topLevelObjectIsActiveAndCurrentz*Utilities.topLevelObjectIsActiveAndCurrentsD]--/BBD&&s+Xu.ST$$X.+2H2H2R  =+C+C+E+W+W+YZr6c||k(rytt|t|}|dg|zzd|}|dg|zzd|}ttt|t|D]}||||kry||||kDsyy)zpCompares the two paths and returns -1, 0, or 1 to indicate if path1 is before, the same, or after path2.rr)Nr )maxrFrJrb)rrsizer<s r4pathComparisonzUtilities.pathComparisons E>3u:s5z*"$et,"$et,s3u:s5z23 AQx%("Qx%("   r6c0tj|||Sr~)rfind_all_descendants)r2r includeIf excludeIfs r4rzUtilities.findAllDescendantss,,T9iHHr6c  |jjr'|jjj|rgStjj tjj g tjjtjjtjjtjjtjjtjjtjjtjjtjjg fd} fd}|j!|||}t#j$|}g}|D]} t#j$| xs|j'| } | r-| |t#j$t#j(| fvrZt+| j-|krw|j/| dk\r|j1| t3j4|S)aReturns 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|rtj|vsytj|ryrtj|syyrY)rr get_relationsrr)r< labelRolesrs r4rz+Utilities.unrelatedLabels.._includesB(++A.*<%%a(;#9#9!#<r6cj|rtj|vryrtj|syyr)rrrr)r<r skipRoless r4rz+Utilities.unrelatedLabels.._excludes1))!, 9;#9#9!#<r6r)r/ spellcheck isCheckWindowrrrSTATICrrtrbMENU_BARro SPLIT_PANEreTREErirrrr*r_rFsplitfindrQrsort_objects_by_position) r2rrrrrrprootNamelabels_filteredrqrr(r*s ` @@r4rzUtilities.unrelatedLabelss << " "t||'>'>'L'LT'RIjj&& (9(9: ZZ))ZZ((ZZ__ZZ((ZZ++ZZ**ZZ%%ZZ__ZZ**,   ((xB$$T* *E$$U+Ht/A/A%/HD8+<+.isDialog;s)$$Q'50ND4K4KA4N Nr6ctj|xrCtj|xr,tj|xstj |Sr~)rrrrrrhr;s r4 isPresentablez=Utilities.unfocusedAlertAndDialogCount..isPresentableAsM))!,J1G1G1JJ&&q)HX-E-Ea-H Jr6cJtjj| Sr~)r rcan_be_active_windowr;s r4cannotBeActiveWindowzDUtilities.unfocusedAlertAndDialogCount..cannotBeActiveWindowEs$//1FFqII Ir6)rrrrrQrrrrrrrrsetrF) r2rRrr<dialogsr:r= presentable unfocusedr s ` @r4unfocusedAlertAndDialogCountz&Utilities.unfocusedAlertAndDialogCount+s""#  % % ' LL)) * O'44X5M5Mc5RT\]^1^^8#9#9$:M:Mc:RT\#]^a^_ J J6-W>?  4kBC 9~_^s  D Dctj|sytj|tjj }|r|j dStj|S)z!Finds the object before this one.Nr)rr^rMrrD FLOWS_FROMrOget_previous_objectr2rRrZs r4findPreviousObjectzUtilities.findPreviousObjectRsX  %((e.@.@.K.KL &&q) )++C00r6ctj|sytj|tjj }|r|j dStj|S)z Finds the object after this one.Nr)rr^rMrrDFLOWS_TOrOget_next_objectrFs r4findNextObjectzUtilities.findNextObject^sX  %((e.@.@.I.IJ &&q) )'',,r6ctj|\}}}|r*|jjj dr|||fS|j |r|||fS|j |}|r6tj|d}|sn|d|}|j |}|r6|j|}|r6tj|d}|sn|d|}|j|}|r6|||fS)aGet 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. entireDocumentSelectedrr)rget_selected_textr/r,rr'rGrK)r2rR textContents startOffset endOffsetr9 selectionnextObjs r4allSelectedTextzUtilities.allSelectedTextjs06/G/G/L, k9 DLL99==>VWi7 7  ! !# &i7 7))#.009!>>> != 5++S$7  ' ' 5((6F:FCH!!%"2"2FDAbz!C 5++S$7r6cxtjj}tj|}||fSr~)r rrrget_caret_offsetrs r4rzUtilities.getCaretContexts3&&(;;=((-F{r6c |dfSr9rtrus r4getFirstCaretPositionzUtilities.getFirstCaretPositions Av r6crtjjd|d|j||yrs)r rset_locus_of_focussetCaretOffset)r2rRrrs r4setCaretPositionzUtilities.setCaretPositions-  "55dCG C(r6c0tj||yr~)rset_caret_offsetrs r4rtzUtilities.setCaretOffsetsV,r6c0tj|||Sr~)r get_substring)r2rRrPrQs r4rVzUtilities.substrings##Ci@@r6cp|jjjD]\}}||k(s |cS|S)aConverts 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)r2 attribNamekeyvalues r4getAppNameForAttributez Utilities.getAppNameForAttributes?,,99??A JC "  r6cN|jjj||S)aaConverts the given attribute name into the Atk equivalent. This is necessary because an application or toolkit (e.g. Gecko) might invent entirely new names for the same attributes. Arguments: - attribName: The name of the text attribute Returns the Atk equivalent name if found or attribName otherwise. )r/r{r)r2r|s r4getAtkNameForAttributez Utilities.getAtkNameForAttributes!||..22:zJJr6c.tj||Sr~)rget_text_attributes_at_offset)r2rr get_defaultss r4textAttributeszUtilities.textAttributes s33C@@r6cD|dk(r#|dk(st|dkDrtjS|jds|dk(rtjSt j ||j}|dk(r2|jddjjd}n|r||jd rk|jd d}tjd |vrtjt|}ntjt|}nw|jd rF|j|\}}}tj rt#j$|||}n)d |||fz}n t j ||j}|d |S)Nweightboldispellingz family-name,r"px decimal_pointcolorz%i %i %iz: )intrBOLDendswith MISSPELLEDrgetTextAttributeNamer/r1rlocale localeconv pixelCountfloat rgbFromStringr useColorNamesr rgbToName)r2r}r~ localizedKeylocalizedValuergrds r4localizeTextAttributezUtilities.localizeTextAttributes^ (?3u:3C== << #u ':&& &+@@dllS - "[[-a0668>>sCN u~~d+KK%a(E  "?3u!+q!Qi!71FFudll[Nr.!122r6cg}|j|||}|D]V\}}}} ||k\r||kr|St||}t||}|j|||} |j ||| || gX|S)zAReturns a list of (start, end, string, language, dialect) tuples.)'getLanguageAndDialectFromTextAttributesrrbrVrQ) r2rRrr r allSubstringsrPrQlanguagedialectrs r4splitSubstringByLanguagez"Utilities.splitSubstringByLanguage,sDDS%QTU 9F K 5KHg !k!  e[1KC+I^^Ci@F II{IvxI J K r6cd|j|||}|D]\}}}}||ks||k\s||fcSy)zReturns 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) r2rRrr rrPrQrrs r4!getLanguageAndDialectForSubstringz+Utilities.getLanguageAndDialectForSubstring=sP DDS%QTU 9F ) 5KHge# S(8(( )r6cg}tj|||}dx}}|D]h\}} } | jdd} d} d| vr| jdd\} } |r|| k(r|| k(r|dd| | | f|d<n|j || | | f| | }}j|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)rget_all_text_attributesrr1rQ) r2rRrPrQr attributeSet lastLanguage lastDialectrr rrrs r4rz1Utilities.getLanguageAndDialectFromTextAttributesIs55c; R %'' {#/ : UCyyR0HGh$,NN3$:!'lh.;'3IBC7:2 5#x9:(0'+L : r6c2tjj}|rtjsyt |j dk7s|jtjzrytj|rytj|ryy)zGiven a keyboard event containing an alphanumeric key, determine if the script is likely to echo it as a character. Fr T) r rrrenableEchoByCharacterrF event_string modifiersrORCA_CTRL_MODIFIER_MASKrrlr)r2rrs r4willEchoCharacterzUtilities.willEchoCharacter]sv ((*==?H:: u!! "a 'oo C CC  ' ' .  " "5 )r6c|jr||zSt|}|tjk\r@|d|jj vr%|d}t j||}|d|d}|S||z }|S)auAdd 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. Returns: the current built-up line plus the new segment, after adjusting for repeat character counts and punctuation. rr)isalnumrFrrepeatCharacterLimitr/ whitespacerrepeatedCharCount)r2segmentliner repeatChar repeatSegments r4_addRepeatSegmentzUtilities._addRepeatSegmentxs ?? '> !G  H11 1gaj H_H_6_ J$66z5IMV1]O1-D  GOD r6c|j|s|j|sytjj d}|t j t jfvryy)NFverbalizePunctuationStyleT)rrrrrrPUNCTUATION_STYLE_ALLPUNCTUATION_STYLE_NONE)r2rRstyles r4shouldVerbalizeAllPunctuationz'Utilities.shouldVerbalizeAllPunctuationsY C D$9$9#$> !++-889TU X33X5T5TU Ur6c|}ttj|j|D]"}d|d}tjd|z||}$|S)Nrz\%s)r>rfindall PUNCTUATIONsub)r2rrGsymbolcharNames r4verbalizeAllPunctuationz!Utilities.verbalizeAllPunctuationsV"**T%5%5v>? ?F6(!}HVVFVOXv>F ? r6c|t|z}tj|||}|Dcgc]}tj|}}t |Dcgc]}||z  c}d}t |} |D]@} dt j} | t| kr| | jr| dz } | | | | Bdj| Scc}wcc}w)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. T)rarr') rFrget_all_links_in_rangeget_link_end_offsetsortedrrrrr) r2rRrrPrQlinkslinkoffsetsrrUors r4adjustForLinkszUtilities.adjustForLinkss #d)+ 223 YOEJKT;2248KKWE6&;.EtTd !A(F3v;6!9#4#4#6#  F1QK  ! wwvLEs C C c0tjdd|S)Nz(?<=[a-z])(?=[A-Z])r)rr)rs r4_processMultiCaseStringz!Utilities._processMultiCaseStringsvv,c6::r6cZ|js|Sdjt|S)Nr) isnumericrr)words r4_convertWordToDigitszUtilities._convertWordToDigitss$~~KxxT ##r6c|jdd}tjr|j|}|j rt j |}tjr@|jj|}djt|j|}|j|}t|dk(rF|jj!s,|j#rt j$|}||k7r|Stj&s|Sd}|jj|}djtt(j*|}tjr|j|}|S)a@Adjust the line to replace words in the pronunciation dictionary, with what those words actually sound like. Arguments: - line: the string to adjust for words in the pronunciation dictionary. Returns: a new line adjusted for words found in the pronunciation dictionary.  rr'r )replacerspeakMultiCaseStringsAsWordsrrradjustForSpeechspeakNumbersAsDigitsWORDS_REr1rrradjustForDigitsrFr/r6rgetCharacterNameusePronunciationDictionaryrgetPronunciation)r2rwordscharnamenewLines r4adjustForPronunciationz Utilities.adjustForPronunciations1||Hc*  0 0//5D  $ $ &..t4D  ( (MM''-E773t88%@AD##D) t9>$,,"7"7"9dmmo"33D9H422K ##D)''#0AA5IJ  0 0227;Gr6c t|dkstjdkr|Sd}|dx}}tdt|D]/}|||k(r |||z }n|j ||}||}||}1|j ||S)aAdjust 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 = If is 0, then there would be no repeat characters. Otherwise 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'rr )rFrrrJr)r2rrrlastCharrXs r4adjustForRepeatszUtilities.adjustForRepeatss& IMx<rr SUBSCRIPTS_RESUPERSCRIPTS_RErSUPERSCRIPT_DIGITSrrDIGITS_SUPERSCRIPTrrSUBSCRIPT_DIGITSDIGITS_SUBSCRIPT)r2r subscripted superscriptednumberdnew newStrings r4rzUtilities.adjustForDigits s"**T%7%7@A BJJt';';VDE # 7FBHIQ3t..44Q78ICI 33bggclBIVVFIv6F 7 " 7F@FG13t,,22156GCG 11BGGCL@IVVFIv6F 7  J Hs +D7 +D<ctjjds#tjjdsy|jdd}t j d|}|r|d|j }d}t jd|Dcgc]}|j}}t jd|Dcgc]}|j}}t||z}|D]H\}}||f|vr|tj||z dz }+|tj||z dz }J|Scc}wcc}w) NonlySpeakDisplayedTextenableSpeechIndentationr'rrz[^ ]z +z +) rrrrrrrfinditerspanrr spacesCount tabsCount) r2rr rGmspacestabsspansrs r4indentationDescriptionz Utilities.indentationDescription5 s7  & & ( 3 34L M"--/::;TU||Hc*ii$'  %D$&KKd$;?qAAX//e <=Q??  @  =;s EE cddlm}|jjj }|j \}}}}||fS)z0Gets the absolute position of the mouse pointer.rr) gi.repositoryrWindow get_screenget_root_window get_pointer)r rootWindowrr<yrs r4absoluteMouseCoordinatesz"Utilities.absoluteMouseCoordinatesK sF &SZZ\,,.>>@ ","8"8":1i!t r6c"|s|S|s|S||z|zS)zAppends 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.rt)rUnewText delimiters r4rnzUtilities.appendStringU s$ KNi'))r6c"|r|sy||k(ry|j|jk(xrj|j|jk(xrO|j|jk(xr4|j|jk(xr|j|jk(Srs)rtypedetail1detail2rh)r2event1event2s r4treatAsDuplicateEventzUtilities.treatAsDuplicateEventb s6 V }} -3 v{{*3&..03&..036??2  3r6c$|jjdr|jr |jsyt j |jsyt j |jsyt j|jrAtj|jddt j|jsy|j\}}|dk(r|jdk7ry|dk(r|jdk7ry|d vr|j|jS|jsytj|j}|j!|jrtj"|j\}}}||jk(ry||jk(rR|j!|rA|d |j%|}|j'j!|j'Sy) zReturns 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:insertFrTab TReturn )UpDownPage_Up Page_DownN)r startswithrhrrrrrrrrlastKeyAndModifiersisEditableDescendantOfComboBoxlastInputEventWasPrintableKeyrrrrNr2lower) r2rlastKeymodsrrRrr  beginnings r4isAutoTextEventzUtilities.isAutoTextEventp s :: != >>>**5<<8))%,,7'' 5$$U\\5:_`"--ell;  446MGT%ENNd$:("u~~'=@@::5<<HH557((6Fu~~.(.(@(@(N% 5#.U^^+ 0J &'> I(> ?I$??,55gmmoFFr6cT|dk(s|dk(ry||jjvxr|dvS)aReturns 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.  rTz!.?:;)r/r)r2 currentChar previousChars r4isSentenceDelimiterzUtilities.isSentenceDelimiter s: $ +"5dll555+7* +r6ct||jjvxs|dvxs||jjk(S)zReturns 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/rNO_BREAK_SPACE_CHARACTER)r2 characters r4isWordDelimiterzUtilities.isWordDelimiter sCDLL333E88Et||DDD Er6ctjj}|j|d}t t tj t|Sr)rKeymap get_defaultget_entries_for_keycoderr keyval_namer>)keycodekeymapentriess r4_allNamesForKeyCodezUtilities._allNamesForKeyCode sC'')009"=CW677r6cttjtjsytj }|r|j |jfSy)N)rr)rrlastInputEventr KeyboardEventlastNonModifierKeyEventhw_coder)rs r4_lastKeyCodeAndModifiersz"Utilities._lastKeyCodeAndModifiers s?*33[5N5NO22 ==%//1 1r6c,ttjtjretj rUtj }|j dvr |j }n |j}tjj}||fSd}d}||fS)zConvenience 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.) BackSpaceDeleter'r) rrr?rr@rAr9rr)reventStrr)s r4r$zUtilities.lastKeyAndModifiers s j//1J1J K1166E  $;; ,, --,,66D $HD$r6cX ddlm}|j|\}}|j||}|r$|j dr|j dr|}tj|S#t $r5|j dd}|j ddj}YRwxYw) z3Turns a key sequence into a user-presentable label.rr+z++r) rraccelerator_parseaccelerator_get_labelrrlrrr localizeKeySequence)sequencerr}r) newSequences r4labelFromKeySequencezUtilities.labelFromKeySequence s : )---h7IC3#33C>K((-1E1Ed1K& ++H55  :''R0H''S1779H :sAA++;B)(B)cV |jj|j|S#t$rH|j|jjvr#i|jj|j<YnwxYwt j |d}|sNgd|jj|j|<|jj|j|S|j d}t|dk(r|d}|d}|d}n3t|dkDrd}|d} |d}n#t$rd}Yn wxYwd}d}d}|jdd j}|j|}|j|}|j|}|j|jjvr#i|jj|j<|||g|jj|j|<|jj|j|S) a2Gets 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/rj KEY_BINDINGrlrget_action_key_bindingr1rFrrrQ)r2rR keybindingbindingStringsmnemonic fullShortcut accelerators r4mnemonicShortcutAcceleratorz%Utilities.mnemonicShortcutAccelerator s C<<..t/?/?@E E Ct||'B'BB@B ++D,<,<= C44S!< AMDLL ' '(8(8 9# ><<..t/?/?@E E$))#. ~ ! #+A.H+A.L+A.K  1 $H+A.L !,Q/  !  ! HLK#++C5;;= 00> ,,X6// <   4<<#>#> ><>DLL ' '(8(8 9|[ 1 ##D$4$45c:||**4+;+;:; 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 :; 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. rSrVrUr)r1rrFdictrl)rsritemkeys dictionarys r4stringToKeysAndDictzUtilities.stringToKeysAndDict+ s (. S(9:1QWWY:E:&+Ids4::c?/Cq/HTIEI;@A4DJJsOA&,,.ADA5A4tzz#ABJj!!;IAA r6M sJC B6C "B;B;C )C C C+C 6C CCc t|dS#t$r&tjtjYywxYw)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 04xr')ordrlr printException LEVEL_WARNING)r3s r4unicodeValueStringzUtilities.unicodeValueStringD s< )nS) *   !4!4 5 s ,>>cgSr~rt)r2rRr layoutModeuseCaches r4getLineContentsAtOffsetz!Utilities.getLineContentsAtOffsetT rr6cgSr~rt)r2rRrrns r4getObjectContentsAtOffsetz#Utilities.getObjectContentsAtOffsetW rr6c:|s|j\}}||dz fSNr rr2rRr skipSpaces r4previousContextzUtilities.previousContextZ %..0KCFQJr6c:|s|j\}}||dzfSrsrtrus r4 nextContextzUtilities.nextContext` rxr6cNtdtj|dz }||fSNrr )rrget_character_count)r2rrs r4 lastContextzUtilities.lastContextf s(Q22481<=V|r6c\tj|}|r|Sd}tjtj|dt j |}|tjjk(r"|s |j|tj}|tjjk(ry|rwt j |dtjjk(rD|j|d}t j||srfd}|j||}|S)NzJSCRIPT UTILITIES: Selected children not retrieved via selection interface.Trc4tj|k(Sr~)rr)r<rs r4r=z(Utilities.selectedChildren..pred{ s#,,Q/477r6)rget_selected_childrenr rrHrrrrrbrrrrrr)r2rRchildrenrrr=rs @r4rzUtilities.selectedChildrenj s44S9 OZ 5++S$7  % 5::?? "8..sK4K4KLH 5::'' 'H--hqk:ejjooM,,Xa[9H$$S)D8 223=r6cyrsrtrus r4speakSelectedCellRangez Utilities.speakSelectedCellRange rwr6c |sy|j|rytj|r|Stjj tjj gtjjtjj gtjjtjjgtjjtjjtjjgtjjtjjtjjgtjjtjjtjjgi}|j!tj"|fd}tj$||S)Ncbrtj|vrytj|Srs)rrr)r< matchingRoless r4isMatchz0Utilities.getSelectionContainer..isMatch s,!2!21!5]!J..q1 1r6)rrrrrrrpICONrrtrdr0rirgrerYrrr)r2rRrolemaprrs @r4getSelectionContainerzUtilities.getSelectionContainer s1 ??3   & &s +J JJ   7 78 JJOOejj556 JJ 5::#6#6"7 JJ 5::??EJJ4I4I"J JJ ! !EJJ$4$4ejj6K6K#L JJ 5::#3#3UZZ5J5J"K   H$5$5c$:;  2 %%c733r6c tj|sytj|r!tj|}t d|St jjt jjgt jjt jjgitj|vrtj|Sfd}t|j||S)NrcPtj|jvSr~)rrr)r<rrs r4rz/Utilities.selectableChildCount..isMatch s"$$Q'7;;t+<< dJJr6cjtjjtjjfSr~)rrrrrs r4_contextMenuParentRolesz!Utilities._contextMenuParentRoles s!zz!2!222r6ctj|sytjtj||j vSrs)rrrrr_rrus r4rzUtilities.isContextMenu s=""3'  !4!4S!9:d>Z>Z>\\\r6c|tj|sytj||j |k(Srs)rrrr_rrus r4isTopLevelMenuzUtilities.isTopLevelMenu s4""3'""3'4+>+>s+CCCr6ctj|sytj|sytj|Srs)rrsupports_autocompletionis_single_linerus r4isSingleLineAutocompleteEntryz'Utilities.isSingleLineAutocompleteEntry s5##C(2237))#..r6cyrsrtrus r4isEntryCompletionPopupItemz$Utilities.isEntryCompletionPopupItem rwr6ctj|sytj||jDcgc]}|}}t |dk(r|dSycc}w)Nr r)rrrrisEditableTextArearF)r2rRr<rs r4getEntryForEditableComboBoxz%Utilities.getEntryForEditableComboBox sX'','55c4;R;RST!ATT x=A A;  Us Ac(|j|duSr~)rrus r4isEditableComboBoxzUtilities.isEditableComboBox s//4D@@r6cztj|sytj|tjduSrs)rrrrrrus r4r%z(Utilities.isEditableDescendantOfComboBox s1&&s+%%c;+C+CDDPPr6ctj|s|j|S|j|}|r|j|S|jj j |}|xs9|jj j tj|d}t|dk(r%|djxs|j|dS|j|Sr|) rrhr*rr/rrr`rFr)r2rRentryrs r4getComboBoxValuezUtilities.getComboBoxValue s'',%%c* *005 %%e, ,<<))::3?bt||55FFxGYGYZ]_`Gab x=A A;##Ft'9'9(1+'F F!!#&&r6cyrsrtrus r4 isPopOverzUtilities.isPopOver+ rwr6cR|j|sytj| Srs)rris_modalrus r4isNonModalPopOverzUtilities.isNonModalPopOver. s%~~c"'',,,r6cyrsrtrus r4isUselessPanelzUtilities.isUselessPanel3 rwr6ctjdtj}tj|d|}|j d\}}}t |t |t |fS)Nz rgb|[^\w,]r'r)rcompile IGNORECASErr1r)r2attributeValueregexrredgreenblues r4rzUtilities.rgbFromString6 sV ="--8r>2!<<,UD3xUSY..r6cyrsrtrus r4isClickableElementzUtilities.isClickableElement= rwr6cyrsrtrus r4 hasLongDesczUtilities.hasLongDesc@ rwr6cyrsrtrus r4 hasDetailszUtilities.hasDetailsC rwr6cyrsrtrus r4 isDetailszUtilities.isDetailsF rwr6cgSr~rtrus r4 detailsForzUtilities.detailsForI rr6cyrsrtrus r4hasVisibleCaptionzUtilities.hasVisibleCaptionL rwr6cyrrtrus r4 popupTypezUtilities.popupTypeO rr6c8tj|sytj| }tj||} t |j dd}|S#t$r/d|d|dg}tjtj|dYywxYw)Nrlevel0z-SCRIPT UTILITIES: Exception getting value for()T) r is_headingrrrrrrr rGrH)r2rR use_cacherr~rUs r4 headingLevelzUtilities.headingLevelR s%%c*#//44 ,,S)<  '3/0E   EsCQVX[\F   e.. = sA!!5BBcztj|dxs$tj|tjS)Ntoggle)r has_actionr ACTION_TOGGLErus r4hasMeaningfulToggleActionz#Utilities.hasMeaningfulToggleActionb s5""31I""3(9(G(GH Ir6cxtj|r|Stj|tjSr~)ris_table_headerrrrus r4containingTableHeaderzUtilities.containingTableHeaderf s.  & &s +J%%c;+F+FGGr6c,tj|Sr~ris_indeterminaterus r4setSizeUnknownzUtilities.setSizeUnknownl rbr6c,tj|Sr~rrus r4rowOrColumnCountUnknownz!Utilities.rowOrColumnCountUnknowno rbr6c|ytj|rytj|xstj| Srs)rrrrrrus r4_boundsIncludeChildrenz Utilities._boundsIncludeChildrenr s? ;  " "3 ''',L 0G0G0LMMr6cyrsrtrus r4 treatAsEntryzUtilities.treatAsEntry{ rwr6c|tj|rytj|sytj|stj |rytj |r&tj|tjduStj|rtj|rytj|rtj| Stj|ryyrY)rrrhris_autocompleterrrrrr is_expandablerArrus r4_treatAsLeafNodezUtilities._treatAsLeafNode~ s ;(**3/'',  & &s +{/G/G/L  # #C (++C1E1EF$N N   s #(9(9#(>  $ $S )"..s33 3   %r6c|sytj|sytj|}t t d|j d}t|dkDS)NFc"|jSr~)rr;s r4rz2Utilities.isMultiParagraphObject.. s qwwyr6z r )r supports_textrrrrr1rF)r2rRrchunkss r4isMultiParagraphObjectz Utilities.isMultiParagraphObject sR%%c*$$S)f0&,,v2FGH6{Qr6c tj||\}}}|jjj dd\}}||k7r|||fStj||\}} } |jjj ddk(r|j r|}|}n|j r|}|}tj|||}|jdd} d|d| d |d |d } tjtj| d |||fS|j r.|}|d js|d jsl|dz}nf|j rV|}||k7r| |cxkr| krnn| }tj||dz |} | js| js|dz }tj|||}d|vr2||k(r-|jdr|dz }n|jdr|dz}tj|||}|jdd} d|d| d |d |d } tjtj| d |||fS)NpenultimateCursorPositionrlastTextUnitSpokenrrz\nz*SCRIPT UTILITIES: Adjusted word at offset z for ongoing word nav is '' (rrTr)r z for new word nav is ')rget_word_at_offsetr/r,rlastInputEventWasPrevWordNavlastInputEventWasNextWordNavryrr rrHisspacerr#r)r2rRrrrr r9 prevOffsetprevWord prevStartprevEnd debugStringrrs r4$getWordAtOffsetAdjustedForNavigationz.Utilities.getWordAtOffsetAdjustedForNavigation s!44S&AeS"ll;;?? '5 c># #(.'@'@*'U$)W << ( ( , ,-A Bf L002 224"''UC8D,,tU3K> >!'!=!=c1a!H FE3 //:: :!'!9!9#q!!D FE3 //44 4!'!>!>sAq!I FE3uc> ! u--88 8''UC8zz|#$$ T[00$?FdNt$$5#% % u--22 25#% %Q5+A+A+F+FG 7d?tAwa0A5Kuc!!r6cHtj|}d|d|dg}tjtj|dt j ||j|jdz}tj|dd}td|}d |d |g}tjtj|dt j|}t j ||j|j|jzdz}|tj|ddft||} d |d |d g}tjtj|dt j ||j|j|jzdz }tj|dd}d |d |d g}tjtj|d|dk(r|}|} tt| | } || vr| jd|| S)NzSCRIPT UTILITIES: zhas z rowsTr Fr?rzSCRIPT UTILITIES: First cell:z(row: zSCRIPT UTILITIES: Next cell:rzSCRIPT UTILITIES: Last cell:r))rrKr rGrHrget_descendant_at_pointr<r rIrrrrrJinsert) r2rR table_rectnRowsrUrYrV startIndex cell_rect nextIndexendIndexrs r4 visibleRowszUtilities.visibleRows s%%c*&tE7%-@A %**FD9223 jllUVFVW**4%HKC[ 146#H %**FD9 ((. 22 z||i.>.>>BD W ) )$ G JJ C( 0$&QH %**FD922 z||j.?.??!CE**4%HK0$&QH %**FD9 "9CE)X./ T ! KK: & r6ctj|sgS|j|tj|}|sgS|j |\}}||k(rgSg}t ||D]}g}|D]}tj|||} | |s?tj| }|r(|j|dr|j|d|j| sp|j| |Sr9) rrr&rr_getTableRowRangerJrrLget_column_headersrrQ) r2rRr colStartIndex colEndIndexrrWheadersrVrYs r4rzUtilities.getVisibleTableCells9 s&&s+I[%9%9#%>?I%)%;%;C%@" { K 'I 4 'CG '**3S9< &88>G4??71:#> WQZ0??4(LL& ' '$ r6ctj|}|ytj|d}d|}}|j|s||fSt j |}t j ||jdz|j}|rtj|dd}|}t j ||j|jzdz |j}|rtj|dd}|dz}||fS)Nr)r)Frr r?) rrBget_column_countr'rrrr<r rIr) r2rRr: columnCountr"r%rrYrs r4r(zUtilities._getTableRowRangeZ s!!#& =..ue<  +H %%c*x' '##E*225$&&1*dffM 11$OPQRFJ225$&&4:::MPQ:QSWSYSYZ 11$OPQRFzH8##r6c~tj|dd}|dk(rgStj|}|rdtj|}}n|j |\}}||k(rgSg}t ||D]@}tj |||} tj| s0|j| B|S)NFr?rr)) rrIrBr/r(rJrLrrrQ) r2rR forceFullRowrVr:r"r%rrXrYs r4getShowingCellsInSameRowz"Utilities.getShowingCellsInSameRowq s**3GJ "9I!!#& #$g&>&>u&EJ#'#9#9##> J  !Iz8, #A&&uc15D%%d+ T" #  r6cddd|g}tjtj|d|rsytj|stj |ryfd}||r|}nt j||}d|dg}tjtj|d|S)Nz-SCRIPT UTILITIES: Searching for replicant forinTc.j|ddS)NT)rr)rPrs r4isSamez'Utilities.findReplicant..isSame s$$Q$D$Q Qr6zHACK: Returningzas replicant for invalid object)r rGrHrr is_embeddedrr)r2rrRrUr7 replicants` ` r4 findReplicantzUtilities.findReplicant sA3dS %**FD9    %)@)@)F R $<I 00v>I#Y0QSVW %**FD9r6ctj|tjj}|r|j Stj |Sr~)rrMrrDrE get_n_targetsrhrFs r4getFunctionalChildCountz!Utilities.getFunctionalChildCount sC((e.@.@.O.OP ))+ +'',,r6c\tj|tjj}|r|S|j |r|j |S|j|r |j|j|Stj|Dcgc]}|c}Scc}wr~) rrCrrDrErrr valuesForTerm termForValuer)r2rRsiblingrGr<s r4getFunctionalChildrenzUtilities.getFunctionalChildren s..sE4F4F4U4UV M  % %g .,,S1 1  , ,W 5%%d&7&7&@A A#11#67a777s B)ctj|tjj}|r|j dStj |Sr9)rrMrrDrNrOr_rFs r4getFunctionalParentzUtilities.getFunctionalParent sE((e.@.@.N.NO &&q) )""3''r6c 8 |ytj|rU|jdrDtj|d}tj tj |}||fStj|rJ|j|}|r|d}n1d}|jtj||}|r|d}ny|j|}|j|}|dkDr/|tj|k(rtj||fS|j||} t!| dkrrtj"|tjsNt$j&j(t$j&j*g fd} t-t/| | } | r|| vsy|j1|r.t-t/|j0| } t!| dk(ry| j3|} t!| } | | fS)Nr. readingRowrcZtj|xstj|Sr~)rr is_list_boxr;s r4isMenuz/Utilities.getPositionAndSetSize..isMenu s#&..q1O[5L5LQ5OOr6rc`tj|xrtj|vSr~)rr^r)r< layoutRoless r4isNotLayoutOnlyz8Utilities.getPositionAndSetSize..isNotLayoutOnly s)((+W0A0A!0DK0WWr6r )rrjrrrIrKrBrrrrrDr=r_r:rBrFrrrrsrrrrrKr)r2rRargsrVrowcountrrIrSrsiblingsrLpositionsetSizerKs @r4getPositionAndSetSizezUtilities.getPositionAndSetSize s ;  $ $S )dhh|.D..s3A6C,,W->->s-CDH=  # #C (,,S1HqkP 001I1I#v1VW"1+C!))#.11&9  (*=*=c*B B//4j@ @--fc: x=3 x'='=c;C[C['\ :://1M1MNK XF?H=>HSH_   %F4#8#8(CDH8}!>>#&h-  r6c|j|sy|r:|j|s)tj|}|r|j|s)|Sr~)rrrget_previous_siblingrus r4r@zUtilities.termForValue sL005$44S9//4C$44S9 r6c|j|sgSg}tj|}|rK|j|r:|j |tj|}|r|j|r:|Sr~)rrget_next_siblingrrQ)r2rRvaluess r4r?zUtilities.valuesForTerm so))#.I'',d77< MM# ++C0Cd77< r6c6t|j|Sr~)rFr?rus r4getValueCountForTermzUtilities.getValueCountForTerm s4%%c*++r6cyrrt)r2rR isBrailles r4getRoleDescriptionzUtilities.getRoleDescription rr6c |jjjdi}|jt|d\}}}d|d|d|d|dg}t j tj |d|||fS) NtextSelections)rrr'z&SCRIPT UTILITIES: Cached selection foris 'r, rT)r/r,rrr rGrH)r2rRr^rr rrUs r4getCachedTextSelectionz Utilities.getCachedTextSelection s66::;KRP+//S :FsF:C4xsSXRYY[\_[``aAbc %**FD9c6!!r6c |jjjdrH|j|d}|s2d|jjd<i|jjd<|jjjdi}t ||vrc|j t |}|j Dcgc]}|j||k(s|c}D]}|j |tj|\}}} d|d|d|d| d g} tjtj| d || |f|t |<||jjd<ycc}w) NrMrFr^z#SCRIPT UTILITIES: New selection forr_rr`rT) r/r,rrTrpoprcrrNr rGrH) r2rR selectedTextr^r~kr<rrr rUs r4updateCachedTextSelectionz#Utilities.updateCachedTextSelection sg << ( ( , ,-E F//4Q7LJO --.FGBD --.>?66::;KRP 9 &"&&tCy1E!/!4!4!6YA.:L:LQ:OSX:XaY &""1% &$55c:s7VHCPUwVXY\X]]^>_` %**FD9$)3$6tCy!:H %%&67Zs E<'E<cFtjj}|ytjtj z dkr(d}t jt j|dytjt_|j|y)Ng?zDSCRIPT UTILITIES: Clipboard contents change believed to be duplicateT) rrgetActiveScriptrr"_last_clipboard_updater rrHonClipboardContentsChanged)rMr3rs r4rjz$Utilities.onClipboardContentsChanged sx**,<<> >  99;99 9D @XC   u//d ; +/99; ()))40r6c|jytjjtj j dd}|jd|j|_y)N CLIPBOARDFz owner-change) r0r ClipboardrrAtominternconnectrjr2 clipboards r4connectToClipboardzUtilities.connectToClipboard( sR  # # / MM%%chhook5&IJ #,#4#4 D;;$= r6c|jytjjtj j dd}|j|jyNrlF)r0rrmrrrnro disconnectrqs r4disconnectFromClipboardz!Utilities.disconnectFromClipboard0 sH  # # + MM%%chhook5&IJ T556r6ctjjtjj dd}|j Sru)rrmrrrnro wait_for_textrqs r4getClipboardContentszUtilities.getClipboardContents7 s4MM%%chhook5&IJ &&((r6ctjjtjj dd}|j |dy)NrlFr))rrmrrrnroset_textr2rUrrs r4setClipboardTextzUtilities.setClipboardText; s5MM%%chhook5&IJ 4$r6ctjjtjj dd}|j |j|yru)rrmrrrnro request_text_appendTextToClipboardCallbackr}s r4appendTextToClipboardzUtilities.appendTextToClipboard? s;MM%%chhook5&IJ tBBDIr6cZ|jd}|||}|j|dy)Nrr))rstripr|)r2rrrUr separators r4rz(Utilities._appendTextToClipboardCallbackC s2{{4  {7),4$r6cttjtjsytj }|xr%|j |jjSrs) rrr?rr@rAisFromApplicationr/rrs r4lastInputEventCameFromThisAppz'Utilities.lastInputEventCameFromThisAppH sF*33[5N5NO22B001A1ABBr6cxtj}t|tjsy|j Srs)rr?rrr@isPrintableKeyrs r4r&z'Utilities.lastInputEventWasPrintableKeyO s/))%!:!:;##%%r6cN|j\}}|tjzSr~r$rCTRL_MODIFIER_MASKr2 keyStringr)s r4lastInputEventWasCommandz"Utilities.lastInputEventWasCommandV s%224 4k4444r6c|j\}}|jr|tjzS|dvr|tjzSyN)r!r"F)r$rrALT_MODIFIER_MASKrrs r4lastInputEventWasPageSwitchz%Utilities.lastInputEventWasPageSwitchZ sN224 4    +777 7 0 0+888 8r6c|j\}}|dvry|tjzs9|tjzs&|tjzs|tj zryy)N)LeftRightrr FT)r$rrSHIFT_MODIFIER_MASKrORCA_MODIFIER_MASKrs r4 lastInputEventWasUnmodifiedArrowz*Utilities.lastInputEventWasUnmodifiedArrowd s^224 4 ; ; +00 0[444[222[333r6c|jxs4|jxs"|jxs|jSr~)lastInputEventWasCharNavlastInputEventWasWordNavlastInputEventWasLineNav lastInputEventWasLineBoundaryNavrs r4lastInputEventWasCaretNavz#Utilities.lastInputEventWasCaretNavq sH,,.7,,.7,,.7446 7r6c|j\}}|dvry|tjzs|tjzryy)NrrFT)r$rrrrs r4rz"Utilities.lastInputEventWasCharNavw sB224 4 - - +00 0[222r6cX|j\}}|dvry|tjzS)NrFrrs r4rz"Utilities.lastInputEventWasWordNav s1224 4 - -k4444r6cZ|j\}}|dk(sy|tjzS)NrFrrs r4rz&Utilities.lastInputEventWasPrevWordNav s0224 4F"k4444r6cZ|j\}}|dk(sy|tjzS)NrFrrs r4rz&Utilities.lastInputEventWasNextWordNav s0224 4G#k4444r6c|j\}}|dvry|jtjj ry|t j z S)N)rr Fr$r%r rrrrrs r4rz"Utilities.lastInputEventWasLineNav sV224 4 N *  . .}/G/G/I/\/\/^ _;999::r6cZ|j\}}|dvry|tjz SN)HomeEndFrrs r4rz*Utilities.lastInputEventWasLineBoundaryNav s3224 4 O +;999::r6c|j\}}|dvry|jtjj ry|t j z Srrrs r4lastInputEventWasPageNavz"Utilities.lastInputEventWasPageNav sW224 4 4 4  . .}/G/G/I/\/\/^ _;999::r6cX|j\}}|dvry|tjzSrrrs r4 lastInputEventWasFileBoundaryNavz*Utilities.lastInputEventWasFileBoundaryNav s0224 4 O +k4444r6cX|j\}}|tjzr|dvSy)N)rrrr rrF)r$rrrs r4&lastInputEventWasCaretNavWithSelectionz0Utilities.lastInputEventWasCaretNavWithSelection s1224 4 +11 1 NN Nr6c|j\}}|j|}d|vry|tjzr|tjz SyNzFrCr=rrrr2r:r)r s r4lastInputEventWasUndozUtilities.lastInputEventWasUndo T557 ++G4 h  +00 0{>>>? ?r6c|j\}}|j|}d|vry|tjzr|tjzSyrrrs r4lastInputEventWasRedozUtilities.lastInputEventWasRedo sQ557 ++G4 h  +00 0+999 9r6c|j\}}|j|}d|vry|tjzr|tjz Sy)Nr<Frrs r4lastInputEventWasCutzUtilities.lastInputEventWasCut rr6c|j\}}|j|}d|vry|tjzr|tjz Sy)NcFrrs r4lastInputEventWasCopyzUtilities.lastInputEventWasCopy rr6c|j\}}|j|}d|vry|tjzr|tjz Sy)NvFrrs r4lastInputEventWasPastez Utilities.lastInputEventWasPaste rr6c|j\}}|j|}d|vry|tjzr|tjz Sy)NrcFrrs r4lastInputEventWasSelectAllz$Utilities.lastInputEventWasSelectAll rr6c|j\}}|dvry|j\}}|j|}d|vry|tjzS)N)rF KP_DeleteTrF)r$rCr=rr)r2rr)r:r s r4lastInputEventWasDeletez!Utilities.lastInputEventWasDeletes^224 4 / /557 ++G4 h k4444r6c|j\}}|dvry|tjzs&|tjzs|tjzryy)N)r ISO_Left_TabFT)r$rrrrrs r4lastInputEventWasTabzUtilities.lastInputEventWasTabsP224 4 3 3 +00 0[222[333r6cRttjtjSr~)rrr?rMouseButtonEventrs r4lastInputEventWasMouseButtonz&Utilities.lastInputEventWasMouseButtons*33[5Q5QRRr6ctj}t|tjr|j dk(xr |j SyN1Frr?rrrbuttonpressedrs r4"lastInputEventWasPrimaryMouseClickz,Utilities.lastInputEventWasPrimaryMouseClick8)) e[99 :<<3&85== 8r6ctj}t|tjr|j dk(xr |j SyN2Frrs r4!lastInputEventWasMiddleMouseClickz+Utilities.lastInputEventWasMiddleMouseClick$rr6ctj}t|tjr|j dk(xr |j SyN3Frrs r4$lastInputEventWasSecondaryMouseClickz.Utilities.lastInputEventWasSecondaryMouseClick+rr6ctj}t|tjr|j dk(xr |j Syrrrs r4$lastInputEventWasPrimaryMouseReleasez.Utilities.lastInputEventWasPrimaryMouseRelease2;)) e[99 :<<3& {88 9$$T\\%E%EF"&":":"< 4$<< **=+C+C+E+X+X+Z[[r6c|j|jtjj ryt j |jst j|jryt j|jst j|jrt j|jSyr) rPrr rrrrrHrrrrs r4!isPresentableExpandedChangedEventz+Utilities.isPresentableExpandedChangedEvent_s   U\\=+C+C+E+X+X+Z [  # #ELL 1[5L5LU\\5Z  # #ELL 1[5J5J5<<5X))%,,7 7r6cl|jjds|jjdsytj|js]tj |js>tj |jstj|jr(d}tjtj|dytj|jr_|j|jrytj|jrytjj!rgytj"|jrGtj$|js(d}tjtj|dytjj'|jt)j*|jfvryd}tjtj|dy)Nzobject:text-changed:zobject:text-attributes-changedFz:SCRIPT UTILITIES: Event is not being presented due to roleTzESCRIPT UTILITIES: Event is not being presented due to role and stateszCSCRIPT UTILITIES: Event is not being presented due to lack of cause)rr#ris_menu_relatedr is_slideris_spin_buttonrJr rrHrrrlr r focus_is_deadrjrrrr_r2rrs r4,isPresentableTextChangedEventForLocusOfFocusz6Utilities.isPresentableTextChangedEventForLocusOfFocuskszz$$%;<::(()IJ  & &u|| 4##ELL1((6""5<<0NC   u//d ;  ! !%,, / -++ELL9'')779  & &u|| 4[=T=TUZUaUa=bYC   u//d ;  # # % 8 8 : \\8..u||< = >S 5++S$7r6c|jjdsy|j|jry|j \}}|dk(ryy)Nobject:text-changed:deleteFrET)rr#rrr$)r2rrr)s r4#isBackSpaceCommandTextDeletionEventz-Utilities.isBackSpaceCommandTextDeletionEventsKzz$$%AB == &224 4  #r6c|jjdsy|jjdry|jS)NrFsystem)rr#rrrs r4 isDeleteCommandTextDeletionEventz*Utilities.isDeleteCommandTextDeletionEvents<zz$$%AB ::  x (++--r6c|jjdsy|jsy|j|j\}}}| SNrF)rr#rrarr2rrr rs r4isUndoCommandTextDeletionEventz(Utilities.isUndoCommandTextDeletionEventsJzz$$%AB))+!88FsFzr6c|jjdsy|jry|j|j\}}}|xr+|j |j j k(Sr)rr#rrarrrhrs r4isSelectedTextDeletionEventz%Utilities.isSelectedTextDeletionEventsezz$$%AB  & & (!88FsFB&,,.ENN,@,@,BBBr6c|jjdsy|j|j|j |j\}}}|xr ||j k(xr||j k(SNrF)rr#rfrrarhrrs r4isSelectedTextInsertionEventz&Utilities.isSelectedTextInsertionEventsgzz$$%AB &&u||4!88FsFM&ENN2Mu 7MMr6cJ|jsy|j|ryyrY)rrrs r4isSelectedTextRestoredEventz%Utilities.isSelectedTextRestoredEvents%))+  , ,U 3r6cZ|jjdsy|jSr)rr#rrs r4%isMiddleMouseButtonTextInsertionEventz/Utilities.isMiddleMouseButtonTextInsertionEvents'zz$$%AB5577r6c||jjdsytj|jrvtj |jsW|jt jjk7r(d}tjtj|dytj|jr#tjjdSt|j j#dk(r#tjjdSy)NrFzTSCRIPT UTILITIES: Not echoable text insertion event: focusable source is not focusedT enableKeyEchor r)rr#rrrrr rrr rrHrlrrrFrhrrs r4isEchoableTextInsertionEventz&Utilities.isEchoableTextInsertionEventszz$$%AB  # #ELL 1))%,,7||}779LLNN3C   u//d ;  ' ' 5#..0;;OL L u~~##% &! +#..0;;>X %  %0 1T"))E8:T5U U 8  5 5 78 Cr6cp|xs"tjj}|rtj|ry|j }|syt j|\}}}|r||vry|j|xs|}tj|ry|xrtj||vSrY) r rrrrrzrrNrr)r2rRrrrr s r4objectContentsAreInClipboardz&Utilities.objectContentsAreInClipboardsD]--/BBDh&&s+,,.#55c:s f('',3   C 9x((-99r6cd|jjd<d|jjd<d|jjd<d|jjd<y)NFundoredopaster'last-selection-message)r/r,rs r4clearCachedCommandStatez!Utilities.clearCachedCommandStatesS05 %%f-05 %%f-16 %%g.BD %%&>?r6cP|jr|jjjdsB|jj t j d|jjd<|j|jy|jr|jjjdsB|jj t jd|jjd<|j|jyy)NrTrF) rr/r,rpresentMessagerUNDOrfrrREDOrs r4handleUndoTextEventzUtilities.handleUndoTextEvents  % % '<<0044V< ++HMM:8< --f5  * *5<< 8  % % '<<0044V< ++HMM:8< --f5  * *5<< 8r6c|jry|jrh|jjj dsB|jj t jd|jjd<y|jrh|jjj dsB|jj t jd|jjd<yy)NFrTr) rrr/r,rrrrrrrs r4handleUndoLocusOfFocusChangez&Utilities.handleUndoLocusOfFocusChange0s  - - /  % % '<<0044V< ++HMM:8< --f5  % % '<<0044V< ++HMM:8< --f5r6c4|jry|jrw|jjj dsQ|jj t jt jd|jjd<yy)NFrT) rrr/r,rrrCLIPBOARD_PASTED_FULLCLIPBOARD_PASTED_BRIEFrs r4handlePasteLocusOfFocusChangez'Utilities.handlePasteLocusOfFocusChangeBss  - - /  & & (<<0044W= ++22H4S4SU9= --g6r6cyrsrtrs r4eventIsCanvasNoisezUtilities.eventIsCanvasNoiseOrwr6cyrsrtrs r4eventIsSpinnerNoisezUtilities.eventIsSpinnerNoiseRrwr6c6tjs(d}tjtj|dyt j tjj z }|dkDr-d|dd}tjtj|dyy)Nz:SCRIPT UTILITIES: Not user triggered: No last input event.TFr z7SCRIPT UTILITIES: Not user triggered: Last input event z.2fzs ago.)rr?r rrHr)r2rrrs r4eventIsUserTriggeredzUtilities.eventIsUserTriggeredUs~((NC   u//d ; j77<<< 19KERU;V\]C   u//d ;r6cH|jry|jryyr)rr#rs r4presentFocusChangeReasonz"Utilities.presentFocusChangeReasoncs#  , , .  - - /r6ctj|sytj|rtj|sytj |stj |rytj|}|tj|k(r[tj|d}tj||k7ryd|d}tjtj|dytj |S)NFrzSCRIPT UTILITIES: All z! children believed to be selectedT)rrrrrArrrhrrget_selected_childr_r rrHrall_cells_are_selected)r2rRrrrs r4allItemsSelectedzUtilities.allItemsSelectedjs**3/  $ $S )+2I2I#2N  # #C (K,?,?,D--c2 ==cB B 223:E""5)S0*:,6WXC   u//d ;--c22r6cn|jjjd}|j|}|r|ry||jjd<|j rQ|rO|jj t jtjjd|dyy)Nr/TF) r/r,rr/rrrCONTAINER_SELECTED_ALLr rrs)r2rRallAlreadySelectedallCurrentlySelecteds r4handleContainerSelectionChangez(Utilities.handleContainerSelectionChanges!\\::>>?QR#44S9 "6tj|sy|j|\}}}|j||j|\}}}|j t |ry|j s.|r,|s*|jjtjyg} tt||} tt||} | j| sy| rY| rW| j| sF| j||tj g| j||tj"gnt%| j'| } | sy| d| ddz}} | | krn| j| |tj"g|j)|j*r|| k(rt-j.||dz }|j1|dnh| j| |tj g|j)|j*r+t-j.||dz }|j1|d|xr$t3j4j7d }| D]\}}}t9j:|||}|j)|j*}|r|dz}|jj=||||r|s|jj|d|st-j.||}|j1||y)NFTrr)r r) interrupt)rrrarf_speakTextSelectionStaterFrr/ speakMessagerSELECTION_REMOVEDr>rJunion intersectionrQTEXT_UNSELECTED TEXT_SELECTEDrsymmetric_differencerrrr[handleTextSelectionChangerrrrry sayPhrase)r2rRr8oldStartoldEnd oldStringnewStartnewEndrchangesoldCharsnewCharschange changeStart changeEndrrr messager endsWithChilds r4r?z#Utilities.handleTextSelectionChanges %%c*&*&A&A#&F#&) &&s+&*&A&A#&F#&)  ( (Y 8::<S\ LL % %h&@&@ AuXv./uXv./~~h' )>)>x)H NNHfh.F.FG H NNHfh.D.DE FH99(CDF%+AYr QK(" Y8N8NOP%%d&D&DE&T_J_(;;C!LE225%@ Y8P8PQR%%d&D&DE(;;C!LE225%@#W$//1<<=UVV #* D E3))#uc:F"OOD,J,JKMq LL " "3s 3M ))'U)C#77SA..ulC Dr6c~tjtjtjtjgS)!Hacky and to-be-obsoleted method.)rPARAGRAPH_SELECTED_DOWNPARAGRAPH_UNSELECTED_DOWNPARAGRAPH_SELECTED_UPPARAGRAPH_UNSELECTED_UPrs r4_getCtrlShiftSelectionsStringsz(Utilities._getCtrlShiftSelectionsStringss00022..002 2r6ctjjdry|j\}}|tj z}|tj z}|dkD}d}|dk(r|r|rtj}n|dk(r|r|rtj}nh|dk(r*|r(|s&|rtj}nKtj}n9|dk(r*|r(|s&|rtj}ntj}n |dk(r"|r |r|j}|r|d}n|d}n|d k(r"|r |r|j}|r|d }n|d }n|d k(r(|r&|r$|rtj}ntj }n|d k(r(|r&|r$|rtj"}nstj}nb|j%rR|rP|j&j(j+ds*d|j&j(d<tj,}ny|sy||j&j(j+dk7r4||j&j(d<|j&j/|y)rOrFrNr"r!r r rrUrTrrrMTr)rrrr$rrrrLINE_SELECTED_RIGHTLINE_SELECTED_LEFTPAGE_SELECTED_DOWNPAGE_UNSELECTED_DOWNPAGE_SELECTED_UPPAGE_UNSELECTED_UPrTDOCUMENT_SELECTED_UPDOCUMENT_UNSELECTED_UPDOCUMENT_SELECTED_DOWNrr/r,rDOCUMENT_SELECTED_ALLr8) r2 nSelectionsrGr) isControlKey isShiftKeyrdrstringss r4r7z"Utilities._speakTextSelectionStates  & & ( 3 34L M113$k<<< K;;; "Q   # //D)# ..D+%:l2244)#L0022& j\99;Gqzqz$J<99;Gqzqz& j\4466%ZL6644  , , .<<<00445MNJN --.FG55 4<<00445MN NFJDLL ) )*B C LL % %d +r6cd}|+|dz }tjtj|dy|6|jj dr|j j |StjrUtjr@tjr+|dz }tjtj|dytjsUtjstjr+|dz }tjtj|dytjrAtj r+|dz }tjtj|dyyfd }fd }tj"t$j&j(|r+|d z }tjtj|dytj"t$j&j(|r+|d z }tjtj|dyy) Nz