Actions and events

<< 点击显示目录 >>

主页  mappView帮助助手 > mapp View帮助信息 > Widgets  > Data  > UserList  > UserList  >

Actions and events

The following section describes the possible actions and events for the widget.

Actions

Name

Description

Arguments

Result

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

 

GoToPage

Navigates to the page specified as the index in the argument. If the page is not available, value false is returned.

For information about creating external navigation, see here.

value: Integer

result: Boolean

GoToFirstPage

Navigates to the first page. If the page is not available, value false is returned.

 

result: Boolean

GoToLastPage

Navigates to the last page. If the page is not available, value false is returned.

 

result: Boolean

GoToNextPage

Navigates to the next page. If the page is not available, value false is returned.

 

result: Boolean

GoToPreviousPage

Navigates to the previous page. If the page is not available, value false is returned.

 

result: Boolean

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".

 

 

DeleteUser

Deletes the currently selected user.

 

result: Integer

1: User successfully deleted

104: Session not valid

200: User does not exist

202: Insufficient rights

207: Currently logged-in user

-3: Anonymous cannot be deleted.

OpenAddUserDialog

Opens a dialog box to add a user.

 

result: Integer

1: The user could open the dialog box.

202: Insufficient rights

OpenModifyUserDialog

Opens a dialog box to edit a user.

 

result: Integer

1: The user could open the dialog box.

200: User does not exist (e.g. if none is selected)

202: Insufficient rights

206: Action not permitted (when opened in central mode / for central users)

Focus

Sets the focus to the widget when keyboard operation is enabled.

 

 

Table: Actions

Events

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" defines the usability of the widget. If true is returned, the widget can be used; if false, it cannot be used.

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" defines the visibility of the widget. If true is returned, the widget is displayed; if false, it is not displayed.

OnError

Triggered if an error occurs.

Code: Integer

The error or success code that is transmitted. Possible values:

1: Success

104: Session not valid

102: Unauthorized user

ItemClick

Triggered when clicking on a user list entry.

UserName:String

Contains the username of the entry.

FullName:String

Contains the full name (first name + last name) of the entry.

IsAdmin:Boolean

Contains information whether the user is an admin.

IsLocked:Boolean

Contains information whether the user is locked.

LastLogin:String

Contains the date when the user was last logged in

horizontalPos:String

horizontalPos contains the horizontal position of the click event in pixels (e.g. 10px starting from viewport).

verticalPos:String

verticalPos contains the vertical position of the click event in pixels (e.g. 10px starting from viewport).

ItemDoubleClick

Triggered when double-clicking on a user list entry.

UserName:String

Contains the username of the entry.

FullName:String

Contains the full name (first name + last name) of the entry.

IsAdmin:Boolean

Contains information whether the user is an admin.

IsLocked:Boolean

Contains information whether the user is locked.

LastLogin:String

Contains the date when the user was last logged in

horizontalPos:String

horizontalPos contains the horizontal position of the click event in pixels (e.g. 10px starting from viewport).

verticalPos:String

verticalPos contains the vertical position of the click event in pixels (e.g. 10px starting from viewport).

FirstPageNumber

Triggered on every page change and returns the following arguments.

Arguments

pageNumber = Number of the first page

pageText = Number of the first page as text

show = False if the first page is selected

select = 1 if the first page is currently displayed

pageNumber: Integer

pageText: String

show: Boolean

select: Integer

PreviousPageNumber

Triggered on every page change and returns the following arguments.

Arguments

pageNumber = Number of the previous page starting from the currently displayed page.

pageText = Number of the previous page as text (e.g. "1" if 2 is currently displayed)

show = True if at least one page is displayed in the list

select = 1 if the first page is currently displayed

pageNumber: Integer

pageText: String

show: Boolean

select: Integer

CurrentPageNumber

Triggered on every page change and returns the following arguments.

Arguments

pageNumber = Number of the current page

pageText = Number of the current page as text (e.g. "2" if page 2 is currently displayed)

show = True if at least 2 pages are displayed in the list

select = 1 if the first or last page is not currently displayed

pageAlternativeNumber = Number of the current page, but will never be below 2 or above the maximum number of pages minus 1

pageAlternativeText = Number of the current page as text, but will never be below 2 or above the maximum number of pages minus 1

If 3 buttons are used, for example pageAlternativeNumber is used in the middle since the button for the 1st page is before it and the 3rd button is for the last page.

tw_pagealternativenumber

pageNumber: Integer

pageText: String

show: Boolean

select: Integer

pageAlternativeNumber:Integer

pageAlternativeText: String

NextPageNumber

Triggered on every page change and returns the following arguments.

Arguments

pageNumber = Number of the next page starting from the current page.

pageText = Number of the next page as text (e.g. "3" if 2 is the current page)

show = True if at least three pages are displayed

select = 1 if the last page is currently displayed

pageNumber: Integer

pageText: String

show: Boolean

select: Integer

LastPageNumber

Triggered on every page change and returns the following arguments.

Arguments

pageNumber = Number of the last page

pageText = Number of the last page as text

show = False if the last page is displayed

select = 1 if the last page is currently displayed

pageNumber: Integer

pageText: String

show: Boolean

select: Integer

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.

UserAdded

Triggered when closing the dialog box for adding users via the OK button.

UserName:String

Contains the username that will be added

Code: Integer

The error or success code that is transmitted. Possible values:

1: User successfully added

104: Session not valid

201: User already exists

202: Insufficient rights

206: Action not permitted (when opened in central mode / for central users)

UserModified

Triggered when closing the dialog box for editing users with the OK button.

UserName:String

Contains the username that is edited

Code: Integer

The error or success code that is transmitted. Possible values:

1: User successfully edited

104: Session not valid

201: User already exists

202: Insufficient rights

206: Action not permitted (when opened in central mode / for central users)

FocusIn

Triggered when a widget gets the focus.

 

FocusOut

Triggered when a widget loses focus.

 

Table: Events