Using your own widgets derived from Taurus base classes

The following example demonstrates how widgets displaying devices of the OmsVme58 server class are configured with an update period of 300 msecs. This is done by creating a new class, TaurusValueHB, derived from TaurusValue.

Figure 7.21: taurusform: replacing taurus widgets

The code:

from taurus.qt.qtgui.taurusgui.utils import PanelDescription,\
    ExternalApp, ToolBarDescription, AppletDescription

from taurus.qt.qtgui.panel.taurusform import TaurusForm

GUI_NAME = 'heartbeatform'
ORGANIZATION = 'DESY'


dcm_motor_control = PanelDescription(
    'DCM motor control',
    classname = 'TaurusForm',
    model = ['tango://haso228k:10000/p09/motor/exp.29',
             'tango://haso228k:10000/p09/motor/exp.30'])


if __name__ == '__main__':
    from taurus.qt.qtgui.application import TaurusApplication
    from taurus.qt.qtgui.taurusgui import TaurusGui
    from taurus.external.qt import Qt
    app = TaurusApplication()
    gui = TaurusGui()
    cwmap = gui.getCustomWidgetMap()
    cwmap.update({
        'OmsVme58': ('nxstaurusgui.heartbeat.TaurusValueHB', (),
                     {'period': 300, 'attr': 'position'}),
    })
    gui.setCustomWidgetMap(cwmap)
    gui.loadConfiguration(__file__)
    gui.show()
    app.exec_()

In the above example:

• the TaurusValue widget of TaurusForm is replaced by the TaurusValueHB widget from the nxstaurusgui.heartbeat package. TaurusValueHB has to be in a module which is in PYTHONPATH. TaurusValueHB is TaurusValue with set its heartbeat period.
• in PanelDescription() only device name is given (without its attribute)
• TaurusGui() is created without its arguments
• after creating TaurusGUI CustomWidgetMap is set by assigning the new class into the required device class. Depending on a new widget type its widget contructor parameters can be passed in futher positions of the dictionary tuple, i.e. 'period' or 'attr'.
• after setting the custom widget map the loadConfiguration() method is called
• the custom widget map is set globally, i.e. for all panels.