Added matlab.py script.

Author: CyrilleB79

README.md

@@ -12,7 +12,7 @@ This may include potential features in development, (to be included later in an
     * copy the script you want to install in the corresponding subfolder (appModules or globalPlugins) of the scratchpad folder.
 
 
-## Scripts
+## globalPlugins Scripts
 
 ### globalPlugins/autoLangSwitch.py
 
@@ -29,6 +29,7 @@ This script provides information on any script in input help mode. If the execut
 
 Executing a gesture bound to a script without description in input help mode also create an entry for this script in the gesture management dialog. This entry is located in a dedicated category called "Scripts without description (modify at your own risk!)". This allow to easily add, delete or change the native NVDA gestures for these script.
 Be aware however that it is often intended that such script do not have any description to prevent the user to modify the associated gesture. Indeed, the gesture may be defined to match an application shortcut key. For example the script script_toggleItalic on NVDAObjects.window.winword.WordDocument is bound to control+I and this should not be modified since the gesture is passed to the application to actually execute the shortcut key.
+
 Known bug: A script added for a specific class is visible even if gesture manager is opened in another context.
 
 ### globalPlugins/debugTool.py
@@ -62,11 +63,17 @@ name, role, state, value, windowClassName, windowControlID, windowHandle, locati
 If you have installed [Speech history review and copying][3]  addon from Tyler Spivey and James Scholes, you may use it to copy and paste the announced property to review it;
 review via copy/paste is especially useful for pythonClassMRO since it may be long.
 
+## appModules scripts
+
+### appModules/matlab.py
+
+A script to issue some commands in Matlab console by just pressing a keystroke. E.g. press F5 to issue "dbcont" command.
+
 ## Removed scripts
 
 ### globalPlugins/startupOptionWorkaround.py
 
-This script has been package as an add-on: [Startup option workaround add-on][4] that is itself deprecated.
+This script has been packaged as an add-on: [Startup option workaround add-on][4] that is itself deprecated.
 
 With Windows 10 1903 update, NVDA may start after logon even when this is disabled in General settings panel (cf. [#9528][1]).
 This script does not fix the issue. However, as a work-around, it unloads NVDA just after startup in the case it should not have started up at all.

appModules/matlab.py

@@ -0,0 +1,81 @@
+# Matlab App Module for NVDA
+
+
+import appModuleHandler
+from NVDAObjects.behaviors import Terminal
+import controlTypes
+
+SEND_CMD = 'sendCommand'
+
+class AppModule(appModuleHandler.AppModule):
+
+	# Allow this to be overridden for derived applications.
+	#TERMINAL_WINDOW_CLASS = "MATLAB"
+
+	def chooseNVDAObjectOverlayClasses(self, obj, clsList):
+		import NVDAObjects.behaviors, NVDAObjects.window, NVDAObjects.window.winConsole
+		if obj.windowClassName == "Edit" and obj.role == controlTypes.ROLE_EDITABLETEXT:
+			#obj.STABILIZE_DELAY = 0
+			clsList[0:0] = [
+				NVDAObjects.behaviors.Terminal,
+				NVDAObjects.window.DisplayModelLiveText,
+				NVDAObjects.window.DisplayModelEditableText,
+				]
+			
+			
+		if False and obj.windowClassName == "Edit" and obj.role == controlTypes.ROLE_EDITABLETEXT:
+			from NVDAObjects.window import DisplayModelEditableText, DisplayModelLiveText
+			from NVDAObjects.window import winConsole #.WinConsole
+			try:
+				clsList.remove(DisplayModelEditableText)
+			except ValueError:
+				pass
+			#clsList[0:0] = (winConsole.WinConsole, Terminal, DisplayModelLiveText)
+			clsList[0:0] = (Terminal, DisplayModelLiveText)
+			
+	def __init__(self, *args, **kw):
+		super(AppModule, self).__init__(*args, **kw)
+		self.commandTable = [
+			('DbCont', 'dbcont', 'kb:F5'),
+			('DbStepIn', 'dbstepin', 'kb:F8'),
+			('DbStepOut', 'dbstepout', 'kb:control+shift+F8'),
+			('DbStep', 'dbstep', 'kb:shift+F8'),
+			('DbQuit', 'dbquit', 'kb:shift+escape'),
+			('ClearSound', 'clear sound', 'kb:F7'),
+			('GoToCurrentExecPoint', '', 'kb:control+shift+G'),
+			]
+		self.createAllScript_sendCommand()
+		dicGestures = {gesture: SEND_CMD+name for name,cmd,gesture in self.commandTable}
+		self.bindGestures(dicGestures)
+		
+	def sendCommand(self, sCmd, gesture):
+		import brailleInput
+		import inputCore
+		import keyboardHandler
+		#inputCore.manager.emulateGesture(keyboardHandler.KeyboardInputGesture.fromName("home"))
+		#inputCore.manager.emulateGesture(keyboardHandler.KeyboardInputGesture.fromName("control+delete"))
+		brailleInput.handler.sendChars(sCmd)
+		inputCore.manager.emulateGesture(keyboardHandler.KeyboardInputGesture.fromName("enter"))
+		
+	def DISABLED_zzz_chooseNVDAObjectOverlayClasses(self, obj, clsList):
+		if obj.windowClassName == "Edit" and obj.role == controlTypes.ROLE_EDITABLETEXT:
+			#clsList.insert(0, EnhancedEditField)
+			clsList.insert(0, Terminal)
+
+	@staticmethod
+	def _createScript_sendCommand(name, cmd):
+		def  _genericScript_sendCommand(self, gesture):
+			self.sendCommand(cmd,gesture)
+		#Translators: Input help mode message pattern for the script used to send commands to Matlab.
+		_genericScript_sendCommand.__doc__ = _("Send a command to Matlab: {name}").format(name=name)
+		return _genericScript_sendCommand
+	
+	
+	def createAllScript_sendCommand(self):
+		for name, cmd, gesture in self.commandTable:
+			scriptName = 'script_' + SEND_CMD + name
+			scriptFun = self._createScript_sendCommand(scriptName, cmd)
+			setattr(self.__class__, scriptName, scriptFun)
+	
+AppModule.scriptCategory = _("Matlab")
+