输入法框架


输入法框架

icon-note.gif 说明: 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import inputMethod from '@ohos.inputMethod';
1

inputMethod8+

常量值。

系统能力:以下各项对应的系统能力均为SystemCapability.Miscservices.InputMethodFramework

名称 参数类型 可读 可写 说明
MAX_TYPE_NUM number 可支持的最大输入法个数。

InputMethodProperty8+

输入法应用属性。

系统能力:以下各项对应的系统能力均为SystemCapability.Miscservices.InputMethodFramework

名称 参数类型 可读 可写 说明
packageName string 包名。
methodId string Ability名。

inputMethod.getInputMethodController

getInputMethodController(): InputMethodController

获取客户端实例InputMethodController

系统能力:SystemCapability.Miscservices.InputMethodFramework

返回值:

| 类型 | 说明 |
| -------- | -------- |
| [InputMethodController](#InputMethodController) | 回调返回当前客户端实例。 |

示例:

var InputMethodController = inputMethod.getInputMethodController();
1

inputMethod.getInputMethodSetting8+

getInputMethodSetting(): InputMethodSetting

获取客户端设置实例InputMethodSetting

系统能力: SystemCapability.Miscservices.InputMethodFramework

返回值:

类型 说明
InputMethodSetting 回调返回当前客户端设置实例。

示例:

var InputMethodSetting = inputMethod.getInputMethodSetting();
1

InputMethodController

下列API示例中都需使用getInputMethodController回调获取到InputMethodController实例,再通过此实例调用对应方法。

stopInput

stopInput(callback: AsyncCallback<boolean>): void

隐藏输入法。

系统能力:SystemCapability.Miscservices.InputMethodFramework

参数:

参数名 类型 必填 说明
callback AsyncCallback<boolean> 返回输入法隐藏是否成功。

示例:

 InputMethodController.stopInput((error)=>{
     console.info('stopInput');
 });
1
2
3

stopInput

stopInput(): Promise<boolean>

隐藏输入法。

系统能力: SystemCapability.Miscservices.InputMethodFramework

返回值:

类型 说明
Promise<boolean> 返回输入法隐藏是否成功。

示例:

 var isSuccess = InputMethodController.stopInput();
 console.info('stopInput isSuccess = ' + isSuccess);
1
2

InputMethodSetting8+

下列API示例中都需使用getInputMethodSetting回调获取到InputMethodSetting实例,再通过此实例调用对应方法。

listInputMethod

listInputMethod(callback: AsyncCallback<Array<InputMethodProperty>>): void

查询已安装的输入法列表。

系统能力: SystemCapability.Miscservices.InputMethodFramework

参数:

参数名 类型 必填 说明
callback Array<InputMethodProperty> 返回已安装输入法列表。

示例:

 InputMethodSetting.listInputMethod((properties)=>{
   for (var i = 0;i < properties.length; i++) {
     var property = properties[i];
     console.info(property.packageName + "/" + property.methodId);
   }
});
1
2
3
4
5
6

listInputMethod

listInputMethod(): Promise<Array<InputMethodProperty>>

查询已安装的输入法列表。

系统能力: SystemCapability.Miscservices.InputMethodFramework

返回值:

类型 说明
Promise<Array<InputMethodProperty>> 返回已安装输入法列表。

示例:

 var properties = InputMethodSetting.listInputMethod();
 for (var i = 0;i < properties.length; i++) {
   var property = properties[i];
   console.info(property.packageName + "/" + property.methodId);
 }
1
2
3
4
5

displayOptionalInputMethod

displayOptionalInputMethod(callback: AsyncCallback<void>): void

显示输入法选择对话框。

系统能力: SystemCapability.Miscservices.InputMethodFramework

参数:

参数名 类型 必填 说明
callback AsyncCallback<void> 回调函数。

示例:

 InputMethodSetting.displayOptionalInputMethod(()=>{
   console.info('displayOptionalInputMethod is called');
 });
1
2
3

displayOptionalInputMethod

displayOptionalInputMethod(): Promise<void>

显示输入法选择对话框。

系统能力: SystemCapability.Miscservices.InputMethodFramework

返回值:

类型 说明
Promise<void> 回调函数。

示例: js InputMethodSetting.displayOptionalInputMethod();