輸入法框架

導(dǎo)入模塊

import inputMethod from '@ohos.inputMethod';

常量8+

常量值。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

InputMethodProperty8+

輸入法應(yīng)用屬性。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

inputMethod.getController9+

getController(): InputMethodController

獲取客戶端實例InputMethodController。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

let inputMethodController = inputMethod.getController();

inputMethod.getSetting9+

getSetting(): InputMethodSetting

獲取客戶端設(shè)置實例InputMethodSetting。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

let inputMethodSetting = inputMethod.getSetting();

inputMethod.switchInputMethod9+

switchInputMethod(target: InputMethodProperty, callback: AsyncCallback<boolean>): void

切換輸入法。使用callback異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

let im = inputMethod.getCurrentInputMethod();
let prop = {
    packageName: im.packageName,
    methodId: im.methodId,
    name: im.packageName,
    id: im.methodId,
    extra: {}
}
try{
    inputMethod.switchInputMethod(prop, (err, result) => {
        if (err !== undefined) {
            console.error('Failed to switchInputMethod: ' + JSON.stringify(err));
            return;
        }
        if (result) {
            console.info('Succeeded in switching inputmethod.');
        } else {
            console.error('Failed to switchInputMethod.');
        }
    });
} catch(err) {
    console.error('Failed to switchInputMethod: ' + JSON.stringify(err));
}

inputMethod.switchInputMethod9+

switchInputMethod(target: InputMethodProperty): Promise<boolean>

切換輸入法。使用promise異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

let im = inputMethod.getCurrentInputMethod();
let prop = {
    packageName: im.packageName,
    methodId: im.methodId,
    name: im.packageName,
    id: im.methodId,
    extra: {}
}
try {
    inputMethod.switchInputMethod(prop).then((result) => {
        if (result) {
            console.info('Succeeded in switching inputmethod.');
        } else {
            console.error('Failed to switchInputMethod.');
        }
    }).catch((err) => {
        console.error('Failed to switchInputMethod: ' + JSON.stringify(err));
    })
} catch(err) {
    console.error('Failed to switchInputMethod: ' + JSON.stringify(err));
}

inputMethod.getCurrentInputMethod9+

getCurrentInputMethod(): InputMethodProperty

獲取當(dāng)前輸入法擴(kuò)展應(yīng)用，提供同步接口，返回當(dāng)前輸入法屬性。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

示例：

let currentIme = inputMethod.getCurrentInputMethod();

inputMethod.switchCurrentInputMethodSubtype9+

switchCurrentInputMethodSubtype(target: InputMethodSubtype, callback: AsyncCallback<boolean>): void

在當(dāng)前輸入法應(yīng)用內(nèi)切換子類型。使用callback異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

try {
    inputMethod.switchCurrentInputMethodSubtype({
      id: "ServiceExtAbility",
      label: "",
      name: "com.example.kikakeyboard",
      mode: "upper",
      locale: "",
      language: "",
      icon: "",
      iconId: 0,
      extra: {}
    }, (err, result) => {
        if (err !== undefined) {
            console.error('Failed to switchCurrentInputMethodSubtype: ' + JSON.stringify(err));
            return;
        }
        if (result) {
            console.info('Succeeded in switching currentInputMethodSubtype.');
        } else {
            console.error('Failed to switchCurrentInputMethodSubtype');
        }
    });
} catch(err) {
    console.error('Failed to switchCurrentInputMethodSubtype: ' + JSON.stringify(err));
}

inputMethod.switchCurrentInputMethodSubtype9+

switchCurrentInputMethodSubtype(target: InputMethodSubtype): Promise<boolean>

在當(dāng)前輸入法應(yīng)用內(nèi)切換子類型。使用promise異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

try {
    inputMethod.switchCurrentInputMethodSubtype({
      id: "ServiceExtAbility",
      label: "",
      name: "com.example.kikakeyboard",
      mode: "upper",
      locale: "",
      language: "",
      icon: "",
      iconId: 0,
      extra: {}
    }).then((result) => {
        if (result) {
            console.info('Succeeded in switching currentInputMethodSubtype.');
        } else {
            console.error('Failed to switchCurrentInputMethodSubtype.');
        }
    }).catch((err) => {
        console.error('Failed to switchCurrentInputMethodSubtype: ' + JSON.stringify(err));
    })
} catch(err) {
    console.error('Failed to switchCurrentInputMethodSubtype: ' + JSON.stringify(err));
}

