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 LabelCls:
"""
| Commands in total: 1
| Subgroups: 0
| Direct child commands: 1
"""
def __init__(self, core: Core, parent):
self._core = core
self._cmd_group = CommandsGroup("label", core, parent)
[docs]
def set(self, label: str, cursor=repcap.Cursor.Default, vertical=repcap.Vertical.Default) -> None:
"""
``CURSor<*>:VERTical<*>:LABel`` \n
Snippet: ``driver.cursor.vertical.label.set(label = 'abc', cursor = repcap.Cursor.Default, vertical = repcap.Vertical.Default)`` \n
Defines the label to be displayed with the vertical cursor lines. By default, the cursors are labeled as Cu1.1, Cu1.
2, Cu2.1, ...
:param label: String with the cursor label
:param cursor: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Cursor')
:param vertical: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Vertical')
"""
param = Conversions.value_to_quoted_str(label)
cursor_cmd_val = self._cmd_group.get_repcap_cmd_value(cursor, repcap.Cursor)
vertical_cmd_val = self._cmd_group.get_repcap_cmd_value(vertical, repcap.Vertical)
self._core.io.write(f'CURSor{cursor_cmd_val}:VERTical{vertical_cmd_val}:LABel {param}')
[docs]
def get(self, cursor=repcap.Cursor.Default, vertical=repcap.Vertical.Default) -> str:
"""
``CURSor<*>:VERTical<*>:LABel`` \n
Snippet: ``value: str = driver.cursor.vertical.label.get(cursor = repcap.Cursor.Default, vertical = repcap.Vertical.Default)`` \n
Defines the label to be displayed with the vertical cursor lines. By default, the cursors are labeled as Cu1.1, Cu1.
2, Cu2.1, ...
:param cursor: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Cursor')
:param vertical: optional repeated capability selector. Default value: Nr1 (settable in the interface 'Vertical')
:return: label: String with the cursor label
"""
cursor_cmd_val = self._cmd_group.get_repcap_cmd_value(cursor, repcap.Cursor)
vertical_cmd_val = self._cmd_group.get_repcap_cmd_value(vertical, repcap.Vertical)
response = self._core.io.query_str(f'CURSor{cursor_cmd_val}:VERTical{vertical_cmd_val}:LABel?')
return trim_str_response(response)