js-apis-inputmethod-extension-ability.md 1.8 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

## 导入模块

```
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 22 23 24 25

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


## InputMethodExtensionAbility.onCreate()

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

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

H
update  
Hollokin 已提交
30
**系统能力:** SystemCapability.MiscServices.InputMethodFramework
Z
zhaolinglan 已提交
31 32 33 34 35 36 37 38 39

**参数:**

  | 参数名 | 类型 | 必填 | 说明 | 
  | -------- | -------- | -------- | -------- |
  | want |  [Want](js-apis-application-Want.md) | 是 | 当前Extension相关的Want类型信息,包括ability名称、bundle名称等。 | 

**示例:**

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


## InputMethodExtensionAbility.onDestroy()

H
Hollokin 已提交
51
onDestroy(): void
Z
zhaolinglan 已提交
52

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

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

**示例:**

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