From 17c8251089ed4413f1620557b7e4e42dab0bc556 Mon Sep 17 00:00:00 2001 From: Hollokin Date: Sun, 7 May 2023 17:28:56 +0800 Subject: [PATCH] =?UTF-8?q?=E7=BB=9F=E4=B8=80=E6=8E=92=E6=9F=A5=EF=BC=8C?= =?UTF-8?q?=E5=9C=A8-type=E4=B8=AD=E9=97=B4=E5=8A=A0=E7=A9=BA=E6=A0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Hollokin --- .../reference/apis/js-apis-inputmethod.md | 48 ++++++++++--------- .../apis/js-apis-inputmethodengine.md | 4 +- 2 files changed, 28 insertions(+), 24 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md index b24eae05ba..c485e0dbe5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethod.md @@ -965,7 +965,7 @@ setCallingWindow(windowId: number, callback: AsyncCallback<void>): void 设置要避让的窗口。使用callback异步回调。 -比如：将当前绑定到输入法的应用程序的窗口ID通知系统，正确设置后，客户端所在的窗口可以避开输入法窗口。 +比如：将当前绑定到输入法的应用程序的窗口ID通知系统，正确设置后，客户端所在的窗口可以避开输入法窗口。预留能力，当前暂不支持获取windowId。 **系统能力：** SystemCapability.MiscServices.InputMethodFramework @@ -1009,7 +1009,7 @@ setCallingWindow(windowId: number): Promise<void> 设置要避让的窗口。使用promise异步回调。 -比如：将当前绑定到输入法的应用程序的窗口ID通知系统，正确设置后，客户端所在的窗口可以避开输入法窗口。 +比如：将当前绑定到输入法的应用程序的窗口ID通知系统，正确设置后，客户端所在的窗口可以避开输入法窗口。预留能力，当前暂不支持获取windowId。 **系统能力：** SystemCapability.MiscServices.InputMethodFramework @@ -1635,7 +1635,7 @@ on(type: 'insertText', callback: (text: string) => void): void; | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | -| type | string | 是 | 设置监听类型。
-type为‘insertText’时表示订阅输入法应用插入文本事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘insertText’时表示订阅输入法应用插入文本事件监听。 | | callback | (text: string) => void | 是 | 回调函数，返回需要插入的文本内容。
开发者需要在回调函数中根据传入的文本内容操作编辑框中的内容。 | **错误码：** @@ -1670,7 +1670,7 @@ off(type: 'insertText'): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------------------------------------------------ | -| type | string | 是 | 设置监听类型。
-type为‘insertText’时表示取消订阅输入法应用插入文本事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘insertText’时表示取消订阅输入法应用插入文本事件监听。 | **示例：** @@ -1690,7 +1690,7 @@ on(type: 'deleteLeft' | 'deleteRight', callback: (length: number) => void): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ----- | ---- | ----- | -| type | string | 是 | 设置监听类型。
-type为‘deleteLeft’时表示订阅输入法应用向左删除事件监听。
-type为‘deleteRight’时表示订阅输入法应用向右删除事件监听。| +| type | string | 是 | 设置监听类型。
- type为‘deleteLeft’时表示订阅输入法应用向左删除事件监听。
- type为‘deleteRight’时表示订阅输入法应用向右删除事件监听。| | callback | (length: number) => void | 是 | 回调函数，返回需要向左或向右删除的文本的长度。
开发者需要在回调函数中根据传入的删除长度操作编辑框中相应文本。 | **错误码：** @@ -1733,7 +1733,7 @@ off(type: 'deleteLeft' | 'deleteRight'): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------------------------------------------------ | -| type | string | 是 | 设置监听类型。
-type为‘deleteLeft’时表示取消订阅输入法应用向左删除的事件监听。
-type为‘deleteRight’时表示取消订阅输入法应用向右删除的事件监听。| +| type | string | 是 | 设置监听类型。
- type为‘deleteLeft’时表示取消订阅输入法应用向左删除的事件监听。
- type为‘deleteRight’时表示取消订阅输入法应用向右删除的事件监听。| **示例：** @@ -1754,7 +1754,7 @@ on(type: 'sendKeyboardStatus', callback: (keyBoardStatus: KeyboardStatus) => voi | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ---- | -| type | string | 是 | 设置监听类型。
-type为‘sendKeyboardStatus’时表示订阅输入法应用发送键盘状态事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘sendKeyboardStatus’时表示订阅输入法应用发送键盘状态事件监听。 | | callback | (keyBoardStatus: [KeyboardStatus](#keyboardstatus10)) => void | 是 | 回调函数，返回键盘状态。
开发者需要在回调函数中根据传入的键盘状态做相应动作。 | **错误码：** @@ -1789,7 +1789,7 @@ off(type: 'sendKeyboardStatus'): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------------------------------------------------ | -| type | string | 是 | 设置监听类型。
-type为‘sendKeyboardStatus’时表示取消订阅输入法应用发送键盘状态事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘sendKeyboardStatus’时表示取消订阅输入法应用发送键盘状态事件监听。 | **示例：** @@ -1809,7 +1809,7 @@ on(type: 'sendFunctionKey', callback: (functionKey: FunctionKey) => void): void | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | ---- | ----- | -| type | string | 是 | 设置监听类型。
-type为‘sendFunctionKey’时表示订阅输入法应用发送功能键事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘sendFunctionKey’时表示订阅输入法应用发送功能键事件监听。 | | callback | (functionKey: [FunctionKey](#functionkey10)) => void | 是 | 回调函数，返回输入法应用发送的功能键信息。
开发者需要根据返回的功能键做相应的操作。 | **错误码：** @@ -1844,7 +1844,7 @@ off(type: 'sendFunctionKey'): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------------------------------------------------ | -| type | string | 是 | 设置监听类型。
-type为‘sendFunctionKey’时表示取消订阅输入法应用发送FunctionKey事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘sendFunctionKey’时表示取消订阅输入法应用发送FunctionKey事件监听。 | **示例：** @@ -1864,7 +1864,7 @@ on(type: 'moveCursor', callback: (direction: Direction) => void): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | ------ | -| type | string | 是 | 设置监听类型。
-type为‘moveCursor’时表示订阅输入法应用移动光标事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘moveCursor’时表示订阅输入法应用移动光标事件监听。 | | callback | callback: (direction: [Direction10+](#direction10)) => void | 是 | 回调函数，返回光标信息。
开发者需要根据返回的光标移动方向改变光标位置。 | **错误码：** @@ -1899,7 +1899,7 @@ off(type: 'moveCursor'): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ---- | -| type | string | 是 | 设置监听类型。
-type为‘moveCursor’时表示取消订阅输入法应用发送移动光标事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘moveCursor’时表示取消订阅输入法应用发送移动光标事件监听。 | **示例：** @@ -1919,7 +1919,7 @@ on(type: 'handleExtendAction', callback: (action: ExtendAction) => void): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ------ | ---- | -------- | -| type | string | 是 | 设置监听类型。
-type为‘handleExtendAction’时表示订阅输入法应用发送扩展操作代码事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘handleExtendAction’时表示订阅输入法应用发送扩展操作代码事件监听。 | | callback | callback: (action: [ExtendAction](#extendaction10)) => void | 是 | 回调函数，返回扩展操作类型。
开发者需要在回调函数中根据传入的扩展操作类型做相应的操作。 | **错误码：** @@ -1954,7 +1954,7 @@ off(type: 'handleExtendAction'): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| type | string | 是 | 设置监听类型。
-type为‘handleExtendAction’时表示取消订阅输入法应用发送扩展代码事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘handleExtendAction’时表示取消订阅输入法应用发送扩展代码事件监听。 | **示例：** @@ -1974,7 +1974,7 @@ on(type: 'selectByRange', callback: Callback<Range>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---- | ---- | ------- | -| type | string | 是 | 设置监听类型。
-type为‘selectByRange’时表示订阅输入法应用按范围选中文本事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘selectByRange’时表示订阅输入法应用按范围选中文本事件监听。 | | callback | Callback<[Range](#range10)> | 是 | 回调函数，返回需要选中的文本的范围。
开发者需要在回调函数中根据传入的范围选中编辑框中相应文本。 | **示例：** @@ -1997,7 +1997,7 @@ off(type: 'selectByRange'): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------------------------------------------------ | -| type | string | 是 | 设置监听类型。
-type为‘selectByRange’时表示取消订阅输入法应用按范围选中文本事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘selectByRange’时表示取消订阅输入法应用按范围选中文本事件监听。 | **示例：** @@ -2017,7 +2017,7 @@ on(type: 'selectByMovement', callback: Callback<Movement>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ----- | ---- | ------ | -| type | string | 是 | 设置监听类型。
-type为‘selectByMovement’时表示订阅输入法应用按光标移动动作选中文本事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘selectByMovement’时表示订阅输入法应用按光标移动动作选中文本事件监听。 | | callback | Callback<[Movement](#movement10)> | 是 | 回调函数，返回需要选中的文本的范围。
开发者需要在回调函数中根据传入的光标动作选中编辑框中相应文本。 | **示例：** @@ -2040,7 +2040,7 @@ off(type: 'selectByMovement'): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------------------------------------------------ | -| type | string | 是 | 设置监听类型。
-type为‘selectByMovement’时表示取消订阅输入法应用按范围选中文本事件监听。 | +| type | string | 是 | 设置监听类型。
- type为‘selectByMovement’时表示取消订阅输入法应用按范围选中文本事件监听。 | **示例：** @@ -2064,7 +2064,7 @@ on(type: 'imeChange', callback: (inputMethodProperty: InputMethodProperty, input | 参数名 | 类型 | 必填 | 说明 | | -------- | ------------------------------- | ---- | ------------------------------------------------------------ | -| type | string | 是 | 设置监听类型。
-type为‘imeChange’时表示订阅输入法及子类型变化监听事件。 | +| type | string | 是 | 设置监听类型。
- type为‘imeChange’时表示订阅输入法及子类型变化监听事件。 | | callback | (inputMethodProperty: [InputMethodProperty](#inputmethodproperty8), inputMethodSubtype: [InputMethodSubtype](./js-apis-inputmethod-subtype.md#inputmethodsubtype)) => void | 是 | 回调函数，返回输入法属性对象及输入法子类型对象。 | **示例：** @@ -2087,7 +2087,7 @@ off(type: 'imeChange', callback?: (inputMethodProperty: InputMethodProperty, inp | 参数名 | 类型 | 必填 | 说明 | | -------- | --------- | ---- | --------------- | -| type | string | 是 | 设置监听类型。
-type为‘imeChange’时表示取消订阅输入法及子类型变化监听事件。 | +| type | string | 是 | 设置监听类型。
- type为‘imeChange’时表示取消订阅输入法及子类型变化监听事件。 | | callback | (inputMethodProperty: [InputMethodProperty](#inputmethodproperty8), inputMethodSubtype: [InputMethodSubtype](./js-apis-inputmethod-subtype.md#inputmethodsubtype)) => void | 否 | 回调函数，返回取消订阅的输入法属性对象及输入法子类型对象。 | **示例：** @@ -2267,7 +2267,9 @@ try { getInputMethods(enable: boolean, callback: AsyncCallback<Array<InputMethodProperty>>): void -获取已激活/未激活输入法列表。参数enable取true，返回已激活输入法列表，取false返回未激活输入法列表。已激活/未激活输入法的确切功能当前版本未支持。已激活输入法包括当前使用的输入法，未激活输入法包括当前输入法以外的其他已安装的输入法。使用callback异步回调。 +获取已激活/未激活输入法列表。使用callback异步回调。 + +参数enable取true，返回已激活输入法列表；取false返回未激活输入法列表。已激活/未激活为预留概念，当前暂未支持。当前版本中，已激活输入法包括当前使用的输入法，未激活输入法包括当前输入法以外的其他已安装的输入法。 **系统能力：** SystemCapability.MiscServices.InputMethodFramework @@ -2307,7 +2309,9 @@ try { getInputMethods(enable: boolean): Promise<Array<InputMethodProperty>> -获取已激活/未激活输入法列表。参数enable取true，返回已激活输入法列表，取false返回未激活输入法列表。已激活/未激活输入法的确切功能当前版本未支持。已激活输入法包括当前使用的输入法，未激活输入法包括当前输入法以外的其他已安装的输入法。使用promise异步回调。 +获取已激活/未激活输入法列表。使用promise异步回调。 + +参数enable取true，返回已激活输入法列表；取false返回未激活输入法列表。已激活/未激活为预留概念，当前暂未支持。当前版本中，已激活输入法包括当前使用的输入法，未激活输入法包括当前输入法以外的其他已安装的输入法。 **系统能力：** SystemCapability.MiscServices.InputMethodFramework diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmethodengine.md b/zh-cn/application-dev/reference/apis/js-apis-inputmethodengine.md index 5f312b007b..fb2f368000 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmethodengine.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmethodengine.md @@ -1514,7 +1514,7 @@ sendKeyFunction(action:number, callback: AsyncCallback<boolean>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| action | number | 是 | 功能键键值。
当值为0时，表示无效按键；
当值为1时，表示确认键（即回车键）。 | +| action | number | 是 | 功能键键值。
- 当值为0时，表示无效按键；
- 当值为1时，表示确认键（即回车键）。 | | callback | AsyncCallback<boolean> | 是 | 回调函数。当功能键发送成功，err为undefined，data为true；否则为错误对象。 | **错误码：** @@ -2864,7 +2864,7 @@ sendKeyFunction(action: number, callback: AsyncCallback<boolean>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | -| action | number | 是 | 功能键键值。
当值为0时，表示无效按键；
当值为1时，表示确认键（即回车键）。 | +| action | number | 是 | 功能键键值。
- 当值为0时，表示无效按键；
- 当值为1时，表示确认键（即回车键）。 | | callback | AsyncCallback<boolean> | 是 | 回调函数。当功能键发送成功，err为undefined，data为true；否则为错误对象。 | **示例：** -- GitLab