可绑定的属性Bindable properties

<< 点击显示目录 >>

主页  mappView帮助助手 > mapp View帮助信息 > 工程 > 定制的小工具 > 复合型小部件 > 编辑复合小部件(XML) >

可绑定的属性Bindable properties

复合部件的可绑定属性是在.compoundwidget文件的<Properties>元素中配置的。可绑定的属性使得在配置复合部件时,可以在一块内容中绑定一个变量。

以下是可用的选项。

 

-具有 值绑定用户 定义的属性

- 带有节点绑定用户 定义的属性

- 将 一个用户定义的属性传递 给多个小组件

- 具有结构绑定用户 定义的属性

Element "Property"

可绑定属性的配置是在<Property>元素中进行的。

Attribute

描述

Data type

Required

xsi:type

BindableProperty定义了 它是基本数据类型的一个可绑定的属性。

StructureBindableProperty定义了 它是结构数据类型的可绑定属性。

String

Yes

name

属性的名称,因为它显示在内容编辑器的属性窗口中,并且选择了复合部件。

不允许使用由复合部件本身提供的下列属性名称。
width, height, top, left, enable, visible, zIndex, margin, permissionOperate, permissionView, id, description
该名称也不允许包含任何空格、特殊字符、句号或冒号。

String

Yes

type

属性的数据类型。数据类型必须对应于 映射 元素中的复合widget中包含的widget属性的数据类型  。

绑定一个结构时 ,必须指定结构数据类型。

See the widget help documentation.

Yes

required

定义该属性在被使用时是否必须被配置。

如果使用这个属性,它必须被设置为 false ,因为如果属性被绑定,用户不应该被强制使用一个默认值。

Boolean

No

category

定义了显示该属性的类别。

String

No

defaultValue

定义了该属性的默认值(例如,visible=false")。

xsi:type BindableProperty:必须定义一个默认值。

xsi:type StructureBindableProperty:不可能有一个默认值。

如果定义了默认值,则 必须将所需的 属性设置为 false

See the widget help documentation.

Yes/No

localizable

定义了该属性是否可以被本地化。这使得指定或选择一个文本键成为可能。

这个属性只有在小组件上的<Mapping>引用的属性也是可本地化的时候才有用。

Boolean

No

typeRefId

对于 StyleReference类型的属性 ,这允许选择一个在属性窗口中派生的样式(例如widgets.brease.Button)。

StyleReference

No

nodeRefId

允许一个数字属性被链接到一个具有 Node类型 的属性

只有在xsi:type="Bindableproperty"(例如nodeRefId="node")的情况下才可能。

nodeRefId

No

Element "Mapping" for basic data types

将可绑定的属性分配给包含在复合部件中的部件的属性是在<Mapping>元素中完成的。

Attribute

说明

Data type

Required

widget

应该应用用户定义的属性的映射的小组件的名称。

widgetRefId

Yes

property

应该应用该映射的小组件属性的名称。

See the widget help documentation.

Yes

mode

定义数据应该被传输方向(单向、双向、单向到源)。

String

Yes

Element "Mapping" for structure data types

将可绑定的属性分配给包含在复合部件中的部件的多个属性是在一个<Mapping>元素中完成。

这允许 将一个结构绑定 到小部件实例的可绑定属性上。

Attribute

说明

Data type

Required

widget

应该应用用户定义的属性的映射的小组件的名称。

widgetRefId

Yes

property

应该应用该映射的小组件属性的名称。

See the widget help documentation.

Yes

mode

定义数据应该被传输方向(单向、双向、单向到源)。

String

Yes

memberPath

绑定结构的成员的名称。

String

Yes

mapToNode

定义该结构成员的值或节点绑定是否应该发生。

Boolean

Yes

samplingRate

定义  应从成员结构中读取采样率组 (无指定=默认、快速、慢速)。

String

No

本节的主题:

?Value binding of a user-defined property

?Node binding of a user-defined property

?Transmitting a property to child widgets

?Structure binding of a user-defined property