# `ExternalAppAction`

digraph inheritance6d8c5ce776 { bgcolor=transparent; rankdir=UD; ratio=compress; size="8.0, 12.0"; "BaseConfigurableClass" [URL="taurus.qt.qtcore.configuration-BaseConfigurableClass.html#taurus.qt.qtcore.configuration.BaseConfigurableClass",color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded,target="_top",tooltip="A base class defining the API for configurable objects."]; "ExternalAppAction" [URL="#taurus.qt.qtgui.util.ExternalAppAction",color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded,target="_top",tooltip="An specialized QAction for launching external applications"]; "QAction" -> "ExternalAppAction" [arrowsize=0.5,style="setlinewidth(0.5)"]; "BaseConfigurableClass" -> "ExternalAppAction" [arrowsize=0.5,style="setlinewidth(0.5)"]; "QAction" [color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded,tooltip="QAction(parent: QObject|None = None)"]; "QObject" -> "QAction" [arrowsize=0.5,style="setlinewidth(0.5)"]; "QObject" [color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded,tooltip="QObject(parent: QObject|None = None)"]; "wrapper" -> "QObject" [arrowsize=0.5,style="setlinewidth(0.5)"]; "simplewrapper" [color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded]; "wrapper" [color=dodgerblue1,fillcolor=white,fontcolor=black,fontname="Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans",fontsize=10,height=0.5,shape=box,style=rounded]; "simplewrapper" -> "wrapper" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

class ExternalAppAction(cmdargs, text=None, icon=None, parent=None, interactive=True)

  An specialized QAction for launching external applications

  Signals: apart of those from QAction, it emits a “cmdArgsChanged” signal with the current cmdArgs list as its argument.

  Import from `taurus.qt.qtgui.util` as:

      from taurus.qt.qtgui.util import ExternalAppAction

  DEFAULT_ICON_NAME = 'application-x-executable'
  actionTriggered(args=None)

    launches the external application as a subprocess

  check()

    Returns True if the application is available for executing

    Returns:

    Return type:

      bool

  cmdArgs()
  cmdArgsChanged

    int = …, arguments: Sequence = …) -> PYQT_SIGNAL

    types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

    Type:

      pyqtSignal(*types, name

    Type:

      str = …, revision

  kill()
  setCmdArgs(cmdargs, emitsignal=True)

    Sets the command args for executing this external application.

    It emits the “cmdArgsChanged” signal with the new cmdArgs list

    Parameters:

      cmdargs (list<str> or str) – A list of strings to be passed to `subprocess.Popen()` for launching the external application. It can also be a string containing a command, which will be automatically converted to a list