inputMethod.getCurrentInputMethodSubtype9+

getCurrentInputMethodSubtype(): InputMethodSubtype

獲取當(dāng)前輸入法子類型。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

示例：

let currentImeSubType = inputMethod.getCurrentInputMethodSubtype();

inputMethod.switchCurrentInputMethodAndSubtype9+

switchCurrentInputMethodAndSubtype(inputMethodProperty: InputMethodProperty, inputMethodSubtype: InputMethodSubtype, callback: AsyncCallback<boolean>): void

切換至指定輸入法應(yīng)用的指定子類型，用于跨輸入法應(yīng)用切換子類型。使用callback異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

let im = inputMethod.getCurrentInputMethod();
let imSubType = inputMethod.getCurrentInputMethodSubtype();
try {
    inputMethod.switchCurrentInputMethodAndSubtype(im, imSubType, (err,result) => {
        if (err !== undefined) {
            console.error('Failed to switchCurrentInputMethodAndSubtype: ' + JSON.stringify(err));
            return;
        }
        if (result) {
            console.info('Succeeded in switching currentInputMethodAndSubtype.');
        } else {
            console.error('Failed to switchCurrentInputMethodAndSubtype.');
        }
    });
} catch (err) {
    console.error('Failed to switchCurrentInputMethodAndSubtype: ' + JSON.stringify(err));
}

inputMethod.switchCurrentInputMethodAndSubtype9+

switchCurrentInputMethodAndSubtype(inputMethodProperty: InputMethodProperty, inputMethodSubtype: InputMethodSubtype): Promise<boolean>

切換至指定輸入法應(yīng)用的指定子類型，用于跨輸入法應(yīng)用切換子類型。使用promise異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

let im = inputMethod.getCurrentInputMethod();
let imSubType = inputMethod.getCurrentInputMethodSubtype();
try {
    inputMethod.switchCurrentInputMethodAndSubtype(im, imSubType).then((result) => {
        if (result) {
            console.info('Succeeded in switching currentInputMethodAndSubtype.');
        } else {
            console.error('Failed to switchCurrentInputMethodAndSubtype.');
        }
    }).catch((err) => {
        console.error('Failed to switchCurrentInputMethodAndSubtype: ' + JSON.stringify(err));
    })
} catch(err) {
    console.error('Failed to switchCurrentInputMethodAndSubtype: ' + JSON.stringify(err));
}

inputMethod.getInputMethodController(deprecated)

getInputMethodController(): InputMethodController

獲取客戶端實例InputMethodController。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

示例：

let inputMethodController = inputMethod.getInputMethodController();

inputMethod.getInputMethodSetting(deprecated)

getInputMethodSetting(): InputMethodSetting

獲取客戶端設(shè)置實例InputMethodSetting。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

示例：

let inputMethodSetting = inputMethod.getInputMethodSetting();

InputMethodController

下列API示例中都需使用getController獲取到InputMethodController實例，再通過此實例調(diào)用對應(yīng)方法。

stopInputSession9+

stopInputSession(callback: AsyncCallback<boolean>): void

結(jié)束輸入會話。通過點擊輸入框?qū)崿F(xiàn)輸入會話的開啟之后該接口的調(diào)用才可生效。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

try {
    inputMethodController.stopInputSession((error, result) => {
        if (error !== undefined) {
            console.error('Failed to stopInputSession: ' + JSON.stringify(error));
            return;
        }
        if (result) {
            console.info('Succeeded in stopping inputSession.');
        } else {
            console.error('Failed to stopInputSession.');
        }
    });
} catch(error) {
    console.error('Failed to stopInputSession: ' + JSON.stringify(error));
}

stopInputSession9+

stopInputSession(): Promise<boolean>

