中年人学C语言Windows程序设计，27控件ListView

最近学习的是WIN32控件ListView的使用，以下是个人的一点心得。
参考链接参考链接

ListView控件，在直观上个人认为就是表格的意思。与表格一样，ListView也有表头，表头有几个项，下面的内容行也有几个项。

使用列表控制的步骤如下：

调用CreateWindowEx函数来创建一个列表控件，指定它的类名为SysListView32。您还可以在此处指定控件初次显示时的方式。
创建和初始化用在列表控件中显示项目的图象列表（如果存在）。
向列表控件中插入列，如果显示的方式是报告方式这一步是必须的。
向控件中插入项目和自项目。

ListView的创建

创建ListView的函数是createWindow()函数，其中窗口类别参数使用 WC_LISTVIEW ，该参数定义在头文件 CommCtrl.h 中。

示例代码：

HWND hListview;
hListview = CreateWindowEx(0, TEXT("SysListView32"), 
           	TEXT("我是一个list表"), 
            WS_VISIBLE | WS_CHILD | WS_BORDER |LVS_REPORT |LVS_SHOWSELALWAYS,//样式
            0, 0,//坐标
            350, 100, //大小
            hwnd, 
            NULL, 
            hInst,
            NULL);

ListView控件。
为了使用ListView控件,我们需要初始化公共控件库,我们需要在程序刚刚启动时调用InitCommonControls() 函数，如果发生链接错误，说明我们没有链接拥有该函数的库文件。
它们对应的头和库 DLL分别为 #include <commctrl.h> comctl32.lib comctl32.dll
为了使用这个控件 我们就需要知道它的窗口类，利用Spy++等文件可以找到指定进程窗口的窗口类，而一个ListView控件也是一个子窗口，所以我们可以得到它的类名为syslistview32，其他的控件，我们只需要按照同样的道理来得到类名即可。
有了类名还不够，我们还需要知道每种控件的风格，比如listView控件有以下的风格LVS_REPORT | LVS_SHOWSELALWAYS， 它表示要产生报表和总是显示。为了得到控件的风格，我们可以通过MSDN中MFC中的ListView风格来作参考。有了窗口类和风格，我们利用CreateWindow就可以创建并得到
这个控件的句柄了。有了句柄，我们就可以随便控制了，具体要怎么看你自己的了。

ListView的操作

此外为了向ListView内插入项和列，我们需要两个结构体。
LVITEM和LVCOLUMN

(1)添加分栏，即为表头

LVCOLUMNW 结构（commctrl.h）

typedef struct _LVCOLUMN { 
    UINT mask; 
    int fmt; 
    int cx; 
    LPTSTR pszText; 
    int cchTextMax; 
    int iSubItem; 
#if (_WIN32_IE >= 0x0300)
    int iImage;
    int iOrder;
#endif
} LVCOLUMN, *LPLVCOLUMN; 

参数:

Field name	Meanings
imask	一组标志位标明该结构体中那些成员变量中的值有效。它的意义和上面我们提到的LV_COLUMN型结构体中向对应的成员变量基本相同。更详细的信息，可以查询WIN32 API 手册。
iItem	该结构体代表的项目的索引号。索引号是从0开始编号的。该值和表单的“行”类似。
iSubItem	和上一个成员变量指定的项目相连的子项目的索引号。您可以把它当作表单的“列”。譬如您想要把一个项目插入到新创建的列表视图控件，iItem的 值应为0（因为该项目是第一个项目），iSubItem的值也应当为0（我们想把该项目插到第一列）。如果你想指定一个子项目和该项目相连，iItem中 应该是您想要相连的项目的索引号，iSubItem的值应当是大于0的值，具体的值取决于您想把该子项目插在那一列。如果你的列表视图控件一共有4列的 化，第一列包含了项目，其余3列是留给子项目的。如果您想把子项目插在第四列，应当指定该值为3。
state	该成员变量包含的标志位反应了项目的状态。状态的改变可能是由用户的操作引起的或是程序改变的。这些状态包括：是否有焦点/高亮度显示/被选中（由于被剪切）/被选中等。另外还包括，以1为基数的索引用来代表是否处使用重叠/状态图标。
stateMask	由于上面的成员变量包含状态标志位、重叠的位图索引号、和状态位图的索引号，我们需要告诉WINDOWS我们到底需要设定或查询那一个值。该成员变量就是用来做这项工作的。
pszText	当我们想设定项目的属性时，它包含项目名称的ASCII码的字符串的地址。当查询项目的属性时，该成员变量将用来接收查询返回的项目的名称。
cchTextMax	仅当您用来查询项目的属性时才需要使用该值，这时它包含上一个成员变量的大小。
iImage	图标在列表视图中的图象链表中的索引号。
lParam	用户定义的值，当您给项目排序时使用。当您告诉列表视图对项目排序时，列表视图将成对地比较项目。 它将会把两个项目的lParam的值传给您，这样您就可以进行比较先列出那一个了。如果您现在还不太明白的话，没有系，我们稍后还要讲关于排序的问题。

