LoginButton

<< 点击显示目录 >>

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

LoginButton

Widget "LoginButton" performs a login on the mapp View server. The parameters bound to the widget are used for the username and password. This widget can be used as an alternative to widget "Login".

This widget should only be used if the HMI application is output via "https" (TLS); otherwise, the integrity of the data is not ensured.

The following properties cannot be used in compound widget "Mapping":

zIndex, left, top, height, width, maxHeight, minHeight, maxWidth, minWidth, imageHeight, imageWidth

Appearance

loginbutton_editor

loginbutton_runtime

Editor

Web browser

Properties

Name

Type

Description

Bindable

Necessary

Default value

breakWord

Boolean

Defines whether a string without spaces that is too long can be split up in the middle.

This option has no effect if multiLine is set to value false. For more information, see here.

 

 

false

ellipsis

Boolean

Defines whether a text that is too long should be indicated by an ellipsis, e.g. "This text is..." instead of "This text is too long". For more information, see here. Defines whether a number that is too long should be indicated by an ellipsis, e.g. "12012 ..." instead of "120125100". Defines whether a number in the ValueDisplaybox that is too long should indicated by an ellipsis, e.g. "12..." instead of "12.000". If true, ellipses are applied; if false, the width of the ValueDisplaybox is adjusted exactly to the number width so that the whole number can be displayed.Defines whether a text that is too long should be indicated by an ellipsis, e.g. "This text is..." instead of "This text is too long".

For more information, see here.

 

 

false

enable

Boolean

Defines the usability of the widget. A disabled widget (enable=false) does not react to user interaction and does not trigger events. The "disabled..." style is displayed at runtime. The "enable" behavior is inherited from the container widgets to the child widgets.

check

 

true

image

ImagePath

Relative path to an image that is shown in the widget.

For more information, see here.

check

 

 

imageAlign

ImageAlign

Position of the image relative to the text. For more information, see here.

 

 

left

mouseDownImage

ImagePath

Relative path to an image that is shown as long as the widget is pressed.

For more information, see here.

check

 

 

mouseDownText

String

Static text or text from the text system that is shown as long as the widget is pressed.

A localized text is defined by specifying $IAT/Textkey.

check

 

 

multiLine

Boolean

Defines whether the text can be shown in multiple lines. If "wordWrap" has value true, a break is added to the text after a word or at an explicitly defined line break (\n) if necessary. For more information, see here.Defines whether the text can be shown in multiple lines.

If "wordWrap" has value true, a break is added to the text after a word or at an explicitly defined line break (\n) if necessary. For more information, see here.

 

 

false

password

String

Defines the password used to log in.

check

 

 

permissionOperate

RoleCollection

Defines the roles that are permitted to use the widget. For roles without sufficient rights, the widget does not react to user interaction and does not trigger events.

 

 

 

permissionView

RoleCollection

Defines the roles that are permitted to see the widget. For roles without sufficient rights, the widget is hidden.

 

 

 

style

StyleReference

Reference to a customizable widget style.

check

 

default

text

String

Defines the text shown in widget "LoginButton".

check

 

 

userName

String

Defines the username used to log in.

check

 

 

visible

Boolean

Defines the visibility of the widget. The widget can be hidden with visible=false. (visible = true, hidden = false). The "visible" behavior is inherited from the container widget to the child widgets.

check

 

true

wordWrap

Boolean

Defines whether a break will be added to the text after a word if necessary. This option has no effect if "multiLine" is set to value false. For more information, see here.

 

 

false

zIndex

UInteger

zIndex determines the z-order of the widget. With overlapping widgets, the zIndex determines which widget is on the top and which one is on the bottom. The widget with the larger zIndex is on top, and the one with the smaller zIndex is on the bottom. The zIndex must be unique within a piece of content or a container widget. The zIndex is automatically assigned by the visual editor and can therefore be changed via the toolbar.

 

check

 

left

Integer

Absolute position measured from the left border of the surrounded element (e.g. container widget or content).

 

 

 

top

Integer

Absolute position measured from the top border of the surrounded element (e.g. container widget or content).

 

 

 

height

AutoSize

Defines the total height of the widget in pixels.

A value in % refers to the height of the surrounding element.If the value is set to "auto", the height is defined by the contents.

 

 

30

width

AutoSize

Defines the total width of the widget in pixels.

A value in % refers to the width of the surrounding element.If the value is set to "auto", the width is defined by the contents.

 

 

100

imageHeight

ImageSize

Defines the height of the image in the widget.

 

 

0

imageWidth

ImageSize

Defines the width of the image in the widget.

 

 

0

tooltip

String

Defines the text that should appear as information when the tooltip indicator is pressed.

You can use a static text or a text from the text system. For more information, see here.

