g f@\dZdZdZdZdZdZddlmZddlmZdd lm Z dd lm Z dd lm Z dd lm Z dd lm Z ddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z Gd d!Z!y")#a$Each script maintains a set of key bindings, braille bindings, and AT-SPI event listeners. The key bindings are an instance of KeyBindings. The braille bindings are also a dictionary where the keys are BrlTTY command integers and the values are instances of InputEventHandler. The listeners field is a dictionary where the keys are AT-SPI event names and the values are function pointers. Instances of scripts are intended to be created solely by the script manager. This Script class is not intended to be instantiated directly. Instead, it is expected that subclasses of the Script class will be created in their own module. The module defining the Script subclass is also required to have a 'getScript(app)' method that returns an instance of the Script subclass. See default.py for an example.z$Id$z $Revision$z$Date$z-Copyright (c) 2005-2009 Sun Microsystems Inc.LGPL)ax_event_synthesizer)action_presenter)braille_generator)debug) event_manager)flat_review_presenter) formatting) keybindings)label_inference)learn_mode_presenter) mouse_review)notification_presenter)object_navigator)script_utilities)settings_manager)sleep_mode_manager)sound_generator)speech_and_verbosity_manager)speech_generator)structural_navigation)system_information_presenter)table_navigator) bookmarks)where_am_i_presenter)AXObjectc(eZdZdZdZdZdZdZd1dZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!d Z"d!Z#d"Z$d#Z%d$Z&d%Z'd&Z(d'Z)d2d)Z*d*Z+d+Z,d,Z-d-Z.d.Z/d/Z0d0Z1y()3Scriptz:The specific focus tracking scripts for applications. c||_|r)tj|jxsd|_nd|_|xjd|jzdzz c_|j |_d|_|j|_ |j|_ |j|_ |j|_|j!|_|j%|_|j)|_|j-|_|j1|_|j5|_|j9|_|j=|_|jA|_!|jE|_#|jI|_%|jM|_'|jQ|_)|jU|_+|jY|_-i|_.i|_/|jatcjd|_3|ji|_5|jm|_7|jq|_9|ju|_;|jy|_=i|_>i|_?|j|_Ad|_Bd|jd}tjtj|dy) zCreates a script for the given application, if necessary. This method should not be called by anyone except the script manager. Arguments: - app: the Python Accessible application to create a script for defaultz (module=)TFzSCRIPT: z initializedN)Fapprget_namename __module__ getListeners listenerspresentIfInactive getUtilities utilitiesgetLabelInferencelabelInferencegetStructuralNavigationstructuralNavigationgetCaretNavigationcaretNavigation getBookmarksrgetLiveRegionManagerliveRegionManagergetNotificationPresenternotificationPresentergetFlatReviewPresenterflatReviewPresentergetSpeechAndVerbosityManagerspeechAndVerbosityManagergetSystemInformationPresentersystemInformationPresentergetObjectNavigatorobjectNavigatorgetTableNavigatortableNavigatorgetWhereAmIPresenterwhereAmIPresentergetLearnModePresenterlearnModePresentergetMouseReviewer mouseReviewergetEventSynthesizereventSynthesizergetActionPresenteractionPresentergetSleepModeManagersleepModeManagergetChatchatinputEventHandlerspointOfReferencesetupInputEventHandlersr KeyBindings keyBindingsgetBrailleBindingsbrailleBindings getFormattingr getBrailleGeneratorbrailleGeneratorgetSoundGeneratorsoundGeneratorgetSpeechGeneratorspeechGeneratorgeneratorCache eventCache getSpellCheck spellcheckfindCommandRunr printMessage LEVEL_INFO)selfr"msgs -/usr/lib/python3/dist-packages/orca/script.py__init__zScript.__init__Isu  ))$((3@yDI!DI [4??2S88 **,"&**,"446$($@$@$B!#668**,!%!:!:!<%)%B%B%D"#'#>#>#@ )-)J)J)L&*.*L*L*N'#668"446!%!:!:!<"&"<"<">!224 $ 8 8 :#668 $ 8 8 :LLN "$ " $$&&224#668,,. $ 8 8 :"446#668 ,,.# <0 5++S$7c|jSN)r$rcs re__str__zScript.__str__s))rgciS)zSets up the AT-SPI event listeners for this script. Returns a dictionary where the keys are AT-SPI event names and the values are script methods. rjs rer&zScript.getListeners  rgcy)zlDefines InputEventHandler fields for this script that can be called by the key and braille bindings.Nrmrjs rerPzScript.setupInputEventHandlerss rgc*tjS)zkDefines the key bindings for this script. Returns an instance of keybindings.KeyBindings. r rQ)rc enabledOnlys regetKeyBindingszScript.getKeyBindingss &&((rgc*tjS)z9Returns the toolkit-specific keybindings for this script.rqrjs regetToolkitKeyBindingszScript.getToolkitKeyBindings&&((rgc*tjS)z=Returns the application-specific keybindings for this script.rqrjs regetAppKeyBindingszScript.getAppKeyBindingsrvrgciS)zDefines the braille bindings for this script. Returns a dictionary where the keys are BrlTTY commands and the values are InputEventHandler instances. rmrjs rerSzScript.getBrailleBindingsrnrgc,tj|S)z/Returns the formatting strings for this script.)r Formattingrjs rerUzScript.getFormattings$$T**rgc,tj|S)z7Returns the braille generator for this script. )rBrailleGeneratorrjs rerVzScript.getBrailleGenerators!11$77rgc,tj|S)z,Returns the sound generator for this script.)rSoundGeneratorrjs rerXzScript.getSoundGenerator--d33rgc,tj|S)z6Returns the speech generator for this script. )rSpeechGeneratorrjs rerZzScript.getSpeechGenerators //55rgcy)z2Returns the 'chat' class for this script. Nrmrjs rerLzScript.getChatsrgcy)z/Returns the spellcheck support for this script.Nrmrjs rer^zScript.getSpellCheckrgcy)z5Returns the caret navigation support for this script.Nrmrjs rer/zScript.getCaretNavigationrrgc,tj|S)z&Returns the utilities for this script.)r Utilitiesrjs rer)zScript.getUtilitiess))$//rgc,tj|S)z:Returns the label inference functionality for this script.)r LabelInferencerjs rer+zScript.getLabelInferencerrgcgS)zaReturns a list of the structural navigation object types enabled in this script. rmrjs re#getEnabledStructuralNavigationTypesz*Script.getEnabledStructuralNavigationTypess  rgc|j}tjjd}t j |||S)z:Returns the 'structural navigation' class for this script.structuralNavigationEnabled)rr getManager getSettingrStructuralNavigation)rctypesenables rer-zScript.getStructuralNavigations?88:!,,.99:WX$99$vNNrgcy)z0Returns the live region support for this script.Nrmrjs rer2zScript.getLiveRegionManagerrrgc*tjSri)r getPresenterrjs rer4zScript.getNotificationPresenters%2244rgc*tjSri)r rrjs rer6zScript.getFlatReviewPresenters$1133rgc*tjSri)rrrjs rer:z$Script.getSystemInformationPresenters+88::rgc*tjSri)r getNavigatorrjs rer<zScript.getObjectNavigator,,..rgc*tjSri)rrrjs rer>zScript.getTableNavigators++--rgc*tjSri)rrrjs rer8z#Script.getSpeechAndVerbosityManagers+6688rgc*tjSri)rrrjs rer@zScript.getWhereAmIPresenter#0022rgc*tjSri)r rrjs rerBzScript.getLearnModePresenterrrgc*tjSri)rrrjs rerHzScript.getActionPresenterrrgc*tjSri)rrrjs rerJzScript.getSleepModeManagers!,,..rgc*tjSri)r getReviewerrjs rerDzScript.getMouseReviewers''))rgc*tjSri)rgetSynthesizerrjs rerFzScript.getEventSynthesizers#2244rgc |jS#t$r)tj||_|jcYSwxYw)z7Returns the "bookmarks" class for this script. )rAttributeError Bookmarksrjs rer1zScript.getBookmarks s< ">> ! "&006DN>> ! "s /AAcy)zxReturn a GtkGrid containing the application unique configuration GUI items for the current application. Nrmrjs regetAppPreferencesGUIzScript.getAppPreferencesGUIsrgciS)z7Returns a dictionary with the app-specific preferences.rmrjs regetPreferencesFromGUIzScript.getPreferencesFromGUIs  rgcJtjj|y)zTells the event manager to start listening for all the event types of interest to the script. Arguments: - script: the script. N)rrregisterScriptListenersrjs reregisterEventListenerszScript.registerEventListenerss   "::4@rgcJtjj|y)zTells the event manager to stop listening for all the event types of interest to the script. Arguments: - script: the script. N)rrderegisterScriptListenersrjs rederegisterEventListenerszScript.deregisterEventListeners)s   "<>&&( +Czz$$S)#s#E* +rgNc|jj|ddg\}}|s*d|g}tjtj|dy|E||j k7r6d|j d|g}tjtj|dy|E||j k7r6d|j d|g}tjtj|dy|E||jk7r6d|jd|g}tjtj|dyd|g}tjtj|d|S) NzSCRIPT: No queued event of typeTz SCRIPT: Queued event's detail1 (z) doesn't matchz SCRIPT: Queued event's detail2 (z!SCRIPT: Queued event's any_data (z$SCRIPT: Found matching queued event:)r]getr printTokensrbdetail1detail2any_data)rc eventTyperrr cachedEvent eventTimetokenss re_getQueuedEventzScript._getQueuedEventUsB!%!4!4Yq !J Y7CF   e.. =  7k.A.A#A8+:M:M'2F   e.. =  7k.A.A#A8+:M:M'2F   e.. =  H 0D0D$D9!**,=xIF   e.. =8+F %**FD9rgcV|jj|jddg\}}|r||k(rydg}ddg}gd}d}|j|vs|j|vr|j|jk(rd}d }n|j|vrP|j|jk7r7|j|jk(r|j|jk(rd}d }n|jj d r|j|jk(rd}d }nj|jj d rO|j|jk(r6|j|jk(r|j|jk(rd}d}|r*d|g} tjtj| d|S)aGives us, and scripts, the ability to decide an event isn't worth taking the time to process under the current circumstances. Arguments: - event: the Event Returns True if we shouldn't bother processing this object event. NrFzobject:state-changed:focusedzobject:text-changed:insertzobject:text-changed:delete)zobject:text-caret-movedzobject:text-selection-changedzobject:selection-changedz object:active-descendant-changedTz5more recent event of the same type in the same objectz8more recent event of the same type in a different objectsystemz+more recent system event in the same objectzobject:state-changedz+appears to be duplicate state-changed eventzSCRIPT: Skipping object event:) r]rrsourcerendswithrrrrb) rcrrrfocustypingarrowingskipreasonrs rerzScript.skipObjectEventrs"&!4!4UZZ$!K YkU22302NOT JJ( "ejjF&:||{111DLF ZZ5 U\\[5G5G%G{///+"5"55DOF ZZ  *u||{?Q?Q/QDBF ZZ " "#9 :{///!3!33+"5"55DBF 6 LF   e.. = rgcy)aUpdates state and presents changes to the user in response to a notification from the FocusManager. Do not call this method outside of the FocusManager. Arguments: - event: if not None, the Event that caused the change - oldLocusOfFocus: Accessible that is the old locus of focus - newLocusOfFocus: Accessible that is the new locus of focus Nrm)rcroldLocusOfFocusnewLocusOfFocuss relocusOfFocusChangedzScript.locusOfFocusChangeds rgcy)aReturns True if the given event is one that should cause this script to become the active script. This is only a hint to the focus tracking manager and it is not guaranteed this request will be honored. Note that by the time the focus tracking manager calls this method, it thinks the script should become active. This is an opportunity for the script to say it shouldn't. Trmrcrs reisActivatableEventzScript.isActivatableEventsrgcy)z8Allows scripts to insist that they should become active.Frmrs reforceScriptActivationzScript.forceScriptActivationsrgcy)z%Called when this script is activated.Nrmrjs reactivatezScript.activate rgcy)z'Called when this script is deactivated.Nrmrjs re deactivatezScript.deactivaterrgciSrirmrjs regetTransferableAttributesz Script.getTransferableAttributess rg)T)NNN)2__name__r% __qualname____doc__rfrkr&rPrsrurxrSrUrVrXrZrLr^r/r)r+rr-r2r4r6r:r<r>r8r@rBrHrJrDrFr1rrrrrrrrrrrrrrmrgrerrEs<8| )) ) +8 46  04 O 54;/.933//*5"  AC +D:+Z      rgrN)"r__id__ __version____date__ __copyright__ __license__rrrrrr r r r r rrrrrrrrrrrrrr ax_objectrrrmrgrers}(D  ?  "#"$ *#*"rg