svg
└─── Layer1
  ├─── cdpText                     (text)
  ├─── cdpMenuColor                (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)

Property Documentation

cdpOfflineValue : const double

This property holds the value to show when communication is offline and cdpOfflineValueEnabled is set to true.

The property has no effect when cdpOfflineValueEnabled is set to false.

See also cdpOfflineValueEnabled.

cdpOfflineValueEnabled : const bool

This property holds whether or not to show cdpOfflineValue when communication is offline.

Setting the property to false will make the widget keep/show the last value when communication is down.

See also cdpOfflineValue.

cdpRouting : QString

This property holds the routing to the CDP object that the widget is to connect and control.

The routing is bi-directional. This means that if two combo boxes or other widgets are routed to control the same remote object, they will all receive and show new values when the remote value is changed.

Access functions:

cdpTimeoutMs : int

This property holds the time to wait before confirming the combobox selection.

If there is no signal at the specified route, default value is 0.0 .

Note: This property is ignored if cdpRouting is not set.

Access functions:

cdpUpdateOnSlotOnly : bool

This property holds whether to send a value to the routed CDP object when done editing or only when triggered by the sendToCdp slot function.

Setting this property to true allows for use in settings dialogs where you want to be able to edit values without sending them to the control system. Then, when done editing, the user can decide whether to send or revert the changes by clicking buttons connected to sendToCdp or resetToCdp.

Note that multiple widgets, that support cdpUpdateOnSlotOnly, can be placed/grouped in a container widget to avoid Signal and Slot connections to all of them. The container has slots similar to sendToCdp and resetToCdp that will execute on all child widgets.

Access functions:

See also resetToCdp and sendToCdp.

cdpUseIndexNr : bool

This property holds whether to use the index value of an item in the list to send to the cdp signal instead of the actual value noted in the list.

Note: This has to be unchecked when the combobox is used to send text to a cdpProperty.

Access functions:

See also index0, index1, index2, and index3.

cdpVisibleRouting : const QString

This property holds the full path of the signal/parameter that controls the “visible” property.

Note: Values not equal to 1 are considered false.

See also visible.

cssFile : QString

This property holds the css file to use for customization.

http://doc.qt.io/qt-5/stylesheet-examples.html#customizing-qspinbox

Access functions:

See also svgFile.

currentIndex : int

This property holds the value of the current index.

Access functions:

disabledStateOpacity : double

This property holds the level of opacity for the widget in the disabled state.

The valid range of opacity is from 1.0 (completely opaque) to 0.0 (completely transparent).

Setting this property configures a fixed opacity that can be different than the global opacity used in other widgets.

Access functions:

font : QFont

This property holds the font to be used in widget.

Access functions:

fontColor : QColor

This property holds the font color.

Note: If set, this overrides the text color from SVG file and the entire code received from CSS file.

Access functions:

See also svgFile and cssFile.

icon : QString

This property holds the icon to show on the “Down” button.

If stylingType is set to SVG, this option overrides the icon parsed from the svg file.

Access functions:

See also stylingType and svgFile.

index0 : QColor

This property holds the color to show if index 0 is selected.

Access functions:

See also index1, index2, index3, and useIndexColor.

index1 : QColor

This property holds the color to show if index 1 is selected.

Access functions:

See also index0, index2, index3, and useIndexColor.

index2 : QColor

This property holds the color to show if index 2 is selected.

Access functions:

See also index0, index1, index3, and useIndexColor.

index3 : QColor

This property holds the color to show if index 3 is selected.

Access functions:

See also index0, index1, index2, and useIndexColor.

noSystemBackground : bool

This property holds whether the widget has a background.

Newly exposed areas are never filled with the background.

Access functions:

See also opaquePaintEvent.

opaquePaintEvent : bool

This property holds whether the widget is transparent.

Set true to optimize painting when having no transparency in widget graphics This property should be set true on all widgets that does not require transparency. It will prevent Qt from painting widgets behind current widget and thus increase performance.

Access functions:

See also visible and noSystemBackground.

outOfBoundsAction : OutOfBoundsAction

This property holds what to do if receiving a signal or property from a CDPObject that is not in the list.

Options are:

• Show the first item in the list
• Show the last item in the list
• Add the value at first of the list ( Careful if cdpUseIndexNr is set. )
• Add the value at end of the list ( Careful if cdpUseIndexNr is set. )

Access functions:

See also cdpUseIndexNr.

padTitle : QString

This property holds the title of the input pad.

The pad title can only be set if a pad type is defined using the padType property. Since specifying a pad type requires the combo box to be editable, the editable property must also be set to true. See Editable Mode for details.

Access functions:

See also padType.

padType : CDPBasePadLauncher::GlobalDialog

This property holds the input pad used for manual value entry.

This property requires the widget to be editable, which can be enabled by setting the editable property to true. When enabled, padType allows a keypad to be used instead of a hardware keyboard for entering values.

Clicking inside the combo box line edit opens the keypad, while clicking the combo box button still allows selecting from pre-defined values.

See Editable Mode for more details.

Access functions:

See also padTitle.

pushRoutables : const QStringList

Access functions:

Notifier signal:

stylingType : StylingType

This property holds a selection of how to customize the widget.

Options are:

• "NoFile" - Don't use a file for customization
• "CSS" - Use a css file specified by cssFile property for customization
• "SVG" - Use a svg file specified by svgFile property for customization

Note: To customize in QtDesigner, set this property to "NoFile".

Access functions:

See also svgFile and cssFile.

svgFile : QString

This property holds the path to the svg file that styles the widget.

The path can be either to a resource or a file on disk.

Note: Resources can be overridden by files on disk with identical names.

Access functions:

See also cssFile.

svgOverwriteGeneratedFiles : bool

This property holds whether every time loadSvg() is called, the widget creates new png images from the svg file or not.

Access functions:

See also svgFile.

useIndexColor : bool

This property holds whether to make the text change color depending on what index is shown.

Note: If set, this overrides the text color from SVG file, and the entire code received from CSS file.

Note: If index exceeds index3, the color of index0 is shown.

Access functions:

See also svgFile and cssFile.

visible : const bool

This property holds whether to show the QWidget or not.

See also cdpVisibleRouting.