Bases: PyQt4.QtGui.QPushButton, taurus.qt.qtgui.base.taurusbase.TaurusBaseWidget
This class provides a button that executes a tango command on its device.
Code examples:
# a button that executes the "status" command for the 'a/b/c' device server
button = TaurusCommandButton(command = 'Status', icon=':/taurus.png')
button.setModel('a/b/c')
# a button that executes the "exec" command for the 'a/b/c' device server with one parameter
button = TaurusCommandButton(command = 'Status', parameters=['2+2'],icon=':/taurus.png')
button.setModel('a/b/c')
See also
TaurusCommandsForm provides a good example of use of TaurusCommandButton (including managing the return value)
returns the command name to be executed when the button is clicked
Return type: | :class:~`str` or :class:~`None` |
---|---|
Returns: | the command name |
Returns the custom text of the buttom, or None if no custom text is used
Returns the current apply danger message or None if the apply operation is safe
Return type: | :class:~`str` or :class:~`None` |
---|---|
Returns: | the apply danger message |
Returns the model name for this component.
Return type: | :class:~`str` |
---|---|
Returns: | the model name. |
returns the parameters to be used on command execution
Parameters: | parameters (:class:~`sequence`) – |
---|
Returns whether this component is using the parent model
Return type: | :class:~`bool` |
---|---|
Returns: | True if using parent model or False otherwise |
returns the command name to be executed when the button is clicked
Return type: | :class:~`str` or :class:~`None` |
---|---|
Returns: | the command name |
Returns the custom text of the buttom, or None if no custom text is used
see TaurusBaseComponent.displayValue()
returns the parameters to be used on command execution
Parameters: | parameters (:class:~`sequence`) – |
---|
Slot called when the button is clicked. It executes the command with parameters. It may issue a warning if the command is flagged as dangerous. On successful execution, it returns the command result and it emits a “commandExecuted” signal with the result as well.
Returns: | The result of the command. The type depends on the command. It may be None. |
---|
See also
setCommand(), setParameters(), TaurusBaseComponent.isDangerous()
equivalent to self.setCommand(None)
Equivalent to setCustomText(None)
Equivalent to setParameters(None)
sets the command to be executed when the button is clicked
Parameters: | commandName (:class:~`str` or :class:~`None`) – the command name |
---|
Sets a custom text for the button (by default it is the command name)
Parameters: | customText (:class:~`str` or :class:~`None`) – the custom text. If None passed, it will use the command name |
---|
Sets the parameters to be used on command execution.
Parameters: | parameters (:class:~`sequence`) – a sequence of parameters. If the elements of the sequence are not of the right type required for the parameter, an automatic conversion will be attempted on execution time. As a special case, if parameters is a string, it will be splitted on whitespace to obtain a sequence of parameters. |
---|