Merge fa05ccd into e71916d

rmcpantoja · web-flow · commit 59ea297e828c · 2024-01-25T07:34:35.000-05:00
diff --git a/source/globalCommands.py b/source/globalCommands.py
@@ -312,6 +312,35 @@ def script_dateTime(self,gesture):
 			text=winKernel.GetDateFormatEx(winKernel.LOCALE_NAME_USER_DEFAULT, winKernel.DATE_LONGDATE, None, None)
 		ui.message(text)
 
+	@script(
+		# Translators: Input help mode message for set the first value in the synth ring setting.
+		description=_("Set the first value of the current setting in the synth settings ring"),
+		category=SCRCAT_SPEECH,
+		gestures=("kb(desktop):NVDA+control+home", "kb(laptop):NVDA+shift+control+home")
+	)
+	def script_FirstValueSynthRing(self,gesture):
+		settingName=globalVars.settingsRing.currentSettingName
+		if not settingName:
+			# Translators: Reported when there are no settings to configure in synth settings ring (example: when there is no setting for language).
+			ui.message(_("No settings"))
+			return
+		settingValue=globalVars.settingsRing.first()
+		ui.message("%s %s" % (settingName,settingValue))
+
+	@script(
+		# Translators: Input help mode message for set the last value in the synth ring settings.
+		description=_("Set the last value of the current setting in the synth settings ring"),
+		category=SCRCAT_SPEECH,
+		gestures=("kb(desktop):NVDA+control+end", "kb(laptop):NVDA+shift+control+end")
+	)
+	def script_LastValueSynthRing(self,gesture):
+		settingName=globalVars.settingsRing.currentSettingName
+		if not settingName:
+			ui.message(_("No settings"))
+			return
+		settingValue=globalVars.settingsRing.last()
+		ui.message("%s %s" % (settingName,settingValue))
+
 	@script(
 		# Translators: Input help mode message for increase synth setting value command.
 		description=_("Increases the currently active setting in the synth settings ring"),
@@ -321,7 +350,6 @@ def script_dateTime(self,gesture):
 	def script_increaseSynthSetting(self,gesture):
 		settingName=globalVars.settingsRing.currentSettingName
 		if not settingName:
-			# Translators: Reported when there are no settings to configure in synth settings ring (example: when there is no setting for language).
 			ui.message(_("No settings"))
 			return
 		settingValue=globalVars.settingsRing.increase()
diff --git a/source/synthSettingsRing.py b/source/synthSettingsRing.py
@@ -14,6 +14,16 @@ def __init__(self,synth,setting,min=0,max=100):
 		self.max = setting.maxVal if isinstance(setting, NumericDriverSetting) else max
 		self.step = setting.normalStep if isinstance(setting, NumericDriverSetting) else 1
 
+	def first(self):
+		val = self.min
+		self.value = val
+		return self._getReportValue(val)
+
+	def last(self):
+		val = self.max
+		self.value = val
+		return self._getReportValue(val)
+
 	def increase(self):
 		val = min(self.max,self.value+self.step)
 		self.value = val
@@ -124,6 +134,18 @@ def previous(self):
 			return self.currentSettingName
 		return None
 
+	def first(self):
+		""" set the current setting to the first value """
+		if self._current is not None:
+			return self.settings[self._current].first()
+		return None
+
+	def last(self):
+		""" set the current setting to the last value """
+		if self._current is not None:
+			return self.settings[self._current].last()
+		return None
+
 	def increase(self):
 		""" increases the currentSetting and returns its new value """
 		if self._current is not None:
