g f~R@dZdZdZdZdZdZddlZejdd dd lm Z d d l m Z d d l m Z d dl m Z d dl mZd dl mZd dl mZd dl mZd dl mZd dlmZd dlmZd dlmZd dlmZd dlmZGddZegZGddej>Z y)z:Utilities for obtaining braille presentations for objects.z$Id$z $Revision$z$Date$z-Copyright (c) 2005-2009 Sun Microsystems Inc.LGPLNAtspiz2.0)r)braille)debug) focus_manager) generator)messages)object_properties)settings)settings_manager)AXObject)AXText) AXUtilities)AXValue)shortRoleNamesceZdZdZddZy)SpacezxA dummy class to indicate we want to insert a space into an utterance, but only if there is text prior to the space.c||_yN) delimiterselfrs 8/usr/lib/python3/dist-packages/orca/braille_generator.py__init__zSpace.__init__2s "N )__name__ __module__ __qualname____doc__rrrrr/s @#rrceZdZdZej j ej jej jej jej jej jfZ dZ dZdZdZdZfdZdZd Zd Zd Zd Zd ZdZdZdZdZdZfdZfdZdZ dZ!dZ"ddZ#ddZ$xZ%S)BrailleGeneratoraTakes accessible objects and produces a list of braille Regions for those objects. See the generateBraille method, which is the primary entry point. Subclasses can feel free to override/extend the brailleGenerators instance field as they see fit.cFtjj||dy)Nr)r Generatorr)rscripts rrzBrailleGenerator.__init__Ds$$T69=rctjj|||j|d<tj |d<tj |d<tj|d<tj|d<|j|d<y)zCOther things to make available from the formatting string. space ComponentRegionTextLinkasStringN) r r' _addGlobalsr*rr+r,r-r.r/)r globalsDicts rr0zBrailleGenerator._addGlobalsGsp ''k:#zz G#*#4#4 K ' H%ll F%ll F"&-- Jrct|tjtjfsyt j ||j sytj|tj|j k(S)NF) isinstancerr+r-rhave_same_role accessiblerget_name)robjregions r_isCandidateFocusedRegionz*BrailleGenerator._isCandidateFocusedRegionRs^&7#4#4gll"CD))#v/@/@A  %):):6;L;L)MMMrc tjjdsLtjjds)tjtj ddgdgSt jjk(r|jddsd|d<jfi|} |d}|D]}t|tjtjfr8jj j#|j$dr|}||gSt|tjr>t'j(r)t+j,|j$k(r|}||gSt|tjst'j.st+j,|j$k(s|}||gSfd}t1t3||}d d |g}tj4tj |dt7|d k(r|d}||gS#t$rd}YwxYw) N enableBrailleenableBrailleMonitorz&BRAILLE GENERATOR: generation disabledT formatTypefocusedrc(j|Sr)r9)xr7rs rpredz.BrailleGenerator.generateBraille..preds55c1==rz9BRAILLE GENERATOR: Could not determine focused region forz Candidates:r)r getManager getSettingr printMessage LEVEL_INFOrget_locus_of_focusgetgenerate Exceptionr3rr+r-_script utilities isSameObjectr5r is_combo_boxr get_parent is_table_celllistfilter printTokenslen) rr7argsresult focusedRegionr8rA candidatestokenss `` rgenerateBraillez BrailleGenerator.generateBraille[s**,77H#..0;;fT623JQ=*6F   e.. =:!# *1  &&= ! M !sI IIc |jdr%tjjdsgSg}|jdt j |}tjjd}t jjt jjt jjt jjt jjg}tjt j|r$|j!t j ||t"j$k(rC|j't jj(t jj*g|t jj,k(rI|j.j0j3|}|j!t4j6|z|S|t"j8k(r8|jdds&||vr"|j!|j:|fi||S)aReturns the role name for the object in an array of strings, with the exception that the Atspi.Role.UNKNOWN role will yield an empty array. Note that a 'role' attribute in args will override the accessible role of the obj. isProgressBarUpdatebrailleProgressBarUpdatesrolebrailleVerbosityLevel readingRowF)rGr rBrCrget_rolerRoleUNKNOWNREDUNDANT_OBJECTFILLEREXTENDEDLINKr is_list_boxrNappendr VERBOSITY_LEVEL_BRIEFextendICONCANVASHEADINGrJrK headingLevelr ROLE_HEADING_LEVEL_BRAILLEVERBOSITY_LEVEL_VERBOSEgetLocalizedRoleName)rr7rTrUr]verbosityLevel doNotPresentlevels r_generateRoleNamez"BrailleGenerator._generateRoleNames 88) *#..0;;|j dt j|}tj |}|r|St|(|fi|S)zReturns the localized name of the given Accessible object; the name is suitable to be brailled. Arguments: - obj: an Accessible object brailleRolenameStyler]) r rBrCr BRAILLE_ROLENAME_STYLE_SHORTrGrr`rsuperrq)rr7rTr]rv __class__s rrqz%BrailleGenerator.getLocalizedRoleNamess  & & ( 3 34J K88 988FH$5$5c$:;D##D)B w+C8488rc g}|jjj|}|D]&}|j|fi|}|j |(|Sr)rJrKunrelatedLabels _generateNamerj)rr7rTrUlabelslabelnames r_generateUnrelatedLabelsz)BrailleGenerator._generateUnrelatedLabelssZ''77< E%4%%e4t4D MM$   rc tjjd}|tjk(rgSg}|j j j|\}}}|r|jd|zdz|S)zReturns an array of strings (and possibly voice and audio specifications) that represent the accelerator for the object, or an empty array if no accelerator can be found. r^()) r rBrCr rirJrKmnemonicShortcutAcceleratorrh)rr7rTrrrUmnemonicshortcut accelerators r_generateAcceleratorz%BrailleGenerator._generateAcceleratorsw *446AABYZ X;; ;I LL " " > >s C *8[  MM# +c1 2 rc g} |jjj|}|dkDr$|j t j ||S#t$rd}Y8wxYw)zReturns an array of strings that says how many alerts and dialogs are associated with the application for this object. [[[WDW - I wonder if this string should be moved to settings.py.]]] r)rJrKunfocusedAlertAndDialogCountrIrhr dialogCountBraille)rr7rTrUalertAndDialogCounts r_generateAlertAndDialogCountz-BrailleGenerator._generateAlertAndDialogCountsi  $ &&CCCH   " ]]8667JK L  $"#  $s%A A"!A"c g}tjjds|Sd|d<|jdt j |}|t jjk(}t j|}|r6t j ||jvrt j|}|rg}t j |}|t jjk7r|t jjk7r|t jjk7rw|t jjk7rZ|t jjk7r=|j j"j%|s||d<|j&|fi|}|t jjt jj(fvrr|j j"j+|}|rKt-|r@|j/s0|s,t j ||d<|j&|fi|}nd}|r&|r$|j1t3j4d|j7||t jj8k(rnt j|}|r|j;|S)aEReturns an array of strings (and possibly voice and audio specifications) that represent the text of the ancestors for the object. This is typically used to present the context for an object (e.g., the names of the window, the panels, etc., that the object is contained in). If the 'priorObj' attribute of the args dictionary is set, only the differences in ancestry between the 'priorObj' and the current obj will be computed. The 'priorObj' is typically set by Orca to be the previous object with focus. enableBrailleContextFincludeContextr]r)r rBrCrGrr`rra RADIO_BUTTONget_parent_checkedSKIP_CONTEXT_ROLESrdINVALIDSECTION SPLIT_PANE DESKTOP_FRAMErJrK isLayoutOnlyrHPANELdisplayedLabelrSisspacerhrr,rjEMBEDDEDreverse) rr7rTrUr]excludeRadioButtonGroupparent parentResultrs r_generateAncestorsz#BrailleGenerator._generateAncestorss+**,778NOM!& xx 1 1# 67"&%***A*A"A,,S1 x((0D4K4KK008FL $$V,Duzz(((EJJ...EJJ...EJJ111EJJ444 ..;;FC#V ,t}}V 0N4'x#J9". EN$:"  D.< ;& rr%)!r"__id__ __version____date__ __copyright__ __license__girequire_version gi.repositoryrrrrrr r r r r ax_objectrax_textr ax_utilitiesrax_valuerbraille_rolenamesrrrr'r%r#rrrs(A ?  7E"%-##  Sy**Sr