Skip to main content

Command: Add Standard Property Node

Symbol: _visu_icon_AddStandardPropertyEntry.png

Function: Adds a standard property to the bottom of the tree view in the frame configuration.

Call: Visualization menu; context menu

Requirement: This command can be executed only on the Frame Configuration tab.

The newly added property node is highlighted in gray in the frame configuration to indicate that this node represents a fixed standard property of the Frame visualization element. The node is inserted without sufficient configuration. You need to configure it afterwards.

Check each property for the need to publish

In order to keep the frame interface of a visualization clear, we recommend that you publish as few standard frame properties as possible.

Procedure

  1. In the Property column, double-click the new node.

    A list box is displayed which shows the unpublished visualization element properties of the frame. Moreover, the Forward inputs standard property is provided. This is necessary to correctly forward the user inputs.

  2. Select the desired property.

    The node is configured. The other settings are automatically applied from the frame element and cannot be changed.

  3. Move the node to any position. Use the Move node up or Move node down commands to do this.

    The structure of the properties appear to be clear and well-organized.

Additional standard property: Forward inputs

The Forward inputs standard property provided in the list box can be used to correctly forward input events by the visualization user. This is useful when both the frame element and the referenced visualization need to handle input.

An example of this is a custom button which is the referenced visualization that implements a hovering effect by means of the OnMouseEnter/OnMouseLeave actions, while the actual input action is configured at the frame element. It is not an element property of the frame element itself. When this standard property is configured, input events are forwarded to the referenced visualization, even if the frame element has already processed this input.

Mouse events for forwarding

  • OnMouseDown

    The user presses the mouse button in the element area. This mouse event can be forwarded.

  • OnMouseUp

    The user releases the mouse button within the element area, regardless of whether it was pressed inside or outside the area. Forwarding works with this mouse event.

Unsupported mouse events

  • OnMouseClick

    The user clicks and releases the mouse button within the element area. This mouse event does not work on the frame element.

  • OnMouseLeave

    The user moves the mouse pointer out of the element area. This mouse event cannot be forwarded.