mappView帮助助手 > mapp View帮助信息 > Widgets > Numeric

Widget "BasicSlider" allows a value to be changed using a horizontal or vertical slider thumb.

Data linked to property value must have data type REAL.

This widget is multi-touch capable: For more information, see Multi-touch function.

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

zIndex, left, top, height, width

Appearance


Editor	Web browser

Properties

Name	Type	Description	Bindable	Necessary	Default value
changeOnMove	Boolean	Specifies whether the new value should be sent to the server immediately when the slider thumb is moved. If true, the value is sent to the server immediately. If false, only when the widget is released (no longer being pressed, property "MouseUp").			true
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.			true
format	MeasurementSystemFormat	Defines the number format for the widget.			{'metric':{ 'decimalPlaces' : 1, 'minimumIntegerDigits' : 1 }, 'imperial' :{ 'decimalPlaces' : 1, 'minimumIntegerDigits' : 1 }, 'imperial-us' :{ 'decimalPlaces' : 1, 'minimumIntegerDigits' : 1 }}
image	ImagePath	Relative path to an image that is shown in the widget. For more information, see here.
largeChange	UNumber	If the slider track is clicked, the slider thumb moved by the value specified here (in %).			10
majorTicks	UInteger	Defines how the slider track is subdivided. The starting and end values are not included.			5
maxValue	Number	Defines the maximum permissible value for value binding. With node binding, the "high" attribute for the EU range from the OPC UA variable is used.			100
minValue	Number	Defines the minimum permissible value for value binding. With node binding, the "low" attribute for the EU range from the OPC UA variable is used.			0
node	Node	Value with unit for node binding. The value changes based on the position of the slider thumb.
orientation	Orientation	Defines the orientation of the widget.			LeftToRight
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.
scaleOffset	PixelVal	Defines the distance of the lower part of the graph or scale to the slider track.			15px
showTickNumbers	Boolean	Defines whether the subdivision of the slider track is displayed not only graphically via dashes but also numerically using a value scale. Scale = true / No scale, only graphics = false. Property "tickPosition" is not permitted to equal "none" here.			false
showUnit	Boolean	Defines whether the unit should be displayed. A node binding is necessary for this. Property "showValueDisplay" must be set to true for this. Display unit = true / Do not display unit = false.			false
showValueDisplay	Boolean	Defines whether the value and unit should be displayed. Display value = true / Do not display value = false.			false
smallChange	UNumber	Defines the interval of steps for the slider thumb.			1
style	StyleReference	Reference to a customizable widget style.			default
thumbSize	PixelVal	Defines the size of the slider thumb.			25px
tickPosition	TickStyle	Defines whether the graphic area or scale should be shown above or below the slider track. Possible values: bottom: The scale is displayed below the slider track. none: The scale is not displayed. top: The scale is displayed above the slider track. topbottom: The scale is displayed above and below the slider track.			none
trackSize	PixelVal	Defines the width of the slider track.			7px
unit	MeasurementSystemUnit	Defines the unit code of the widget.
value	Number	This property can be used to bind a numerical value. The value changes based on the position of the slider thumb.			0
valueDisplaySize	PixelVal	Defines the font size of the displayed value. Property "showValueDisplay" must be set to true for this.			35px
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.			true
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.
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	Size	Defines the total height of the widget in pixels. A value in % refers to the height of the surrounding element.			100
width	Size	Defines the total width of the widget in pixels. A value in % refers to the width of the surrounding element.			250
ellipsis	Boolean	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.			false
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.
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 for tabIndex ≥0. It is not possible to operate the thumb with the keyboard.			-1

Styleable properties

Name	Type	Description	Default value
borderWidth	PixelValCollection	Defines the width of the border around the widget.	0px
cornerRadius	PixelValCollection	Defines the corner style of the widget.	0px
borderStyle	BorderStyle	Defines the style of the border around the widget. Borders can be unbroken, dashed or dotted.	solid
backColor	Color	Defines the background color of the widget.	Transparent
disabledBackColor	Color	Defines the background color of the widget in the disabled state.	Transparent
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.
thumbColor	Color	Defines the background color of the slider thumb.	#FF8800
disabledThumbColor	Color	Defines the background color of the slider thumb in the disabled state.	#F1F1F1
thumbGradient	Gradient	Defines the background color of the slider thumb as a color gradient.
disabledThumbGradient	Gradient	Defines the background color of the slider thumb as a color gradient in the disabled state.
borderColor	ColorCollection	Defines the color of the border around the widget.	#C8C8C8
opacity	Opacity	Defines the transparency of the widget. The lower the value, the more transparent the widget.	1
trackColor	Color	Defines the background color of the widget's slider track.	#C8C8C8
disabledTrackColor	Color	Defines the background color of the widget's slider track in the disabled state.	#EAEAEA
trackGradient	Gradient	Defines the background color of the widget slider track as a color gradient.
disabledTrackGradient	Gradient	Defines the background color of the widget slider track in the disabled state as a color gradient.
padding	Padding	Defines the spacing between the outer boundary of the widget and its content. For more information, see here.	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
fontSize	PixelVal	Defines the size of the font used to display the text.	10px
fontName	FontName	Defines the font used for the text shown.	Arial
textColor	Color	Defines the color used to display the values on the scale.	#000000
ticksColor	Color	Defines the color of the hyphens that are displayed as a scale.	#000000
valueDisplayBackColor	Color	Defines the background color of the value display.	#F1F1F1
valueDisplayBackGroundGradient	Gradient	Defines the background color of the value display as a color gradient. The color of the arrow can be adjusted with property valueDisplayBackColor.
valueDisplayTextColor	Color	Defines the color of the text displayed in the value display.	#000000
fillColor	Color	Defines the background color to be used for the slider track between the starting point and current value.	Transparent
fillGradient	Gradient	Defines the background color to be used for the slider track between the starting point and current value as a color gradient.
disabledFillColor	Color	Defines the background color to be used for the slider track between the starting point and current value in the disabled state.	Transparent
disabledFillGradient	Gradient	Defines the background color to be used for the slider track between the starting point and current value as a color gradient in the disabled state.

Topics in this section:

•Actions and events