test/awtk
1
0
Fork 0
mirror of https://gitee.com/zlgopen/awtk.git synced 2024-12-02 20:18:22 +08:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
deda1da12f
awtk/docs/manual/input_method_t.md

559 lines
17 KiB
Markdown
Raw Normal View History

update docs
2018-12-20 17:33:31 +08:00
## input\_method\_t
### 概述
update docs
2019-12-14 13:25:56 +08:00
输入法接口。
常见的实现方式有以下几种：
* 空实现。用于不需要输入法的嵌入式平台。
* 缺省实现。用于需要输入法的嵌入式平台。
* 基于SDL实现的平台原生输入法。用于桌面系统和手机系统。
![image](images/input_method_t_0.png)
> 输入类型请参考：[input\_type](input_type_t.md)
update docs
2019-01-15 14:34:05 +08:00
----------------------------------
update docs
2019-01-02 15:29:25 +08:00
### 函数
<p id="input_method_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
| <a href="#input_method_t_input_method">input\_method</a> | 获取全局输入法对象。 |
| <a href="#input_method_t_input_method_commit_text">input\_method\_commit\_text</a> | 提交输入文本。 |
input method support scriptable
2019-04-22 17:48:54 +08:00
| <a href="#input_method_t_input_method_commit_text_ex">input\_method\_commit\_text\_ex</a> | 提交输入文本。 |
update docs
2019-01-02 15:29:25 +08:00
| <a href="#input_method_t_input_method_create">input\_method\_create</a> | 创建输入法对象。在具体实现中实现。 |
| <a href="#input_method_t_input_method_destroy">input\_method\_destroy</a> | 销毁输入法对象。在具体实现中实现。 |
| <a href="#input_method_t_input_method_dispatch">input\_method\_dispatch</a> | 分发一个事件。 |
| <a href="#input_method_t_input_method_dispatch_action">input\_method\_dispatch\_action</a> | 软键盘上的action按钮被点击时，调用本函数分发EVT_IM_ACTION事件。 |
| <a href="#input_method_t_input_method_dispatch_candidates">input\_method\_dispatch\_candidates</a> | 请求显示候选字。 |
| <a href="#input_method_t_input_method_dispatch_key">input\_method\_dispatch\_key</a> | 提交按键。 |
update docs
2020-04-27 08:36:57 +08:00
| <a href="#input_method_t_input_method_dispatch_keys">input\_method\_dispatch\_keys</a> | 提交按键。 |
| <a href="#input_method_t_input_method_dispatch_pre_candidates">input\_method\_dispatch\_pre\_candidates</a> | 请求显示预候选字。 |
| <a href="#input_method_t_input_method_dispatch_preedit">input\_method\_dispatch\_preedit</a> | 分发进入预编辑状态的事件。 |
| <a href="#input_method_t_input_method_dispatch_preedit_abort">input\_method\_dispatch\_preedit\_abort</a> | 分发取消预编辑状态的事件(提交预编辑内容，退出预编辑状态)。 |
| <a href="#input_method_t_input_method_dispatch_preedit_confirm">input\_method\_dispatch\_preedit\_confirm</a> | 分发确认预编辑状态的事件(提交预编辑内容，退出预编辑状态)。 |
update docs
2019-01-02 15:29:25 +08:00
| <a href="#input_method_t_input_method_dispatch_to_widget">input\_method\_dispatch\_to\_widget</a> | 分发一个事件当前焦点控件。 |
update docs
2020-04-27 08:36:57 +08:00
| <a href="#input_method_t_input_method_get_lang">input\_method\_get\_lang</a> | 获取语言。 |
update docs
2021-08-03 07:53:37 +08:00
| <a href="#input_method_t_input_method_is_native">input\_method\_is\_native</a> | 是否是平台原生输入法。 |
update docs
2019-01-02 15:29:25 +08:00
| <a href="#input_method_t_input_method_off">input\_method\_off</a> | 注销指定事件的处理函数。 |
| <a href="#input_method_t_input_method_on">input\_method\_on</a> | 注册指定事件的处理函数。 |
| <a href="#input_method_t_input_method_request">input\_method\_request</a> | 打开或关闭输入法。 |
| <a href="#input_method_t_input_method_set">input\_method\_set</a> | 设置全局输入法对象。 |
update docs
2020-04-27 08:36:57 +08:00
| <a href="#input_method_t_input_method_set_lang">input\_method\_set\_lang</a> | 设置语言。 |
update docs
2019-01-02 15:29:25 +08:00
| <a href="#input_method_t_input_method_update_action_button_info">input\_method\_update\_action\_button\_info</a> | 设置软键盘上的action按钮的信息。 |
update docs
2018-12-20 17:33:31 +08:00
### 属性
<p id="input_method_t_properties">
fix docs
2019-01-17 15:56:15 +08:00
| 属性名称 | 类型 | 说明 |
update docs
2018-12-20 17:33:31 +08:00
| -------- | ----- | ------------ |
update docs
2018-12-21 18:29:29 +08:00
| <a href="#input_method_t_action_button_enable">action\_button\_enable</a> | bool\_t | 软键盘的上的action按钮是否可用。 |
| <a href="#input_method_t_action_button_enable">action\_button\_enable</a> | bool\_t | 软键盘的上的action按钮文本。 |
update docs
2021-08-03 07:53:37 +08:00
| <a href="#input_method_t_is_native">is\_native</a> | bool\_t | 是否是原生输入法。 |
update idl/docs
2020-04-07 09:44:59 +08:00
| <a href="#input_method_t_keyboard_name">keyboard\_name</a> | char* | 软键盘资源名称。 |
update docs
2019-01-02 15:29:25 +08:00
#### input\_method 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method">获取全局输入法对象。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
input_method_t* input_method ();
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | input\_method\_t* | 成功返回输入法对象，失败返回NULL。 |
#### input\_method\_commit\_text 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_commit_text">提交输入文本。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
update docs
2020-04-27 08:36:57 +08:00
ret_t input_method_commit_text (input_method_t* im, const char* text);
update docs
2019-01-02 15:29:25 +08:00
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
update docs
2020-04-27 08:36:57 +08:00
| text | const char* | 文本。 |
input method support scriptable
2019-04-22 17:48:54 +08:00
#### input\_method\_commit\_text\_ex 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_commit_text_ex">提交输入文本。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
input method support scriptable
2019-04-22 17:48:54 +08:00
* 函数原型：
```
update docs
2020-04-27 08:36:57 +08:00
ret_t input_method_commit_text_ex (input_method_t* im, bool_t replace, const char* text);
input method support scriptable
2019-04-22 17:48:54 +08:00
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
| replace | bool\_t | 是否替换原来的文本。 |
update docs
2020-04-27 08:36:57 +08:00
| text | const char* | 文本。 |
update docs
2019-01-02 15:29:25 +08:00
#### input\_method\_create 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_create">创建输入法对象。在具体实现中实现。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
input_method_t* input_method_create ();
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | input\_method\_t* | 成功返回输入法对象，失败返回NULL。 |
#### input\_method\_destroy 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_destroy">销毁输入法对象。在具体实现中实现。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
ret_t input_method_destroy (input_method_t* im);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
#### input\_method\_dispatch 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_dispatch">分发一个事件。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
ret_t input_method_dispatch (input_method_t* im, event_t* e);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 控件对象。 |
| e | event\_t* | 事件。 |
#### input\_method\_dispatch\_action 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_dispatch_action">软键盘上的action按钮被点击时，调用本函数分发EVT_IM_ACTION事件。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
ret_t input_method_dispatch_action (input_method_t* im);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
#### input\_method\_dispatch\_candidates 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_dispatch_candidates">请求显示候选字。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
update docs
2020-05-24 19:28:22 +08:00
ret_t input_method_dispatch_candidates (input_method_t* im, char* strs, uint32_t nr, int32_t selected);
update docs
2019-01-02 15:29:25 +08:00
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
| strs | char* | 候选字列表。 |
| nr | uint32\_t | 候选字个数。 |
update docs
2020-05-24 19:28:22 +08:00
| selected | int32\_t | 缺省选中候选字的序数。 |
update docs
2019-01-02 15:29:25 +08:00
#### input\_method\_dispatch\_key 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_dispatch_key">提交按键。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
ret_t input_method_dispatch_key (input_method_t* im, uint32_t key);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
| key | uint32\_t | 键值。 |
update docs
2020-04-27 08:36:57 +08:00
#### input\_method\_dispatch\_keys 函数
-----------------------
* 函数功能：
> <p id="input_method_t_input_method_dispatch_keys">提交按键。
* 函数原型：
```
ret_t input_method_dispatch_keys (input_method_t* im, const char* key);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
| key | const char* | 键值。 |
#### input\_method\_dispatch\_pre\_candidates 函数
-----------------------
* 函数功能：
> <p id="input_method_t_input_method_dispatch_pre_candidates">请求显示预候选字。
> 预候选字: 在有的输入法中，比如T9硬键盘输入时，按下12两个键时，预候选字会显示可用的拼音列表。
> 从预候选字列表中选择拼音，再查询拼音对应的候选字列表。
* 函数原型：
```
ret_t input_method_dispatch_pre_candidates (input_method_t* im, char* strs, uint32_t nr, int32_t selected);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
| strs | char* | 候选字列表。 |
| nr | uint32\_t | 候选字个数。 |
| selected | int32\_t | 缺省选中候选字的序数。 |
#### input\_method\_dispatch\_preedit 函数
-----------------------
* 函数功能：
> <p id="input_method_t_input_method_dispatch_preedit">分发进入预编辑状态的事件。
* 函数原型：
```
ret_t input_method_dispatch_preedit (input_method_t* im);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
#### input\_method\_dispatch\_preedit\_abort 函数
-----------------------
* 函数功能：
> <p id="input_method_t_input_method_dispatch_preedit_abort">分发取消预编辑状态的事件(提交预编辑内容，退出预编辑状态)。
* 函数原型：
```
ret_t input_method_dispatch_preedit_abort (input_method_t* im);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
#### input\_method\_dispatch\_preedit\_confirm 函数
-----------------------
* 函数功能：
> <p id="input_method_t_input_method_dispatch_preedit_confirm">分发确认预编辑状态的事件(提交预编辑内容，退出预编辑状态)。
* 函数原型：
```
ret_t input_method_dispatch_preedit_confirm (input_method_t* im);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
update docs
2019-01-02 15:29:25 +08:00
#### input\_method\_dispatch\_to\_widget 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_dispatch_to_widget">分发一个事件当前焦点控件。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
ret_t input_method_dispatch_to_widget (input_method_t* im, event_t* e);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 控件对象。 |
| e | event\_t* | 事件。 |
update docs
2020-04-27 08:36:57 +08:00
#### input\_method\_get\_lang 函数
-----------------------
* 函数功能：
> <p id="input_method_t_input_method_get_lang">获取语言。
* 函数原型：
```
const char* input_method_get_lang (input_method_t* im);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | const char* | 返回语言。 |
| im | input\_method\_t* | 输入法对象。 |
update docs
2021-08-03 07:53:37 +08:00
#### input\_method\_is\_native 函数
-----------------------
* 函数功能：
> <p id="input_method_t_input_method_is_native">是否是平台原生输入法。
* 函数原型：
```
bool_t input_method_is_native (input_method_t* im);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | bool\_t | 返回TRUE表示是原生输入法，否则表示不是。 |
| im | input\_method\_t* | 输入法对象。 |
update docs
2019-01-02 15:29:25 +08:00
#### input\_method\_off 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_off">注销指定事件的处理函数。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
ret_t input_method_off (input_method_t* im, uint32_t id);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
| id | uint32\_t | input\_method\_on返回的ID。 |
#### input\_method\_on 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_on">注册指定事件的处理函数。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
uint32_t input_method_on (input_method_t* im, event_type_t type, event_func_t on_event, void* ctx);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | uint32\_t | 返回id，用于input\_method\_off。 |
| im | input\_method\_t* | 输入法对象。 |
| type | event\_type\_t | 事件类型。 |
| on\_event | event\_func\_t | 事件处理函数。 |
| ctx | void* | 事件处理函数上下文。 |
#### input\_method\_request 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_request">打开或关闭输入法。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
ret_t input_method_request (input_method_t* im, widget_t* widget);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
| widget | widget\_t* | 焦点控件，为NULL时关闭输入法，非NULL时打开输入法。 |
#### input\_method\_set 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_set">设置全局输入法对象。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
ret_t input_method_set (input_method_t* im);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
update docs
2020-04-27 08:36:57 +08:00
#### input\_method\_set\_lang 函数
-----------------------
* 函数功能：
> <p id="input_method_t_input_method_set_lang">设置语言。
> 有时在同一种语言环境下，也需要输入多种文字，典型的情况是同时输入中文和英文。
> 比如T9输入法，可以同时支持中文和英文输入，配合软键盘随时切换输入的语言。
> 数字、小写字母、大写字母和符合也可以视为输入的语言。
> 主要用于提示输入法引擎选择适当的输入方法。
* 函数原型：
```
ret_t input_method_set_lang (input_method_t* im, const char* lang);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
| lang | const char* | 语言。格式为语言+国家/地区码。如：zh\_cn和en\_us等。 |
update docs
2019-01-02 15:29:25 +08:00
#### input\_method\_update\_action\_button\_info 函数
-----------------------
* 函数功能：
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_input_method_update_action_button_info">设置软键盘上的action按钮的信息。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2019-01-02 15:29:25 +08:00
* 函数原型：
```
ret_t input_method_update_action_button_info (input_method_t* im, char* text, bool_t enable);
```
* 参数说明：
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| im | input\_method\_t* | 输入法对象。 |
| text | char* | 按钮的文本。 |
| enable | bool\_t | 按钮的是否可用。 |
update docs
2018-12-20 17:33:31 +08:00
#### action\_button\_enable 属性
-----------------------
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_action_button_enable">软键盘的上的action按钮是否可用。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
* 类型：bool\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### action\_button\_enable 属性
-----------------------
update docs
2019-11-15 11:33:43 +08:00
> <p id="input_method_t_action_button_enable">软键盘的上的action按钮文本。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update docs
2018-12-20 17:33:31 +08:00
* 类型：bool\_t
update docs
2021-08-03 07:53:37 +08:00
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### is\_native 属性
-----------------------
> <p id="input_method_t_is_native">是否是原生输入法。
* 类型：bool\_t
update docs
2018-12-20 17:33:31 +08:00
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
update idl/docs
2020-04-07 09:44:59 +08:00
#### keyboard\_name 属性
update docs
2018-12-20 17:33:31 +08:00
-----------------------
update idl/docs
2020-04-07 09:44:59 +08:00
> <p id="input_method_t_keyboard_name">软键盘资源名称。
update docs (fix issue #253)
2019-10-16 09:02:32 +08:00
update idl/docs
2020-04-07 09:44:59 +08:00
* 类型：char*
update docs
2018-12-20 17:33:31 +08:00
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
Reference in New Issue Copy Permalink