Detailed Description

The UI Loader Widget class loads form (.ui) files dynamically and includes functionality to replace routings in real-time.

The widget supports being used as a routing target, similar to the Routing Container, to enable relative routings in the loaded form. This makes it easy to load multiple instances of a UI file for different targets without having to create separate UI files with different routings.

Relative routings are configured in the form as described in the Design Mode Manual. To make the routing completer show selectable nodes, the top-level widget in the UI file needs to support target routing. This is ensured by selecting a Routing Container or Container widget as the Form Template when creating the UI file. Adding an absolute routing in the cdpTargetRouting property of that widget will enable relative routings in the completer for all widgets in the form. The target routing will only affect Design mode and get ignored when loaded by a UI Loader Widget. See the Example section for a short example.

The routing replacement functionality allows one form file to show data from different objects with the click of a button. Routings can be changed either by providing replacement strings to the slot named setRoutingReplacement(QString) or by configuring replacement strings as dynamic properties in the following format:

stringReplacement1="$(REPLACE1)=Replacement1;$(REPLACE2)=OtherReplacement1"
stringReplacement2="$(REPLACE1)=Replacement2;$(REPLACE2)=OtherReplacement2"

You can provide any number of replacements separated by ";". The replacements are added by first specifying the string that is to be replaced in the routings, followed by an equal sign, and then the string that we want to replace it with (e.g. $(COMPONENT)=Pump1).

The dynamic properties must be named stringReplacement followed by a number. In CDP Studio Design mode, this is done similarly to adding dynamic routings as described in the Design Mode Manual. After configuring the properties, providing the numbers to the slot named setRoutingReplacement(int) or setRoutingReplacement(double) will select the routing replacements. It is also possible to control this using a cdp object by adding routing to the property named cdpSelectReplacementRouting. To select an initial replacement without using routing, we can add a dynamic property of int type named initReplacement. It is important that the property is added after the last stringReplacement property to ensure that the replacement is available when executing the replacement:

stringReplacement0="$(REPLACE)=ReplacementString1"
stringReplacement1="$(REPLACE)=ReplacementString2"
initReplacement=0

The replacement strings are executed on the routings from left to right. The order of the first replacements will be used in all consecutive replacements. Meaning, that if stringReplacement2 in the first example had $(REPLACE2) as its first replacement, it would still be executed after $(REPLACE1) as this is the order used in stringReplacement1. The same goes if the replacements are added using setRoutingReplacement(QString).

To avoid broken routings in the application, the template variables need to be wrapped in $(). The alternative is to ensure that the initial routings are valid (e.g. use MyComp1 instead of $(REPLACE1) in the above example and then use MyComp1=MyComp2 in stringReplacement2 etc.).

Example

The following examples discuss how to use the CDPBaseUiLoaderWidget.

How to Load a Form within a Form

A simple example of using the CDPBaseUiLoaderWidget is to create two form files, main.ui, and load.ui. The main form is typically based on CDPBaseMainWindow and the second one is usually based on a standard QWidget. Add a CDPBaseUiLoaderWidget to the main form and make it load the load.ui form by editing the property named, uiFileName.

How to Replace Routings in a Loaded Form

Start by adding a CDPBaseMeter to the load.ui form and add the following routing to the cdpRouting property; AppName.$(SIGNAL).Value. In this string, the word $(SIGNAL) is what we want to replace. Replace AppName with the name of your application if it is named differently.

Next, we need to set up the replacement strings on the CDPBaseUiLoaderWidget in the main.ui form. Create a dynamic property by clicking on the plus icon next to the filter in the property panel and selecting String... Name the property stringReplacement1 and repeat the steps to create a second property named stringReplacement2. Add the following value in the first property $(SIGNAL)=CPULoad and add $(SIGNAL)=MemUsedRelative to the second one.

Now, when the CDPBaseUiLoaderWidget receives the value 1 or 2, either by setRoutingReplacement slot or by adding routing in the property named cdpSelectReplacementRouting, the CDPBaseMeter will show CPULoad or MemUsedRelative respectively.

How to Use Relative Routings in a Loaded Form

Create a form, mysine.ui, to be loaded by the CDPBaseUiLoaderWidget, and make sure that the template form is based on a widget that supports target routing. Add a temporary routing in the top-level widget of the form. For instance, by configuring cdpTargetRouting with App.Sine. Any widget in the form can now use relative routing to connect objects within the Sine component (e.g. .Output.Value).

Configure a CDPBaseUiLoaderWidget to load the new ui file by setting uiFileName to mysine.ui. To replace the target routing in the form, configure the cdpTargetRouting property to the Sine you want to target, for instance, MyApp.Sine.