控件通过SendMessage来发送消息来控制，常用的消息有：
SendMessage(hButton, LVM_INSERTCOLUMN, 0, (LPARAM)&colmn);

Field name
LVM_INSERTCOLUMN	加入列，wParam 为整型，指定列号，lParam 为指向LV_COLUMN结构的指针
LVM_SETCOLUMN	设置列，参数同上
LVM_INSERTITEM	加入项目或子项目，wParam 为0，lParam 为指向LV_ITEM结构的指针
LVM_SETITEM	设置项目或子项目，参数同上
LVM_GETITEM	取得项目或子项目，参数同上
LVM_GETNEXTITEM	取得下一个项目或子项目，可以用来取得光标选择的项目
LVM_DELETEITEM	删除项目或子项目，wParam 为整型，指定项目索引号，lParam 为0
LVM_DELETEALLITEMS	删除所有项目，wParam 和 lParam 均为0
LVM_SETTEXTCOLOR	设置文字颜色，wParam 为0，lParam 为颜色的RGB值
LVM_SETTEXTBKCOLOR	设置文字背景色，参数同上
LVM_SETBKCOLOR	设置背景色，参数同上

添加分栏需要使用到LVCOLUMN 结构体，示例：

 LV_COLUMN lvc;//LVCOLUMN结构体，定义listview的列属性
 lvc.mask = LVCF_TEXT | LVCF_WIDTH| LVCF_FMT;//指定哪些成员包含有效信息的变量。该成员可以是零
   
   lvc.fmt = LVCFMT_CENTER;  //列标题与列中子项文本的对齐方式。最左边一列的对齐方式始终是 LVCFMT_LEFT；
   lvc.pszText = TEXT("姓名");//列的名称，如果正在设置列信息，则此成员是包含列标题文本的以空字符结尾的字符串的地址
   lvc.cx = 80;//设置列的宽度   
   SendMessage(hListview, LVM_INSERTCOLUMN, 0, (long)&lvc); //LVM_INSERTCOLUMN表示添加列表示添加列,给第1列添加标体

(2)添加项，即行

