组合按键

InputConsumer模块提供对按键事件的监听。

说明：

• 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
• 本模块接口均为系统接口，三方应用不支持调用。

导入模块

import inputConsumer from '@ohos.multimodalInput.inputConsumer';

inputConsumer.on

on(type: “key”, keyOptions: KeyOptions, callback: Callback): void

开始监听组合按键事件, 当满足条件的组合按键输入事件发生时，将keyOptions回调到入参callback表示的回调函数上。

此接口为系统接口。

参数：

参数	类型	必填	说明
type	string	是	监听输入事件类型，只支持“key”。
keyOptions	[KeyOptions]	是	组合键选项，用来指定组合键输入时应该符合的条件。
callback	Callback<[KeyOptions]>	是	回调函数。当满足条件的按键输入产生时，回调到此函数，以传入的KeyOptions为入参。

示例：

let keyOptions = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0}
let callback = function(keyOptions) {
    console.info("preKeys: " + keyOptions.preKeys, "finalKey: " + keyOptions.finalKey, 
                 "isFinalKeyDown: " + keyOptions.isFinalKeyDown, "finalKeyDownDuration: " + keyOptions.finalKeyDownDuration)
}
inputConsumer.on('key', keyOptions, callback);

inputConsumer.off

off(type: “key”, keyOptions: KeyOptions, callback?: Callback): void

停止监听组合按键事件。

此接口为系统接口。

系统能力： SystemCapability.MultimodalInput.Input.InputConsumer

参数：

参数	类型	必填	说明
type	string	是	监听输入事件类型，只支持“key”。
keyOptions	[KeyOptions]	是	开始监听时传入的keyOptions。
callback	Callback<[KeyOptions]>	是	开始监听时与KeyOption一同传入的回调函数 。

示例：

let keyOptions = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0}
let callback = function(keyOptions) {
    console.info("preKeys: " + keyOptions.preKeys, "finalKey: " + keyOptions.finalKey, 
                 "isFinalKeyDown: " + keyOptions.isFinalKeyDown, "finalKeyDownDuration: " + keyOptions.finalKeyDownDuration)
}
inputConsumer.off('key', keyOptions, callback);

KeyOptions

组合键输入事件发生时，组合键满足的选项。

此接口为系统接口。

**系统能力：**SystemCapability.MultimodalInput.Input.InputConsumer

参数	类型	必填	说明
preKeys	Array	是	组合键前置按键集合，可为空，前置按键无顺序要求。
finalKey	Number	是	组合键最后按键，不能为空。
isFinalKeyDown	boolean	是	组合键最后按键是按下还是抬起，默认是按下。
finalKeyDownDuration	Number	是	组合键最后按键按下持续时长，默认无时长要求。