Property Documentation

addEventsFront : bool

This property holds the bool value which decides if new events shall be added in the end (if false) or in front (if true). By default it is set to .

Access functions:

cdpRoutings : QStringList

This property holds cDP object full names the events should be retrieved from (and from the child objects under them), while running in Web UI. When left empty, then all events from all applications of the system will be shown when the CDPEventList is running in the Web UI.

Access functions:

coloursInList : QString

This property holds which text/background colours to use in list, unless svg is used. skipSvgRowBg and skipSvgRowTextColor must be set if these colours shall be used.

This property can be set from the 'Colour selection'-menu/dialog, by right-clicking in header. The property should be set from the dialog, but it is constructed like this: Semicolon-separated info, ended with semicolon: first number is 0 (All columns) or 1 (only Status and Level columns), then ';', then 26 semicolon-separated colour-values (hex) for different combinations of level and status, in this sequence: ERROR_UnackSet_TC;ERROR_Unack_TC;ERROR_Set_TC;ERROR_OK_TC; WARNING_UnackSet_TC;WARNING_Unack_TC;WARNING_Set_TC;WARNING_OK_TC; NOTIFY_UnackSet_TC;NOTIFY_Unack_TC;NOTIFY_Set_TC;NOTIFY_OK_TC; ERROR_UnackSet_BC;ERROR_Unack_BC;ERROR_Set_BC;ERROR_OK_BC; WARNING_UnackSet_BC;WARNING_Unack_BC;WARNING_Set_BC;WARNING_OK_BC; NOTIFY_UnackSet_BC;NOTIFY_Unack_BC;NOTIFY_Set_BC;NOTIFY_OK_BC; OtherColumns_TC;OtherColumns_BC;

Access functions:

columnHeaders : QString

This property holds which columns (text in column-header) to be shown in the list, and indirectly which event-values to show.

This property can be set from the 'Column selection'-menu/dialog (and 'Column Width selection'-menu/dialog), by right-clicking in header. The property should be set from the dialog, but it is constructed like this:

Semicolon-separated info, ended with semicolon:
Visible;Visible;NotSelected;NotSelected;
Between 'Visible;' and 'Visible;', the columns to be shown should be listed,
while between 'NotSelected;' and 'NotSelected;', the columns not to be shown
should be listed.
The column info should be listed like this:
N=<text-string in header>;V=number in range [0..NUMB_EVENTINFOVARIABLES-1]
corresponding to variable in EventInfoVariable;W=width-number;|
Notice the end-character '|'. The width-number is used if columnWidthAdjMode
is Fixed or Interactive (not if Auto).
Example for columns-info: N=Date,Time Event;V=4;W=166;|N=Status;V=2;W=89;|
N=Name;V=5;W=148;|N=Level;V=9;W=79;|

Note: To change the text that shows in column-header, you must edit the text after 'N=' directly in this property.

Access functions:

See also columnWidthAdjMode.

columnSorted : EventInfoVariable

This property holds value which decides which column the list is sorted by. Default is CDPEventList::level.

Access functions:

columnWidthAdjMode : AdjustmentMode

This property holds the column width adjustment mode (Auto/Fixed/Interactive).

This property can be set from the 'Column Width selection'-menu/dialog, by right-clicking in header. In this dialog, you may also set the width-numbers used in CDPEventList::columnHeaders-property.

For the last column, QHeaderView::Stretch will be applied, causing automatically resize the section to fill the available space.

Access functions:

See also columnHeaders.

enableEventCodeFiltering : bool

This property holds the bool value deciding if there will be filtering on event codes or not.

This property can be set from the 'EventCodes to view'-menu/dialog, by right-clicking in header.

Access functions:

See also eventCodesToViewFilterValue().

eventCodesToViewFilterValue : uint

This property holds filter-value(s) for which events (with matching bits in eventCode) will be shown.

This property can be set from the 'EventCodes to view'-menu/dialog, by right-clicking in header. If value is 0x00000000 or 0xFFFFFFFF, there will be no filtering (all events will be shown). CDPEventList::enableEventCodeFiltering must be true if any filtering shall be done.

Access functions:

See also enableEventCodeFiltering().

eventIdSortOrder : Qt::SortOrder

