Detailed Description

The Text Selector displays different texts based on numeric values.

Unlike the CDPBaseComboBox, this widget is read only and can not be changed by user clicks. Note that the above picture shows four different widget states (four widget instances showing different indexes).

Texts are added, removed and rearranged by right-clicking the widget and selecting “Edit Items...” from the context menu. Click on the green plus sign to add text items and note that the order is identical to the signal value for selecting it. Note that we can select to send/receive index numbers or content by editing the cdpUseIndexNr property, inherited from CDPBaseComboBox.

Note that the widget inherits CDPBaseComboBox and thus all of its properties. Some default settings is necessary to make the widget function as intended.

Styling by SVG

Use the svgFile property to style the widget using a svg file. Styling by svg enables switching between different themes in runtime (as long as the files are placed at identical locations within theme directories).

The CDPBaseTextSelector can use the standard svg structure of the CDPBaseComboBox. It can also have its own svg file following the naming conventions listed below.

svg
└─── Layer1
  ├─── cdpText                    (text)
  ├─── cdpBorderMarginTopLeft     (transparent rect/path)
  ├─── cdpBorderMarginBottomRight (transparent rect/path)
  ├─── cdpBackground              (element group)
  ├─── cdpButtonDown              (element group)
  ├─── cdpButtonDownPressed       (element group)
  ├─── cdpButtonDownDisabled      (element group)
  └─── cdpIconDown                (element group)
               ├─── < Path >      (transparent rect/path)
               └─── < Group >     (background graphics)

The following table explains the named elements in more detail.