awtk/docs/manual/input_engine_t.md

input_engine_t

概述

输入法引擎接口。

常见的实现方式有以下几种：

• 空实现。用于不需要输入法的嵌入式平台。

• 拼音输入法实现。用于需要输入法的嵌入式平台。

---

函数

函数名称	说明
input_engine_create	创建输入法引擎对象。
input_engine_destroy	销毁输入法引擎对象。
input_engine_input	输入新的按键，并更新候选字。
input_engine_reset_input	清除所有输入的按键组合和候选字。
input_engine_search	根据按键组合，更新候选字，并通过输入法对象提交候选字和pre候选字。

属性

属性名称	类型	说明

input_engine_create 函数

---

• 函数功能：

创建输入法引擎对象。

• 函数原型：

input_engine_t* input_engine_create (input_method_t* im);

• 参数说明：

参数	类型	说明
返回值	input_engine_t*	返回输入法引擎对象。
im	input_method_t*	输入法对象。

input_engine_destroy 函数

---

• 函数功能：

销毁输入法引擎对象。

• 函数原型：

ret_t input_engine_destroy (input_engine_t* engine);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
engine	input_engine_t*	输入法引擎对象。

input_engine_input 函数

---

• 函数功能：

输入新的按键，并更新候选字。

• 函数原型：

ret_t input_engine_input (input_engine_t* engine, int key);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
engine	input_engine_t*	输入法引擎对象。
key	int	键值。

input_engine_reset_input 函数

---

• 函数功能：

清除所有输入的按键组合和候选字。

• 函数原型：

ret_t input_engine_reset_input (input_engine_t* engine);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
engine	input_engine_t*	输入法引擎对象。

input_engine_search 函数

---

• 函数功能：

根据按键组合，更新候选字，并通过输入法对象提交候选字和pre候选字。

• 函数原型：

ret_t input_engine_search (input_engine_t* engine, const char* keys);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
engine	input_engine_t*	输入法引擎对象。
keys	const char*	按键组合。