This property holds sortorder of column eventId as second sorting, when columnSorted is timestamp/timestampLocal and time is equal. Default sortorder is Qt::DescendingOrder.

Is used if the list is sorted by the column timestamp or timestampLocal: When two lines have equal time, the sorting sequence is decided by the order of the eventId.

Access functions:

See also columnSorted.

eventInfoProperties : QString

This property holds decides which extra property-values will be requested and shown when opening the EventInfoDialog.

eventInfoProperties are semicolon-separated, and they must be set in Design-mode. The property and values are typically found in the CDPAlarm-lines in the xml-files, and if the property is listed in the eventInfoProperties semicolon-separated string, the property and the value will be shown when opening the EventInfoDialog. An example of this property-string could be: "PossibleCause1;PossibleCause2;PossibleCause3;PossibleSolution1;PossibleSolution2;PossibleSolution3;". A CDPAlarm could then contain e.g.: PossibleCause1="..." PossibleCause2="..." PossibleSolution1="..." PossibleSolution2="...".

To open the EventInfoDialog (only if listType is not database), you have several possibilities:

• The slot showEventInfoDialog() will open the EventInfoDialog
• Right click on an event/alarm andf choose 'Event Details...' from the context menu
• If the property openEventInfoDialogByClick is true, the EventInfoDialog will open when clicking on an event/alrm in the list

Access functions:

See also openEventInfoDialogByClick.

fontFamily : QString

This property holds font family value.

Default is Arial. Is not set if empty. If fontfamily from svg is wanted to be used, let this property be empty.

Access functions:

fontItalic : bool

This property holds value which decides if italic font will be used or not. By default it is set to .

Access functions:

fontSize : int

This property holds font size value.

Must be > 0. Is not set if illegal value (default is -1, meaning not set). If fontsize from svg is wanted to be used, let this property have illegal value, like -1.

Access functions:

fontWeight : int

This property holds font weight value.

enum QFont::Weight, 0=ultralight, 99=extremely black, legal values [0..99]. Is not set if illegal value. Default value is -1, meaning not set.

Access functions:

groupsAvailable : QString

This property holds only other group-names available but not selected into the CDPEventList::groupsToView-property.

This property can be set from the 'Groups to view'-menu/dialog, by right-clicking in header.

Access functions:

groupsToView : QString

This property holds the value(s) of how and if there will be filtering on groups or not.

Group-names are semicolon-separated. If empty or 'All' is found, there will be no filtering. Otherwise, only events belonging to one or more of the specified groups will be shown. This property can be set from the 'Groups to view'-menu/dialog, by right-clicking in header.

Access functions:

levelsToView : LevelsToView

This property holds the value(s) of how and if there will be filtering on levels or not.

This property (enum CDPEventList::LevelsToView) can be set from the 'Levels to view'-menu/dialog, by right-clicking in header.

Access functions:

lineHeight : int

This property holds line height value. Default is 30.

Access functions:

listType : ListModelType

This property holds what type of events the list will show.

Access functions:

minimumColumnWidth : int

This property holds minimum column width value. Default is 30.

Access functions:

multiSelection : bool

This property holds the bool value which decides if multiple rows can be selected or not. If true, when the user selects an item in the usual way, the selection status of that item is toggled and the other items are left alone. By default it is set to .

Access functions:

openEventInfoDialogByClick : bool

This property holds the bool value which decides if clicking on and event/alarm in the list will open the EventInfodialog or not.

Note: By default this property is set to false.

Access functions:

See also eventInfoProperties.

pixmapStatusLevelOkErr : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Ok and level is Error.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelOkNot : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Ok and level is Notify.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelOkWar : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Ok and level is Warning.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelSetErr : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Set and level is Error.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelSetNot : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Set and level is Notify.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelSetWar : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Set and level is Warning.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelUnErr : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Unack and level is Error.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelUnNot : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Unack and level is Notify.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelUnSetErr : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Unack-Set and level is Error.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelUnSetNot : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Unack-Set and level is Notify.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelUnSetWar : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Unack-Set and level is Warning.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusLevelUnWar : QString

This property holds value which decides if and which pixmap-symbol to show in column statuslevel (enum EventInfoVariable) when status is Unack and level is Warning.