結(jié)束輸入會話。通過點擊輸入框?qū)崿F(xiàn)輸入會話的開啟之后此接口才可生效。使用promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

try {
    inputMethodController.stopInputSession().then((result) => {
        if (result) {
            console.info('Succeeded in stopping inputSession.');
        } else {
            console.error('Failed to stopInputSession.');
        }
    }).catch((err) => {
        console.error('Failed to stopInputSession: ' + JSON.stringify(err));
    })
} catch(err) {
    console.error('Failed to stopInputSession: ' + JSON.stringify(err));
}

showSoftKeyboard9+

showSoftKeyboard(callback: AsyncCallback<void>): void

顯示軟鍵盤。需要與輸入框綁定使用。當(dāng)點擊輸入框后，才可通過該接口的調(diào)用顯示出當(dāng)前輸入法的軟鍵盤。使用callback異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

inputMethodController.showSoftKeyboard((err) => {
    if (err === undefined) {
        console.info('Succeeded in showing softKeyboard.');
    } else {
        console.error('Failed to showSoftKeyboard: ' + JSON.stringify(err));
    }
})

showSoftKeyboard9+

showSoftKeyboard(): Promise<void>

顯示軟鍵盤。需要與輸入框綁定使用。當(dāng)點擊輸入框后，才可通過該接口的調(diào)用顯示出當(dāng)前輸入法的軟鍵盤。使用Promise異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

inputMethodController.showSoftKeyboard().then(() => {
    console.log('Succeeded in showing softKeyboard.');
}).catch((err) => {
    console.error('Failed to showSoftKeyboard: ' + JSON.stringify(err));
});

hideSoftKeyboard9+

hideSoftKeyboard(callback: AsyncCallback<void>): void

隱藏軟鍵盤。需要與輸入框綁定使用。點擊輸入框后，才可以使用該接口的調(diào)用隱藏軟鍵盤。使用callback異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

inputMethodController.hideSoftKeyboard((err) => {
    if (err === undefined) {
        console.info('Succeeded in hiding softKeyboard.');
    } else {
        console.error('Failed to hideSoftKeyboard: ' + JSON.stringify(err));
    }
})

hideSoftKeyboard9+

hideSoftKeyboard(): Promise<void>

隱藏軟鍵盤。需要與輸入框綁定使用。點擊輸入框后，才可以使用該接口的調(diào)用隱藏軟鍵盤。使用Promise異步回調(diào)。

需要權(quán)限： ohos.permission.CONNECT_IME_ABILITY，僅系統(tǒng)應(yīng)用可用。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

inputMethodController.hideSoftKeyboard().then(() => {
    console.log('Succeeded in hiding softKeyboard.');
}).catch((err) => {
    console.error('Failed to hideSoftKeyboard: ' + JSON.stringify(err));
});

stopInput(deprecated)

stopInput(callback: AsyncCallback<boolean>): void

結(jié)束輸入會話。通過點擊輸入框?qū)崿F(xiàn)輸入會話的開啟之后該接口的調(diào)用才可生效。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

示例：

inputMethodController.stopInput((error, result) => {
    if (error !== undefined) {
        console.error('Failed to stopInput: ' + JSON.stringify(error));
        return;
    }
    if (result) {
        console.info('Succeeded in stopping input.');
    } else {
        console.error('Failed to stopInput.');
    }
});

stopInput(deprecated)

stopInput(): Promise<boolean>

結(jié)束輸入會話。通過點擊輸入框?qū)崿F(xiàn)輸入會話的開啟之后該接口的調(diào)用才可生效。使用promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

示例：

inputMethodController.stopInput().then((result) => {
    if (result) {
        console.info('Succeeded in stopping input.');
    } else {
        console.error('Failed to stopInput.');
    }
}).catch((err) => {
    console.error('Failed to stopInput: ' + err);
})

InputMethodSetting8+

下列API示例中都需使用getSetting獲取到InputMethodSetting實例，再通過此實例調(diào)用對應(yīng)方法。

on('imeChange')9+

on(type: 'imeChange', callback: (inputMethodProperty: InputMethodProperty, inputMethodSubtype: InputMethodSubtype) => void): void

