【STemWin教程】第59章 LISTVIEW控件

席萌0209 · 发表于 2015-3-14 11:23:24

特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接

第59章 LISTVIEW控件

本期教程讲解STemWin支持的LISTVIEW控件。
59. 1 LISTVIEW控件介绍
59. 2 官方WIDGET_ListView实例
59. 3 使用官方GUIBulder建立ListView控件
59. 3 总结

59.1 LISTVIEW控件介绍
LISTVIEW控件可在具有多个列的列表中选择某个元素。由于LISTVIEW控件包含了一个HEADER控件，因此可对列加以管理。所创建的LISTVIEW既可以无环绕型框架窗口，也可以作为FRAMEWIN控件的一个子窗口。一旦选定列表视图中的项目，就会突出显示有关项目。需要注意的是，所选项目的背景颜色取决于LISTVIEW窗口是否具有输入焦点。下表显示的是LISTVIEW小工具的外观：

59.1.1 LISTVIEW支持的通知代码

以下事件是LISTVIEW控件作为WM_NOTIFY_PARENT消息的一部分发送给其父窗口的：

消息	描述
WM_NOTIFICATION_CLICKED	已单击
WM_NOTIFICATION_RELEASED	已释放
WM_NOTIFICATION_MOVED_OUT	已单击小工具，并且指针已移出小工具，但没有释放
WM_NOTIFICATION_SCROLL_CHANGED	可选滚动条的滚动位置已更改
WM_NOTIFICATION_SEL_CHANGED	列表框的选择内容已更改

59.1.2 LISTVIEW支持的键盘反应

如果控件具有输入焦点，则它将对下列各键做出反应：

按键	反应
GUI_KEY_UP	选择栏上移
GUI_KEY_DOWN	选择栏下移。
GUI_KEY_RIGHT	如果总列宽>列表视图的内部区域，则内容将滚动到左侧。
GUI_KEY_LEFT	如果总列宽>列表视图的内部区域，则内容将滚动到右侧。

59.2 官方WIDGET_ListView实例

官方的这个实例很好的演示了ListView的使用，这个例子在模拟器中的位置：

源码如下（程序中进行了详细的注释）：

