mappView帮助助手 > mapp View帮助信息 > 指南 > FAQs > 键盘操作

启用键盘操作时，启动和完成输入的行为可以在HMI应用程序中配置为可选的 <KeyboardHandling> 元素。

键盘操作

默认情况下，输入（例如在部件NumericInput或TextInput）可以用任何允许的字符开始。输入可以用ENTER或TAB / Shift+TAB来应用。

另外，开始和完成输入可以只用ENTER键来配置。

已经开始的输入可以在完成之前通过按ESC键取消。

参数

值

描述

OnStart

any/accept

默认值: any

OnStart 定义拥有焦点的小组件的输入是否可以用该小组件允许的任何字符开始（任何），或者是否用回车键启用输入（接受）。

OnEnd

focus/accept

默认值: focus

OnEnd 定义小部件中的输入是通过TAB/Shift+TAB（焦点）或Enter键（接受）的焦点改变来应用。

这种行为适用于HMI应用程序中所有使用键盘操作的部件。

因此，在小部件上进行配置是不必要的。

一块内容包含允许通过外部键盘输入的NumericInput小组件。根据输入的开始和完成的配置，下表显示了小部件上的行为与相应的 OnStart 和 OnEnd 行为。

参数	值		行为
OnStart	any	重点在小组件NumericInput。输入一个数值或符号（-）将小组件设置为输入模式；允许的、输入的字符会显示在小组件中。	触发了FocusIn事件。样式 "active "被应用于输入。
OnEnd	focus	用回车键完成输入输入的值被应用；焦点保持在小组件上。	触发了ValueChanged事件。样式 "标准 "被显示。
OnEnd	focus	用 TAB 或 Shift+TAB完成输入输入的值被应用；焦点被设置到标签顺序中的下一个或上一个小组件。	事件ValueChanged被触发。 FocusOut事件被触发。样式 "standard "被显示。

参数	值	描述	行为
OnStart	accept	焦点在小组件NumericInput上。必须按下ENTER 键才能开始输入。	事件FocusIn被触发。样式 "active "被应用于ENTER上。
OnEnd	accept	用 ENTER键完成输入输入的值被应用；焦点保持在小组件上。	事件ValueChanged被触发。样式 "standard "被显示。
OnEnd	accept	用 TAB 或 Shift+TAB完成输入输入的值被丢弃；焦点被设置到标签顺序中的下一个或上一个小组件。	事件FocusOut被触发。显示 "standard "样式。

一块内容包含TextInput部件，允许通过外部键盘输入。根据输入的开始和完成的配置，下表显示了小部件上的行为。

参数	值	描述	行为
OnStart	any	焦点在小部件TextInput上。输入一个允许的字符将小组件设置为输入模式；第一个字符会删除现有文本。如果按了ENTER 键，现有的文本就被选中。任何字符。删除现有的文本右光标键。将光标放在文本后面，允许附加字符。主页键。将光标放在文本的开头，允许插入字符。	触发了FocusIn事件。样式 "active "被应用于输入。
OnEnd	focus	用回车键完成输入输入的文本被应用；焦点保持在小组件上。	触发了ValueChanged事件。样式 "standard "被显示。
OnEnd	focus	用 TAB 或 Shift+TAB完成输入输入的文本被应用；焦点被设置到标签顺序中的下一个或上一个小组件。	事件ValueChanged被触发。 FocusOut事件被触发。样式 "standard "被显示。

参数	值	描述	行为
OnStart	accept	焦点在小组件TextInput上。必须按回车键才能开始输入；现有的文本将被选中。任何字符。删除现有的文本右光标键。将光标放在文本后面，允许附加字符主页键。将光标放在文本的开头，允许插入字符。	事件FocusIn被触发。样式 "active "被应用于ENTER上。
OnEnd	accept	用回车键完成输入输入的文本被应用；焦点保持在小组件上。	事件ValueChanged被触发。样式 "standard "被显示。
OnEnd	accept	用 TAB 或 Shift+TAB完成输入输入的文本被丢弃；焦点被设置到标签顺序中的下一个或上一个小组件。	事件FocusOut被触发。显示 "standard "样式。

对于小组件NumericInput和TextInput，属性 keyboard可以用来指定当小组件被点击时是否应该打开虚拟键盘（keyboard=true）或者是否应该只通过外部键盘进行输入（keyboard=false）。

如果键盘=true，当用触摸屏或鼠标操作小部件时，虚拟键盘就会被打开。ESC键也可以用来取消这里的输入；原始值会重新显示在小部件上。