MTK控件开发及使用说明.doc

操作环境：手机平台类型：MTK6235 Code version: 6235_0912 1.介绍：在MTK平台某些界面,在触摸屏中需要进行的操作超过一定数量的时候，便用到了虚拟键盘界面，这些虚拟键盘的作用不是用来输入字符，而是用作图标快捷方式，如下图所示，或者干脆没有，直接用键盘来操作。前者的做法缺点会使界面不是很美观，其次是纯粹用键盘操作，操作不是很方便，给人的感觉也不是很直观。(当然，如果屏幕不是触摸屏，那么只有用后者来进行操作了),为了提升界面的美观性和操作性，便开发了一个具有图标快捷方式功能的控件。该控件的代码以宏__PWV_MMI_WIDGET_SHORTCUT_BAR__来进行控制本篇文档包含以下几个方面： 1：以Shortcut bar控件的代码结构介绍一个基本控件包含的几个基本要素2：介绍Shortcut bar控件的使用方法### MTK控件开发及使用说明####一、背景介绍与目的在移动设备的交互设计中，特别是在MTK6235平台下，为了提高用户体验和界面美观度，通常需要开发定制化的控件来满足特定的需求。本文档旨在详细介绍如何在MTK6235平台上开发和使用一种名为“Shortcut bar”的自定义控件，该控件主要用于提供图标快捷方式功能，以优化触摸屏上的操作体验。 ####二、控件概述**Shortcut bar**控件是在MTK6235平台中为了解决触摸屏上操作过多导致的界面不美观以及操作不便等问题而设计的一种特殊控件。它通过提供一系列图标快捷方式来简化用户操作，同时提升界面的美观性。该控件的核心在于利用宏`__PWV_MMI_WIDGET_SHORTCUT_BAR__`来控制其行为。 ####三、控件代码结构详解1. **初始化**:初始化函数`pwv_init_shortcut_bar()`在`wgui.c`文件中的`wgui_init()`函数中被调用。此函数负责初始化Shortcut bar控件中的图标及其相关事件响应函数。 - **具体作用**:初始化控件中的图标及其关联的事件响应函数，确保控件能够在加载时准备好所有必要的元素。 2. **事件响应注册**: Shortcut bar控件响应三种类型的事件——`pen_up`、`pen_down`和`pen_move`，对应的处理函数分别是： - `pwv_wgui_shortcut_bar_pen_up_handler` - `pwv_wgui_shortcut_bar_pen_down_handler` - `pwv_wgui_shortcut_bar_pen_move_handler`这些函数的主要任务是将触摸笔的位置坐标转换成图标索引，然后根据索引找到相应的事件处理函数执行，最后更新图标状态或绘制新的图标。 3. **坐标参数计算**:在`dm_redraw_category_screen`函数执行过程中，计算整个Shortcut bar的坐标，并进一步计算每个图标的具体位置。 4. **事件响应**:当触摸事件发生时，程序将进入相应的事件处理函数进行处理，包括将触摸位置转换为图标索引、找到相应的事件响应函数并执行，以及重新绘制界面。 ####四、使用方法1. **配置窗口ID和坐标参数**:需要在`CustCoordinates.c`文件中找到相应的分类窗口ID，并在`control_set_p`和`default_coordinate_set_p`参数中分别设置`DM_SHORTCUT_BAR`和对应的坐标参数。 - **示例**: ```c const U8 category75[] = { 5, DM_BASE_LAYER_START, DM_SCR_BG, DM_BASE_CONTROL_SET_COMMON, DM_CATEGORY_CONTROLLED_AREA, DM_SHORTCUT_BAR }; const S16 coordinate_set75[] = { DM_FULL_SCREEN_COORDINATE_FLAG, 0, MMI_STATUS_BAR_HEIGHT + MMI_TITLE_HEIGHT, MAIN_LCD_DEVICE_WIDTH, MAIN_LCD_DEVICE_HEIGHT - 2 * MMI_BUTTON_BAR_HEIGHT - MMI_STATUS_BAR_HEIGHT - MMI_TITLE_HEIGHT, DM_NO_FLAGS, 0, MAIN_LCD_DEVICE_HEIGHT - 2 * MMI_BUTTON_BAR_HEIGHT, MAIN_LCD_DEVICE_WIDTH, MMI_BUTTON_BAR_HEIGHT, DM_NO_FLAGS }; ``` 2. **注册事件响应函数及图标**:在分类窗口实现函数中调用`pwv_register_shortcut_bar_handler`注册事件响应函数。可以通过查找宏`__PWV_EBOOK_SILVER_STYLE__`来获取完整的示例代码。 ####五、总结本文档详细介绍了在MTK6235平台上开发和使用Shortcut bar控件的过程，包括控件的基本结构、代码实现细节以及如何配置和使用该控件。通过遵循上述指南，开发者可以轻松地在MTK6235平台上实现美观且易于使用的触摸屏交互界面。