If property is empty (default), no pixmap will be shown. The different combinations of status and level are found in enum StatusLevel. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Access functions:

pixmapStatusOk : QString

This property holds value which decides if and which pixmap-symbol to show in column status (enum EventInfoVariable) when status is Ok.

If property is empty (default), no pixmap will be shown. Then the status text will be shown in the status column. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Note: If you specify a pixmap to be shown, the property textAlsoPixmapStatus decides if both pixmap and text shall be shown, or only pixmap.

Access functions:

See also textAlsoPixmapStatus.

pixmapStatusSet : QString

This property holds value which decides if and which pixmap-symbol to show in column status (enum EventInfoVariable) when status is Set.

If property is empty (default), no pixmap will be shown. Then the status text will be shown in the status column. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Note: If you specify a pixmap to be shown, the property textAlsoPixmapStatus decides if both pixmap and text shall be shown, or only pixmap.

Access functions:

See also textAlsoPixmapStatus.

pixmapStatusUnack : QString

This property holds value which decides if and which pixmap-symbol to show in column status (enum EventInfoVariable) when status is Unack.

If property is empty (default), no pixmap will be shown. Then the status text will be shown in the status column. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Note: If you specify a pixmap to be shown, the property textAlsoPixmapStatus decides if both pixmap and text shall be shown, or only pixmap.

Access functions:

See also textAlsoPixmapStatus.

pixmapStatusUnackSet : QString

This property holds value which decides if and which pixmap-symbol to show in column status (enum EventInfoVariable) when status is Unack-Set.

If property is empty (default), no pixmap will be shown. Then the status text will be shown in the status column. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file.

Note: If you specify a pixmap to be shown, the property textAlsoPixmapStatus decides if both pixmap and text shall be shown, or only pixmap.

Access functions:

See also textAlsoPixmapStatus.

pixmapsEventCodes : QString

This property holds value which decides if pixmaps should be loaded in the eventCode (enum EventInfoVariable) column or not.

If property is empty (default), no pixmap will be shown. Then only the eventCode text will be shown in the eventCode column. Different files can be specified for each of the Eventcodes listed (you may add as many eventcodes as wanted), telling which pixmap to show, correspondingly. The files (bmp,gif,jpg,jpeg,png,pbm,pgm,ppm,xbm,xpm) must be specified with full path/relative to run-directory/or begin with ':/' to indicate that file is found in the resource file. The value of the eventcode must match exactly. The property is semicolon-separated, ended with semicolon. Example: "0x00000001;D:\Projects\pixmaps\alarmSet32x32.png;0x00000004;D:\Projects\pixmaps\alarmAck32x32.png;"

Note: If you specify a pixmap to be shown, the property textAlsoPixmapsEventCodes decides if both pixmap and text shall be shown, or only pixmap.

Access functions:

See also textAlsoPixmapsEventCodes.

popUpWarnings : bool

This property holds if pop up warnings are allowed in case of error. By default it is set to .

Access functions:

showGrid : bool

Access functions:

showHorizontalHeader : bool

Access functions:

skipSvgRowBg : bool

This property holds the bool value which decides if Background colour is fetched from svg or not. If set, Background colour is fetched from CDPEventList::coloursInList property instead.

Access functions:

See also coloursInList.

skipSvgRowTextColor : bool

This property holds the bool value which decides if Text colour is fetched from svg or not. If set, Text colour is fetched from CDPEventList::coloursInList property instead.

Access functions:

See also coloursInList.

sortOrder : Qt::SortOrder

This property holds sortorder of column specified in columnSorted. Default Qt::AscendingOrder.

Access functions:

See also columnSorted.

statusToView : StatusToView

This property holds the value(s) of how and if there will be filtering on status or not.

This property (enum CDPEventList::StatusToView) can be set from the 'Status to view'-menu/dialog, by right-clicking in header.

Access functions:

svgFile : const QString

This property holds the name of svg-file to be used for configuration. Default value from plugin is .

Access functions:

textAlsoPixmapStatus : bool

This property holds bool-value which decides if text shall be shown in addition to pixmap in column status (enum EventInfoVariable) (if pixmap is specified). By default it is set to .

Access functions:

