TableItem

<< 点击显示目录 >>

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

TableItem

Widget "TableItem" defines a column or row in a table. It can be set to display either a numerical or string value.

Widget "Table" must be added first in order to use widget "TableItem".

When connecting variables under property category "Data", make sure that either a string array or numeric array is bound. Otherwise, nothing will be displayed in the column but the title of the TableItem.

logo_use_case

How the widget can be styled is explained in use case Column styling.

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

zIndex

Appearance

tableitem_editor_01

tableitem_browser

Editor

Web browser

Properties

Name

Type

Description

Binding

Necessary

Default value

columnWidth

UInteger

Defines the column width.

This property can overwrite property "columnWidth" of widget "Table" if the value is not equal to 0. This is only possible, however, if widget "TableItem" has been defined as a column.

check

 

0

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 "enable" behavior is inherited from the container widgets to the child widgets.

check

 

true

format

MeasurementSystemFormat

Defines the number format for the widget.

check

 

{'metric':{ 'decimalPlaces' : 1, 'minimumIntegerDigits' : 1 }, 'imperial' :{ 'decimalPlaces' : 1, 'minimumIntegerDigits' : 1 }, 'imperial-us' :{ 'decimalPlaces' : 1, 'minimumIntegerDigits' : 1 }}

input

Boolean

If true, data can be entered in a table entry.

 

 

false

inputStyle

StyleReference

Style of the numeric pad being used.

 

 

default

limitViolationPolicy

LimitViolationPolicy

If a value is entered in a table that is outside defined limits, "limitViolationPolicy" can be used to define how to handle this out of range violation.

 

 

noSubmit

maxLength

Integer

Defines the maximum number of characters that can be entered.

If undefined, there is no limit.

 

 

100

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

ArrayNode

Binding for numeric arrays with a unit.

Note: Only an array binding is permitted.

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.

 

 

 

rowHeight

UInteger

Defines the row height.

This property can overwrite property "rowHeight" of widget "Table" if the value is not equal to 0. This is only possible, however, if widget "TableItem" has been defined as a line.

check

 

0

showUnit

Boolean

If true, the unit symbol is shown in the header.

Defines whether the unit symbol (e.g. °C) is displayed in the header.

(display = true, do not display = false)

 

 

false

stringValue

StringArray1D

Binding for string arrays.

Note: Only an array binding is permitted.

check

 

 

style

StyleReference

Reference to a customizable widget style.

check

 

default

text

String

Defines the text in the header.

check

 

 

unit

MeasurementSystemUnit

Defines the unit code of the widget.

check

 

 

useDigitGrouping

Boolean

Defines whether number grouping should take place.

If useDigitGrouping = true, the number 100000 will become 100,000, for example.

 

 

true

value

NumberArray1D

Binding for numeric arrays.

Note: Only an array binding is permitted.

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

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

 

Styleable properties - Only configurable using a theme

Name

Type

Description

Default value

backColorEven

Color

Background color for even-numbered table entries in the row direction.

Transparent

backColorOdd

Color

Background color for unevenly numbered table entries in the row direction.

Transparent

backgroundGradientEven

Gradient

Background gradient for even-numbered table entries in the row direction.

 

backgroundGradientOdd

Gradient

Background gradient for unevenly numbered table entries in the row direction.

 

cellAlign

BackgroundPosition

Orientation of the text in a cell.

center center

cellBorderStyle

BorderStyle

Style of the table border.

solid

cellBorderColor

Color

Border color of a cell.

#C8C8C8

cellBorderWidth

PixelValCollection

Border width of a cell.

0px 0px 1px 1px

fontSize

PixelVal

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

14px

headerBackColor

Color

Text color for selected elements.

#FCFCFC

headerGradient

Gradient

Background gradient of the header.

 

headerTextColor

Color

Text color of the header.

#333333

headerFontSize

PixelVal

Font size of the header.

14px

headerBold

Boolean

Defines whether text in the header is shown in bold.

false

headerItalic

Boolean

Defines whether text in the header line is displayed in italics.

false

textColorOdd

Color

Defines the color used to display text in odd-numbered table entries in the row direction.

#333333

textColorEven

Color

Defines the color used to display text in even-numbered table entries in the row direction.

#333333

bold

Boolean

Defines whether the text is shown in bold.

false

italic

Boolean

Defines whether the text is shown in italics.

false

sortingButtonColor

Color

Defines the color used to display the icons for sorting when not applied.

#ECECEC

sortingButtonActiveColor

Color

Defines the color used to display the icon for sorting when applied.

#5F8DD3

cellPadding

Padding

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

0px

headerCellPadding

Padding

Defines the spacing between the outer boundary of the header entry and its contents. For more information, see here.

0px

Topics in this section:

Actions and events