Source code for RsAreg800.Implementations.Display.Dialog

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


# noinspection PyPep8Naming,PyAttributeOutsideInit,SpellCheckingInspection
[docs] class DialogCls: """Dialog commands group definition. 4 total commands, 0 Subgroups, 4 group commands""" def __init__(self, core: Core, parent): self._core = core self._cmd_group = CommandsGroup("dialog", core, parent)
[docs] def close(self, dialog_id: str) -> None: """SCPI: DISPlay:DIALog:CLOSe \n Snippet: driver.display.dialog.close(dialog_id = 'abc') \n Closes the specified dialog. \n :param dialog_id: To find out the dialog identifier, use the query method RsAreg800.Display.Dialog.id. The DialogName part of the query result is sufficient. """ param = Conversions.value_to_quoted_str(dialog_id) self._core.io.write(f'DISPlay:DIALog:CLOSe {param}')
[docs] def close_all(self) -> None: """SCPI: DISPlay:DIALog:CLOSe:ALL \n Snippet: driver.display.dialog.close_all() \n Closes all open dialogs. \n """ self._core.io.write(f'DISPlay:DIALog:CLOSe:ALL')
[docs] def close_all_with_opc(self, opc_timeout_ms: int = -1) -> None: """SCPI: DISPlay:DIALog:CLOSe:ALL \n Snippet: driver.display.dialog.close_all_with_opc() \n Closes all open dialogs. \n Same as close_all, but waits for the operation to complete before continuing further. Use the RsAreg800.utilities.opc_timeout_set() to set the timeout value. \n :param opc_timeout_ms: Maximum time to wait in milliseconds, valid only for this call.""" self._core.io.write_with_opc(f'DISPlay:DIALog:CLOSe:ALL', opc_timeout_ms)
[docs] def get_id(self) -> str: """SCPI: DISPlay:DIALog:ID \n Snippet: value: str = driver.display.dialog.get_id() \n Returns the dialog identifiers of the open dialogs in a string separated by blanks. \n :return: dialog_id_list: Dialog identifiers are string without blanks. Blanks are represented as $$. Dialog identifiers DialogID are composed of two main parts: DialogName[OptionalParts] - DialogName: Meaningful information, mandatory input parameter for the commands::DISPlay:DIALog:OPEN:DISPlay:DIALog:CLOSe - Optional parts: String of $X values, where X is a character, interpreted as follows:$qDialogQualifier: optional dialog qualifier, usually the letter A or B, as displayed in the dialog title.$iInstances: comma-separated list of instance indexes, given in the order h,c,s,d,g,u,0. Default is zero; the terminating ',0' can be omitted.$tTabIds: comma-separated indexes or tab names; required, if a dialog is composed of several tabs.$xLeft$yTop$hLeft$wTop: position and size; superfluous information.""" response = self._core.io.query_str('DISPlay:DIALog:ID?') return trim_str_response(response)
[docs] def open(self, dialog_id: str) -> None: """SCPI: DISPlay:DIALog:OPEN \n Snippet: driver.display.dialog.open(dialog_id = 'abc') \n Opens the specified dialog. \n :param dialog_id: To find out the dialog identifier, use the query method RsAreg800.Display.Dialog.id. The DialogName part of the query result is mandatory. """ param = Conversions.value_to_quoted_str(dialog_id) self._core.io.write(f'DISPlay:DIALog:OPEN {param}')