See also pixmapStatusUnackSet, pixmapStatusUnack, pixmapStatusSet, and pixmapStatusOk.

textAlsoPixmapsEventCodes : bool

This property holds bool-value which decides if text shall be shown in addition to pixmap in column eventCode (enum EventInfoVariable) (if pixmap is specified). By default it is set to .

Access functions:

See also pixmapsEventCodes.

timeStampFormat : TimeStampFormat

This property holds the value which specifies in which format the the time/date is shown in the timestamp/timestampLocal column. Can be set from the 'Timestamp Format'-menu/dialog, by right-clicking in header.

Access functions:

timestampSortOrder : Qt::SortOrder

This property holds sortorder of column timestamp/timestampLocal as second sorting, when columnSorted is level and level is equal. Default sortorder is Qt::AscendingOrder.

Is used if the list is sorted by the column level: When two lines have equal level, the sorting sequence is decided by the order of the column timestamp or timestampLocal (decided by the property useTimestampLocal).

Access functions:

See also columnSorted and useTimestampLocal.

useTimestampLocal : bool

This property holds value which decides if timestamp or timestampLocal is used as second sorting when columnSorted is level, and the events have equal level.

Access functions:

See also columnSorted and timestampSortOrder.

userCanChangeSortColumn : bool

This property holds value which decides if user is allowed to change which column to sort by.

If set to true, user can click on column-header causing list to be sorted by that column. If false, clicking have no effect (list is sorted as given by properties.

Access functions:

See also columnSorted.

version : QString

This property holds the LIB_VERSION. CDPEventList::setVersion doesn't do anything.

Access functions:

viewColourSelectionMenu : bool

This property holds the bool value which decides if the 'Colour selection'-menu/dialog is listed/available when right-clicking in header.

Note: When right-clicking in Design mode, the menu is always available. This property has only influence when running your application. Default true.

Access functions:

viewColumnWidthSelectionMenu : bool

This property holds the bool value which decides if the 'Column Width selection'-menu/ dialog is listed/available when right-clicking in header.

Note: When right-clicking in Design mode, the menu is always available. This property has only influence when running your application. Default true.

Access functions:

viewEventCodesToViewMenu : bool

This property holds the bool value which decides if the 'EventCodes to view'-menu/dialog is listed/available when right-clicking in header.

Note: When right-clicking in Design mode, the menu is always available. This property has only influence when running your application. Default true.

Access functions:

viewFilterColumnMenu : bool

This property holds the bool value which decides if the 'Filter column'-menu/dialog is listed/available when right-clicking in header.

Note: When right-clicking in Design mode, the menu is always available. This property has only influence when running your application. Default true.

Access functions:

viewGroupsToViewMenu : bool

This property holds the bool value which decides if the 'Groups to view'-menu/dialog is listed/available when right-clicking in header.

Note: When right-clicking in Design mode, the menu is always available. This property has only influence when running your application. Default true.

Access functions:

viewLevelsToViewMenu : bool

This property holds the bool value which decides if the 'Levels to view'-menu/dialog is listed/available when right-clicking in header.

Note: When right-clicking in Design mode, the menu is always available. This property has only influence when running your application. Default true.

Access functions:

viewMenuColumnSelectionMenu : bool

This property holds the bool value which decides if the 'Column selection'-menu/dialog is listed/available when right-clicking in header.

Note: This property has only influence when running your application. Default true.

Access functions:

viewProvidersGroupsSelectionMenu : bool

This property holds the bool value which decides if the 'Providers and Groups selection'- menu/dialog is listed/available when right-clicking in header.

Note: When right-clicking in Design mode, the menu is always available. This property has only influence when running your application. Default true.

Access functions:

viewStatusToViewMenu : bool

This property holds the bool value which decides if the 'Status to view'-menu/dialog is listed/available when right-clicking in header.

Note: When right-clicking in Design mode, the menu is always available. This property has only influence when running your application. Default true.

Access functions:

viewTimestampFormatMenu : bool

This property holds the bool value which decides if the 'Timestamp Format'-menu/dialog is listed/available when right-clicking in header.

Note: When right-clicking in Design mode, the menu is always available. This property has only influence when running your application. Default true.

Access functions: