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 TextCls:
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("text", core, parent)
[docs]
def set(self, text: str, window=repcap.Window.Default, trace=repcap.Trace.Default) -> None:
"""
``DISPlay[:WINDow<n>]:TRACe<t>:LABel:TEXT`` \n
Snippet: ``driver.applications.k10Xlte.display.window.trace.label.text.set(text = 'abc', window = repcap.Window.Default, trace = repcap.Trace.Default)`` \n
Defines a descriptive label for the specified trace instead of the default 'Trace <x>' label. Enable the label using the
method ``RsFsw.display.window.trace.label.state.set()`` command. You can only configure labels for active traces and for
traces whose 'State' is enabled.
:param text: String containing the trace label.
:param window: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Window')
:param trace: optional repeated capability selector. Default value: Tr1 (settable in the interface 'Trace')
"""
param = Conversions.value_to_quoted_str(text)
window_cmd_val = self._cmd_group.get_repcap_cmd_value(window, repcap.Window)
trace_cmd_val = self._cmd_group.get_repcap_cmd_value(trace, repcap.Trace)
self._core.io.write(f'DISPlay:WINDow{window_cmd_val}:TRACe{trace_cmd_val}:LABel:TEXT {param}')
[docs]
def get(self, window=repcap.Window.Default, trace=repcap.Trace.Default) -> str:
"""
``DISPlay[:WINDow<n>]:TRACe<t>:LABel:TEXT`` \n
Snippet: ``value: str = driver.applications.k10Xlte.display.window.trace.label.text.get(window = repcap.Window.Default, trace = repcap.Trace.Default)`` \n
Defines a descriptive label for the specified trace instead of the default 'Trace <x>' label. Enable the label using the
method ``RsFsw.display.window.trace.label.state.set()`` command. You can only configure labels for active traces and for
traces whose 'State' is enabled.
:param window: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Window')
:param trace: optional repeated capability selector. Default value: Tr1 (settable in the interface 'Trace')
:return: text: String containing the trace label.
"""
window_cmd_val = self._cmd_group.get_repcap_cmd_value(window, repcap.Window)
trace_cmd_val = self._cmd_group.get_repcap_cmd_value(trace, repcap.Trace)
response = self._core.io.query_str(f'DISPlay:WINDow{window_cmd_val}:TRACe{trace_cmd_val}:LABel:TEXT?')
return trim_str_response(response)