訂閱輸入法及子類型變化監(jiān)聽事件。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

示例：

inputMethodSetting.on('imeChange', (inputMethodProperty, inputMethodSubtype) => {
    console.info('Succeeded in subscribing imeChange: inputMethodProperty: ' + JSON.stringify(inputMethodProperty) + " , inputMethodSubtype: " + JSON.stringify(inputMethodSubtype));
});

off('imeChange')9+

off(type: 'imeChange', callback?: (inputMethodProperty: InputMethodProperty, inputMethodSubtype: InputMethodSubtype) => void): void

取消訂閱輸入法及子類型變化監(jiān)聽事件。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

示例：

inputMethodSetting.off('imeChange');

listInputMethodSubtype9+

listInputMethodSubtype(inputMethodProperty: InputMethodProperty, callback: AsyncCallback<Array<InputMethodSubtype>>): void

獲取指定輸入法應(yīng)用的所有子類型。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

let inputMethodProperty = {
    packageName: 'com.example.kikakeyboard',
    methodId: 'com.example.kikakeyboard',
    name: 'com.example.kikakeyboard',
    id: 'com.example.kikakeyboard',
    extra:{}
}
try {
    inputMethodSetting.listInputMethodSubtype(inputMethodProperty, (err,data) => {
        if (err !== undefined) {
            console.error('Failed to listInputMethodSubtype: ' + JSON.stringify(err));
            return;
        }
        console.log('Succeeded in listing inputMethodSubtype.');
    });
} catch (err) {
    console.error('Failed to listInputMethodSubtype: ' + JSON.stringify(err));
}

listInputMethodSubtype9+

listInputMethodSubtype(inputMethodProperty: InputMethodProperty): Promise<Array<InputMethodSubtype>>

獲取指定輸入法應(yīng)用的所有子類型。使用promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

let inputMethodProperty = {
    packageName: 'com.example.kikakeyboard',
    methodId: 'com.example.kikakeyboard',
    name: 'com.example.kikakeyboard',
    id: 'com.example.kikakeyboard',
    extra:{}
}
try {
    inputMethodSetting.listInputMethodSubtype(inputMethodProperty).then((data) => {
        console.info('Succeeded in listing inputMethodSubtype.');
    }).catch((err) => {
        console.error('Failed to listInputMethodSubtype: ' + JSON.stringify(err));
    })
} catch(err) {
    console.error('Failed to listInputMethodSubtype: ' + JSON.stringify(err));
}

listCurrentInputMethodSubtype9+

listCurrentInputMethodSubtype(callback: AsyncCallback<Array<InputMethodSubtype>>): void

查詢當(dāng)前輸入法應(yīng)用的所有子類型。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

try {
    inputMethodSetting.listCurrentInputMethodSubtype((err, data) => {
        if (err !== undefined) {
            console.error('Failed to listCurrentInputMethodSubtype: ' + JSON.stringify(err));
            return;
        }
        console.log('Succeeded in listing currentInputMethodSubtype.');
    });
} catch(err) {
    console.error('Failed to listCurrentInputMethodSubtype: ' + JSON.stringify(err));
}

listCurrentInputMethodSubtype9+

listCurrentInputMethodSubtype(): Promise<Array<InputMethodSubtype>>

查詢當(dāng)前輸入法的子類型列表。使用promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

try {
    inputMethodSetting.listCurrentInputMethodSubtype().then((data) => {
        console.info('Succeeded in listing currentInputMethodSubtype.');
    }).catch((err) => {
        console.error('Failed to listCurrentInputMethodSubtype: ' + JSON.stringify(err));
    })
} catch(err) {
    console.error('Failed to listCurrentInputMethodSubtype: ' + JSON.stringify(err));
}

getInputMethods9+

getInputMethods(enable: boolean, callback: AsyncCallback<Array<InputMethodProperty>>): void

