Mocor MMI IM Interface User Guide.docx
- 文档编号:29814170
- 上传时间:2023-07-27
- 格式:DOCX
- 页数:12
- 大小:82.80KB
Mocor MMI IM Interface User Guide.docx
《Mocor MMI IM Interface User Guide.docx》由会员分享,可在线阅读,更多相关《Mocor MMI IM Interface User Guide.docx(12页珍藏版)》请在冰豆网上搜索。
MocorMMIIMInterfaceUserGuide
MocorMMIIMInterfaceUserGuide
Version:
1.0.0
DocCode:
SW-MOCOR-UG-0016
Date:
2008-01-30
重要声明
版权声明
本文档中的任何内容受《中华人民共和国著作权法》的保护,版权所有©2008,展讯通信有限公司,保留所有权利,但注明引用其他方的内容除外。
商标声明
展讯通信有限公司和展讯通信有限公司的产品是展讯通信有限公司专有。
在提及其他公司及其产品时将使用各自公司所拥有的商标,这种使用的目的仅限于引用。
不作保证声明
展讯通信有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保证,而且不对特定目的的适销性及适用性或者任何间接、特殊或连带的损失承担任何责任。
保密声明
本文档(包括任何附件)包含的信息是保密信息。
接收人了解其获得的本文档是保密的,除用于规定的目的外不得用于任何目的,也不得将本文档泄露给任何第三方。
前言
文档说明
本文档描述了IM模块的对外接口。
阅读对象
本文档适合使用IM的开发人员使用。
内容介绍
本文档包括三个章节,分别为:
•第一章:
概述。
简单介绍了IM接口模块的特点;
•第二章:
数据类型。
介绍了IM接口所涉及到的各种数据类型,如枚举、结构等;
•第三章:
API函数。
详细描述了IM接口包含的所有API函数的定义及相关说明。
文档约定
本文档采用下面醒目标志来表示在操作过程中应该特别注意的地方。
注意:
提醒操作中应注意的事项。
说明:
说明比较重要的事项。
相关文档
第一章概述
一.1IM模块概念
输入法模块主要与GUI的Editbox控件交互,用于文本输入。
本文以CStar输入法为例进行描述。
一.2IM模块在系统中的位置
图11描述了输入法在系统中的位置。
输入法属于GUI的一部分,用于处理和显示文字信息。
输入法部分从键盘和触笔获得信息,经由MMIIM处理,将相应的事件信息交由IMCore处理,再将其处理结果做部分处理后显示在LCD上。
图11IM模块在系统中的位置
第二章数据类型
二.1宏定义
宏名
取值
说明
IM_SMART_TYPE
0x01
智能输入法,在简体中文下指拼音输入法,在繁体中文下指注音输入法,在其他国家语言下指对应的智能输入法
IM_STROKE_TYPE
0x02
笔画输入法,仅在中文简繁体下可用
IM_MULTITAP_TYPE
0x04
英文multitap输入法
IM_ENGLISH_TYPE
0x08
英文联想词输入法
IM_DIGITAL_TYPE
0x10
数字输入法
IM_SYMBOL_TYPE
0x20
符号输入法
IM_DEFAULT_ALL_INPUT_MODE_SET
(IM_SMART_TYPE|IM_STROKE_TYPE|IM_MULTITAP_TYPE|IM_DIGITAL_TYPE|IM_ENGLISH_TYPE|IM_SYMBOL_TYPE)
默认全部输入模式集
IM_DEFAULT_INPUT_MODE_SET
(IM_SMART_TYPE|IM_STROKE_TYPE|IM_MULTITAP_TYPE|IM_DIGITAL_TYPE|IM_ENGLISH_TYPE)
默认输入模式集
IM_DEFAULT_INPUT_TYPE
IM_SMART_TYPE
默认输入法
IM_DIRECT_UP_FUN
1
向上移动
IM_DIRECT_DOWN_FUN
2
向下移动
IM_DIRECT_LEFT_FUN
3
向左移动
IM_DIRECT_RIGHT_FUN
4
向右移动
二.2枚举
二.2.1INPUT_TYPE_E
【含义】
INPUT_TYPE_E定义了IM提供给Editbox的输入模式。
【定义】
typedefenum
{
INPUT_HANDWRITING_TYPE,
INPUT_KEYBOARD_TYPE,
INPUT_KEYPAD_TYPE
}INPUT_TYPE_E;
【参数说明】
参数名称
含义
INPUT_HANDWRITING_TYPE
全屏手写输入模式
INPUT_KEYBOARD_TYPE
全屏触笔输入模式
INPUT_KEYPAD_TYPE
按键输入模式
二.2.2IM_INPUT_MODE_E
【含义】
IM_INPUT_MODE_E定义了IM提供给其他模块的输入法类型。
【定义】
typedefenum
{
IM_SMART_MODE,
IM_STROKE_MODE,
IM_MULTITAP_MODE,
IM_CHARACTER_MODE=IM_MULTITAP_MODE,
IM_ENGLISH_MODE,
IM_DIGITAL_MODE,
IM_SYMBOL_MODE,
IM_MAX_MODE
}IM_INPUT_MODE_E;
【参数说明】
参数名称
含义
IM_SMART_MODE
智能输入法,在简体中文下指拼音输入法,在繁体中文下指注音输入法,在其他国家语言下指对应的智能输入法
IM_STROKE_MODE
笔画输入法,仅在中文简繁体下可用
IM_MULTITAP_MODE
英文multitap输入法
IM_CHARACTER_MODE
同IM_MULTITAP_MODE
IM_ENGLISH_MODE
英文联想词输入法
IM_DIGITAL_MODE
数字输入法
IM_SYMBOL_MODE
符号输入法
IM_MAX_MODE
系统保留,不可使用
注意:
IM_XXX_MODE和对应的IM_XXX_TYPE表示相同的输入法,前者在枚举变量中用,后者表示其位图,两者必须对应起来。
二.2.3IM_RESULT_E
【含义】
IM_RESULT_E定义了IM模块函数的返回值类型。
【定义】
typedefenum
{
IM_RESULT_TRUE,
IM_RESULT_FALSE,
IM_RESULT_DELETE,
IM_RESULT_RETURN,
IM_RESULT_NEXT_MENU,
IM_RESULT_PREVIOUS_MENU
}IM_RESULT_E;
【参数说明】
参数名称
含义
IM_RESULT_TRUE
该函数已处理了该消息,不需要往下传给控件或窗口继续处理
IM_RESULT_FALSE
该函数未处理该消息,需要往下传给控件或窗口继续处理
IM_RESULT_DELETE
拼音和笔画输入法下,editbox中有内容时softkey显示为delete
IM_RESULT_RETURN
拼音和笔画输入法下,editbox中无内容时softkey显示为return
IM_RESULT_NEXT_MENU
处理完该消息后进入下级菜单
IM_RESULT_PREVIOUS_MENU
处理完该消息后返回上级菜单
二.2.4IM_LANG_SET_E
【含义】
IM_LANG_SET_E定义了输入法所允许的语言模式。
【定义】
typedefenum
{
IM_LANGUAGE_ARABIC,
IM_LANGUAGE_BULGARIAN,
IM_LANGUAGE_CHS,
IM_LANGUAGE_CHT,
IM_LANGUAGE_CROATIAN,
IM_LANGUAGE_CZECH,
IM_LANGUAGE_DANISH,
IM_LANGUAGE_DUTCH,
IM_LANGUAGE_ENGLISH,
IM_LANGUAGE_FINNISH,
IM_LANGUAGE_FRENCH,
IM_LANGUAGE_GERMAN,
IM_LANGUAGE_GREEK,
IM_LANGUAGE_HEBREW,
IM_LANGUAGE_HINDI,
IM_LANGUAGE_HUNGARIAN,
IM_LANGUAGE_INDONESIAN,
IM_LANGUAGE_ITALIAN,
IM_LANGUAGE_MALAY,
IM_LANGUAGE_NORWEGIAN,
IM_LANGUAGE_PERSIAN,
IM_LANGUAGE_POLISH,
IM_LANGUAGE_ROMANIAN,
IM_LANGUAGE_PORTUGUESE,
IM_LANGUAGE_RUSSIAN,
IM_LANGUAGE_SLOVAK,
IM_LANGUAGE_SLOVENE,
IM_LANGUAGE_SPANISH,
IM_LANGUAGE_SWEDISH,
IM_LANGUAGE_THAI,
IM_LANGUAGE_TURKISH,
IM_LANGUAGE_VIETNAMESE,
IM_LANGUAGE_MAX
}IM_LANG_SET_E;
【参数说明】
参数名称
含义
IM_LANGUAGE_ARABIC
阿拉伯语
IM_LANGUAGE_BULGARIAN
保加利亚语
IM_LANGUAGE_CHS
简体中文
IM_LANGUAGE_CHT
繁体中文
IM_LANGUAGE_CROATIAN
克罗地亚语
IM_LANGUAGE_CZECH
捷克语
IM_LANGUAGE_DANISH
丹麦语
IM_LANGUAGE_DUTCH
荷兰语
IM_LANGUAGE_ENGLISH
英语
IM_LANGUAGE_FINNISH
芬兰语
IM_LANGUAGE_FRENCH
法语
IM_LANGUAGE_GERMAN
德语
IM_LANGUAGE_GREEK
希腊语
IM_LANGUAGE_HEBREW
希伯来语
IM_LANGUAGE_HINDI
印地语
IM_LANGUAGE_HUNGARIAN
匈牙利语
IM_LANGUAGE_INDONESIAN
印尼语
IM_LANGUAGE_ITALIAN
意大利语
IM_LANGUAGE_MALAY
马来语
IM_LANGUAGE_NORWEGIAN
挪威语
IM_LANGUAGE_PERSIAN
波斯语
IM_LANGUAGE_POLISH
波兰语
IM_LANGUAGE_ROMANIAN
罗马尼亚语
IM_LANGUAGE_PORTUGUESE
葡萄牙语
IM_LANGUAGE_RUSSIAN
俄罗斯语
IM_LANGUAGE_SLOVAK
斯洛伐克语
IM_LANGUAGE_SLOVENE
斯洛文尼亚语
IM_LANGUAGE_SPANISH
西班牙语
IM_LANGUAGE_SWEDISH
瑞典语
IM_LANGUAGE_THAI
泰语
IM_LANGUAGE_TURKISH
土耳其语
IM_LANGUAGE_VIETNAMESE
越南语
IM_LANGUAGE_MAX
系统保留,不可使用
二.3结构
二.3.1IM_TXT_INFO_T
【含义】
IM_TXT_INFO_T定义了输入文本缓冲区信息。
【定义】
typedefstruct
{
uint16*text_ptr;
uint16text_len;
uint16ucs2_num;
}IM_TXT_INFO_T;
【参数说明】
参数名称
含义
text_ptr
TextBuffer指针
text_len
TextBuffer大小
ucs2_num
TextUCS2字符个数
二.3.2EDITBOX_INPUT_STR_INFO_T
【含义】
EDITBOX_INPUT_STR_INFO_T定义了当前editbox中文本大小信息。
【定义】
typedefstruct
{
uint16ucs_str_len;
uint16ucs_str_num;
uint16max_ucs_txt_num;
uint16max_default_txt_num;
}EDITBOX_INPUT_STR_INFO_T;
【参数说明】
参数名称
含义
ucs_str_len
当前文本信息中字符长度
ucs_str_num
当前文本信息中包含的UCS字符个数
max_ucs_txt_num
文本中允许的最多字符个数
max_default_txt_num
文本中最大默认的长度
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Mocor MMI IM Interface User Guide