GUI高级开发——列表框V1.1 - 命名规范.docVIP

弹出菜单和列表框 一、基本特征 弹出菜单类窗口的主要作用是在屏上任意局部区域显示多行菜单，供用户选择。用户可以通过触摸屏，上下按键，滚动条等移动当前菜单条，并进行选中。 菜单的条目数可任意增加，每个条目支持一个特征的图标和一行文本，由用户赋给菜单类窗口。当菜单类窗口的条目被选中时，会通过command消息的方式通知用户。除此之外的其他处理（如条目的上下切换，换页等）都是弹出菜单类内部自动完成。 弹出菜单（或列表框）的变成和菜单类基本相似，只是比菜单类少了一个滚动条风格支持，弹出菜单类的代码位于uilist.c中 二、数据结构 和菜单类一样，弹出菜单也有两个数据结构，一个是窗口数据结构，一个是菜单条的数据结构： 单个菜单条的结构： typedef struct { UINT16 ICON; 本条目的图标ID UINT16 Text; 本条目的文本ID }MenuItem; 弹出菜单窗口数据结构： typedef struct { UINT16 TitleText; 标题文本 UINT16 TitleHeight; 标题高度 UINT16 IconBackground; 背景图片 PicDescp IconItemSelect; 选中条图片 UINT16 ItemLeft; 条目左缩进 UINT16 Itemheight; 条目高度 UILIST *ListList; 菜单列表 ListItem *CurrItem; 当前条目 UINT16 CurrItemIndex; 当前条目ID UINT16 CurrItemDispLine; 当前条目所在行 UINT32 MaxItemIndex; 条目总数 UINT32 style; 风格 UINT32 WinFullLine; 每屏可显示条目数 } W_List; 三、响应的消息 弹出菜单类响应下列消息： 详细描述如下： WM_ListAddItem 添加菜单条目的消息，用户通过发送此消息向菜单窗添加菜单，可一次添加多个。一般在创建完菜单窗后向窗口发送此消息建立菜单。 WM_KEY 键盘消息，列表框在收到此消息后，上下切换菜单条，或进入菜单条。 WM_TOUCH 触摸屏消息，当有触摸屏点击某条菜单时，列表框收到此消息，选中此条目，并向用户发送选中某条菜单的command WM_SetPic 设置列表框上的几种图片，包括列表框的背景图和选中条图。当用户未向菜单窗发送此消息时，菜单使用默认的图片图标。 WM_SetTxt 设置列表框的标题文本。 WM_CREATE 消息： 当窗口创建时被系统自动发送，列表框响应该消息创建列表框的数据结构。以及初始化必要的数据， WM_DESTROY 消息： 当窗口被关闭时由系统自动发送至列表框，在其中释放掉创建时申请的动态数据。 WM_PAINT 画屏消息：菜单类响应这个刷屏消息时， 先判断屏幕是否需要更新，若需要更新则依次将菜单类的背景图，标题文本，选中条图标和菜单行显示到窗口。 WM_COMMAND 当菜单具有滚动条风格时，滚动条有变化会向菜单窗以command消息的形式发送EV_ScrollChange事件，菜单窗收到事件后重排菜单。 当菜单窗本身被键盘和触摸屏改变而重排时，也会通知滚动条重设百分比。 WM_ListChangeItem 动态修改弹出菜单的一个菜单项 四、使用示例： //创建弹出菜单窗口 win = WindowCreate( win , WS_FULLSCREEN|WS_TICK, 1022, 320-113,240-113, 112,112, SID_Txt_Listw, BID_PicList0, 0, NULL, WinListProcMap, NULL ); //添加菜单条目 WindowSendMessage(win,WM_ListAddItem,4,SampleMenu); 其运行结果如下： 另一种风格见下页： 弹出菜单的另一种风格：支持半透，右箭头等 福州瑞芯微电子有限公司 2007年8月 福州瑞芯微电子有限公司 lingzhaojun@ 第 3 页 QQ