Polybench® Reference
Component that can show alternate user interfaces.

Multi View (alternating panels)


The MultiView can be used to display multiple user interface functions on the same place, by hiding and showing sub-displays.


Find more information about changing properties here: link

type: See description
Set the name of one of the view alternatives that are within this component, to make that view visible.

type: Size containing width and height
The size of the user interface of this object (width, height).

type: Coordinate
The location of the user interface of this object in (x,y) coordinates, relative to the object it is on top of.

type: Word or phrase
The name of the object in the project. This name must not contain '.' or '$' characters.

Every object has the Caption property. This property is very important, because it is the name by which Polybench recognizes this object.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.

type: See description
Optional documentation of this object.

It is good practice to write in short notes why you have used this object, and why its properties are set the way they are set. If this object is an operator, the Documentation text is displayed below the operator symbol.

Special dialog to change properties of this object: Views

Variable Parameters

Find more information about Variable Parameters here: link

type: See description
Set the name of one of the view alternatives that are within this component, to make that view visible.


With this component you could for example make a tabbed page. The end user selects one of the tabs, to view certain functionality.

The MultiView consists of one or more Views. To add a View to the MultiView, click the MultiView to open the properties dialog and press Add View. The MultiView now shows an empty space, on which you can drag other components from the Toolbox.

The MultiView properties dialog shows a list from all Views. Click on a View name to set it to be visible.

You can now also change the name of a View in the input field to the right. Press F2 or click on the input field to start editing the view name.
Please note that a view name cannot have the '.' or '$' characters. Any of those characters are exchanged by an under score ('_').
Press Enter on your keyboard, or the Change button to set the new view name.

Views can be removed from the MultiView by selecting the correct View and pressing Remove. Note that only Views that are empty can be deleted!

Note that Operator symbols cannot be contained by a MultiView.

How to change a view in the user interface?

Your application can change the actual view of the Multi View panel by using a SET_PARAMETER action (link). The value of the action should be the name of the view that should be displayed.
For example, if a Multi View panel called MultiView1 on page Display Page1 has a view called View2, then the following action puts View2 to the front:

Value = View2
Address = Display Page1.MultiView1.CurrentView