添加项需要使用到LVITEM 结构体，示例：

   typedef struct _LVITEM { 
    UINT mask; 
    int iItem; 
    int iSubItem; 
    UINT state; 
    UINT stateMask; 
    LPTSTR pszText; 
    int cchTextMax; 
    int iImage; 
    LPARAM lParam;
#if (_WIN32_IE >= 0x0300)
    int iIndent;
#endif
#if (_WIN32_IE >= 0x560)
    int iGroupId;
    UINT cColumns; // tile view columns
    PUINT puColumns;
#endif

有了这两个结构体，我们就可以利用SendMessage来给ListView控件发送消息来为它添加项和列。
我们分别通过下面两个消息来添加项和列。
SendMessage(hButton, LVM_INSERTITEM, 0, (LPARAM)&item);
SendMessage(hButton, LVM_INSERTCOLUMN, 0, (LPARAM)&colmn);

LVM_INSERTITEM表示添加项
LVM_INSERTCOLUMN表示添加列。
为了更好的查找关于ListView的消息，我们只需要在网上或MSDN 里查找 LVM_XXXXXX 就可以找到

// 向列表中的添加列
VOID InsertListViewColumns(HWND hListView)
{
    // 1. 初始化一个列结构体进行设置
    // 1.1 第一个字段 mask 表示想要应用哪些设置(对齐方式，文字，宽度)
    LVCOLUMN lvColumn = { LVCF_FMT | LVCF_TEXT | LVCF_WIDTH };
    // 1.2 设置对齐方式，第一列的对其方式始终是左对齐
    lvColumn.fmt = LVCFMT_CENTER;
    // 1.3 设置每一列的宽度
    lvColumn.cx = 100;
​
    // 2. 设置列名并添加列
    lvColumn.cx = 100;
    lvColumn.pszText = (LPWSTR)L"姓名";
    ListView_InsertColumn(hListView, 0, &lvColumn);
​
    lvColumn.cx = 50;
    lvColumn.pszText = (LPWSTR)L"年龄";
    ListView_InsertColumn(hListView, 1, &lvColumn);
​
    lvColumn.cx = 260;
    lvColumn.pszText = (LPWSTR)L"学校";
    ListView_InsertColumn(hListView, 2, &lvColumn);
}

相关的消息了。最好自己整理出一份关于ListView的全部消息。
循环添加消息，用FOR语句

 LVITEM vitem;//LVITEM结构体，定义listview的项的数据属性
vitem.mask = LVIF_TEXT;
//vitem.mask = LVIF_TEXT | LVIF_IMAGE | LVIF_PARAM | LVIF_STATE;
for (i = 0; i < 6; i++)
{
    //先添加项再设置子项内容   
    //插入第一行数据，这一段代码是不可以少的。      
    vitem.iItem = i;//第几行的数据
    vitem.iSubItem = 0;//第1列
    vitem.pszText = stu[i].name;//赋值
    ListView_InsertItem(hListview, &vitem);//ListView_InsertItem表示添加项
    // 设置子项  
    vitem.iSubItem = 1;//第2列
    vitem.pszText = stu[i].age;
    ListView_SetItem(hListview, &vitem);
    vitem.iSubItem = 2;//第3列
    vitem.pszText = stu[i].dept;
    ListView_SetItem(hListview, &vitem);
    vitem.iSubItem = 3;//第4列
    vitem.pszText = stu[i].job;
    ListView_SetItem(hListview, &vitem);
}

(3)删除list控件里面的内容

int nSelectItem = ListView_GetSelectionMark(hListWnd); //获取鼠标选中项的索引


SendMessage(hListWnd, LVM_DELETEITEM, nSelectItem, 0); //LVM_DELETEITEM 消息删除nSelectItem item。

(4)获取信息

int nSelectIndex = ListView_GetSelectionMark(hListWnd);

TCHAR wstrText[4][128] = { 0 };

//通过一个for循环 能够获取第 nSelectIndex item的所有内容

for (int i = 0; i < 4; i++)

{

ListView_GetItemText(hListWnd, nSelectIndex, i, wstrText[i], sizeof(wstrText[i]));

}

(5)修改行数据

如何添加一个行：插入一行数据+设置行的信息

ListView_InsertItem + ListView_SetItemText

// 添加数据到某一行
VOID InsertListViewItem(HWND hListView, int index, LPCWSTR Name, LPCWSTR Age, LPCWSTR School)
{
    // 1. 先添加一行数据，并且设置第一列的信息
    LVITEM lvItem = { LVIF_TEXT };
    lvItem.iItem = index;
    lvItem.pszText = (LPWSTR)Name;
    ListView_InsertItem(hListView, &lvItem);
​
    // 2. 设置每一行中的元素信息
    ListView_SetItemText(hListView, index, 1, (LPWSTR)Age);
    ListView_SetItemText(hListView, index, 2, (LPWSTR)School);
}

(6)如何获取列表的选中项

需要注意通知码的筛选， NM_XXXX

当响应的是列表控件产生的通知消息时， LParam 保存的是一个指针，指向 NMLISTVIEW

// 2. 筛选消息是由谁产生的
if (lpNmhdr->idFrom == IDC_LIST1)
{
    // 3. 如果产生的是列表的通知消息，lParam 指向的是另外一个结构
    LPNMLISTVIEW lpNmListVew = (LPNMLISTVIEW)lParam;
​
    // 4. 如果产生的是鼠标的点击消息
    if (lpNmhdr->code == NM_CLICK)
    {
        // 判断点击的行是否有效
        // int n = ListView_GetItemCount(lpNmhdr->hwndFrom);
        if (-1 != lpNmListVew->iItem)
        {
            // 4.1 可以通过 LPNMLISTVIEW 获取点击的位置
            LVITEM lvItem = { LVIF_TEXT };
            // 4.2 必须要将 pszText 指向一个有效的位置
            lvItem.pszText = new WCHAR[0x10];
            // 4.3 设置缓冲区的大小
            lvItem.cchTextMax = 0x10;
​
            // 4.4 设置要获取的行列信息学
            lvItem.iItem = lpNmListVew->iItem;
            lvItem.iSubItem = lpNmListVew->iSubItem;
​
            // 4.5 发送消息获取数据
            ListView_GetItem(lpNmhdr->hwndFrom, &lvItem);
​
            // 4.6 显示获取的数据
            MessageBox(hWnd, lvItem.pszText, L"左键点击", MB_OK);
        }
    }
}

(7)在列表中弹出一个菜单项

case WM_NOTIFY:
{
    // 1. 响应 WM_NOTIFY 消息的时候, lParam 指向的但通常十一个结构体
    LPNMHDR lpNmhdr = (LPNMHDR)lParam;
​
    // 2. 筛选消息是由谁产生的
    if (lpNmhdr->idFrom == IDC_LIST1)
    {
        // 右键弹出菜单
        if (NM_RCLICK == lpNmhdr->code)
        {
            // 1. 获取点击的位置，获取的是相对于桌面的
            POINT Point = { 0 };
            GetCursorPos(&Point);
​
            // 2. 获取一个子菜单
            HMENU hMenu = LoadMenu(GetModuleHandle(NULL), MAKEINTRESOURCE(IDR_MENU1));
            HMENU hSubMenu = GetSubMenu(hMenu, 0);
​
            // 3. 弹出菜单
            TrackPopupMenu(hSubMenu, TPM_LEFTALIGN, Point.x, Point.y, NULL, hWnd, nullptr);
        }
    }
​
    break;
}

(8)第一列不能居中和乱码的问题

曾经卡了我一天的bug 就是 第一列不能居中和乱码的问题，最后发现把第一列宽度设置成0，从第二列开始显示就能解决问题。
代码如下：

LV_COLUMN lvc;
lvc.mask = LVCF_FMT | LVCF_WIDTH | LVCF_TEXT | LVCF_SUBITEM;//指定哪些成员包含有效信息的变量。该成员可以是零        
lvc.fmt = LVCFMT_CENTER;  //列标题与列中子项文本的对齐方式。最左边一列的对齐方式始终是 LVCFMT_LEFT；
lvc.pszText = TEXT("序号");//列的名称，如果正在设置列信息，则此成员是包含列标题文本的以空字符结尾的字符串的地址
lvc.cx = 0;//设置列的宽度   
SendMessage(hListview, LVM_INSERTCOLUMN, 0, (LPARAM)&lvc); //LVM_INSERTCOLUMN表示添加列表示添加列,给第1列添加标体

效果实例

创建一个listview，然后对其进行赋值

实例代码

LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    PAINTSTRUCT ps;
    HDC hdc;
    RECT rt;
    //int ret;
    int i;

    struct STUDENTINFO stu[6] = {
    {  TEXT("无忌"),TEXT("20"), TEXT("技术部"),TEXT("工程师") },
    { TEXT("三丰"), TEXT("80"),TEXT("总经理"), TEXT("总经理") },
    { TEXT("远桥"),TEXT("40"), TEXT("技术部"), TEXT("经理") },
    { TEXT("敏敏"), TEXT("18"), TEXT("客服部"),TEXT("经理") },
    { TEXT("芷若"), TEXT("18"), TEXT("行政部"), TEXT("经理") },
    { TEXT("小昭"), TEXT("16"), TEXT("行政部"), TEXT("前台") }
    };

    switch (message)
    {
    case WM_COMMAND:
        switch (LOWORD(wParam))
        {

        case IDM_ABOUT: //点击关于选项

            MessageBox(hwnd, TEXT("listviewDemo v1.0\nCopyright (C) 2021\n by 卖身买镜头"),
                TEXT("listviewDemo"),  MB_ICONINFORMATION);
            break;
        case IDM_EXIT://点击退出选项
            DestroyWindow(hwnd);
            break;
        default:
            return DefWindowProc(hwnd, message, wParam, lParam);
        }
        break;
    case WM_CREATE://WS_EX_CLIENTEDGE
        //创建listview子窗口
        hListview = CreateWindowEx(0, TEXT("SysListView32"), TEXT("我是一个list表"), 
            WS_VISIBLE | WS_CHILD | WS_BORDER |LVS_REPORT | LVS_SHOWSELALWAYS,
            0, 0,350, 100, 
            hwnd, NULL, hInst, NULL);

        LV_COLUMN lvc;//LVCOLUMN结构体，定义listview的列属性
        lvc.mask = LVCF_TEXT | LVCF_WIDTH| LVCF_FMT;//指定哪些成员包含有效信息的变量。该成员可以是零
        
        lvc.fmt = LVCFMT_CENTER;  //列标题与列中子项文本的对齐方式。最左边一列的对齐方式始终是 LVCFMT_LEFT；
        lvc.pszText = TEXT("姓名");//列的名称，如果正在设置列信息，则此成员是包含列标题文本的以空字符结尾的字符串的地址
        lvc.cx = 80;//设置列的宽度   
        SendMessage(hListview, LVM_INSERTCOLUMN, 0, (long)&lvc); //LVM_INSERTCOLUMN表示添加列表示添加列,给第1列添加标体

        lvc.pszText = TEXT("年龄");
       
        lvc.cx = 70;
        SendMessage(hListview, LVM_INSERTCOLUMN, 1, (long)&lvc);
       
        lvc.pszText = TEXT("部门");
        lvc.cx = 80;
        SendMessage(hListview, LVM_INSERTCOLUMN, 2, (long)&lvc);
        lvc.pszText = TEXT("职务");
        lvc.cx = 80;
        SendMessage(hListview, LVM_INSERTCOLUMN, 3, (long)&lvc);

        SendMessage(hListview, LVM_SETTEXTCOLOR, 0, RGB(255, 255, 255));//设置文字颜色
        SendMessage(hListview, LVM_SETTEXTBKCOLOR, 0, RGB(100, 0, 200));//设置文字背景颜色
        SendMessage(hListview, LVM_SETBKCOLOR, 0, RGB(150, 255, 50));//设置控件背景颜色
        

        LVITEM vitem;//LVITEM结构体，定义listview的项的数据属性
        vitem.mask = LVIF_TEXT;
        //vitem.mask = LVIF_TEXT | LVIF_IMAGE | LVIF_PARAM | LVIF_STATE;
        for (i = 0; i < 6; i++)
        {
            //先添加项再设置子项内容   
            //插入第一行数据，这一段代码是不可以少的。      
            vitem.iItem = i;//第几行的数据
            vitem.iSubItem = 0;//第1列
            vitem.pszText = stu[i].name;//赋值
            ListView_InsertItem(hListview, &vitem);//ListView_InsertItem表示添加项
            // 设置子项  
            vitem.iSubItem = 1;//第2列
            vitem.pszText = stu[i].age;
            ListView_SetItem(hListview, &vitem);
            vitem.iSubItem = 2;//第3列
            vitem.pszText = stu[i].dept;
            ListView_SetItem(hListview, &vitem);
            vitem.iSubItem = 3;//第4列
            vitem.pszText = stu[i].job;
            ListView_SetItem(hListview, &vitem);
        }

        break;
    case WM_PAINT:
        hdc = BeginPaint(hwnd, &ps);
        GetClientRect(hwnd, &rt);

        EndPaint(hwnd, &ps);
        break;
    case WM_DESTROY:
        PostQuitMessage(0);
        break;
    default:
        return DefWindowProc(hwnd, message, wParam, lParam);
    }

    return 0;
}