ITopBottomBar 接口使用.docVIP

ITopBottomBar 接口使用 介绍： ITopBottomBar 接口提供显示顶部状态条和底部导航条的功能。 用法： 。在使用ITopBottomBar的应用的MIF文件中，将接口ITopBottomBar声明为其依赖接口 。拷贝topbottombar目录下的topbottombar.bar文件到应用所在目录，因为目前扩展类只能访问 应用所在目录下的资源文件，这是目前BREW的一个BUG。 。在应用程序中#include “topbottombar.h” 。具体做法可以参见例子myMenuApp 一．生成ITopBottomBar 实例 如： ItopBottmBar pITopBottomBar = NULL; ISHELL_CreateInstance(pMe-a.m_pIShell,AEECLSID_TOPBOTTOMBAR, (void**)(pITopBottomBar)); 二．初始化ITopBottomBar 实例 调用ITopBottomBar_InitBarInterface 接口，向ITopBottomBar 实例提供IShell 和Idisplay 接口指针。 二．底部导航条使用： 1）填充底部导航条信息： typedef struct BottomBarInfoTag { SoftKeyName leftSoftKey; /* 左软键名*/ SoftKeyName rightSoftKey; /* 右软键名*/ MiddleImageName midImage; /* 底部导航条中间显示的提示图标*/ uint8 nReserve; }BottomBarInfo; 2）调用ITopBottomBar_SetBottomBarInfo，设置底部导航条信息 3）调用ITopBottomBar_DrawBottomBar(p,l,r,m)显示底部导航条,其中:p 是ITopBottomBar 接 口指针；l：是否显示左软键；r：是否显示右软键；m：是否显示中间的提示图标 4）用法例子： （1） pMe-botInfo.leftSoftKey = SOFT_CONFIRM; pMe-botInfo.rightSoftKey = SOFT_EXIT; pMe-botInfo.midImage = IMAGE_UP; ITopBottomBar_SetBottomBarInfo(pMe-pITopBottomBar,pMe-botInfo); ITopBottomBar_DrawBottomBar(pMe-pITopBottomBar,TRUE,TRUE,TRUE); 效果： （2）不显示右软键 ITopBottomBar_SetBottomBarInfo(pMe-pITopBottomBar,pMe-botInfo); ITopBottomBar_DrawBottomBar(pMe-pITopBottomBar,TRUE,FALSE,TRUE); 效果： （3）等等。。。。 三．顶部状态条使用： 顶部状态条目前分为7 类，显示如下：（注：以下所有标题均为演示用） 类型效果说明 TOPBAR_NORMAL 这种类型适合一些菜单界面的顶部显示等场合，左边显示提示图标，中间显示标题 TOPBAR_NORMAL_GROUP 和上面相比，主要是多了分组信息的显示第一行左边显示提示图标，中间显示标题，第二行显示分组提示，左右键表示用户可以按左右键切换分组 TOPBAR_CONTACTS 适用于电话本的显示，第一行左边显示提示图标，中间显示当前记录所在位置，最右边的符合提示当前采用中文排序还是英文排序。第二行显示分组提示. 注：电话本显示时，要提供快速查找功能，在顶部状态条显 示当前所按的字符， 提供如下接口： 调用 ITopBottomBar_PrintSearchChar(p,c)显示当前搜索字符，其中 c 是当前所按字符： 如 ITopBottomBar_PrintSearchChar(pMe-pITopBottomBar,A); 显 示如下： 调用ITopBottomBar_ClearSearchChar，清除当前显示的搜索字 符。 TOPBAR_LIST 用于一些列表显示。 第一行左边显示提示图标，中间显示标题，邮编显示当前记录所在位置 TOPBAR_LIST_GROUP 用于带分组信息的的列表显示 和上面的区别就是多了一行分组提示 TOPBAR_INPUTSMS 适用于用于短消息输入等场合 左边显示提示图标，中间显示已经输入的字符和总共允许输入的字符，邮编显示输入法提示 TOPBAR_INPUTOTHER 用于其他的一些输入场合，和上面相比，没有已经输入字符 和总共允许输入字符数的提示 TOPBAR_