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

Z
zhaolinglan 已提交
3
InputMethodExtensionAbility模块,提供生态输入法应用开发者通过InputMethodExtensionAbility、InputMethodExtensionContext接口创作输入法应用,并管理输入法应用生命周期。
Z
zhaolinglan 已提交
4 5 6

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

## 导入模块

```
Z
zhaolinglan 已提交
12
import InputMethodExtensionAbility from '@ohos.inputmethodextensionability';
Z
zhaolinglan 已提交
13 14 15 16 17 18 19 20 21 22 23 24 25
```

## 属性

**系统能力**:SystemCapability.MiscServices.InputMethodFramework

| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| 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 30 31 32 33 34 35 36 37 38 39

**系统能力**:SystemCapability.MiscServices.InputMethodFramework

**参数:**

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

**示例:**

H
Hollokin 已提交
40
```ts
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 55 56 57 58

**系统能力**:SystemCapability.MiscServices.InputMethodFramework

**示例:**

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