+ Qics8RtRtRtRtRtRt^RIHt^RIt]P!RR 4^R I H t ^R I H t ^R I Ht^R I Ht^RI Ht^RI Ht^RI Ht^RI Ht^RI Ht^RIHt^RIHt^RIHt^RIHt^RIHt^RIH t ^RI!H"t"^RI#H$t$!RR4t%R#)RUtilities for providing app/toolkit-specific information about objects and events.z$Id$z $Revision$z$Date$z#Copyright (c) 2010 Joanmarie Diggs.ZLGPL)CallableNAtspiz2.0)r)debug) focus_manager)input_event_manager)messages)object_properties)script_manager)settings)settings_manager) AXComponent) AXHypertext)AXObject) AXSelection)AXTable)AXText) AXUtilities)AXValuecsa]tRt^:toRtRtRtV3RlRltV3RlRltV3RlR lt V3R lR lt RV3R lRllt V3RlRlt V3RlRlt RV3RlRlltRV3RlRlltV3RlRltV3RlRltV3RlRltV3RlRltV3RlR ltRV3R!lR"lltRV3R#lR$lltV3R%lR&ltV3R'lR(ltV3R)lR*ltV3R+lR,ltV3R-lR.ltV3R/lR0ltV3R1lR2ltV3R3lR4ltV3R5lR6ltV3R7lR8lt V3R9lR:lt!RV3R;lR<llt"RV3R=lR>llt#RV3R?lR@llt$V3RAlRBlt%V3RClRDlt&REt'V3RFlRGlt(V3RHlRIlt)V3RJlRKlt*V3RLlRMlt+RV3RNlROllt,RV3RPlRQllt-].V3RRlRSl4t/RV3RTlRUllt0RV3RVlRWllt1RV3RXlRYllt2RV3RZlR[llt3RV3R\lR]llt4RV3R^lR_llt5V3R`lRalt6V3RblRclt7RV3RdlRellt8RV3RflRgllt9RV3RhlRillt:RV3RjlRkllt;V3RllRmltRV3RrlRsllt?RV3RtlRullt@RV3RvlRwlltARV3RxlRylltBRV3RzlR{lltCRV3R|lR}lltDRV3R~lRlltERV3RlRlltFRV3RlRlltGV3RlRltHRV3RlRlltIV3RlRltJV3RlRltKV3RlRltLV3RlRltMV3RlRltNV3RlRltOV3RlRltPV3RlRltQV3RlRltRRV3RlRlltSV3RlRltTV3RlRltUV3RlRltVV3RlRltWV3RlRltXV3RlRltYRV3RlRlltZRV3RlRllt[Rt\Vt]R #) Utilitiesrucs WnRVnR#)NN)_script_caret_context)selfZscript&&:/usr/lib/python3.14/site-packages/orca/script_utilities.py__init__ZUtilities.__init__?s )c:<V^8dQhRS[PRS[/#objreturnr AccessibleintZformat __classdict__"r __annotate__Utilities.__annotate__Gs!e..3rc s\P!V\P4'gR#\P!V4pRV9d#\ VP R^44^, #.pTpV'd;\P!V4;p'dV^,pVPV4KB\V4^, #)z2Returns the node level of the specified tree item.levelr) r find_ancestorrZis_tree_or_tree_tableZget_attributes_dictr$getget_is_node_child_ofappendlen)rr attrsnodesZnodetargetss&& r node_levelZUtilities.node_levelGs%%c;+L+LMMI,,S1 e uyy!,-1 1;#C#CD#III1:D LL 5zA~rc^<V^8dQhRS[PRS[S[P,/#rrr#listr%r'rr(r)Zs,$$u//$D9I9I4J$rc s*\P!V4'g.#\P!V4pVf.#\P!V4pR\ V4RVR.p\ P!\ PVR4V'dV#\P!VRR7wrVVPV4p\V^,\P!VRR74Ftp\P!W(V4p \P!V 4p V 'gK:V ^,p W8XdVPV 4K\VPV 4V8:gKtM R\ V4RVR.p\ P!\ PVR4V#)zOGets all of the objects that have RELATION_NODE_CHILD_OF pointing to this cell.SCRIPT UTILITIES:zchild nodes forzvia node-parent-ofTF)Zprefer_attributezvia node-child-of)r is_expandedr get_tableZget_is_node_parent_ofr/r print_tokens LEVEL_INFOget_cell_coordinatesr3range get_row_countZ get_cell_atr-r.) rr tabler1tokensrowZcolr*icellr2Znode_ofs && r child_nodesZUtilities.child_nodesZsL&&s++I!!#& =I11#6%s5z3DcK_` 5++VT: L //eL$sQw 5 5ee TUA&&u5D!66t.>7497rc sjVPV4p\\\PV44#)z9Returns a list of strings containing the details for obj.)_details_for_objectr6mapr get_all_text)rr details&& rdetails_content_for_objectZ$Utilities.details_content_for_objects,**3/C++W566rcr4rr5r%r'rr(r)s,  u'7'7 DAQAQZ/Utilities._details_for_object..sf&C&CA&F"Fr) rZ get_detailsZis_toggle_buttonr8r6r Z iter_childrenZextend_find_all_descendants)rr rIZ text_objectsZdetail&& rrFZUtilities._details_for_objects))#.;77<<AXAXY\A]A]811#67G F    : :F!H IrNcsz<V^8dQhRS[PR,RS[S[PR,,/#rr Nr!r5r%r'rr(r)s:##    $# e% &#rc s^aRR.pT;'g$\P!4P4pV'g+Rp\P!\P VR4V#VP V4pVf-RV.p\P!\P VR4V#\PP\PP\PP.o\P!V4pVS9dWB^&M\V\PP\PP 39dWB^&V3Rlp\P"!W4V^&RVRV^,RV^,.p\P!\P VR4V#) z;Returns the frame and (possibly) the dialog containing obj.Nz@SCRIPT UTILITIES: frame_and_dialog() called without valid objectTz5SCRIPT UTILITIES: could not find top-level object forcs6<\P!V4S9#rL)r get_role)rN dialog_roles&r is_dialogZ-Utilities.frame_and_dialog..is_dialogs((+|;;rr7z is in framez and dialog)r get_managerget_locus_of_focusr print_messager;top_level_objectr:rRoleDIALOG FILE_CHOOSERALERTr rTFRAMEWINDOWfind_ancestor_inclusive) rr Zresultsmsg top_levelr@rolerWrUs && @rframe_and_dialogZUtilities.frame_and_dialogsU ,EE]..0CCETC    0 0#t <N))#.  MsSF   u// >N ))5::+B+BEJJDTDTU   + < "AJ ((%***;*;<<&  <"99#IGAJ%sM71:|U\]^U_` 5++VT:rcrrrr#boolr%r'rr(r)s!--1A1A-d-rc .\P!V4#)z'',HH}002EEGG HrcH<V^8dQhRS[PR,RS[/#rSrgr%r'rr(r)s* P PU%5%5%< P Prc sVf$\P!4P4p\P!V4'gR#\ P !V\P4RJ#)z3Returns True if obj is in a find-in-page container.NF)rrXrYrZis_entryr r+Z is_tool_barrkrrin_find_containerZUtilities.in_find_containersR ;++-@@BC##C((%%c;+B+BC4OOrcro)r_rootNr!rr#rEr%r'rr(r)s&E,<,YZZ#//1==>VWW/ /**3/// /++C002 2  " "3 ' '' '  ' ' ) 5 56S T T%%c;+D+DEE88$002>>?UV 11 1+ + 44 4$$S)]-F-F-H-Z-Z-\\22A A 99 9--c2C'335KKMJ //1 144rcr4rr5r%r'rr(r)s0 C C%*:*: CtEDTDT?U Crc s\P!V4'g.#\Pp\PpVPWV4#)zCReturns a list of all the accessible description list terms in obj.)ris_description_listZis_description_termrQ)rr _include_exclude&& rdescription_list_termsZ Utilities.description_list_termssC..s33I2222))#BBrcrrrgr%r'rr(r)s%PPE$4$4PPrc s\P!V4'g\P!V4'gR#\P!V\P 4RJ#)z0Returns true if obj is a list inside a document.FN)rZis_listrr r+ is_documentrkrris_document_listZUtilities.is_document_listsF##C((K,K,KC,P,P%%c;+B+BC4OOrcrrrgr%r'rr(r)s%PPU%5%5P$Prc s\P!V4'gR#\P!V\P4RJ#)z1Returns true if obj is a panel inside a document.FN)rZis_panelr r+rrkrris_document_panelZUtilities.is_document_panels6##C((%%c;+B+BC4OOrcrrrgr%r'rr(r)s",,u//,SW,rc ri)z"Returns True if obj is a document.)rr)rr Z_exclude_document_frame&&&rrZUtilities.is_documents &&s++rcrorSrgr%r'rr(r)%s&==u'7'7$'>=$=rc sT;'g$\P!4P4pVPV4RJ#)zCReturns True if obj (or the locus of focus) is in document content.N)rrXrYget_document_for_objectrkrrin_document_contentZUtilities.in_document_content%s9EE]..0CCE++C0<>@ 0 0+2H2H2PQR  6 6 BC y>Q GSTVF   u// >Q< 99  % % ' : : <>KXVrcrrrgr%r'rr(r);s%[[)9)9[d[rc s~VPV4;'d&\P!WP4'*#)z,Returns true if obj is a top-level document.)rr r+rkrris_top_level_documentZUtilities.is_top_level_document;s1$ZZX-C-CCIYIY-Z)ZZrc\<V^8dQhRS[PRS[PR,/#rr r!Nrr%r'rr(r)@s1QQU5E5EQ%JZJZ]aJaQrc B\P!WP4#)z.Returns the top-level document containing obj.)r rbrrkrrrZ+Utilities.get_top_level_document_for_object@s//5O5OPPrcrrrr%r'rr(r)Es1GG5+;+;G@P@PSW@WGrc r)zIReturns the nearest document ancestor of obj, or obj if it is a document.)r rbrrkrrrZ!Utilities.get_document_for_objectEs//5E5EFFrcs&<V^8dQhRS[RS[/#)rcolumnr!)r$rEr%r'rr(r)Ksssrc s\V4#)z4Converts a column number to a string representation.)rE)rrrrconvert_column_to_stringZ"Utilities.convert_column_to_stringKs6{rcrrrgr%r'rr(r)Ps% P P%*:*: Pt Prc s\P!V4'gR#VPV4pVRJ;'d\P!V4'*#)zRReturns True if obj is a text document table (i.e. not a spreadsheet or GUI table)FN)ris_tableris_document_spreadsheetrr ZdocrJris_text_document_tableZ Utilities.is_text_document_tablePsH ##C((**3/$OO{'J'J3'O#OOrcrrrgr%r'rr(r)[s%WW 0 0WTWrc sd\P!V4;'dVPV4RJ#)z#Returns True if obj is a GUI table.N)rrrrkrr is_gui_tableZUtilities.is_gui_table[s. ##C(VVT-I-I#-NRV-VVrcrrrgr%r'rr(r)bs!22(8(82T2rc s\P!V4'd\P!V4'gR#VP V4pVfR#\P !V4'dR#\ P!V4R8#)z+Returns True if obj is a spreadsheet table.FTi)rrr supports_tablerrrr>rrJris_spreadsheet_tableZUtilities.is_spreadsheet_tablebsj $$S))h.E.Ec.J.J**3/ ;  . .s 3 3$$S)E11rcrrrgr%r'rr(r)rs%TT)9)9TdTrc \P!V4'gR#\P!WP4RJ#)z7Returns true if obj is a cell in a text document table.FN)ris_table_cell_or_headerr r+rrkrris_text_document_cellZUtilities.is_text_document_cellrs4 22377%%c+F+FGtSSrcrrrgr%r'rr(r){s%JJu//JDJrc r)z-Returns true if obj is a cell in a GUI table.FN)rrr r+rrkrr is_gui_cellZUtilities.is_gui_cell{s4 22377%%c+<+<=TIIrcrrrgr%r'rr(r)s%RRu'7'7RDRrc r)z5Returns true if obj is a cell in a spreadsheet table.FN)rrr r+rrkrris_spreadsheet_cellZUtilities.is_spreadsheet_cells4 22377%%c+D+DETQQrcb<V^8dQhRS[PRS[PR,RS[/#rrC prior_cellNr!rgr%r'rr(r)s:%%%$$t+%  %rc s\P!V4^,pVR8XdR#Vf*\P!4P 4wrEW58g#\P!V4^,pW58g#)z@Returns True if the column of cell has changed since prior_cell.Frrr<rrXZget_last_cell_coordinates)rrCrrZ _last_rowZ last_column&&& rcell_column_changedZUtilities.cell_column_changedsn--d3A6 R<  %2%>%>%@%Z%Z%\ "I$$"66zB1EK$$rcrrrgr%r'rr(r)s:$$t+  rc s\P!V4^,pVR8XdR#Vf*\P!4P 4wrEW48g#\P!V4^,pW48g#)z=Returns True if the row of cell has changed since prior_cell.Frr)rrCrrAZlast_rowZ _last_columnrrcell_row_changedZUtilities.cell_row_changedsl**403 "9  %2%>%>%@%Z%Z%\ "H33J?BHrcr)rr previous_objectNr!rgr%r'rr(r)s?XX   X))D0X  Xrc sV\P!4P4'dR#VPP 4P 4'dR#VP W4'gR#\P!V4pVfR#VPV4'g%\P!4PR4#VPV4'd%\P!4PR4#\P!4PR4#)z9Returns True if we should present the full row in speech.FZreadFullRowInGUITableZreadFullRowInSpreadSheetZreadFullRowInDocumentTable) rrXZ in_say_allrZget_table_navigatorZ'last_input_event_was_navigation_commandrrr9rr r{r)rr rr?&&& rshould_read_full_rowZUtilities.should_read_full_rows  $ $ & 1 1 3 3 << + + - U U W W$$S::!!#& =++E22#//1==>UV V  $ $U + +#//1==>XY Y++-99:VWWrcrrrrr%r'rr(r)s!  E,<,<  rc  s&\P!V4'gR#.p\P!V4pV'dVP V4VP V4pV'dWB9dVP V4MLRP \RVPVR^444pV'dWR9dVP V4\P!V4pV'dWb9dVP V4RP V4#)z@Returns a string containing the content of the notification obj.rt cj\P!V4;'g\P!V4#rL)rrHr get_namerMrOrrPZ4Utilities.get_notification_content..s&F,?,?,B,Z,ZhFWFWXYFZ,ZrF) rZis_notificationr rr. expand_eocsjoinrGunrelated_labelsZget_description)rr r@nametextlabelsZ descriptions&& rget_notification_contentZ"Utilities.get_notification_contents**3//  %  MM$ $ D& MM$ XXc"Z"&"7"7UA"FHIF&. f%..s3 ;4 MM+ &xxrcrrrgr%r'rr(r)s!((5++((rc ri)zReturns True if obj is a link.)rrwrkrrrwZUtilities.is_links""3''rcsVPPpRpVFpVR8XdK W$,pK TpV# \\\3dT#i;ir)rr~Z IndexErrorZ TypeErrorZAttributeError)rZpathstartrvZprRr_get_object_from_pathZUtilities._get_object_from_pathsf    ABw  B  >:   s8AAcrrrr%r'rr(r)s,U%5%5%:J:JT:Qrc s\P!V4'dR#\P!V4'gV#\P!V4'dV#Rp\P !W4pVeV#V#)z:Legacy table-cell code originally for managed descendants.NcrrL)r rrrHrMrOrpredZ)Utilities.active_descendant..pred s&$$Q'AA6+>+>q+A Ar)r Zis_deadr is_table_cellrfind_descendant)rr rchildrractive_descendantZUtilities.active_descendantsl   C ((--J   S ! !J B((3  L rcsD<V^8dQhRS[S[P,/#rr!)r6rr\r%r'rr(r)s$uzz"2rcs\PP\PP\PP\PP \PP .pV#rL)rr\r]r^r`rar_)rZroless& r_top_level_rolesZUtilities._top_level_rolessQ""((!!""!! #  rcr)rrr!Nrr%r'rr(r)s-53C3CHXHX[_H_rc sa\P!S4pVfR#\\P!V44Fp\P !W#4p\P !VV3Rl4e1RVRS.p\P!\PVR4Vu#RVRS.p\P!\PVR4K R#)z:A terrible, non-performant workaround for broken ancestry.Ncs<VS8H#rLru)rNrrVrrPZ9Utilities._find_window_witih_descendant..%s !u*rr7ZcontainsTzdoes not contain) rr}r=r get_child_countZ get_childrrr:r;)rrr~rBrr@s&f r_find_window_witih_descendantZ'Utilities._find_window_witih_descendants))%0 ;x//45A''/F''0DEQ-vz5I""5#3#3VTB )63EuMF   u// >6rcrrrgr%r'rr(r)/s%VV(8(8VTVrcs\P!V4VP49;'dF\P!\P!V44\P P 8H#rL)r rTr get_parentrr\Z APPLICATIONrkrr_is_top_level_objectZUtilities._is_top_level_object/sX  %)>)>)@@VV!!("5"5c":;uzz?U?UU Vrcsb<V^8dQhRS[PRS[RS[PR,/#)rr use_fallback_searchr!Nrgr%r'rr(r)3s:   "   D rc s(\P!WP4pRVRV.p\P!\P VR4VfBV'd:Rp\P !\P VR4VPV4pV#)z@Returns the top-level object (frame, dialog ...) containing obj.r7zis top-level object for:TzISCRIPT UTILITIES: Attempting to find top-level object via fallback search)r rbrrr:r;rZr)rr rrr@rcrrr[ZUtilities.top_level_object3s{ - -c3L3L M%r+EsK 5++VT: :-]C    0 0#t <33C8B rcrorSrgr%r'rr(r)Es+ L L%:J:JT:Q L]a Lrc sT;'g$\P!4P4pVPV4pV'gR#\P !VRR4\ P!V4'd\ P!V4'dR#V\P!4P48H#)zRReturns true if the top-level object for obj/locus-of-focus is active and current.Fz#Ensuring we have the correct state.) rrXrYr[r Z clear_cacherZ is_activeZ is_defunctr|)rr rdrJr&top_level_object_is_active_and_currentZ0Utilities.top_level_object_is_active_and_currentEsEE]..0CCE))#. Y/TU$$Y//;3I3I)3T3TM557IIKKKrcsL<V^8dQhRS[S[,RS[S[,RS[/#)rpath1path2r!)r6r$r%r'rr(r)Us*tCycsrc sXW8Xd^#\\V4\V44pVR.V,,RVpVR.V,,RVp\\\V4\V444F0pW,W,8dRu#W,W,8gK/^# ^#)zMReturns -1, 0, or 1 to indicate if path1 is before, the same, or after path2.Nr)maxr/r=min)rrZsizerNrrpath_comparisonZUtilities.path_comparisonTs >3u:s5z*"$et,"$et,s3u:s5z23Ax%(" x%(" 4 rc s<V^8dQhRS[PR,RS[S[P.S[3,R,RS[S[P.S[3,R,RS[S[P,/#)rrootN include_if exclude_ifr!)rr#rrhr6r%r'rr(r)isKK%Ke../56=Ke../56= K e  KrcsVf.#\P!V4'd-RV.p\P!\PVR4.#\ P !WV4#)Nz7SCRIPUT UTILITIES: Returning 0 descendants for pre/codeT)rZis_coderr:r;r Zfind_all_descendants)rrrrr@&&&& rrQZUtilities._find_all_descendantsis\ <I   t $ $OQUVF   u// >I,,TzJJrc sx<V^8dQhRS[PR,RS[RS[RS[S[P,/#)rrN only_showing minimum_wordsr!)rr#rhr$r6r%r'rr(r)|sUEEEE%EEEE EE e  EErc svaa a VPP'd.VPPPV4'd.#\PP \PP .o \PP\PP\PP\PP\PP\PP\PP\PP\PP\PP \PP"\PP$\PP&\PP(\PP*\PP,\PP.\PP0\PP2\PP4\PP6.o \8P:!V4S 9d.#V V3RlpVV 3RlpVP=WV4p\8P>!V4p.pVFp \8P>!V 4;'g\@PB!V 4p V 'd3W\8P>!\8PD!V 4439dKq\GV PI44V8dKVPKV 4^8dKVPMV 4K \NPP!V4#)z:Returns a list of labels in root that lack a relationship.cs<V'd\P!V4S9gR#\P!V4'gR#S'd\P!V4'gR#R#)FT)r rTrZobject_is_unrelatedr)rN label_rolesr&rrZ,Utilities.unrelated_labels.._includesH(++A.+=22155K$:$:1$=$=rcs<V'd\P!V4S9dR#S'd\P!V4'gR#R#)TF)r rTrr)rNr skip_rolesrrrZ,Utilities.unrelated_labels.._excludes4))!, :K$:$:1$=$=r))rZ spellcheckZis_spell_check_windowrr\ZLABELZSTATICZ COMBO_BOXZDOCUMENT_EMAILZDOCUMENT_FRAMEZDOCUMENT_PRESENTATIONZDOCUMENT_SPREADSHEETZ DOCUMENT_TEXTZ DOCUMENT_WEBr`LIST_BOXLIST LIST_ITEMZMENUZMENU_BARZ PUSH_BUTTONZ SCROLL_PANEZ SPLIT_PANETABLEZ TOGGLE_BUTTONTREE TREE_TABLErar rTrQrrrHrr/splitZfindr.r Zsort_objects_by_position) rrrrrrrZ root_nameZlabels_filteredZlabelrrrs &&f& @@rrZUtilities.unrelated_labels|sS << " " "t||'>'>'T'TUY'Z'ZIzz''):):; jj**jj//jj//jj66jj55jj..jj--jj&&jj))jjoojj**jjoojj))jj,,jj,,jj++jj&&jj..jjoojj++jj'')) ,   T "j 0I  ++DHE%%d+ E$$U+IIv/B/B5/IDH,=,=h>Q>QRW>X,Y ZZ4::< =0~~d#q(  " "5 )33ODDrc<V^8dQhRS[PRS[PR,RS[PR,/#rr restrict_toNr!rr%r'rr(r)sE   %%,   D rc TVfVPV4p\P!V4pRVRVR.p\P!\P VR4VeL\ P!W2R4'g/RVRV.p\P!\P VR4R#V#)z!Finds the object before this one.Nz%SCRIPT UTILITIES: Previous object foris.Tr7is not a descendant of)rrZget_previous_objectrr:r;r is_ancestorrr rresultr@&&& rfind_previous_objectZUtilities.find_previous_objects  @@EK00593fcR 5++VT:  "8+?+?UY+Z+Z)63K[YF   u// > rcrrrr%r'rr(r)sE   %%,   D rc r)z Finds the object after this one.Nz!SCRIPT UTILITIES: Next object forrrTr7r)rrZget_next_objectrr:r;r rrrrfind_next_objectZUtilities.find_next_objects  @@EK,,S15sD&#N 5++VT:  "8+?+?UY+Z+Z)63K[YF   u// > rcsF<V^8dQhRS[PRS[RS[RS[/#rr start_offset end_offsetr!)rr#r$rEr%r'rr(r)s9((   (( ( (rc  s\P!WV4pRV9dV#\PP\PP \PP \PP\PP\PP\PP\PP.p\V4p\V4FlwrxVR8XgK\P!WV,4p VP!V 4p V 'd%\"P$!V 4V9d V R, p WV&Kn RP'V4p RVRV RV RV R2.p \(P*!\(P,V R 4RV 9d+R p \(P.!\(P,V R 4R#V #) zPExpands the current object replacing embedded object characters with their text.rrtz#SCRIPT UTILITIES: Expanded EOCs forzrange: Z:z: ''Tz'SCRIPT UTILITIES: Unable to expand EOCs)r get_substringrr\ZHEADINGrrZ PARAGRAPHZSECTIONr TABLE_CELL TABLE_ROWr6Z enumerater find_child_at_offsetrr rTrrr:r;rZ) rr rrrZ block_rolesZto_buildrBcharrrr@rc &&&& rrZUtilities.expand_eocssx##CzB 4 Kzz))jjoojj**jj**jj((jj&&jj++jj**, : *GAx#88,>NO))%0X..u5DcMF$ +"7<.*SBD 5++VT: v ;C    0 0#t < rc s<V^8dQhRS[PRS[S[S[PS[S[S[3,,R,RS[/#)rr contentsNr!)rr#r6rzr$rErhr%r'rr(r)sM   uU--sC<=>E  rc sV'gR#\P!V4'gR#VF+wr4rV\P!V4pVfK"W9gK*R# R#)z9Returns True of obj is an error message for the contents.FT)rZget_is_error_forZget_error_message)rr rZaccZ_startZ_endZ_stringr2s&&& ris_error_for_contentsZUtilities.is_error_for_contentssO++C00*2 &C!33C8G"s~+3 rcrreventr!rEventrEr%r'rr(r)(s%++#rc sVP#)zOTries to determine the real deleted text for the given event. Because app bugs.)any_datarrrr deleted_textZUtilities.deleted_text(s~~rcrrrr%r'rr(r)-s5;;3rc sVP'd VP#Rp\P!\PVR4\P !VP 4'd]\P!VP 4pV'd5RVR.p\P!\PVR4VR,#Rp\P!\PVR4R#)zPTries to determine the real inserted text for the given event. Because app bugs.z-SCRIPT UTILITIES: Broken text insertion eventTzHACK: Returning last char in 'rz3FAIL: Unable to correct broken text insertion eventrtr) rrrZr;rZis_password_textsourcerrHr:)rrrcstringr@rRr inserted_textZUtilities.inserted_text-s >>>>> != E,,c48  ' ' 5 5((6F:FCH""5#3#3VTBbz!C E,,c48rcsF<V^8dQhRS[PR,RR/#)rrNr!rr%r'rr(r)As*))""T)) )rc sRVnR#)zClears the caret context.Nrr)rrrrclear_caret_contextZUtilities.clear_caret_contextAs )rcst<V^8dQhRS[PR,RS[RS[PR,RR/#)rr Noffsetrr!r"r%r'rr(r)JsI , ,    $ , ,""T) ,  ,rc sW3VnR#)z4Sets the caret context in document to (obj, offset).Nr)rr rrs&&&&rset_caret_contextZUtilities.set_caret_contextJs #mrc s~<V^8dQhRS[PR,RS[RS[RS[S[PS[3,/#)rrN get_replicantsearch_if_neededr!)rr#rhrzr$r%r'rr(r)UsN""T)  u$ % rc sLVPwrEVe.RWE.p\P!\PVR4WE3#\P !4P 4p\P!V4pRWE.p\P!\PVR4WE3#)zAReturns an (obj, offset) tuple representing the current location.z0SCRIPT UTILITIES: Returning cached caret contextTz0SCRIPT UTILITIES: Returning focus + caret offset) rrr:r;rrXrYrget_caret_offset)rrrrr rr@&&&& rget_caret_contextZUtilities.get_caret_contextUs))  ?H#VF   u// >; '')<<>((-DcR 5++VT:{rcsf<V^8dQhRS[PRS[RS[PR,RR/#)rr rrNr!r"r%r'rr(r)isJNN   NN""T) N  Nrc  s\P!4pVPRVR4VPV4'd\P !V4\ P!V4VPW4VPW4VPW4\^\V\ P!V4^, 44pVPP4P!W4R#)zESets the locus of focus to obj and sets the caret position to offset.NF)rrXset_locus_of_focusrlr Z grab_focusrZclear_all_selected_textset_caret_offsetZset_last_cursor_positionrrrget_character_countrZget_event_synthesizerZscroll_into_view)rr rrmanagerZ scroll_to&&&& rset_caret_positionZUtilities.set_caret_positionis ++-""4e4  - -c 2 2    $ &&s+ c* ((5 s+3vv'A'A#'F'JKL  **,==cMrcs><V^8dQhRS[PRS[RR/#)rr rr!Nr"r%r'rr(r)s/--   --  -rc s2\P!W4R#)z$Sets the caret offset via AtspiText.N)rr )rr rrrr ZUtilities.set_caret_offsets ,rcsx<V^8dQhRS[PRS[RS[RS[S[S[S[S[S[S[3,,/#rr rendr!rr#r$r6rzrEr%r'rr(r)sN     eCc3+, - rc s.pVPWV4pVFXwrgrW'8dKW68:dV#\W&4p\W74p\P!WV4p VP WgWV 34KZ V#)zAReturns a list of (start, end, string, language, dialect) tuples.)-get_language_and_dialect_from_text_attributesrrrrr.) rr rrrall_substringsrrlanguagedialectrs &&&& rsplit_substring_by_languageZ%Utilities.split_substring_by_languages46KKCX[\;I 7Lh""  u3LS-J))#ZHF II|7K L\P!W4wrEpWWd3.#)zJReturns a list of (obj, start, end, string) tuples for the word at offset.)rget_word_at_offsetrr rrrrrrrget_word_contents_at_offsetZ%Utilities.get_word_contents_at_offsets'"44SASS'((rc<V^8dQhRS[PR,RS[RS[R,RS[RS[S[S[PS[S[S[3,,/#rr Nr layout_moderr!rr%r'rr(r)e!!    $!!D[ !  ! eE$$c334 5 !rc sNVfVP4wrVR8Xd\P!V4p\P!W4wrVpV'dWWu3.#\P!W4wrp V 'g&VP V^4wrVP W4#V^^R3.#)zIReturns a list of (obj, start, end, string) tuples for the previous line.rtr)r rrZget_previous_lineget_line_at_offsetprevious_contextget_line_contents_at_offset) rr rr&rrrr _this_lineZ this_startZ _this_endprev_obj prev_offset &&&&& rget_previous_line_contentsZ$Utilities.get_previous_line_contentss ;002KC R<,,S1F!33C@S +, ,,2,E,Ec,R) $($9$9#q$A !H33HJ JaB  rcs<V^8dQhRS[PRS[RS[R,RS[RS[S[S[PS[S[S[3,,/#)rr rr&Nrr!rr%r'rr(r)s` ) )    ) )D[ )  ) eE$$c334 5 )rc s>\P!W4wrVpWWu3.#)zJReturns a list of (obj, start, end, string) tuples for the line at offset.)rr()rr rr&rrrr&&&&& rr*Z%Utilities.get_line_contents_at_offsets'"44SASS'((rcr$r%rr%r'rr(r)r'rc srVfVP4wrVR8Xd\P!V4p\P!W4wrVpV'dWWu3.#\P!W4wrp V \P !V48Xd%VP W4wrVPW4#V^^R3.#)zEReturns a list of (obj, start, end, string) tuples for the next line.rtr)r rrZ get_next_liner(r  next_contextr*) rr rr&rrrrr+Z _this_startZthis_endnext_obj next_offsetr.rget_next_line_contentsZ Utilities.get_next_line_contentss ;002KC R<,,S1F!//<S +, ,,2,E,Ec,R)  v11#6 6$($5$5c$D !H33HJ JaB  rc rrrr%r'rr(r)sR + +    + + + eE$$c334 5 +rc sN\P!V4pV^\V4V3.#)zLReturns a list of (obj, start, end, string) tuples for the object at offset.)rrHr/)rr rrrrrget_object_contents_at_offsetZ'Utilities.get_object_contents_at_offsets*""3'aTD)**rc rrrr%r'rr(r)%rrc r )z7Returns the sentence contents for the specified offset.)rZget_sentence_at_offsetr"rrget_sentence_contents_at_offsetZ)Utilities.get_sentence_contents_at_offset%s'"88ESS'((rc <V^8dQhRS[PR,RS[RS[RS[PR,RS[S[PR,S[3,/#rr Nr skip_spacerr!rr#r$rhrzr%r'rr(r)0sh    $  %%,  u$&+ , rc s VfVP4wrV^, pV'dd\P!W4^,pV'd?VP4'd)V^,p\P!W4^,pKFV^8dW3#VP W4;p'dWWq8wd)\P !V4'g V'gV^3#\P !V4pVP WxW44#R#)zEReturns the previous viable/valid caret context given obj and offset.r)r rget_character_at_offsetisspacerr r)) rr rr9rr-rr,Zlengths &&&&& rr)ZUtilities.previous_context0s ;002KCqj 11#CAFD4<<>>q 55cGJ ! # #00B B8 Bv'A'A('K'KT^{"//9F((:S Src r7r8r:r%r'rr(r)Nsh    $  %%,  u$&+ , rc s VfVP4wrV^,pV'dd\P!W4^,pV'd?VP4'd)V^, p\P!W4^,pKFV\P!V48:dW3#VP W4;p'dBWq8wd)\P!V4'g V'gV^3#VP VRW44#R#)zAReturns the next viable/valid caret context given obj and offset.rr)r rr;r<r rr1)rr rr9rr3rr2r0rr1ZUtilities.next_contextNs ;002KCqj 11#CAFD4<<>>q 55cGJ &44S9 9# #,,S> >8 >v'A'A('K'KT^{"$$Xr:K Krcsj<V^8dQhRS[PRS[RS[S[PS[3,/#)rr rr!)rr#r$rzr%r'rr(r)ks9  !1!1 3 5IYIY[^I^C_ rc s\P!V4'dW3#\P!V\P4pVeV^3#W3#)zBReturns the first viable/valid caret context given obj and offset.)r supports_textr)rr rZ descendantrr first_contextZUtilities.first_contextksM  ! !# & &; --c83I3IJ  !q= {rc s<V^8dQhRS[S[S[PS[S[S[3,,RS[RS[S[S[PS[S[S[3,,/#)rr infer_labelsr!)r6rzrr#r$rErhr%r'rr(r)ws[uU--sC<=> eE$$c334 5 rc sV#)zPFilters contents for presentation, removing objects that should not be included.ru)rrr?rr filter_contents_for_presentationZ*Utilities.filter_contents_for_presentationws rcsd<V^8dQhRS[PRS[S[PS[3,/#)rrr!)rr#rzr$r%r'rr(r)s1!1!1eE.is_matchs,("3"3A"6n"L..q1 1r)rZ is_paragraph is_editabler rFrr\ZCANVASZ LAYERED_PANEZICONrr TREE_ITEMrrrrrr,rTr+)rr rolemaprHrGs&& @rget_selection_containerZ!Utilities.get_selection_containersK  # #C ( (K,C,CC,H,H  & &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  !X%6%6s%;< 2 %%c44rcrrr"r%r'rr(r)s%>>   > >rc s6aa\P!V4'g^#\P!V4'd#\P!V4p\ ^V4#\ PP\ PP.\ PP\ PP./o\P!V4oSS9d\P!V4#VV3Rlp\VPW44#)z1Returns the number of selectable children in obj.csT<\P!V4SPS49#rL)r rTr,)rNrerKrrrHZ2Utilities.selectable_child_count..is_matchs"$$Q'7;;t+<< rrr\rrrrJrTrr/rQ)rr ZrowsrHrerKs&& @@rselectable_child_countZ Utilities.selectable_child_counts**3//  " "3 ' '((-Dq$<  JJ  %**"6"6!7 JJOOejj223    % w ++C0 0 =4--c<==rcrrr"r%r'rr(r)s% 9 9    9  9rc s\P!V4'd\P!V4#\P !V4#)z/Returns the number of selected children in obj.)r rrZget_selected_row_countrget_selected_child_countrkrrselected_child_countZUtilities.selected_child_counts7  " "3 ' '11#6 633C88rcrrrgr%r'rr(r)%    rc rs)zKReturns true if obj is a clickable element (in the web sense of that word).Frurkrris_clickable_elementZUtilities.is_clickable_element rcrrrgr%r'rr(r)rPrc rs)z>Returns true if obj has a longdesc (deprecated web attribute).Frurkrr has_long_descZUtilities.has_long_descrRrcrrrgr%r'rr(r)s)II   I Irc s\P!VR4;'g&\P!V\P4#)zMReturns true if obj has a toggle action that is meaningful. Because app bugs.Ztoggle)r rxrZ ACTION_TOGGLErkrrhas_meaningful_toggle_actionZ&Utilities.has_meaningful_toggle_actions= ""31II""3(9(G(GH Irc sh<V^8dQhRS[PRS[R,RS[S[S[S[3,/#)rr rNr!rr%r'rr(r)sCV V   V d V  sC}  V rc  sVf\P!V4p\P!W4wr4p\P!4P 4wrgWa8wdW4V3#\ P!4pVP4p VP4p \P!Wg4wrp VPPPR4R8Xd|V 'dTpTpM V 'dTpTp\P!WV4pVPRR4pRV RV RV RV R 2 p\P!\P VR 4W4V3#V 'dGTpVR ,P#4'g'VR ,P%4'g V^,pM}V 'dvTpW;8wdYu;8dV 8:dMMT pV^8dT\P!W^, V4pVP#4'g VP%4'g V^, p\P!WV4pRV9dHW;8XdBVP'R4'd V^, pM VP)R4'd V^,p\P!WV4pVPRR4pRV R V RV RV R 2 p\P!\P VR 4W4V3#) zDReturns the word at offset, adjusted for native navigation commands.ZlastTextUnitSpokenwordZ z\nz*SCRIPT UTILITIES: Adjusted word at offset z for ongoing word nav is 'z' (rZ)Tz for new word nav is 'r)rrr!rrXZget_penultimate_cursor_positionrZ'last_event_was_previous_word_navigationZ#last_event_was_next_word_navigationrpoint_of_referencer,rZreplacerrZr;r<Zisalnum startswithendswith)rr rrUrrr,r-r Zwas_previous_word_navZwas_next_word_navZ prev_wordZ prev_startZprev_endZ debug_stringrcZ last_chars&&& r*get_word_at_offset_adjusted_for_navigationZ4Utilities.get_word_at_offset_adjusted_for_navigations >,,S1F!44SAS - 9 9 ; [ [ ] ?# #%113 ' O O Q#GGI+1*C*CH*Z' x << * * . ./C D N$!"#''C8D<<e4LUG1SE4     0 0#t <# # !E H$$&&$r(*:*:*<*<q C Z%DH%D" z"00qj&I !))++y/@/@/B/B"QJE##C4 4> ,,X]];:> //7  . .u|| <  * * , @ @ B B<<2266v>> ,,X]];:> //7  . .u|| <rc <V^8dQhRS[/#rrhr%r'rr(r)vs4rc sf\P!4P4'dpVPPP R4'gCVPP \P4RVPPR&R#\P!4P4'dpVPPP R4'gCVPP \P4RVPPR&R#R#)z>Presents an undo/redo message when the locus of focus changes.rZTr[F) rrXr_rrVr,r`rrarcrdr]rOr!handle_undo_locus_of_focus_changeZ+Utilities.handle_undo_locus_of_focus_changevs  * * , @ @ B B<<2266v>> ,,X]];:> //7  * * , @ @ B B<<2266v>> ,,X]];:> //7rcrfrrgr%r'rr(r)s  D rc sT\P!4P4'dVPPP R4'gRVPP \P\P4RVPPR&R#R#)z9Presents a paste message when the locus of focus changes.r\TF) rrXZlast_event_was_pasterrVr,r`rZCLIPBOARD_PASTED_FULLZCLIPBOARD_PASTED_BRIEFr]rOr"handle_paste_locus_of_focus_changeZ,Utilities.handle_paste_locus_of_focus_changesu  * * , A A C C<<2266w?? ,,22H4S4SU;? //8rcrrrgr%r'rr(r)s%33   3 3rc sx\P!V4'gR#\P!V4'd\P!V4'gR#\P !V4'g\P !V4'dR#\P!V4pV\P!V48Xdc\P!V^4p\P!V4V8wdR#RV R2p\P!\PVR4R#\P !V4#)z.Returns True if all items in obj are selected.FzSCRIPT UTILITIES: All z! children believed to be selectedT)r rFrZ is_expandabler8rmis_menurrrNZget_selected_childrrrZr;rZall_cells_are_selected)rr Z child_countrrcrRrall_items_selectedZUtilities.all_items_selecteds**3//  $ $S ) )+2I2I#2N2N  # #C ( (K,?,?,D,D..s3 +>>sC C 223:E""5)S0*;-7XYC    0 0#t <--c22rcrrrgr%r'rr(r)s%    rc sVPPPR4pVPV4pV'd V'dR#W0PPR&\P !4P 4'dZV'dRVPP\P4\P !4PRVR4R#R#)z8Handles a change in a container that supports selection.ZallItemsSelectedTNF) rrVr,rkrrXlast_event_was_select_allr`rZCONTAINER_SELECTED_ALLrr )rr Zall_already_selectedZall_currently_selectedrr!handle_container_selection_changeZ+Utilities.handle_container_selection_changes $||>>BBCUV!%!8!8!= $:>T ''(:;  * * , F F H HMc LL ( ()H)H I  % % ' : :4e Lrcs@<V^8dQhRS[PRS[RS[/#)rr speak_messager!rgr%r'rr(r)s4VV   VV  Vrc sn \P!V4'gR#\P!4P 4'dR#\ P !V4wr4p\ P!V4\ P !V4wrgp\P!4P4'd:V'd2Wc8wd*VPP\P4R#\P!4P4'g<V'd4V'g,VPP\P4R#.p \\!WE44p \\!Wx44p V P#V 4'gR#V 'ddV 'd\V P%V 4'gEV P'WE\P(.4V P'Wx\P*.4EM\-V P/V 44p V 'gR#V ^,V R,^,rW8doV P'W\P*.4VP1R4'd6W]8Xd0\2P4!W^, 4pVP7VR4MgV P'W\P(.4VP1R4'd0\2P4!W^, 4pVP7VR4T;'d*\8P!4P;R4'*pV EF^wppp\ P<!VVV4pVP1R4pV'd V^,p\?V4R8dV'dV\P*8Xd:VPP\P@!\?V444MVPP\PB!\?V444MJVPPEVVV4V'd&V'gVPPVRR7V'gEK6\2P4!VV4pVP7W4EKa R#)z&Handles a change in the selected text.FTrZonlySpeakDisplayedTexti)Z interruptr)#r r=rrXZlast_event_was_cutrZget_cached_selected_textrbrlrrnrZDOCUMENT_SELECTED_ALLZlast_event_was_caret_selectionZSELECTION_REMOVEDZsetr=ZunionZ intersectionr.ZTEXT_UNSELECTEDZ TEXT_SELECTEDZsortedZsymmetric_differencerXr rhandle_text_selection_changer r{rr/Zselected_character_countZunselected_character_countZ say_phrase)rr rnZ old_stringZ old_startZold_endZ new_stringZ new_startZnew_endZchangesZ old_charsZ new_charsZchangeZ change_startZ change_endrrrZmessagerZends_with_childs&&& rroZ&Utilities.handle_text_selection_changes\%%c**  * * , ? ? A A)/)H)H)M& w**3/)/)H)H)M& w  * * , F F H HZ' **8+I+IJ#..0OOQQ* LL & &x'A'A Bi12 i12 y)) 9+A+A)+L+L NNI0H0HI J NNI0F0FG HI::9EFF'-ay&*q.*$ (:P:PQR&&x00W5L(<>?WXX #* E3))#uc:F$ooh7Oq6{T!mh444LL..x/P/PQTU[Q\/]^LL..x/R/RSVW]S^/_` ''UC8 LL..w%.H#88cB11%G%$+(rcs|<V^8dQhRS[PRS[PRS[PR,RS[/#)r old_focus new_focusrNr!)rr#rrhr%r'rr(r)sH<<##<##<{{T! <  <rc sRpVf2VR, p\P!\PVR4R#W8Xd2VR, p\P!\PVR4R#VPP R4'd2VR, p\P!\PVR4R#\ P !V4'dj\ P!V4'dN\ P!V4'd2VR, p\P!\PVR4R#\ P!V4'gj\ P!V4'g\ P!V4'd2VR , p\P!\PVR4R#\P!W!4'Ed \P!V4;p'd~V\P!V48Xd2VR , p\P!\PVR4R#VR , p\P!\PVR4R#\ P!V4'dP\ P !V4'dR#VR , p\P!\PVR4R#R#\ P"!W4'g\ P"!W!4'd2VR , p\P!\PVR4R#R#)zFReturns True if speech should be interrupted to present the new focus.z