<< 点击显示目录 >> 主页 mappView帮助助手 > mapp View帮助信息 > Widgets > Chart > XYChart > Actions and events |
The following section describes the possible actions and events for the widget.
Name |
Description |
Arguments |
SetVisible |
Controls the visibility of the widget. |
•value: Boolean Visible if the value is true. Otherwise, invisible. |
SetEnable |
Controls the usability of the widget. |
•value: Boolean Enabled if the value is true. Otherwise, disabled. |
SetStyle |
Sets a predefined style for the widget. |
•value: StyleReference |
ScrollDown |
Scrolls down 25%. To do this, the widget must be in freeze mode. |
|
ScrollUp |
Scrolls up 25%. To do this, the widget must be in freeze mode. |
|
ScrollLeft |
Scrolls 25% to the left. To do this, the widget must be in freeze mode. |
|
ScrollRight |
Scrolls 25% to the right. To do this, the widget must be in freeze mode. |
|
SetCursorStyle |
Applies a predefined style for the cursor collection. |
•cursorId: PropertyCollectionReference •value: StyleReference |
SetCursorVisible |
Controls the visibility of the cursor collection that is specified as an argument. |
•cursorId: PropertyCollectionReference •value: Boolean Visible if the value is true. Otherwise, invisible. |
SetGraphStyle |
Applies a predefined style for the graph collection. |
•graphId: PropertyCollectionReference •value: StyleReference |
SetGraphVisible |
Controls the visibility of the graph collection that is specified as an argument. |
•graphId: PropertyCollectionReference •value: Boolean Visible if the value is true. Otherwise, invisible. |
SetXAxisStyle |
Applies a predefined style for the x-axis collection. |
•xAxisId: PropertyCollectionReference •value: StyleReference |
SetXAxisVisible |
Controls the visibility of the x-axis collection that is specified as the argument. |
•xAxisId: PropertyCollectionReference •value: Boolean Visible if the value is true. Otherwise, invisible. |
SetYAxisStyle |
Applies a predefined style for the y-axis collection. |
•yAxisId: PropertyCollectionReference •value: StyleReference |
SetYAxisVisible |
Controls the visibility of the y-axis collection that is specified as the argument. |
•yAxisId: PropertyCollectionReference •value: Boolean Visible if the value is true. Otherwise, invisible. |
SetZoomType |
Defines on which axis zooming is enabled. |
•zoomType: ChartZoomType |
ShowTooltip |
Mode "Tooltip" can be enabled using this action. When enabled, a tooltip indicator appears inside the widget. For this, a text must be configured in property "Tooltip". This text is displayed when the indicator is selected. Any other operation of a widget terminates mode "Tooltip". |
|
Freeze |
Ends the graph data update and makes it possible to use the zoom and scroll functions. |
|
Unfreeze |
Restarts the update of the graph data and prevents the zoom and scroll functions. |
|
ZoomIn |
Zooms in the graph by 20%. To do this, the widget must be in freeze mode. |
|
ZoomOut |
Zooms out the graph by 20%. To do this, the widget must be in freeze mode. |
|
ZoomReset |
Resets the zoom to 0%. To do this, the widget must be in freeze mode. |
|
Update |
This action is used to "update" a chart if the chart is in freeze mode or configured with updateChartTime = 0 in freeze mode. |
•graphId: PropertyCollectionReference |
ToggleCursorTable |
This action is used to show or hide a table in the graph area in which the cursor values are displayed. |
|
SetXAxisPosition |
Defines the position of the x-axis, which is specified as an argument. The desired position top or bottom must also be specified as an argument. |
•yAxisId: PropertyCollectionReference •position: VerticalAlign |
SetYAxisPosition |
Defines the position of the y-axis, which is specified as an argument. The desired position left or right must also be specified as an argument. |
•yAxisId: PropertyCollectionReference •position: HorizontalAlign |
SetSelectedCursor |
Defines which cursor can be moved in freeze mode. |
•cursorId: PropertyCollectionReference |
Focus |
Sets the focus to the widget when keyboard operation is enabled. |
|
To obtain the result of a reading action, an "operand" must be used. For more information, see here. For how the result can be used in the ResultHandler, see here.
Name |
Description |
Result |
GetStatus |
This action is used to determine whether the graph is in freeze mode. If true is returned, freeze mode is not active. |
•result: Boolean |
Name |
Description |
Arguments |
Click |
Triggered when clicking on the widget. |
•origin: String "origin" contains the ID of the widget that triggers the click event. •horizontalPos: String horizontalPos contains the horizontal position of event "Click" in pixels (e.g. 10px starting from the viewport). •verticalPos: String verticalPos contains the vertical position of the click event in pixels (e.g. 10px starting from viewport). |
DisabledClick |
Triggered when clicking on the disabled widget. |
•origin: String "origin" contains the ID of the widget that triggers the click event. •hasPermission: Boolean "hasPermission" defines whether the current user has the necessary rights to access it. •horizontalPos: String horizontalPos contains the horizontal position of the DisabledClick event in pixels (e.g. 10px starting from viewport). •verticalPos: String verticalPos contains the vertical position of the DisabledClick event in pixels (e.g. 10px starting from viewport). |
EnableChanged |
Triggered when the usability of the widget is changed. This can be changed using various options: 1) Using property enable (binding or via widget action SetEnable) 2) Using property permissionOperate 3) Using usability properties (enable, permissionOperate, OPC UA variable) of the surrounding container widget 4) Using a bound OPC UA variable with write permissions that have been changed. |
•value: Boolean "value" returns the new value of property "enable". |
VisibleChanged |
Triggers when the visibility of the widget is changed. This can be changed using various options: 1) Using property visible (binding or via widget action SetVisible) 2) Using property permissionView 3) Using the visibility properties (visible, permissionView) of the surrounding container widget |
•value: Boolean "value" returns the new value of property "visible". |
OnDragEnter |
Triggers when a dragged widget is moved over the target widget. |
•widgetId: String "widgetId" contains the ID of the widget that performed the drag operation. •contentId: String "contentId" contains the ID of the piece of content whose widget performed the drag operation. |
OnDragLeave |
Triggers when a dragged widget is dragged away from the target widget. |
•widgetId: String "widgetId" contains the ID of the widget that performed the drag operation. •contentId: String "contentId" contains the ID of the piece of content whose widget performed the drag operation. |
OnDrop |
Triggers when a dragged widget is released on the target widget. For the definition of drag-and-drop and an explanation of how these events can be used, see here. |
•widgetId: String "widgetId" contains the ID of the widget that performed the drag operation. •contentId: String "contentId" contains the ID of the piece of content whose widget performed the drag operation. |
FocusIn |
Triggered when a widget gets the focus. |
|
FocusOut |
Triggered when a widget loses focus. |
|