Source code for RsFsw.Implementations.Calculate.Mask.Comment

from ....Internal.Core import Core
from ....Internal.CommandsGroup import CommandsGroup
from ....Internal import Conversions
from ....Internal.Utilities import trim_str_response
from .... import repcap


# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
class CommentCls:
	"""
	| Commands in total: 1
	| Subgroups: 0
	| Direct child commands: 1
	"""

	def __init__(self, core: Core, parent):
		self._core = core
		self._cmd_group = CommandsGroup("comment", core, parent)



	def set(self, comment: str, window=repcap.Window.Default) -> None:
		"""
		``CALCulate<n>:MASK:COMMent`` \n
		Snippet: ``driver.calculate.mask.comment.set(comment = 'abc', window = repcap.Window.Default)`` \n
		Defines a comment for the frequency mask that you have selected with method ``RsFsw.calculate.mask.name.set()`` .

		:param comment: String containing the comment for the frequency mask.
		:param window: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Calculate')
		"""
		param = Conversions.value_to_quoted_str(comment)
		window_cmd_val = self._cmd_group.get_repcap_cmd_value(window, repcap.Window)
		self._core.io.write(f'CALCulate{window_cmd_val}:MASK:COMMent {param}')




	def get(self, window=repcap.Window.Default) -> str:
		"""
		``CALCulate<n>:MASK:COMMent`` \n
		Snippet: ``value: str = driver.calculate.mask.comment.get(window = repcap.Window.Default)`` \n
		Defines a comment for the frequency mask that you have selected with method ``RsFsw.calculate.mask.name.set()`` .

		:param window: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Calculate')
		:return: comment: String containing the comment for the frequency mask.
		"""
		window_cmd_val = self._cmd_group.get_repcap_cmd_value(window, repcap.Window)
		response = self._core.io.query_str(f'CALCulate{window_cmd_val}:MASK:COMMent?')
		return trim_str_response(response)