js-apis-inputmethod-extension-ability.md 1.9 KB
Newer Older
Z
zhaolinglan 已提交
1 2
# InputMethodExtensionAbility

H
Hollokin 已提交
3
开发者可通过继承本模块开发自己的输入法应用并管理输入法应用生命周期。
Z
zhaolinglan 已提交
4

H
update  
Hollokin 已提交
5 6
> **说明:**
>
7
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
Z
zhaolinglan 已提交
8 9 10

## 导入模块

11
```js
Z
zhaolinglan 已提交
12
import InputMethodExtensionAbility from '@ohos.inputmethodextensionability';
Z
zhaolinglan 已提交
13 14 15 16
```

## 属性

H
update  
Hollokin 已提交
17
**系统能力:** SystemCapability.MiscServices.InputMethodFramework
Z
zhaolinglan 已提交
18

19 20 21
| 名称    | 参数类型           | 可读 | 可写 | 说明                 |
| ------- | -----------------| --- | ---- | -------------------- |
| context | [InputMethodExtensionContext](js-apis-inputmethod-extension-context.md) | 是   | 否   | InputMethodExtension的上下文环境,继承自ExtensionContext。 |
Z
zhaolinglan 已提交
22

23
## InputMethodExtensionAbility.onCreate
Z
zhaolinglan 已提交
24

H
Hollokin 已提交
25
onCreate(want: Want): void
Z
zhaolinglan 已提交
26

Z
zhaolinglan 已提交
27
Extension生命周期回调,在拉起Extension输入法应用时调用,执行初始化输入法应用操作。
Z
zhaolinglan 已提交
28

H
update  
Hollokin 已提交
29
**系统能力:** SystemCapability.MiscServices.InputMethodFramework
Z
zhaolinglan 已提交
30 31 32

**参数:**

33 34 35
| 参数名 | 类型          | 必填 | 说明                             |
| ------ | ----------- | ---- | ------------------------------- |
| want   | [Want](js-apis-application-Want.md) | 是   | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 |
Z
zhaolinglan 已提交
36 37 38

**示例:**

H
Hollokin 已提交
39
```js
H
Hollokin 已提交
40
class InputMethodExt extends InputMethodExtensionAbility {
Z
zhaolinglan 已提交
41
    onCreate(want) {
H
Hollokin 已提交
42
        console.log('onCreate, want:' + want.abilityName);
Z
zhaolinglan 已提交
43
    }
H
Hollokin 已提交
44 45
}
```
Z
zhaolinglan 已提交
46

47
## InputMethodExtensionAbility.onDestroy
Z
zhaolinglan 已提交
48

H
Hollokin 已提交
49
onDestroy(): void
Z
zhaolinglan 已提交
50

Z
zhaolinglan 已提交
51
Extension生命周期回调,在销毁输入法应用时回调,执行资源清理等操作。
Z
zhaolinglan 已提交
52

H
update  
Hollokin 已提交
53
**系统能力:** SystemCapability.MiscServices.InputMethodFramework
Z
zhaolinglan 已提交
54 55 56

**示例:**

H
Hollokin 已提交
57
```js
H
Hollokin 已提交
58
class InputMethodExt extends InputMethodExtensionAbility {
Z
zhaolinglan 已提交
59
    onDestroy() {
H
Hollokin 已提交
60
        console.log('onDestroy');
Z
zhaolinglan 已提交
61
    }
H
Hollokin 已提交
62
}
63
```