#include <stddef.h>
#include <string.h>
#include "GUI.h"
#include "LISTVIEW.h"
#include "FRAMEWIN.h"
/*********************************************************************
*
* Defines
*
**********************************************************************
*/
#define SPEED 650
#define MSG_CHANGE_MAIN_TEXT (WM_USER + 0)
#define MSG_CHANGE_INFO_TEXT (WM_USER + 1)
/*********************************************************************
*
* Static data
*
**********************************************************************
*/
static const GUI_COLOR Colors[] = { 0, GUI_BLUE };
static const GUI_LOGPALETTE Palette = {
2, /* bps */
1, /* transparency */
Colors /* pointer to colors */
};
static const unsigned char acBarCode[] = {
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
_XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_, ________, ________, ________, ________, _XXX_X__, XXX__XX_, X_X_X_XX, __X_XXX_,
};
static const GUI_BITMAP bmBarCode = { 96, 10, 12, 1, acBarCode, &Palette};
static const char * _aTable_1[][3] = {
{ "623499-0010001", "1", "Item 1" },
{ "623499-0010002", "2", "Item 2" },
{ "623499-0010003", "3", "Item 3" },
{ "623499-0010004", "4", "Item 4" },
{ "623499-0010005", "5", "Item 5" },
{ "623499-0010006", "6", "Item 6" },
{ "623499-0010007", "7", "Item 7" },
{ "623499-0010008", "8", "Item 8" }
};
static const char * _aTable_2[][3] = {
{ "111111-1111111", "100-A", "Item AAA" },
{ "222222-2222222", "100-B", "Item BBB" },
{ "333333-3333333", "100-C", "Item CCC" },
{ "444444-4444444", "100-D", "Item DDD" },
{ "555555-5555555", "100-E", "Item EEE" },
{ "666666-6666666", "100-F", "Item FFF" },
{ "777777-7777777", "100-G", "Item GGG" },
{ "888888-8888888", "100-H", "Item HHH" }
};
static LISTVIEW_Handle _hListView;
static char _acMainText[100];
static char _acInfoText[100];
/*******************************************************************
*
* _ChangeMainText
*
* 用于给桌面窗口发自定义消息，并将桌面窗口无效，这样就可以出发桌面窗口回调函数
* 的WM_PAINT消息。
*/
static void _ChangeMainText(char* pStr) {
WM_MESSAGE Message;
Message.MsgId = MSG_CHANGE_MAIN_TEXT;
Message.Data.p = pStr;
WM_SendMessage(WM_HBKWIN, &Message);
WM_InvalidateWindow(WM_HBKWIN);
}
/*******************************************************************
*
* _ChangeInfoText
*
* 用于给桌面窗口发自定义消息，并将桌面窗口无效，这样就可以出发桌面窗口回调函数
* 的WM_PAINT消息。
*/
static void _ChangeInfoText(char* pStr) {
WM_MESSAGE Message;
Message.MsgId = MSG_CHANGE_INFO_TEXT;
Message.Data.p = pStr;
WM_SendMessage(WM_HBKWIN, &Message);
WM_InvalidateWindow(WM_HBKWIN);
GUI_Delay(SPEED);
}
/*******************************************************************
*
* _cbBkWindow
*/
static void _cbBkWindow(WM_MESSAGE* pMsg) {
switch (pMsg->MsgId) {
case MSG_CHANGE_MAIN_TEXT: //自定义消息
strcpy(_acMainText, (char const *)pMsg->Data.p);
WM_InvalidateWindow(pMsg->hWin);
break;
case MSG_CHANGE_INFO_TEXT: //自定义消息
strcpy(_acInfoText, (char const *)pMsg->Data.p);
WM_InvalidateWindow(pMsg->hWin);
break;
case WM_PAINT:
GUI_SetBkColor(GUI_BLACK);
GUI_Clear();
GUI_SetColor(GUI_WHITE);
GUI_SetFont(&GUI_Font24_ASCII);
GUI_DispStringHCenterAt("LISTVIEW Widget - Sample", 160, 5);
GUI_SetFont(&GUI_Font8x16);
GUI_DispStringAt(_acMainText, 5, 40);
GUI_SetFont(&GUI_Font8x8);
GUI_DispStringAt(_acInfoText, 5, 60);
break;
default:
WM_DefaultProc(pMsg);
}
}
/*********************************************************************
*
* _Demo
*/
static void _Demo(void) {
unsigned int i;
unsigned int j;
int Key = 0;
int Cnt = 15;
char acInfoText[] = "-- sec to play with header control";
HEADER_Handle hHeader;
/* 得到LISTVIEW中的HEADER控件句柄 */
hHeader = LISTVIEW_GetHeader(_hListView);
WM_SetFocus(_hListView);
/* 演示LISTVIEW_AddColumn */
_ChangeInfoText("LISTVIEW_AddColumn");
LISTVIEW_AddColumn(_hListView, 100, "EAN", GUI_TA_CENTER);
GUI_Delay(SPEED / 2);
LISTVIEW_AddColumn(_hListView, 50, "Order #\0x0", GUI_TA_CENTER);
GUI_Delay(SPEED / 2);
LISTVIEW_AddColumn(_hListView, 100, "Description", GUI_TA_CENTER);
GUI_Delay(SPEED / 2);
/* 演示SCROLLBAR_CreateAttached */
_ChangeInfoText("SCROLLBAR_CreateAttached");
SCROLLBAR_CreateAttached(_hListView, SCROLLBAR_CF_VERTICAL);
GUI_Delay(SPEED / 2);
/* 演示LISTVIEW_AddRow */
_ChangeInfoText("LISTVIEW_AddRow");
for (i = 0; i < GUI_COUNTOF(_aTable_1); i++) {
LISTVIEW_AddRow(_hListView, _aTable_1[i]);
GUI_Delay(SPEED / 3);
}
/* 演示LISTVIEW_IncSel */
_ChangeInfoText("LISTVIEW_IncSel");
for (i = 0; i < LISTVIEW_GetNumRows(_hListView); i++) {
LISTVIEW_IncSel(_hListView);
GUI_Delay(SPEED / 4);
}
GUI_Delay(SPEED / 4);
/* 演示LISTVIEW_DecSel */
_ChangeInfoText("LISTVIEW_DecSel");
for (i = 0; i < LISTVIEW_GetNumRows(_hListView); i++) {
LISTVIEW_DecSel(_hListView);
GUI_Delay(SPEED / 4);
}
GUI_Delay(SPEED / 4);
/* 演示LISTVIEW_SetTextAlign */
_ChangeInfoText("LISTVIEW_SetTextAlign");
LISTVIEW_SetTextAlign(_hListView, 0, GUI_TA_RIGHT);
GUI_Delay((int)(SPEED * 0.7));
/* 演示LISTVIEW_SetColumnWidth */
_ChangeInfoText("LISTVIEW_SetColumnWidth");
LISTVIEW_SetColumnWidth(_hListView, 1, 70);
GUI_Delay((int)(SPEED * 0.7));
/* 演示HEADER_SetTextColor */
_ChangeInfoText("HEADER_SetTextColor");
HEADER_SetTextColor(hHeader, GUI_BLUE);
GUI_Delay((int)(SPEED * 0.7));
/* 演示LISTVIEW_SetItemText */
_ChangeInfoText("LISTVIEW_SetItemText");
for (i = 0; i < GUI_COUNTOF(_aTable_2); i++) {
for (j = 0; j < GUI_COUNTOF(_aTable_2[i]); j++) {
LISTVIEW_SetItemText(_hListView, j, i, _aTable_2[i][j]);
}
}
GUI_Delay(SPEED / 2);
/* 演示LISTVIEW_SetBkColor */
_ChangeInfoText("LISTVIEW_SetBkColor");
LISTVIEW_SetBkColor(_hListView, 0, GUI_YELLOW);
GUI_Delay((int)(SPEED * 0.7));
/* 演示LISTVIEW_SetGridVis */
_ChangeInfoText("LISTVIEW_SetGridVis");
LISTVIEW_SetGridVis(_hListView, 1);
GUI_Delay((int)(SPEED * 0.7));
/* 演示HEADER_SetHeight */
_ChangeInfoText("HEADER_SetHeight");
HEADER_SetHeight(hHeader, 30);
GUI_Delay((int)(SPEED * 0.7));
/* 演示HEADER_SetBitmap */
_ChangeInfoText("HEADER_SetBitmapEx");
HEADER_SetBitmap(hHeader, 0, &bmBarCode);
GUI_Delay((int)(SPEED * 0.7));
/* 等待一段时间，用于用户操作 */
while ((Key != GUI_KEY_ENTER) && (Cnt > 0)) {
acInfoText[0] = '0' + (Cnt / 10);
acInfoText[1] = '0' + (Cnt-- % 10);
_ChangeInfoText(acInfoText);
GUI_Delay(1000);
Key = GUI_GetKey();
}
}
/*********************************************************************
*
* _DemoListView
*/
static void _DemoListView(void) {
_ChangeMainText("LISTVIEW control without parent");
_ChangeInfoText("LISTVIEW_Create");
/* 创建LISTVIEW */
_hListView = LISTVIEW_Create(10, 80, 300, 89, 0, 1234, WM_CF_SHOW, 0);
GUI_Delay(SPEED / 2);
/* Demo演示 */
_Demo();
_ChangeInfoText("LISTVIEW_Delete");
/* 删除listview */
LISTVIEW_Delete(_hListView);
GUI_Delay(SPEED);
}
/*********************************************************************
*
* MainTask
*/
void MainTask(void) {
GUI_Init();
/* 使能桌面窗口使用内存设备 */
WM_EnableMemdev(WM_HBKWIN);
/* 使能所有其它窗口使用内存设备 */
WM_SetCreateFlags(WM_CF_MEMDEV);
/* 设置桌面窗口的回调函数 */
WM_SetCallback(WM_HBKWIN, _cbBkWindow);
GUI_CURSOR_Show();
while(1) {
_DemoListView();
}
}