mirror of
https://gitee.com/openharmony/interface_sdk-js
synced 2025-04-12 18:28:35 +00:00
2554 lines
89 KiB
TypeScript
2554 lines
89 KiB
TypeScript
/*
|
|
* Copyright (c) 2021-2024 Huawei Device Co., Ltd.
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
* @kit IMEKit
|
|
*/
|
|
import type { AsyncCallback, Callback } from './@ohos.base';
|
|
import type { KeyEvent as InputKeyEvent } from './@ohos.multimodalInput.keyEvent';
|
|
import InputMethodSubtype from './@ohos.InputMethodSubtype';
|
|
import BaseContext from './application/BaseContext';
|
|
import window from './@ohos.window';
|
|
|
|
/**
|
|
* Input method engine
|
|
*
|
|
* @namespace inputMethodEngine
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
declare namespace inputMethodEngine {
|
|
/**
|
|
* When "enter" key is pressed, there is no action
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const ENTER_KEY_TYPE_UNSPECIFIED: number;
|
|
|
|
/**
|
|
* When "enter" key is pressed, it means GO
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const ENTER_KEY_TYPE_GO: number;
|
|
|
|
/**
|
|
* When "enter" key is pressed, it means SEARCH
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const ENTER_KEY_TYPE_SEARCH: number;
|
|
|
|
/**
|
|
* When "enter" key is pressed, it means SEND
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const ENTER_KEY_TYPE_SEND: number;
|
|
|
|
/**
|
|
* When "enter" key is pressed, it means NEXT
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const ENTER_KEY_TYPE_NEXT: number;
|
|
|
|
/**
|
|
* When "enter" key is pressed, it means DONE
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const ENTER_KEY_TYPE_DONE: number;
|
|
|
|
/**
|
|
* When "enter" key is pressed, it means PREVIOUS
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const ENTER_KEY_TYPE_PREVIOUS: number;
|
|
|
|
/**
|
|
* When "enter" key is pressed, it means NEWLINE
|
|
*
|
|
* @constant
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
const ENTER_KEY_TYPE_NEWLINE: 8;
|
|
|
|
/**
|
|
* Editor with no special function
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const PATTERN_NULL: number;
|
|
|
|
/**
|
|
* Editor of type TEXT
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const PATTERN_TEXT: number;
|
|
|
|
/**
|
|
* Editor of type NUMBER
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const PATTERN_NUMBER: number;
|
|
|
|
/**
|
|
* Editor of type PHONE NUMBER
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const PATTERN_PHONE: number;
|
|
|
|
/**
|
|
* Editor of type DATETIME
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const PATTERN_DATETIME: number;
|
|
|
|
/**
|
|
* Editor of type EMAIL
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const PATTERN_EMAIL: number;
|
|
|
|
/**
|
|
* Editor of type URI
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const PATTERN_URI: number;
|
|
|
|
/**
|
|
* Editor of type PASSWORD
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const PATTERN_PASSWORD: number;
|
|
|
|
/**
|
|
* Editor of type SCREEN LOCK PASSWORD
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
const PATTERN_PASSWORD_SCREEN_LOCK: number;
|
|
|
|
/**
|
|
* Editor of type NUMBER PASSWORD
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
const PATTERN_PASSWORD_NUMBER: number;
|
|
|
|
/**
|
|
* Editor in SELECTING state
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const FLAG_SELECTING: number;
|
|
|
|
/**
|
|
* Editor in SINGLE_LINE state
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const FLAG_SINGLE_LINE: number;
|
|
|
|
/**
|
|
* The Editor displays in PART mode
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const DISPLAY_MODE_PART: number;
|
|
|
|
/**
|
|
* The Editor displays in FULL mode
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const DISPLAY_MODE_FULL: number;
|
|
|
|
/**
|
|
* Allows ASCII to be inputted
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const OPTION_ASCII: number;
|
|
|
|
/**
|
|
* Do not specify Editor's input type
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const OPTION_NONE: number;
|
|
|
|
/**
|
|
* Allows CHARACTERS to be inputted
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const OPTION_AUTO_CAP_CHARACTERS: number;
|
|
|
|
/**
|
|
* Allows SENTENCES to be inputted
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const OPTION_AUTO_CAP_SENTENCES: number;
|
|
|
|
/**
|
|
* Allows WORDS to be inputted
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const OPTION_AUTO_WORDS: number;
|
|
|
|
/**
|
|
* Allows MULTI_LINE to be inputted
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const OPTION_MULTI_LINE: number;
|
|
|
|
/**
|
|
* Half-screen mode
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
const OPTION_NO_FULLSCREEN: number;
|
|
|
|
/**
|
|
* The move direction of cursor: UP
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
const CURSOR_UP: number;
|
|
|
|
/**
|
|
* The move direction of cursor: DOWN
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
const CURSOR_DOWN: number;
|
|
|
|
/**
|
|
* The move direction of cursor: LEFT
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
const CURSOR_LEFT: number;
|
|
|
|
/**
|
|
* The move direction of cursor: RIGHT
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
const CURSOR_RIGHT: number;
|
|
|
|
/**
|
|
* The window styles for input method ability.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
const WINDOW_TYPE_INPUT_METHOD_FLOAT: number;
|
|
|
|
/**
|
|
* Get InputMethodAbility object to subscribe events about IME.
|
|
*
|
|
* @returns { InputMethodAbility } the object of the InputMethodAbility.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
function getInputMethodAbility(): InputMethodAbility;
|
|
|
|
/**
|
|
* @returns { InputMethodEngine }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine#getInputMethodAbility
|
|
*/
|
|
function getInputMethodEngine(): InputMethodEngine;
|
|
|
|
/**
|
|
* Get KeyboardDelegate object to subscribe key event or events about editor.
|
|
*
|
|
* @returns { KeyboardDelegate } the object of KeyboardDelegate.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
function getKeyboardDelegate(): KeyboardDelegate;
|
|
|
|
/**
|
|
* @returns { KeyboardDelegate }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine#getKeyboardDelegate
|
|
*/
|
|
function createKeyboardDelegate(): KeyboardDelegate;
|
|
|
|
/**
|
|
* Indicates the possible data types of the command.
|
|
* @typedef { number | string | boolean }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
type CommandDataType = number | string | boolean;
|
|
|
|
/**
|
|
* The callback of 'sizeUpdate' event.
|
|
*
|
|
* @typedef { function } SizeUpdateCallback.
|
|
* @param { window.Size } size - panel size.
|
|
* @param { KeyboardArea } keyboardArea - keyboard area.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @systemapi
|
|
* @since 14
|
|
*/
|
|
export type SizeUpdateCallback = (size: window.Size, keyboardArea: KeyboardArea) => void;
|
|
|
|
/**
|
|
* The callback of 'sizeChange' event.
|
|
*
|
|
* @typedef { function } SizeChangeCallback.
|
|
* @param { window.Size } size - panel size.
|
|
* @param { KeyboardArea } keyboardArea - keyboard area.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
export type SizeChangeCallback = (size: window.Size, keyboardArea?: KeyboardArea) => void;
|
|
|
|
/**
|
|
* @interface KeyboardController
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
interface KeyboardController {
|
|
/**
|
|
* Hide soft keyboard
|
|
*
|
|
* @param { AsyncCallback<void> } callback - indicates the callback function of hide.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
hide(callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Hide soft keyboard
|
|
*
|
|
* @returns { Promise<void> } the promise returned by the function
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
hide(): Promise<void>;
|
|
|
|
/**
|
|
* @param { AsyncCallback<void> } callback - indicates the callback function of hideKeyboard.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.KeyboardController#hide
|
|
*/
|
|
hideKeyboard(callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* @returns { Promise<void> } the promise returned by the function
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.KeyboardController#hide
|
|
*/
|
|
hideKeyboard(): Promise<void>;
|
|
|
|
/**
|
|
* Exit the current input type. This function can only be called by default input method configured by system.
|
|
*
|
|
* @param { AsyncCallback<void> } callback - the callback of exitCurrentInputType.
|
|
* @throws { BusinessError } 12800008 - input method manager service error.
|
|
* @throws { BusinessError } 12800010 - not the preconfigured default input method.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
exitCurrentInputType(callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Exit the current input type. This function can only be called by default input method configured by system.
|
|
*
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 12800008 - input method manager service error.
|
|
* @throws { BusinessError } 12800010 - not the preconfigured default input method.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
exitCurrentInputType(): Promise<void>;
|
|
}
|
|
|
|
/**
|
|
* @interface InputMethodEngine
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
interface InputMethodEngine {
|
|
/**
|
|
* Subscribe 'inputStart'
|
|
*
|
|
* @param { 'inputStart' } type - indicates the type of subscribe event.
|
|
* @param { function } callback - indicates the callback of on('inputStart').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
on(
|
|
type: 'inputStart',
|
|
callback: (kbController: KeyboardController, textInputClient: TextInputClient) => void
|
|
): void;
|
|
|
|
/**
|
|
* Unsubscribe 'inputStart'
|
|
*
|
|
* @param { 'inputStart' } type - indicates the type of subscribe event.
|
|
* @param { function } callback - optional, indicates the callback of off('inputStart').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
off(
|
|
type: 'inputStart',
|
|
callback?: (kbController: KeyboardController, textInputClient: TextInputClient) => void
|
|
): void;
|
|
|
|
/**
|
|
* Subscribe 'keyboardShow'|'keyboardHide'
|
|
*
|
|
* @param { 'keyboardShow' | 'keyboardHide' } type - indicates the type of subscribe event.
|
|
* @param { function } callback - indicates the callback of on('keyboardShow'|'keyboardHide').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
on(type: 'keyboardShow' | 'keyboardHide', callback: () => void): void;
|
|
|
|
/**
|
|
* Unsubscribe 'keyboardShow'|'keyboardHide'
|
|
*
|
|
* @param { 'keyboardShow' | 'keyboardHide' } type - indicates the type of subscribe event.
|
|
* @param { function } [callback] - optional, indicates the callback of off('keyboardShow'|'keyboardHide').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
off(type: 'keyboardShow' | 'keyboardHide', callback?: () => void): void;
|
|
}
|
|
|
|
/**
|
|
* <p>Control events about IME.</p>
|
|
* <p>Events provided for IME to subscribe with callback function. When those events occur, the corresponding callback
|
|
* will be invoked.</p>
|
|
*
|
|
* @interface InputMethodAbility
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
interface InputMethodAbility {
|
|
/**
|
|
* Subscribe 'inputStart' event.
|
|
*
|
|
* @param { 'inputStart' } type - the type of subscribe event.
|
|
* @param { function } callback - the callback of on('inputStart').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
on(type: 'inputStart', callback: (kbController: KeyboardController, inputClient: InputClient) => void): void;
|
|
|
|
/**
|
|
* Unsubscribe 'inputStart' event.
|
|
*
|
|
* @param { 'inputStart' } type - the type of unsubscribe event.
|
|
* @param { function } [callback] - optional, the callback of off('inputStart').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
off(type: 'inputStart', callback?: (kbController: KeyboardController, inputClient: InputClient) => void): void;
|
|
|
|
/**
|
|
* Subscribe 'inputStop'.
|
|
*
|
|
* @param { 'inputStop' } type - the type of subscribe event.
|
|
* @param { function } callback - the callback of on('inputStop').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
on(type: 'inputStop', callback: () => void): void;
|
|
|
|
/**
|
|
* Unsubscribe 'inputStop'.
|
|
*
|
|
* @param { 'inputStop' } type - the type of unsubscribe event.
|
|
* @param { function } callback - the callback of off('inputStop').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
off(type: 'inputStop', callback: () => void): void;
|
|
|
|
/**
|
|
* Subscribe 'setCallingWindow'.
|
|
*
|
|
* @param { 'setCallingWindow' } type - the type of subscribe event.
|
|
* @param { function } callback - the callback of on('setCallingWindow').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
on(type: 'setCallingWindow', callback: (wid: number) => void): void;
|
|
|
|
/**
|
|
* Unsubscribe 'setCallingWindow'.
|
|
*
|
|
* @param { 'setCallingWindow' } type - the type of unsubscribe event.
|
|
* @param { function } callback - the callback of off('setCallingWindow').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
off(type: 'setCallingWindow', callback: (wid: number) => void): void;
|
|
|
|
/**
|
|
* Subscribe 'keyboardShow'|'keyboardHide'.
|
|
*
|
|
* @param { 'keyboardShow' | 'keyboardHide' } type - the type of subscribe event.
|
|
* @param { function } callback - the callback of on('keyboardShow'|'keyboardHide').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
on(type: 'keyboardShow' | 'keyboardHide', callback: () => void): void;
|
|
|
|
/**
|
|
* Unsubscribe 'keyboardShow'|'keyboardHide'.
|
|
*
|
|
* @param { 'keyboardShow' | 'keyboardHide' } type - the type of unsubscribe event.
|
|
* @param { function } [callback] - the callback of off('keyboardShow'|'keyboardHide').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
off(type: 'keyboardShow' | 'keyboardHide', callback?: () => void): void;
|
|
|
|
/**
|
|
* Subscribe 'setSubtype'.
|
|
*
|
|
* @param { 'setSubtype' } type - the type of subscribe event.
|
|
* @param { function } callback - the callback of on('setSubtype').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
on(type: 'setSubtype', callback: (inputMethodSubtype: InputMethodSubtype) => void): void;
|
|
|
|
/**
|
|
* Unsubscribe 'setSubtype'.
|
|
*
|
|
* @param { 'setSubtype' } type - the type of subscribe event.
|
|
* @param { function } [callback] - the callback of off('setSubtype').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
off(type: 'setSubtype', callback?: (inputMethodSubtype: InputMethodSubtype) => void): void;
|
|
|
|
/**
|
|
* Subscribe 'securityModeChange' event.
|
|
*
|
|
* @param { 'securityModeChange' } type - the type of subscribe event.
|
|
* @param { Callback<SecurityMode> } callback - the callback of on('securityModeChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
on(type: 'securityModeChange', callback: Callback<SecurityMode>): void;
|
|
|
|
/**
|
|
* Unsubscribe 'securityModeChange' event.
|
|
*
|
|
* @param { 'securityModeChange' } type - the type of unsubscribe event.
|
|
* @param { Callback<SecurityMode> } [callback] - optional, the callback of off('securityModeChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
off(type: 'securityModeChange', callback?: Callback<SecurityMode>): void;
|
|
|
|
/**
|
|
* Subscribe 'privateCommand'.This function can only be called by default input method configured by system.
|
|
*
|
|
* @param { 'privateCommand' } type - indicates the type of subscribe event.
|
|
* @param { Callback<Record<string, CommandDataType>> } callback - indicates the callback of on('privateCommand').
|
|
* @throws { BusinessError } 12800010 - not the preconfigured default input method.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
on(type: 'privateCommand', callback: Callback<Record<string, CommandDataType>>): void;
|
|
|
|
/**
|
|
* Unsubscribe 'privateCommand'.This function can only be called by default input method configured by system.
|
|
*
|
|
* @param { 'privateCommand' } type - indicates the type of subscribe event.
|
|
* @param { Callback<Record<string, CommandDataType>> } [callback] - optional,
|
|
* indicates the callback of off('privateCommand').
|
|
* @throws { BusinessError } 12800010 - not the preconfigured default input method.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
off(type: 'privateCommand', callback?: Callback<Record<string, CommandDataType>>): void;
|
|
|
|
/**
|
|
* Subscribe 'callingDisplayDidChange' event.
|
|
*
|
|
* @param { 'callingDisplayDidChange' } type - indicates the type of subscribe event.
|
|
* @param { Callback<number> } callback - indicates the callback of on('callingDisplayDidChange').
|
|
* @throws { BusinessError } 801 - capability not supported.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 18
|
|
*/
|
|
on(type: 'callingDisplayDidChange', callback: Callback<number>): void;
|
|
|
|
/**
|
|
* Unsubscribe 'callingDisplayDidChange' event.
|
|
*
|
|
* @param { 'callingDisplayDidChange' } type - indicates the type of subscribe event.
|
|
* @param { Callback<number> } [callback] - optional, indicates the callback of off('callingDisplayDidChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 18
|
|
*/
|
|
off(type: 'callingDisplayDidChange', callback?: Callback<number>): void;
|
|
|
|
/**
|
|
* Get input method's security mode.
|
|
*
|
|
* @returns { SecurityMode } return security mode.
|
|
* @throws { BusinessError } 12800004 - not an input method.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
getSecurityMode(): SecurityMode;
|
|
|
|
/**
|
|
* Creates a panel.
|
|
* <p>The system only allows one soft keyboard and one status bar to be created.</p>
|
|
*
|
|
* @param { BaseContext } ctx - indicates the context on which the window depends.
|
|
* @param { PanelInfo } info - the info of panel to be created.
|
|
* @param { AsyncCallback<Panel> } callback - the callback of createPanel.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types;
|
|
* @throws { BusinessError } 12800004 - not an input method.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
createPanel(ctx: BaseContext, info: PanelInfo, callback: AsyncCallback<Panel>): void;
|
|
|
|
/**
|
|
* Creates a panel.
|
|
* <p>The system only allows one soft keyboard and one status bar to be created.</p>
|
|
*
|
|
* @param { BaseContext } ctx - indicates the context on which the window depends.
|
|
* @param { PanelInfo } info - the info of panel to be created.
|
|
* @returns { Promise<Panel> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types;
|
|
* @throws { BusinessError } 12800004 - not an input method.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
createPanel(ctx: BaseContext, info: PanelInfo): Promise<Panel>;
|
|
|
|
/**
|
|
* Destroys a panel.
|
|
*
|
|
* @param { Panel } panel - to be destroyed.
|
|
* @param { AsyncCallback<void> } callback - the callback of destroyPanel.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
destroyPanel(panel: Panel, callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Destroys a panel.
|
|
*
|
|
* @param { Panel } panel - to be destroyed.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
destroyPanel(panel: Panel): Promise<void>;
|
|
}
|
|
|
|
/**
|
|
* @interface TextInputClient
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine#InputClient
|
|
*/
|
|
interface TextInputClient {
|
|
/**
|
|
* @param { number } action - action indicates the function of "enter" key.
|
|
* @param { AsyncCallback<boolean> } callback - the callback of sendKeyFunction.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#sendKeyFunction
|
|
*/
|
|
sendKeyFunction(action: number, callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* @param { number } action - action indicates the function of "enter" key.
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#sendKeyFunction
|
|
*/
|
|
sendKeyFunction(action: number): Promise<boolean>;
|
|
|
|
/**
|
|
* @param { number } length - length of text which will be deleted forward.
|
|
* @param { AsyncCallback<boolean> } callback - the callback of deleteForward.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#deleteForward
|
|
*/
|
|
deleteForward(length: number, callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* @param { number } length - length of text which will be deleted forward.
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#deleteForward
|
|
*/
|
|
deleteForward(length: number): Promise<boolean>;
|
|
|
|
/**
|
|
* @param { number } length - length of text which will be deleted backward.
|
|
* @param { AsyncCallback<boolean> } callback - the callback of deleteBackward.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#deleteBackward
|
|
*/
|
|
deleteBackward(length: number, callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* @param { number } length - length of text which will be deleted backward.
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#deleteBackward
|
|
*/
|
|
deleteBackward(length: number): Promise<boolean>;
|
|
|
|
/**
|
|
* @param { string } text - text which will be inserted.
|
|
* @param { AsyncCallback<boolean> } callback - the callback of insertText.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#insertText
|
|
*/
|
|
insertText(text: string, callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* @param { string } text - text which will be inserted.
|
|
* @returns { Promise<boolean> } the promise returned by the function
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#insertText
|
|
*/
|
|
insertText(text: string): Promise<boolean>;
|
|
|
|
/**
|
|
* @param { number } length - the length of text which will be got.
|
|
* @param { AsyncCallback<string> } callback - the callback of getForward.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#getForward
|
|
*/
|
|
getForward(length: number, callback: AsyncCallback<string>): void;
|
|
|
|
/**
|
|
* @param { number } length - the length of text which will be got.
|
|
* @returns { Promise<string> } the promise returned by the function
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#getForward
|
|
*/
|
|
getForward(length: number): Promise<string>;
|
|
|
|
/**
|
|
* @param { number } length - the length of text which will be got.
|
|
* @param { AsyncCallback<string> } callback - the callback of getBackward.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#getBackward
|
|
*/
|
|
getBackward(length: number, callback: AsyncCallback<string>): void;
|
|
|
|
/**
|
|
* @param { number } length - the length of text which will be got.
|
|
* @returns { Promise<string> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#getBackward
|
|
*/
|
|
getBackward(length: number): Promise<string>;
|
|
|
|
/**
|
|
* @param { AsyncCallback<EditorAttribute> } callback - the callback of getEditorAttribute.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#getEditorAttribute
|
|
*/
|
|
getEditorAttribute(callback: AsyncCallback<EditorAttribute>): void;
|
|
|
|
/**
|
|
* @returns { Promise<EditorAttribute> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
* @deprecated since 9
|
|
* @useinstead inputMethodEngine.InputClient#getEditorAttribute
|
|
*/
|
|
getEditorAttribute(): Promise<EditorAttribute>;
|
|
}
|
|
|
|
/**
|
|
* Control events about Editor.
|
|
*
|
|
* @interface InputClient
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
interface InputClient {
|
|
/**
|
|
* Send the function of the key.
|
|
*
|
|
* @param { number } action - action indicates the function of "enter" key.
|
|
* @param { AsyncCallback<boolean> } callback - the callback of sendKeyFunction.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
sendKeyFunction(action: number, callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* Send the function of the key.
|
|
*
|
|
* @param { number } action - action indicates the function of "enter" key.
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
sendKeyFunction(action: number): Promise<boolean>;
|
|
|
|
/**
|
|
* Delete text forward.
|
|
*
|
|
* @param { number } length - length of text which will be deleted forward. It can't be less than 0.
|
|
* @param { AsyncCallback<boolean> } callback - the callback of deleteForward.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800002 - Input method engine error.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
deleteForward(length: number, callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* Delete text forward.
|
|
*
|
|
* @param { number } length - length of text which will be deleted forward. It can't be less than 0.
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800002 - Input method engine error.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
deleteForward(length: number): Promise<boolean>;
|
|
|
|
/**
|
|
* Delete text forward.
|
|
*
|
|
* @param { number } length - length of text which will be deleted forward. It can't be less than 0.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800002 - input method engine error.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
deleteForwardSync(length: number): void;
|
|
|
|
/**
|
|
* Delete text backward.
|
|
*
|
|
* @param { number } length - length of text which will be deleted backward. It can't be less than 0.
|
|
* @param { AsyncCallback<boolean> } callback - the callback of deleteBackward.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800002 - Input method engine error.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
deleteBackward(length: number, callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* Delete text backward.
|
|
*
|
|
* @param { number } length - length of text which will be deleted backward. It can't be less than 0.
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800002 - Input method engine error.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
deleteBackward(length: number): Promise<boolean>;
|
|
|
|
/**
|
|
* Delete text backward.
|
|
*
|
|
* @param { number } length - length of text which will be deleted backward. It can't be less than 0.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800002 - input method engine error.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
deleteBackwardSync(length: number): void;
|
|
|
|
/**
|
|
* Insert text into Editor.
|
|
*
|
|
* @param { string } text - text which will be inserted.
|
|
* @param { AsyncCallback<boolean> } callback - the callback of insertText.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800002 - Input method engine error.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
insertText(text: string, callback: AsyncCallback<boolean>): void;
|
|
|
|
/**
|
|
* Insert text into Editor.
|
|
*
|
|
* @param { string } text - text which will be inserted.
|
|
* @returns { Promise<boolean> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800002 - Input method engine error.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
insertText(text: string): Promise<boolean>;
|
|
|
|
/**
|
|
* Insert text into Editor.
|
|
*
|
|
* @param { string } text - text which will be inserted.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800002 - input method engine error.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
insertTextSync(text: string): void;
|
|
|
|
/**
|
|
* Get the text before cursor.
|
|
*
|
|
* @param { number } length - the length of text which will be got. It can't be less than 0.
|
|
* @param { AsyncCallback<string> } callback - the callback of getForward.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - Input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
getForward(length: number, callback: AsyncCallback<string>): void;
|
|
|
|
/**
|
|
* Get the text before cursor.
|
|
*
|
|
* @param { number } length - the length of text which will be got. It can't be less than 0.
|
|
* @returns { Promise<string> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - Input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
getForward(length: number): Promise<string>;
|
|
|
|
/**
|
|
* Get the text before cursor.
|
|
*
|
|
* @param { number } length - the length of text which will be got. It can't be less than 0.
|
|
* @returns { string } the text string before cursor.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
getForwardSync(length: number): string;
|
|
|
|
/**
|
|
* Get the text after cursor.
|
|
*
|
|
* @param { number } length - the length of text which will be got.It can't be less than 0.
|
|
* @param { AsyncCallback<string> } callback - the callback of getBackward.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - Input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
getBackward(length: number, callback: AsyncCallback<string>): void;
|
|
|
|
/**
|
|
* Get the text after cursor.
|
|
*
|
|
* @param { number } length - the length of text which will be got.It can't be less than 0.
|
|
* @returns { Promise<string> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - Input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
getBackward(length: number): Promise<string>;
|
|
|
|
/**
|
|
* Get the text after cursor.
|
|
*
|
|
* @param { number } length - the length of text which will be got. It can't be less than 0.
|
|
* @returns { string } the text string after cursor.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
getBackwardSync(length: number): string;
|
|
|
|
/**
|
|
* Get attribute about editor.
|
|
*
|
|
* @param { AsyncCallback<EditorAttribute> } callback - the callback of getEditorAttribute.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
getEditorAttribute(callback: AsyncCallback<EditorAttribute>): void;
|
|
|
|
/**
|
|
* Get attribute about editor.
|
|
*
|
|
* @returns { Promise<EditorAttribute> } the promise returned by the function.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
getEditorAttribute(): Promise<EditorAttribute>;
|
|
|
|
/**
|
|
* Get attribute about editor.
|
|
*
|
|
* @returns { EditorAttribute } the attribute of editor.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
getEditorAttributeSync(): EditorAttribute;
|
|
|
|
/**
|
|
* Move cursor from input method.
|
|
*
|
|
* @param { number } direction - Indicates the distance of cursor to be moved. It can't be less than 0.
|
|
* @param { AsyncCallback<void> } callback - the callback of moveCursor.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
moveCursor(direction: number, callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Move cursor from input method.
|
|
*
|
|
* @param { number } direction - Indicates the distance of cursor to be moved. It can't be less than 0.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 9
|
|
*/
|
|
moveCursor(direction: number): Promise<void>;
|
|
|
|
/**
|
|
* Move cursor from input method.
|
|
*
|
|
* @param { number } direction - Indicates the distance of cursor to be moved. It can't be less than 0.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
moveCursorSync(direction: number): void;
|
|
|
|
/**
|
|
* Select text in editor by range.
|
|
*
|
|
* @param { Range } range - indicates the range of selected text in editor.
|
|
* @param { AsyncCallback<void> } callback - the callback of selectByRange.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
selectByRange(range: Range, callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Select text in editor by range.
|
|
*
|
|
* @param { Range } range - indicates the range of selected text in editor.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
selectByRange(range: Range): Promise<void>;
|
|
|
|
/**
|
|
* Select text in editor by range.
|
|
*
|
|
* @param { Range } range - indicates the range of selected text in editor.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
selectByRangeSync(range: Range): void;
|
|
|
|
/**
|
|
* Select text in editor by cursor movement.
|
|
*
|
|
* @param { Movement } movement - indicates the movement of cursor when selecting.
|
|
* @param { AsyncCallback<void> } callback - the callback of selectByMovement.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
selectByMovement(movement: Movement, callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Select text in editor by cursor movement.
|
|
*
|
|
* @param { Movement } movement - indicates the movement of cursor when selecting.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
selectByMovement(movement: Movement): Promise<void>;
|
|
|
|
/**
|
|
* Select text in editor by cursor movement.
|
|
*
|
|
* @param { Movement } movement - indicates the movement of cursor when selecting.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
selectByMovementSync(movement: Movement): void;
|
|
|
|
/**
|
|
* Get the index number of text at cursor.
|
|
*
|
|
* @param { AsyncCallback<number> } callback - the callback of getTextIndexAtCursor, number represents the index
|
|
* number of text at cursor.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - Input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
getTextIndexAtCursor(callback: AsyncCallback<number>): void;
|
|
|
|
/**
|
|
* Get the index number of text at cursor.
|
|
*
|
|
* @returns { Promise<number> } the promise returned by the function, number represents the index number of text
|
|
* at cursor.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - Input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
getTextIndexAtCursor(): Promise<number>;
|
|
|
|
/**
|
|
* Get the index number of text at cursor.
|
|
*
|
|
* @returns { number } the index number of text at cursor.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - Input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
getTextIndexAtCursorSync(): number;
|
|
|
|
/**
|
|
* Send extend action code.
|
|
*
|
|
* @param { ExtendAction } action - action code which will be send.
|
|
* @param { AsyncCallback<void> } callback - the callback of sendExtendAction.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - Input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
sendExtendAction(action: ExtendAction, callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Send extend action code.
|
|
*
|
|
* @param { ExtendAction } action - action code which will be send.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800006 - Input method controller error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
sendExtendAction(action: ExtendAction): Promise<void>;
|
|
|
|
/**
|
|
* Send private command.This function can only be called by default input method configured by system.
|
|
*
|
|
* @param { Record<string, CommandDataType> } commandData - command data which will be send.Max size 32KB.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800010 - not the preconfigured default input method.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
sendPrivateCommand(commandData: Record<string, CommandDataType>): Promise<void>;
|
|
|
|
/**
|
|
* Get info of the calling window.
|
|
*
|
|
* @returns { Promise<WindowInfo> } the promise returned by the function.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800012 - the input method panel does not exist.
|
|
* @throws { BusinessError } 12800013 - window manager service error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
getCallingWindowInfo(): Promise<WindowInfo>;
|
|
|
|
/**
|
|
* Insert the provided text as preview text.
|
|
*
|
|
* @param { string } text - the text to be previewed.
|
|
* @param { Range } range - the range of the text to be replaced by the preview text.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800011 - text preview not supported.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
setPreviewText(text: string, range: Range): Promise<void>;
|
|
|
|
/**
|
|
* Insert the provided text as preview text.
|
|
*
|
|
* @param { string } text - the text to be previewed.
|
|
* @param { Range } range - the range of the text to be replaced by the preview text.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800011 - text preview not supported.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
setPreviewTextSync(text: string, range: Range): void;
|
|
|
|
/**
|
|
* Finish the text preview.
|
|
*
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800011 - text preview not supported.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
finishTextPreview(): Promise<void>;
|
|
|
|
/**
|
|
* Finish the text preview.
|
|
*
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800011 - text preview not supported.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
finishTextPreviewSync(): void;
|
|
|
|
/**
|
|
* Send message to edit box.
|
|
*
|
|
* @param { string } msgId - the identifier of the message. Max size is 256B.
|
|
* @param { ?ArrayBuffer } [msgParam] - the param of the custom message. Max size is 128KB.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1. Incorrect parameter types. 2. Incorrect parameter length.
|
|
* @throws { BusinessError } 12800003 - input method client error.
|
|
* @throws { BusinessError } 12800009 - input method client detached.
|
|
* @throws { BusinessError } 12800014 - the input method is in basic mode.
|
|
* @throws { BusinessError } 12800015 - the other side does not accept the request.
|
|
* @throws { BusinessError } 12800016 - input method client is not editable.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
sendMessage(msgId: string, msgParam?: ArrayBuffer): Promise<void>;
|
|
|
|
/**
|
|
* Start receiving message from edit box.
|
|
*
|
|
* @param { ?MessageHandler } [msgHandler] - optional, the handler of the custom message.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes: 1. Incorrect parameter types.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
recvMessage(msgHandler?: MessageHandler): void;
|
|
}
|
|
|
|
/**
|
|
* @interface KeyboardDelegate
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
interface KeyboardDelegate {
|
|
/**
|
|
* Subscribe key up or down event
|
|
*
|
|
* @param { 'keyDown' | 'keyUp' } type - indicates the type of subscribe event.
|
|
* @param { function } callback - indicates the callback function of on('keyDown'|'keyUp').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
on(type: 'keyDown' | 'keyUp', callback: (event: KeyEvent) => boolean): void;
|
|
|
|
/**
|
|
* Unsubscribe key up or down event
|
|
*
|
|
* @param { 'keyDown' | 'keyUp' } type - indicates the type of unsubscribe event.
|
|
* @param { function } [callback] - optional, indicates the callback function of off('keyDown'|'keyUp').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
off(type: 'keyDown' | 'keyUp', callback?: (event: KeyEvent) => boolean): void;
|
|
|
|
/**
|
|
* Subscribe key event.
|
|
*
|
|
* @param { 'keyEvent' } type - indicates the type of subscribe event.
|
|
* @param { function } callback - indicates the callback function of on('keyEvent').
|
|
* If the key is processed by event subscriber, callback should be return true, else return false.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
on(type: 'keyEvent', callback: (event: InputKeyEvent) => boolean): void;
|
|
|
|
/**
|
|
* Unsubscribe key event.
|
|
*
|
|
* @param { 'keyEvent' } type - indicates the type of unsubscribe event.
|
|
* @param { function } [callback] - optional, indicates the callback function of off('keyEvent').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
off(type: 'keyEvent', callback?: (event: InputKeyEvent) => boolean): void;
|
|
|
|
/**
|
|
* Subscribe cursor context change
|
|
*
|
|
* @param { 'cursorContextChange' } type - indicates the type of subscribe event.
|
|
* @param { function } callback - indicates the callback function of on('cursorContextChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
on(type: 'cursorContextChange', callback: (x: number, y: number, height: number) => void): void;
|
|
|
|
/**
|
|
* Unsubscribe cursor context change
|
|
*
|
|
* @param { 'cursorContextChange' } type - indicates the type of unsubscribe event.
|
|
* @param { function } [callback] - optional, indicates the callback function of off('cursorContextChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
off(type: 'cursorContextChange', callback?: (x: number, y: number, height: number) => void): void;
|
|
|
|
/**
|
|
* Subscribe selection change
|
|
*
|
|
* @param { 'selectionChange' } type - indicates the type of subscribe event.
|
|
* @param { function } callback - indicates the callback function
|
|
* of on('selectionChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
on(
|
|
type: 'selectionChange',
|
|
callback: (oldBegin: number, oldEnd: number, newBegin: number, newEnd: number) => void
|
|
): void;
|
|
|
|
/**
|
|
* Unsubscribe selection change
|
|
*
|
|
* @param { 'selectionChange' } type - indicates the type of unsubscribe event.
|
|
* @param { function } [callback] - optional,
|
|
* indicates the callback function of off('selectionChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
off(
|
|
type: 'selectionChange',
|
|
callback?: (oldBegin: number, oldEnd: number, newBegin: number, newEnd: number) => void
|
|
): void;
|
|
|
|
/**
|
|
* Subscribe text change
|
|
*
|
|
* @param { 'textChange' } type - indicates the type of subscribe event.
|
|
* @param { function } callback - indicates the callback function of on('textChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
on(type: 'textChange', callback: (text: string) => void): void;
|
|
|
|
/**
|
|
* Unsubscribe text change
|
|
*
|
|
* @param { 'textChange' } type - indicates the type of unsubscribe event.
|
|
* @param { function } [callback] - optional, indicates the callback function of off('textChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
off(type: 'textChange', callback?: (text: string) => void): void;
|
|
|
|
/**
|
|
* Subscribe input text attribute change
|
|
*
|
|
* @param { 'editorAttributeChanged' } type - indicates the type of subscribe event.
|
|
* @param { function } callback - indicates the callback function of on('editorAttributeChanged').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
on(type: 'editorAttributeChanged', callback: (attr: EditorAttribute) => void): void;
|
|
|
|
/**
|
|
* Unsubscribe input text attribute change
|
|
*
|
|
* @param { 'editorAttributeChanged' } type - indicates the type of subscribe event.
|
|
* @param { function } [callback] - indicates the callback function of off('editorAttributeChanged').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
off(type: 'editorAttributeChanged', callback?: (attr: EditorAttribute) => void): void;
|
|
}
|
|
|
|
/**
|
|
* Defines the immersive mode.
|
|
*
|
|
* @enum { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
export enum ImmersiveMode {
|
|
/**
|
|
* Default immersive mode, the panel is not in immersive mode.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
NONE_IMMERSIVE = 0,
|
|
|
|
/**
|
|
* Immersive mode.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
IMMERSIVE,
|
|
|
|
/**
|
|
* Light immersive mode.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
LIGHT_IMMERSIVE,
|
|
|
|
/**
|
|
* Dark immersive mode.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
DARK_IMMERSIVE
|
|
}
|
|
|
|
/**
|
|
* A panel is a container used to hold soft keyboard, candidate list, or status bar.
|
|
*
|
|
* @interface Panel
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
interface Panel {
|
|
/**
|
|
* Sets ui content.
|
|
* <p>When this method is executed successfully, the content of panel will be replaced.</p>
|
|
*
|
|
* @param { string } path - the path of ui content.
|
|
* @param { AsyncCallback<void> } callback - the callback of setUiContent.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
setUiContent(path: string, callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Sets ui content.
|
|
* <p>When this method is executed successfully, the content of panel will be replaced.</p>
|
|
*
|
|
* @param { string } path - the path of ui content.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
setUiContent(path: string): Promise<void>;
|
|
|
|
/**
|
|
* Sets ui content.
|
|
* <p>When this method is executed successfully, the content of panel will be replaced.</p>
|
|
*
|
|
* @param { string } path - the path of ui content.
|
|
* @param { LocalStorage } storage - the data object shared within the content instance loaded by the panel.
|
|
* @param { AsyncCallback<void> } callback - the callback of setUiContent.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
setUiContent(path: string, storage: LocalStorage, callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Sets ui content.
|
|
* <p>When this method is executed successfully, the content of panel will be replaced.</p>
|
|
*
|
|
* @param { string } path - the path of ui content.
|
|
* @param { LocalStorage } storage - the data object shared within the content instance loaded by the panel.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
setUiContent(path: string, storage: LocalStorage): Promise<void>;
|
|
|
|
/**
|
|
* Resizes a panel.
|
|
*
|
|
* @param { number } width - the new width of the panel.
|
|
* @param { number } height - the new height of the panel.
|
|
* @param { AsyncCallback<void> } callback - the callback of resize.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
resize(width: number, height: number, callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Resizes a panel.
|
|
*
|
|
* @param { number } width - the new width of the panel.
|
|
* @param { number } height - the new height of the panel.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
resize(width: number, height: number): Promise<void>;
|
|
|
|
/**
|
|
* Moves a panel.
|
|
* <p>It's unusable for SOFT_KEYBOARD panel with FLG_FIXED.</p>
|
|
*
|
|
* @param { number } x - the x-coordinate of the new position.
|
|
* @param { number } y - the y-coordinate of the new position.
|
|
* @param { AsyncCallback<void> } callback - the callback of moveTo.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
moveTo(x: number, y: number, callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Moves a panel.
|
|
* <p>It's unusable for SOFT_KEYBOARD panel with FLG_FIXED.</p>
|
|
*
|
|
* @param { number } x - the x-coordinate of the new position.
|
|
* @param { number } y - the y-coordinate of the new position.
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
moveTo(x: number, y: number): Promise<void>;
|
|
|
|
/**
|
|
* Starts moving a panel. The panel starts moving when pressed with finger or mouse and stops moving when released.
|
|
* <p>It's Only used for STATUS_BAR panel.</p>
|
|
*
|
|
* @throws { BusinessError } 12800002 - input method engine error.
|
|
* @throws { BusinessError } 12800013 - window manager service error.
|
|
* @throws { BusinessError } 12800017 - invalid panel type or panel flag.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
/**
|
|
* Starts moving a panel. The panel starts moving when pressed with finger or mouse and stops moving when released.
|
|
* <p>It's Only used for STATUS_BAR panel.</p>
|
|
*
|
|
* @throws { BusinessError } 801 - capability not supported.
|
|
* @throws { BusinessError } 12800002 - input method engine error.
|
|
* @throws { BusinessError } 12800013 - window manager service error.
|
|
* @throws { BusinessError } 12800017 - invalid panel type or panel flag.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 18
|
|
*/
|
|
startMoving(): void;
|
|
|
|
/**
|
|
* Get the ID of the display where the input method panel is located.
|
|
*
|
|
* @returns { Promise<number> } the promise returned by the function.
|
|
* @throws { BusinessError } 12800002 - input method engine error.
|
|
* @throws { BusinessError } 12800013 - window manager service error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
getDisplayId(): Promise<number>;
|
|
|
|
/**
|
|
* Shows panel.
|
|
*
|
|
* @param { AsyncCallback<void> } callback - the callback of show.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
show(callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Shows panel.
|
|
*
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
show(): Promise<void>;
|
|
|
|
/**
|
|
* Hides panel.
|
|
*
|
|
* @param { AsyncCallback<void> } callback - the callback of hide.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
hide(callback: AsyncCallback<void>): void;
|
|
|
|
/**
|
|
* Hides panel.
|
|
*
|
|
* @returns { Promise<void> } the promise returned by the function.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
hide(): Promise<void>;
|
|
|
|
/**
|
|
* Registers panel show event.
|
|
* <p>The "show" events are triggered when the panel is shown.</p>
|
|
*
|
|
* @param { 'show' } type - events type.
|
|
* @param { function } callback - the callback will be called when events are triggered.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
on(type: 'show', callback: () => void): void;
|
|
|
|
/**
|
|
* Unregisters panel show event.
|
|
*
|
|
* @param { 'show' } type - events type.
|
|
* @param { function } [callback] - the callback to Unregister.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
off(type: 'show', callback?: () => void): void;
|
|
|
|
/**
|
|
* Registers panel hide event.
|
|
* <p>The "hide" events are triggered when the panel is hidden.</p>
|
|
*
|
|
* @param { 'hide' } type - events type.
|
|
* @param { function } callback - the callback will be called when events are triggered.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
on(type: 'hide', callback: () => void): void;
|
|
|
|
/**
|
|
* Unregisters panel hide event.
|
|
*
|
|
* @param { 'hide' } type - events type.
|
|
* @param { function } [callback] - the callback to Unregister.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
off(type: 'hide', callback?: () => void): void;
|
|
|
|
/**
|
|
* Changes panel flag.
|
|
* <p>Before flag is changed, Developers should hide the panel.After that, developers can change the content, size, point of the panel
|
|
* and show it again at appropriate opportunity.</p>
|
|
*
|
|
* @param { PanelFlag } flag - the callback of changeFlag.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
changeFlag(flag: PanelFlag): void;
|
|
|
|
/**
|
|
* Sets ime panel private mode or not.
|
|
*
|
|
* @permission ohos.permission.PRIVACY_WINDOW
|
|
* @param { boolean } isPrivacyMode - if the value is true, the privacy mode will be set,
|
|
* otherwise the non-privacy mode will be set.
|
|
* @throws { BusinessError } 201 - permissions check fails.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
setPrivacyMode(isPrivacyMode: boolean): void;
|
|
|
|
/**
|
|
* Adjust the rect of soft keyboard panel for landscape and portrait orientations.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with FLG_FIXED and FLG_FLOATING.</p>
|
|
*
|
|
* @param { PanelFlag } flag - panel flag.
|
|
* @param { PanelRect } rect - panel rect.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800013 - window manager service error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
adjustPanelRect(flag: PanelFlag, rect: PanelRect): void;
|
|
|
|
/**
|
|
* Adjust the rect of soft keyboard panel for landscape and portrait orientations.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with fixed or floating flag.</p>
|
|
*
|
|
* @param { PanelFlag } flag - panel flag.
|
|
* @param { EnhancedPanelRect } rect - panel rect.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800013 - window manager service error.
|
|
* @throws { BusinessError } 12800017 - invalid panel type or panel flag.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
adjustPanelRect(flag: PanelFlag, rect: EnhancedPanelRect): void;
|
|
|
|
/**
|
|
* <p>Update the region in the panel which accepts input events.</p>
|
|
* <p>It's only used for SOFT_KEYBOARD panel with fixed flag or floating flag.</p>
|
|
*
|
|
* @param { Array<window.Rect> } inputRegion - region in the panel which accepts input event. The size of the array must range from 1 to 4.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types; 3.Parameter verification failed.
|
|
* @throws { BusinessError } 12800013 - window manager service error.
|
|
* @throws { BusinessError } 12800017 - invalid panel type or panel flag.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
updateRegion(inputRegion: Array<window.Rect>): void;
|
|
|
|
/**
|
|
* Subscribe 'sizeChange' event.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with FLG_FIXED and FLG_FLOATING.</p>
|
|
*
|
|
* @param { 'sizeChange' } type - the type of subscribe event.
|
|
* @param { Callback<window.Size> } callback - the callback of on('sizeChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
/**
|
|
* Subscribe 'sizeChange' event.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with FLG_FIXED and FLG_FLOATING.</p>
|
|
*
|
|
* @param { 'sizeChange' } type - the type of subscribe event.
|
|
* @param { SizeChangeCallback } callback - the callback of on('sizeChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
on(type: 'sizeChange', callback: SizeChangeCallback): void;
|
|
|
|
/**
|
|
* Unsubscribe 'sizeChange' event.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with FLG_FIXED and FLG_FLOATING.</p>
|
|
*
|
|
* @param { 'sizeChange' } type - the type of unsubscribe event.
|
|
* @param { ?Callback<window.Size> } [callback] - optional, the callback of off('sizeChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
/**
|
|
* Unsubscribe 'sizeChange' event.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with FLG_FIXED and FLG_FLOATING.</p>
|
|
*
|
|
* @param { 'sizeChange' } type - the type of unsubscribe event.
|
|
* @param { ?SizeChangeCallback } [callback] - optional, the callback of off('sizeChange').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
off(type: 'sizeChange', callback?: SizeChangeCallback): void;
|
|
|
|
/**
|
|
* Subscribe 'sizeUpdate' event.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with FLG_FIXED and FLG_FLOATING.</p>
|
|
*
|
|
* @param { 'sizeUpdate' } type - the type of subscribe event.
|
|
* @param { SizeUpdateCallback } callback - the callback of on('sizeUpdate').
|
|
* @throws { BusinessError } 202 - not system application.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @systemapi
|
|
* @since 14
|
|
*/
|
|
on(type: 'sizeUpdate', callback: SizeUpdateCallback): void;
|
|
|
|
/**
|
|
* Unsubscribe 'sizeUpdate' event.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with FLG_FIXED and FLG_FLOATING.</p>
|
|
*
|
|
* @param { 'sizeUpdate' } type - the type of unsubscribe event.
|
|
* @param { ?SizeUpdateCallback } [callback] - optional, the callback of off('sizeUpdate').
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @systemapi
|
|
* @since 14
|
|
*/
|
|
off(type: 'sizeUpdate', callback?: SizeUpdateCallback): void;
|
|
|
|
/**
|
|
* Set immersive mode.
|
|
*
|
|
* @param { ImmersiveMode } mode - Immersive mode.
|
|
* @throws { BusinessError } 401 - parameter error. Possible causes:
|
|
* 1.Incorrect parameter types; 2.Parameter verification failed.
|
|
* @throws { BusinessError } 12800002 - input method engine error.
|
|
* @throws { BusinessError } 12800013 - window manager service error.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
setImmersiveMode(mode: ImmersiveMode): void;
|
|
|
|
/**
|
|
* Get immersive mode.
|
|
*
|
|
* @returns { ImmersiveMode } Immersive mode.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
getImmersiveMode(): ImmersiveMode;
|
|
}
|
|
|
|
/**
|
|
* @interface EditorAttribute
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
interface EditorAttribute {
|
|
/**
|
|
* Editor's pattern
|
|
*
|
|
* @type { number }
|
|
* @readonly
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
readonly inputPattern: number;
|
|
|
|
/**
|
|
* Editor's key type
|
|
*
|
|
* @type { number }
|
|
* @readonly
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
readonly enterKeyType: number;
|
|
|
|
/**
|
|
* Indicates whether the editor supports the text preview.
|
|
*
|
|
* @type { boolean }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
isTextPreviewSupported: boolean;
|
|
|
|
/**
|
|
* Editor's bundle name.
|
|
*
|
|
* @type { ?string }
|
|
* @readonly
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 14
|
|
*/
|
|
readonly bundleName?: string;
|
|
|
|
/**
|
|
* Immersive mode.
|
|
*
|
|
* @type { ?ImmersiveMode }
|
|
* @readonly
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
readonly immersiveMode?: ImmersiveMode;
|
|
|
|
/**
|
|
* Indicates the ID of the window where the edit box is located.
|
|
*
|
|
* @type { ?number }
|
|
* @readonly
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 18
|
|
*/
|
|
readonly windowId?: number;
|
|
|
|
/**
|
|
* Indicates the ID of the display where the edit box is located.
|
|
*
|
|
* @type { ?number }
|
|
* @readonly
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 18
|
|
*/
|
|
readonly displayId?: number;
|
|
}
|
|
|
|
/**
|
|
* @interface KeyEvent
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
interface KeyEvent {
|
|
/**
|
|
* Key code
|
|
*
|
|
* @type { number }
|
|
* @readonly
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
readonly keyCode: number;
|
|
|
|
/**
|
|
* Key action
|
|
*
|
|
* @type { number }
|
|
* @readonly
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 8
|
|
*/
|
|
readonly keyAction: number;
|
|
}
|
|
|
|
/**
|
|
* Enumerates the flags of panel
|
|
*
|
|
* @enum { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
export enum PanelFlag {
|
|
/**
|
|
* Fixed style.
|
|
* <p>It's provided for the panel with type of SOFT_KEYBOARD.
|
|
* When the flag is set, the soft keyboard is fixed at the bottom of the screen.</p>
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
FLG_FIXED = 0,
|
|
|
|
/**
|
|
* Floating style.
|
|
* <p>It's provided for the panel with type of SOFT_KEYBOARD.
|
|
* When the flag is set, the soft keyboard is floating.</p>
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
FLG_FLOATING,
|
|
|
|
/**
|
|
* Candidate style.
|
|
* <p>It's provided for the panel with type of SOFT_KEYBOARD.
|
|
* When the flag is set, the soft keyboard is a candidate window which will show the possible characters when user types a input code.
|
|
* Panel with candidate style will not be automatically shown or hidden by input method service.
|
|
* Input method application developers are supposed to control the panel status on their own.</p>
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
FLAG_CANDIDATE
|
|
}
|
|
|
|
/**
|
|
* <p>Panel types provided for input method applications.</p>
|
|
* <p>Input method application developers should select the appropriate panel type according to the user scenario.</p>
|
|
*
|
|
* @enum { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
export enum PanelType {
|
|
/**
|
|
* Panel for displaying a virtual software keyboard.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
SOFT_KEYBOARD = 0,
|
|
|
|
/**
|
|
* Panel for displaying status bar.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
STATUS_BAR
|
|
}
|
|
|
|
/**
|
|
* Panel information.
|
|
*
|
|
* @typedef PanelInfo
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
export interface PanelInfo {
|
|
/**
|
|
* Panel type.
|
|
*
|
|
* @type { PanelType }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
type: PanelType;
|
|
|
|
/**
|
|
* <p>Flag of Panel.</p>
|
|
* <p>Currently only using for SOFT_KEYBOARD panel.</p>
|
|
*
|
|
* @type { ?PanelFlag }
|
|
* @default FLG_FIXED
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
flag?: PanelFlag;
|
|
}
|
|
|
|
/**
|
|
* Enumerates the moving direction of cursor
|
|
*
|
|
* @enum { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
export enum Direction {
|
|
/**
|
|
* Cursor moves up
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
CURSOR_UP = 1,
|
|
|
|
/**
|
|
* Cursor moves down
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
CURSOR_DOWN,
|
|
|
|
/**
|
|
* Cursor moves left
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
CURSOR_LEFT,
|
|
|
|
/**
|
|
* Cursor moves right
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
CURSOR_RIGHT
|
|
}
|
|
|
|
/**
|
|
* Enumerates the security mode.
|
|
*
|
|
* @enum { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
export enum SecurityMode {
|
|
/**
|
|
* Basic security mode
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
BASIC = 0,
|
|
/**
|
|
* Full security mode
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 11
|
|
*/
|
|
FULL
|
|
}
|
|
|
|
/**
|
|
* Range of selected text.
|
|
*
|
|
* @interface Range
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
export interface Range {
|
|
/**
|
|
* Indicates the index of the first character of the selected text.
|
|
*
|
|
* @type { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
start: number;
|
|
|
|
/**
|
|
* Indicates the index of the last character of the selected text.
|
|
*
|
|
* @type { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
end: number;
|
|
}
|
|
|
|
/**
|
|
* Movement of cursor.
|
|
*
|
|
* @interface Movement
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
export interface Movement {
|
|
/**
|
|
* Indicates the direction of cursor movement
|
|
*
|
|
* @type { Direction }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
direction: Direction;
|
|
}
|
|
|
|
/**
|
|
* Enumerates the extend action.
|
|
*
|
|
* @enum { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
export enum ExtendAction {
|
|
/**
|
|
* Select all text.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
SELECT_ALL = 0,
|
|
|
|
/**
|
|
* Cut selecting text.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
CUT = 3,
|
|
|
|
/**
|
|
* Copy selecting text.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
COPY = 4,
|
|
|
|
/**
|
|
* Paste from paste board.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 10
|
|
*/
|
|
PASTE = 5
|
|
}
|
|
|
|
/**
|
|
* Window info.
|
|
*
|
|
* @interface WindowInfo
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
export interface WindowInfo {
|
|
/**
|
|
* Rectangle.
|
|
*
|
|
* @type { window.Rect }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
rect: window.Rect;
|
|
|
|
/**
|
|
* Window status.
|
|
*
|
|
* @type { window.WindowStatusType }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
status: window.WindowStatusType;
|
|
}
|
|
|
|
/**
|
|
* Panel Rect.
|
|
*
|
|
* @interface PanelRect
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
export interface PanelRect {
|
|
/**
|
|
* Panel rect in landscape orientation.
|
|
*
|
|
* @type { window.Rect }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
landscapeRect: window.Rect;
|
|
|
|
/**
|
|
* Panel rect in portrait orientation.
|
|
*
|
|
* @type { window.Rect }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 12
|
|
*/
|
|
portraitRect: window.Rect;
|
|
}
|
|
|
|
/**
|
|
* <p>Custom message handler.</p>
|
|
* <p>Implement this interface to respond to custem messages.</p>
|
|
*
|
|
* @interface MessageHandler
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
interface MessageHandler {
|
|
/**
|
|
* This method is called when a custom message is received.
|
|
*
|
|
* @param { string } msgId - the identifier of the message.
|
|
* @param { ?ArrayBuffer } [msgParam] - the parameter of the custom message.
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
onMessage(msgId: string, msgParam?: ArrayBuffer): void;
|
|
|
|
/**
|
|
* This method is called when a new message handler is set.
|
|
*
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
onTerminated(): void;
|
|
}
|
|
|
|
/**
|
|
* Enhanced panel rect information.
|
|
*
|
|
* @interface EnhancedPanelRect
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
export interface EnhancedPanelRect {
|
|
/**
|
|
* <p>Panel rect in landscape orientation.</p>
|
|
* <p>It must be filled when fullScreenMode is flase or not specified.</p>
|
|
*
|
|
* @type { ?window.Rect }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
landscapeRect?: window.Rect;
|
|
/**
|
|
* <p>Panel rect in portrait orientation.</P>
|
|
* <p>It must be filled when fullScreenMode is flase or not specified.</p>
|
|
*
|
|
* @type { ?window.Rect }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
portraitRect?: window.Rect;
|
|
/**
|
|
* The distance between the top of the panel and the top of the avoidance area in landscape orientation.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with fixed flag or floating flag.</p>
|
|
*
|
|
* @type { ?number }
|
|
* @default 0
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
landscapeAvoidY?: number;
|
|
/**
|
|
* <p>Region in the panel that accepts input events in landsacpe mode.</p>
|
|
* <p>It's only used for SOFT_KEYBOARD panel with fixed flag or floating flag. Max array size is 4.</p>
|
|
* <p>Defaults to entire panel area if not specifed.</p>
|
|
*
|
|
* @type { ?Array<window.Rect> }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
landscapeInputRegion?: Array<window.Rect>;
|
|
/**
|
|
* The distance between the top of the panel and the top of the avoidance area in portrait orientation.
|
|
* <p>It's only used for SOFT_KEYBOARD panel with fixed flag or floating flag.</p>
|
|
*
|
|
* @type { ?number }
|
|
* @default 0
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
portraitAvoidY?: number;
|
|
/**
|
|
* <p>Region in the panel that accepts input events in portrait mode.</p>
|
|
* <p>It's only used for SOFT_KEYBOARD panel with fixed flag or floating flag. Max array size is 4.</p>
|
|
* <p>Defaults to entire panel area if not specifed.</p>
|
|
*
|
|
* @type { ?Array<window.Rect> }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
portraitInputRegion?: Array<window.Rect>;
|
|
/**
|
|
* <p>Enter the full screen mode.</p>
|
|
* <p>It's only used for SOFT_KEYBOARD panel with fixed flag or floating flag.</p>
|
|
*
|
|
* @type { ?boolean }
|
|
* @default false
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
fullScreenMode?: boolean;
|
|
}
|
|
|
|
/**
|
|
* Keyboard area.
|
|
*
|
|
* @interface KeyboardArea
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
export interface KeyboardArea {
|
|
/**
|
|
* Top of the keyboard area in the panel.
|
|
*
|
|
* @type { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
top: number;
|
|
/**
|
|
* Bottom of the keyboard area in the panel.
|
|
*
|
|
* @type { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
bottom: number;
|
|
/**
|
|
* Left of the keyboard area in the panel.
|
|
*
|
|
* @type { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
left: number;
|
|
/**
|
|
* Right of the keyboard area in the panel.
|
|
*
|
|
* @type { number }
|
|
* @syscap SystemCapability.MiscServices.InputMethodFramework
|
|
* @since 15
|
|
*/
|
|
right: number;
|
|
}
|
|
}
|
|
|
|
export default inputMethodEngine;
|