獲取已激活/未激活輸入法列表。參數(shù)enable取true，返回已激活輸入法列表，取false返回未激活輸入法列表。已激活/未激活輸入法的確切功能當(dāng)前版本未支持。當(dāng)前版本中，已激活輸入法包括當(dāng)前使用的輸入法，未激活輸入法包括當(dāng)前輸入法以外的其他已安裝的輸入法。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

try {
    inputMethodSetting.getInputMethods(true, (err,data) => {
        if (err !== undefined) {
            console.error('Failed to getInputMethods: ' + JSON.stringify(err));
            return;
        }
        console.log('Succeeded in getting inputMethods.');
    });
} catch (err) {
    console.error('Failed to getInputMethods: ' + JSON.stringify(err));
}

getInputMethods9+

getInputMethods(enable: boolean): Promise<Array<InputMethodProperty>>

獲取已激活/未激活輸入法列表。參數(shù)enable取true，返回已激活輸入法列表，取false返回未激活輸入法列表。已激活/未激活輸入法的確切功能當(dāng)前版本未支持。當(dāng)前版本中，已激活輸入法包括當(dāng)前使用的輸入法，未激活輸入法包括當(dāng)前輸入法以外的其他已安裝的輸入法。使用promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

返回值：

示例：

try {
    inputMethodSetting.getInputMethods(true).then((data) => {
        console.info('Succeeded in getting inputMethods.');
    }).catch((err) => {
        console.error('Failed to getInputMethods: ' + JSON.stringify(err));
    })
} catch(err) {
    console.error('Failed to getInputMethods: ' + JSON.stringify(err));
}

showOptionalInputMethods9+

showOptionalInputMethods(callback: AsyncCallback<boolean>): void

顯示輸入法選擇對話框。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

try {
    inputMethodSetting.showOptionalInputMethods((err, data) => {
        if (err !== undefined) {
            console.error('Failed to showOptionalInputMethods: ' + JSON.stringify(err));
            return;
        }
        console.info('Succeeded in showing optionalInputMethods.');
    });
} catch (err) {
    console.error('Failed to showOptionalInputMethods: ' + JSON.stringify(err));
}

showOptionalInputMethods9+

showOptionalInputMethods(): Promise<boolean>

顯示輸入法選擇對話框。使用promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見輸入法框架錯誤碼。

示例：

inputMethodSetting.showOptionalInputMethods().then((data) => {
    console.info('Succeeded in showing optionalInputMethods.');
}).catch((err) => {
    console.error('Failed to showOptionalInputMethods: ' + JSON.stringify(err));
})

listInputMethod(deprecated)

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

查詢已安裝的輸入法列表。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

示例：

inputMethodSetting.listInputMethod((err,data) => {
    if (err !== undefined) {
        console.error('Failed to listInputMethod: ' + JSON.stringify(err));
        return;
    }
    console.log('Succeeded in listing inputMethod.');
 });

listInputMethod(deprecated)

listInputMethod(): Promise<Array<InputMethodProperty>>

查詢已安裝的輸入法列表。使用promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

示例：

inputMethodSetting.listInputMethod().then((data) => {
    console.info('Succeeded in listing inputMethod.');
}).catch((err) => {
    console.error('Failed to listInputMethod: ' + JSON.stringify(err));
})

displayOptionalInputMethod(deprecated)

displayOptionalInputMethod(callback: AsyncCallback<void>): void

顯示輸入法選擇對話框。使用callback異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

參數(shù)：

示例：

inputMethodSetting.displayOptionalInputMethod((err) => {
    if (err !== undefined) {
        console.error('Failed to displayOptionalInputMethod: ' + JSON.stringify(err));
        return;
    }
    console.info('Succeeded in displaying optionalInputMethod.');
});

displayOptionalInputMethod(deprecated)

displayOptionalInputMethod(): Promise<void>

顯示輸入法選擇對話框。使用promise異步回調(diào)。

系統(tǒng)能力： SystemCapability.MiscServices.InputMethodFramework

返回值：

示例：

inputMethodSetting.displayOptionalInputMethod().then(() => {
    console.info('Succeeded in displaying optionalInputMethod.');
}).catch((err) => {
    console.error('Failed to displayOptionalInputMethod: ' + JSON.stringify(err));
})