Detailed Description

The Lost Routings Label is a widget for showing info about routings which are not connected.

The label will show the number of unconnected routings or the actual routing text based on configuration. When there are multiple lost routings, clicking the label will show the next lost routing when configured to do so.

Typical usage would be to place it in a message panel on the top of the main window and make it show in the event of lost routings. The following example demonstrates how to configure the various elements of such a panel:

• Starting out with an empty main window, drag in a CDPBaseContainer at the top of the page and an ordinary Widget at the bottom. Place the widgets in a vertical layout. Set layout margins to 0 and give the CDPBaseContainer a max height of about 40 pixels.
• The bottom widget is where you will design your application and the container where we will create our lost routings message panel.
• Drag two instances of the CDPBaseLostRoutingsLabel into the message panel. We'll configure the first one to show the number of lost routings by setting routingDisplay to Count. The second one is configured to show lost routings in text by selecting something other than Count in routingDisplay.
• Next, we'll drag in a CDPBaseLabel to function as a close/hide button on the right side of the panel. Set its text property to X, and set minimumSize and maximumSize to 40 to add extra space around the button.
• Finally, well add a horizontal layout to the panel and make the lost routings text expanding by selecting Expanding as the Horizontal Policy (located under the sizePolicy property group). You should also adjust the layout margins to make the panel look good with the rest of teh gui.
• To make the panel hide and show when there are lost routings, we will use qt signals and slots. Enter signals and slots mode by pressing F4 and make the following connections by drag and drop. Connect routing label signal lostRoutings to message panel showWidget. Similarily, connect lostRoutingsEmpty to hideWidget to make the message panel hide when there are no lost routings. Also, connect the clicked signal from our X label to hideWidget to enable it to hide the panel by click. It might be a good idea to also add a button in gui for showing the panel.
• To make the panel look more like an actual message panel, you can configure it with the the borderPixmap property set to, :/themes/cdp_light/backgrounds/bgMsgBox.svg, and select widgetStyle number 2.
• Some users also prefer to add a border around the lost routings number. This can be done by adding it to a QFrame with the following styling: QFrame {border: 1px solid gray; border-radius: 12px;}

  

  Note: Remember to set visible to false on the CDPBaseContainer unless you want the panel to show initially. Use the object inspector to show it again after making it invisible.