mappView帮助助手 > mapp View帮助信息 > 工程 > 定制的小工具 > 定制键盘 > 编辑自定义键盘(XML)

Alphanumeric keyboard

一个字母数字键盘以XML格式编辑在一个.alphapad文件中。

元素

一个.alphapad文件包含以下信息。

元素AlphaPad

Attribute	说明	Data type	Required
id	将在HMI应用中使用的字母数字键盘的名称。该名称在创建字母数字键盘时使用，以后可以修改。	ID	Yes
display	如果配置了改变键盘布局，该文本将显示为布局选择。最多允许5个字符（例如："en "或 "en-US"）。	String	Yes
width	小部件的外部宽度。	Integer	Yes
height	小部件的外部高度。	Integer	Yes
Element	说明		Required
Header	头部区域。		No
Section	构造元素的区域。		No
Label	显示单行文本。		No
NodeInfo	显示指定OPC UA节点的属性。可用的属性是 "描述 "和 "显示名称"。如果在小组件中显示的文本是静态的（没有绑定），会显示一个空字符串。如果绑定的节点没有选择的属性或属性是空的，则显示一个空字符串。属性 NodeInfo 只能在 OPC UA信息模型2.0 或更高版本中使用。		No
Value	显示一个值。		Yes
ValueButton	显示一个用于输入数值的按钮。		No
ActionButton	显示一个按钮，用于执行定义的操作。		No
ActionImage	显示一个按钮，显示为一个图像，用于执行定义的操作。显示的图像必须由一个样式指定，见字母数字键盘的样式。		No
LayoutSelector	如果在当前语言的一个键盘配置中存储了多个键盘，则显示替代键盘。见键盘配置		No
IME	用于输入汉字的输入法编辑器		No

Element "Header"

Attribute	说明	Data type	Required
height	外部高度。	Integer	No
Element	说明		Required
Label	显示单行文本。		No
NodeInfo	显示指定OPC UA节点的属性。可用的属性是 "描述 "和 "显示名称"。如果在小组件中显示的文本是静态的（没有绑定），会显示一个空字符串。如果绑定的节点没有选择的属性或属性为空，则显示一个空字符串。		No

Element "Section"

Attribute	说明	Data type	Required
top	该区域的垂直位置。	Integer	Yes
left	该区域的水平位置。	Integer	Yes
width	元素的外部宽度。	Integer	Yes
height	元素的外部高度。	Integer	Yes
zIndex	zIndex决定了显示元素的z-order。对于重叠的显示元素，zIndex决定了哪个元素在上面，哪个在下面。zIndex大的元素在上面；zIndex小的元素在下面。	UInteger	No
Element	说明		Required
Label	显示单行文本。		No
NodeInfo	显示指定的OPC UA节点的属性。可用的属性是 "描述 "和 "显示名称"。如果在小组件中显示的文本是静态的（没有绑定），会显示一个空字符串。如果绑定的节点没有选择的属性或属性为空，则显示一个空字符串。		No
Value	显示一个值。		No
LayoutSelector	如果在当前语言的一个键盘配置中存储了几个键盘，则显示替代键盘。参见键盘配置。		No
ValueButton	显示一个用于输入数值的按钮。		No
ActionButton	显示一个用于执行规定动作的按钮。		No
ActionImage	显示一个按钮，显示为图像，用于执行定义的操作。显示的图像必须由一个样式指定，见字母数字键盘的样式。		No

Element "Label"

Attribute	描述	Data type	Required
top	垂直位置。	Integer	Yes
left	水平位置。	Integer	Yes
width	外部宽度。	Integer	Yes
height	外围高度。	Integer	Yes
zIndex	zIndex决定了显示元素的z-order。对于重叠的显示元素，zIndex决定了哪个元素在上面，哪个在下面。zIndex大的元素在上面；zIndex小的元素在下面。	UInteger	No
display	显示的文本。在使用特殊字符时，必须使用HTML编码，例如&#177。	String	Yes
textAlign	定义了文本的方向。可用的值： left center right	TextAlign	No
multiLine	定义文本是否在多行上显示。可用的值： true false Default setting: false	Boolean	No

Element NodeInfo

Attribute	描述	Data type	Required
top	垂直位置。	Integer	Yes
left	水平位置。	Integer	Yes
width	外部宽度。	Integer	Yes
height	外围高度。	Integer	Yes
zIndex	zIndex决定了显示元素的z-order。对于重叠的显示元素，zIndex决定了哪个元素在上面，哪个在下面。zIndex大的元素在上面；zIndex小的元素在下面。	UInteger	No
nodeAttribute	显示的节点属性。如果绑定的节点没有选择的属性或属性为空，则显示一个空字符串。可用的值： displayName description	String	Yes
textAlign	定义了文本的方向。可用的值： left center right	TextAlign	No
multiLine	定义文本是否在多行上显示。可用的值： true false Default setting: false	Boolean	No

Element LayoutSelector