Mode "Tooltip" must be enabled for this. There are two different options for this:

Using action "ShowTooltip"

Using action "Client system" ShowTooltips.

 

 

 

draggable

Boolean

Defines whether the widget can be dragged at runtime. This can be used to perform actions or establish relationships between two widgets.

If true, the widget can be moved onto another widget. The source widget remains in its position and a copy is created and dragged. Actions OnDragStart and OnDragEnd can be used.

If false, the widget cannot be moved.

For more information, see here.

 

 

false

minWidth

Size

Defines the minimum total width of the widget. This property is applied if width="auto". Value 0 has no effect.

 

 

0

maxWidth

Size

Defines the maximum total width of the widget. This property is applied if width="auto". Value 0 has no effect.

 

 

0

minHeight

Size

Defines the minimum total height of the widget. This property is applied if height="auto". Value 0 has no effect.

 

 

0

maxHeight

Size

Defines the maximum size of the widget. This property is applied if height="auto". Value 0 has no effect.

 

 

0

useSVGStyling

Boolean

Defines whether an SVG image is added to the widget as an "inline" or an "object". If useSVGStyling = true, SVG properties such as imageColor can be changed at runtime. However, this can affect performance on the client if the SVG image contains a lot of elements. If useSVGStyling = false, property imageColor is ignored but will be displayed faster at runtime.

 

 

true

tabIndex

Integer

Property tabIndex is used to manage the tab order during keyboard operation.

For additional information, see Keyboard operation.

ENTER triggers events MouseDown, MouseUp and Click when tabIndex ≥0; the user is logged in with the username and password specified on the login widget.

 

 

0

Styleable properties

Name

Type

Description

Default value

borderStyle

BorderStyle

Defines the style of the border around the widget. Borders can be unbroken, dashed or dotted.

solid

borderWidth

PixelValCollection

Defines the width of the border around the widget.

2px

cornerRadius

PixelValCollection

Defines the corner style of the widget.

0px

backColor

Color

Defines the background color of the widget.

#DBDBDB

disabledBackColor

Color

Defines the background color of the widget in the disabled state.

#F1F1F1

backGroundGradient

Gradient

Defines the background color of the widget as a color gradient.

 

disabledBackGroundGradient

Gradient

Defines the background color of the widget as a color gradient in the disabled state.

 

mouseDownBackGroundGradient

Gradient

Defines the background color of the widget as a color gradient while the widget is being pressed.

 

backGround

ImagePath

Defines a relative path to an image to be used as the background.

 

borderColor

ColorCollection

Defines the color of the border around the widget.

#5B7C70

disabledBorderColor

ColorCollection

Defines the color of the border around the widget in the disabled state.

#FFFFFF #C8C8C8 #C8C8C8 #FFFFFF

textColor

Color

Defines the color used to display the text.

#000000

disabledTextColor

Color

Defines the color of the text in the disabled state.

#989898

mouseDownBorderColor

ColorCollection

Defines the border color of the widget while the widget is being pressed.

#FD7B01

mouseDownBorderWidth

PixelValCollection

Defines the border width of the widget while the widget is being pressed.

2px

mouseDownBackColor

Color

Defines the background color of the widget while the widget is being pressed.

#DBDBDB

mouseDownTextColor

Color

Defines the color used to display the text while the widget is being pressed.

#000000

textAlign

TextAlign

Defines the orientation of the text.

center

opacity

Opacity

Defines the transparency of the widget. The lower the value, the more transparent the widget.

1

rotation

Rotation

Defines the rotation of the widget, e.g. a value of 90 degrees changes the rotation of the widget by 90 degrees clockwise.

0deg

fontSize

PixelVal

Defines the size of the font used to display the text.

12px

fontName

FontName

Defines the font used for the text shown.

Arial

bold

Boolean

Defines whether the text is shown in bold.

false

italic

Boolean

Defines whether the text is shown in italics.

false

padding

Padding

Defines the spacing between the outer boundary of the widget and its content. For more information, see here.

0px 10px

margin

Margin

Defines the offset of the external boundary of the widget to the widget's actual set position. For more information, see here.

0px

shadow

Shadow

Defines the shadow of the widget.

none

mouseDownShadow

Shadow

Defines the shadow of the widget while the widget is being pressed.

none

imageColor

Color

Defines the color of the image in the widget. This requires an SVG image whose color has not been set explicitly.

#000000

mouseDownImageColor

Color

Defines the color of the image in the widget while the widget is pressed. This requires an SVG image whose color has not been set explicitly.

#000000

disabledImageColor

Color

Defines the color of the image in the widget while the widget is disabled. This requires an SVG image whose color has not been set explicitly.

#000000

Topics in this section:

Actions and events