Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
e5806859
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
e5806859
编写于
4月 06, 2023
作者:
L
limeng
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
快捷键开发者文档
Signed-off-by:
N
limeng
<
limeng208@huawei.com
>
上级
c9e19a2f
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
9 addition
and
9 deletion
+9
-9
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-keyboardshortcut.md
...eference/arkui-ts/ts-universal-events-keyboardshortcut.md
+9
-9
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-keyboardshortcut.md
浏览文件 @
e5806859
...
...
@@ -8,16 +8,16 @@
## 接口
keyboardShortcut(value: string | [FunctionKey], keys: Array
<
[
Ctrl
Key
]
>
)
keyboardShortcut(value: string | [FunctionKey], keys: Array
<
[
Modifier
Key
]
>
)
**参数:**
| 参数名 | 参数类型 | 必填 | 参数描述 |
| ------ | ------------------------------------- | ---- | ------------------------------------------------------------ |
| value | string
\|
[
FunctionKey
](
#functionkey
)
| 是 | 热键的单个字符(可以通过键盘输入的字符)或
[
FunctionKey
](
#functionkey
)
。
<br/>
|
| keys | Array
<
[
CtrlKey
](
#ctrlkey
)
>
| 是 | 热键组合。
<br/>
|
| keys | Array
<
[
ModifierKey
](
#modifierkey
)
>
| 是 | 热键组合。
<br/>
|
##
Ctrl
Key
##
Modifier
Key
| 名称 | 描述 |
| ----- | ------------------- |
...
...
@@ -48,17 +48,17 @@ keyboardShortcut(value: string | [FunctionKey], keys: Array<[CtrlKey]>)
| 场景 | 快捷键处理逻辑 | 例子 |
| ------------------------------------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------ |
| 所有支持onClick事件的组件 | 支持自定义组合键 | 无 |
| 自定义组合键要求 | 控制键Ctrl,Shift,Alt及它们的组合加上其它可输入字符按键 | Button('button1').keyboardShortcut('a',[
CtrlKey.CTRL])
|
| 多个不同组件设置相同组合键 | 只响应结点树上的第一个组件、其它组件不响应快捷键。 | Button('button1').keyboardShortcut('a',[
CtrlKey.CTRL])
<br
/>
Button('button2').keyboardShortcut('a',[Ctrl
Key.CTRL]) |
| 自定义组合键要求 | 控制键Ctrl,Shift,Alt及它们的组合加上其它可输入字符按键 | Button('button1').keyboardShortcut('a',[
ModifierKey.CTRL])
|
| 多个不同组件设置相同组合键 | 只响应结点树上的第一个组件、其它组件不响应快捷键。 | Button('button1').keyboardShortcut('a',[
ModifierKey.CTRL])
<br
/>
Button('button2').keyboardShortcut('a',[Modifier
Key.CTRL]) |
| 无论组件是否获得焦点 | 只要窗口获焦快捷键就会响应 | 无 |
| 绑定单个快捷键时候,通过keyboardShortcut接口value值或者是keys值或两者都是空的情况下。
<br
/>
绑定多个快捷键的时候无法取消快捷键。 | 取消快捷键的设置 | Button('button1').keyboardShortcut('',[
Ctrl
Key.CTRL])
<br
/>
Button('button2').keyboardShortcut('a',[l])
<br
/>
Button('button3').keyboardShortcut('',[]) |
| 绑定单个快捷键时候,通过keyboardShortcut接口value值或者是keys值或两者都是空的情况下。
<br
/>
绑定多个快捷键的时候无法取消快捷键。 | 取消快捷键的设置 | Button('button1').keyboardShortcut('',[
Modifier
Key.CTRL])
<br
/>
Button('button2').keyboardShortcut('a',[l])
<br
/>
Button('button3').keyboardShortcut('',[]) |
| 独立pipeline子窗口、主窗口共存的情况下 | 获焦的窗口响应快捷键 | 无 |
| keyboardShortcut接口中的keys命令中ctrl、shift、alt | 不区分左右键都响应 | Button('button1').keyboardShortcut('a',[
CtrlKey.CTRL, Ctrl
Key.ALT]) |
| keyboardShortcut接口中的value单个字符 | 不区分大小写都响应 | Button('button1').keyboardShortcut('a',[
CtrlKey.CTRL])
<br
/>
Button('button2').keyboardShortcut('A',[Ctrl
Key.CTRL]) |
| keyboardShortcut接口中的keys命令中ctrl、shift、alt | 不区分左右键都响应 | Button('button1').keyboardShortcut('a',[
ModifierKey.CTRL, Modifier
Key.ALT]) |
| keyboardShortcut接口中的value单个字符 | 不区分大小写都响应 | Button('button1').keyboardShortcut('a',[
ModifierKey.CTRL])
<br
/>
Button('button2').keyboardShortcut('A',[Modifier
Key.CTRL]) |
| 快捷键的响应 | 所有快捷键down的状态下响应、且连续响应 | 无 |
| 隐藏组件
<br
/>
| 响应快捷键 | 无 |
| disable状态组件 | 不响应快捷键 | 无 |
| 1. 组件的组合键(包括系统预定义快捷键)相同时。
<br
/>
2. 接口参数value有多个字符时。
<br
/>
3. 接口参数keys有重复的控制键时。 | 这几种情况不绑定组合键, 先前绑定的组合键仍然有效 | Button('button1').keyboardShortcut('c',[
CtrlKey.CTRL])
<br
/>
Button('button2').keyboardShortcut('ab',[CtrlKey.CTRL])
<br
/>
Button('button3').keyboardShortcut('ab',[CtrlKey.CTRL,Ctrl
Key.CTRL]) |
| 1. 组件的组合键(包括系统预定义快捷键)相同时。
<br
/>
2. 接口参数value有多个字符时。
<br
/>
3. 接口参数keys有重复的控制键时。 | 这几种情况不绑定组合键, 先前绑定的组合键仍然有效 | Button('button1').keyboardShortcut('c',[
ModifierKey.CTRL])
<br
/>
Button('button2').keyboardShortcut('ab',[ModifierKey.CTRL])
<br
/>
Button('button3').keyboardShortcut('ab',[ModifierKey.CTRL,Modifier
Key.CTRL]) |
## 系统已有组合键
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录