Attribute	描述	Data type	Required
top	垂直位置。	Integer	Yes
left	水平位置。	Integer	Yes
width	外部宽度。计算的宽度包括任何边界。	Integer	Yes
height	外层高度。高度的计算包括任何边框。	Integer	Yes
zIndex	zIndex决定了显示元素的z-order。对于重叠的显示元素，zIndex决定了哪个元素在上面，哪个在下面。zIndex大的元素在上面；zIndex小的元素在下面。	UInteger	No

Element "Value"

Attribute	描述	Data type	Required
top	垂直位置。	Integer	Yes
left	水平位置。	Integer	Yes
width	外部宽度。计算的宽度包括任何边界。	Integer	Yes
height	外层高度。高度的计算包括任何边框。	Integer	Yes
zIndex	zIndex决定了显示元素的z-order。对于重叠的显示元素，zIndex决定了哪个元素在上面，哪个在下面。zIndex大的元素在上面；zIndex小的元素在下面。	UInteger	No

Element ValueButton

Attribute	说明	Data type	Required
value	按键时要处理的值。	String	Yes
shiftValue	当按下shift键时要处理的值。	String	No
specialValue	按下特殊键时要处理的值。	String	No
top	垂直位置。	Integer	Yes
left	水平位置。	Integer	Yes
width	外部宽度。计算的宽度包括任何边界。	Integer	Yes
height	外层高度。高度的计算包括任何边框。	Integer	Yes
zIndex	zIndex决定了显示元素的z-order。对于重叠的显示元素，zIndex决定了哪个元素在上面，哪个在下面。zIndex大的元素在上面；zIndex小的元素在下面。	UInteger	No
display	显示的文本。使用特殊字符时必须使用HTML编码，例如&#177。	String	Yes
shiftDisplay	按下shift键时显示的文本。使用特殊字符时必须使用HTML编码，例如：&#177。	String	No
specialDisplay	当按下特殊键时显示的文本。使用特殊字符时必须使用HTML编码，例如：&#177。	String	No

Element ActionButton

Attribute	Description	Data type	Required
action	要通过按键应用的行动。可用的行动： close: 关闭键盘 shift: 切换到输入在ValueButton元素中已被存储为shiftValue的数值 special: 切换到输入在ValueButton元素中已被存储为特殊值的数值 delete: 删去最后一个字符 clear: 删除整个条目 enter: 确认输入值 left: 将光标向左移动 right: 将光标向右移动 ime-prev-candidates: 使用IME元素时，加载先前的候选者 ime-next-candidates: 在使用IME元素时加载额外的候选者	Button action	Yes
top	垂直位置。	Integer	Yes
left	水平位置。	Integer	Yes
width	外部宽度。计算的宽度包括任何边界。	Integer	Yes
height	外层高度。高度的计算包括任何边框。	Integer	Yes
zIndex	zIndex决定了显示元素的z-order。对于重叠的显示元素，zIndex决定了哪个元素在上面，哪个在下面。zIndex大的元素在上面；zIndex小的元素在下面。	UInteger	No
display	显示的文本。在使用特殊字符时，必须使用HTML编码，例如&#177。	String	Yes

Element ActionImage

Attribute	描述	Data type	Required
action	要通过按键应用的行动。可用的行动： close: 关闭键盘 shift: 切换到输入在ValueButton元素中已被存储为shiftValue的数值 special: 切换到输入在ValueButton元素中已被存储为特殊值的数值 delete: 删去最后一个字符 clear: 删除整个条目 enter: 确认输入值 left: 将光标向左移动 right: 将光标向右移动 right: 将光标向右移动 ime-prev-candidates: 使用IME元素时，加载先前的候选者 ime-next-candidates: 在使用IME元素时加载额外的候选者	Button action	Yes
top	垂直位置。	Integer	Yes
left	水平位置。	Integer	Yes
width	外部宽度。	Integer	Yes
height	外侧高度。	Integer	Yes
zIndex	zIndex决定了显示元素的z-order。对于重叠的显示元素，zIndex决定了哪个元素在上面，哪个在下面。zIndex大的元素在上面；zIndex小的元素在下面。	UInteger	No

IME element

元素IME只在基于用户输入的字符的候选人列表可用时才会显示。这也适用于ActionImage元素和带有 "image-prev-candidates "或 "image-next-candidates "动作的ActionButton元素。

元素IME只能被添加到元素AlphaPad中。不支持在元素 "Section "或元素 "Header "中使用该元素。

Attribute	描述	Data type	Required
lang	可用值: zh-CN: Chinese Simplified zh-HK: Chinese Traditional	String	Yes
top	垂直位置。	Integer	Yes
left	水平位置。	Integer	Yes
width	外部宽度。	Integer	Yes
height	外侧高度。	Integer	Yes
zIndex	zIndex决定了显示元素的z-order。对于重叠的显示元素，zIndex决定了哪个元素在上面，哪个在下面。zIndex大的元素在上面；zIndex小的元素在下面。	UInteger	No

Editing custom keyboards (XML)

Editing custom keyboards (XML)

Alphanumeric keyboard

元素