TaurusLCD

class TaurusLCD(parent=None, designMode=False)

A Taurus-enabled Qt.QLCDNumber widget. Its text can represent either the rvalue or wvalue magnitude (or nothing), and the background can colour-code the attribute quality or the device state (or nothing)

Import from taurus.qt.qtgui.display as:

from taurus.qt.qtgui.display import TaurusLCD

DefaultBgRole = 'quality'

DefaultFgRole = 'value'

DefaultModelIndex = None

DefaultShowText = True

bgRole

This property holds the background role. Valid values are ‘’/’None’, ‘quality’, ‘state’

Access functions:

• TaurusLCD.getBgRole()

• TaurusLCD.setBgRole()

• TaurusLCD.resetBgRole()

controller()

fgRole

This property holds the foreground role. Valid values are:

1. ‘’/’None’ - no value is displayed

2. ‘value’ - the value is displayed

3. ‘w_value’ - the write value is displayed

Access functions:

• TaurusLCD.getFgRole()

• TaurusLCD.setFgRole()

• TaurusLCD.resetFgRole()

getBgRole()

getFgRole()

getModelIndex()

getModelIndexValue()

Called inside getDisplayValue to use with spectrum attributes. By default not used, but some widget might want to support this feature.

Note

getModelIndexValue() is only supported for the default model key

Override when needed.

classmethod getQtDesignerPluginInfo()

Returns pertinent information in order to be able to build a valid QtDesigner widget plugin.

The dictionary returned by this method should contain at least the following keys and values:

• ‘module’ : a string representing the full python module name (ex.: ‘taurus.qt.qtgui.base’)

• ‘icon’ : a string representing valid resource icon (ex.: ‘designer:combobox.png’)

• ‘container’a bool telling if this widget is a container widget or

  not.

This default implementation returns the following dictionary:

{ 'group'     : 'Taurus [Unclassified]',
  'icon'      : 'logos:taurus.png',
  'container' : False }

Returns:

a map with pertinent designer information

Return type:

dict

handleEvent(evt_src, evt_type, evt_value)

very basic and generalistic handling of events.

Override when necessary.

Parameters:

• evt_src (object or None) – object that triggered the event

• evt_type (taurus.core.taurusbasetypes.TaurusEventType or None) – type of event

• evt_value (object or None) – event value

isReadOnly()

Determines if this component is read-only or not in the sense that the user can interact with it. Default implementation returns True.

Override when necessary.

Returns:

whether or not this component is read-only

Return type:

bool

model

This property holds the unique URI string representing the model name with which this widget will get its data from. The convention used for the string can be found here.

Access functions:

• TaurusBaseWidget.getModel()

• TaurusLCD.setModel()

• TaurusBaseWidget.resetModel()

See also

Model concept

modelIndex

This property holds the index inside the model value that should be displayed

Access functions:

• TaurusLCD.getModelIndex()

• TaurusLCD.setModelIndex()

• TaurusLCD.resetModelIndex()

See also

Model concept

resetBgRole()

resetFgRole()

resetModelIndex()

setBgRole(bgRole)

setFgRole(fgRole)

setModel(m, **kwargs)

Sets/unsets the model name for the given key. If key is MLIST, a model is set for each name in the model sequence, new model keys are automatically added to the object’s modelList attribute and the corresponding models are attached using those keys. The new keys are of the form (MLIST, i) where i is the index of the corresponding model name in the model sequence.

Parameters:

• model (str (or sequence of str if key is MLIST)) – the new model name. If key is MLIST, model is expected to be a sequence of model names.

• key (object) – the model key. Defaults to first element of .modelKeys

setModelIndex(modelIndex)

useParentModel

(deprecated))