Win32 ListBox控件

Win32 ListBox控件

创建ListBox控件

1. 创建窗口函数

   HWND CrateWindowEx(
       DWORD dwExStyle , // 窗口的扩展风格,基本没用
       LPCTSTR lpClassName, // 已经注册的窗口类名称
       LPCTSTR lpWindowName, // 窗口标题栏的名字
       DWORD dwStyle, // 窗口的基本风格
       int x, // 左上角水平坐标
       int y, // 左上角垂直坐标
       int nWidth,
       int nHeight,
       HWND hWndParent, // 窗口的父窗口句柄 --> 如果是子窗口要写这个参数
       HMENU hMenu,     // 窗口菜单句柄
       HINSTANCE hInstance, // 应用程序实例句柄 --> WinMain 第一个参数
       LPVOID lpParam // 窗口创建时附加参数 --> 一般给NULL
   ); // 创建成功返回窗口句柄

2. 创建ListBox

   #define ID_LIST        1001   // 窗口句柄
   
   HWND hListBox = CreateWindowEx(0, TEXT("ListBox"), NULL, WS_VISIBLE | WS_CHILD | WS_BORDER | LBS_HASSTRINGS,10, 10, 200, 200, hWnd, (HMENU)ID_LIST, ((LPCREATESTRUCT)lParam)->hInstance, 0);
   
   const TCHAR *strArray[] = { TEXT("星期一"), TEXT("星期二"), TEXT("星期三"), 
                             TEXT("星期四"), TEXT("星期五"), TEXT("星期六"), TEXT("星期日")};
   for (int i = 0; i < 7; i++){
       // 添加内容
       SendMessage(hListBox, LB_ADDSTRING, 0, (LPARAM)strArray[i]);
   }

3. 效果

控件样式

控件消息

Demo

1. 单击选项弹出消息框显示选择的项

if (LOWORD (wParam) == ID_LIST && HIWORD(wParam) == LBN_SELCHANGE) {
    int iIndex = SendMessage(hListBox, LB_GETCURSEL, 0, 0);
    int iLength = SendMessage(hListBox, LB_GETTEXTLEN, iIndex, 0) + 1;
    TCHAR * pVarName = (TCHAR*)malloc(iLength*sizeof(TCHAR));
    SendMessage(hListBox, LB_GETTEXT, iIndex, (LPARAM)pVarName);
    MessageBox(hWnd, pVarName, TEXT("选择的内容"), MB_OK);
    free(pVarName);
}

2. ListBox重绘

ListBox重绘，实现QQ 消息列表效果

通过指定LBS_OWNERDRAWFIXED样式，可以进行ListBox的重绘。

两个重要消息：WM_DRAWITEM 和 WM_MEASUREITEM

2.1 WM_DRAWITEM 消息

第二个附加参数lParam里包含了控件的相关信息， 其实际类型是DRAWITEMSTRUCT的指针类型

DRAWITEMSTRUCT 原型：

typedef struct tagDRAWITEMSTRUCT {
  UINT      CtlType;
  UINT      CtlID;
  UINT      itemID;
  UINT      itemAction;
  UINT      itemState;
  HWND      hwndItem;
  HDC       hDC;
  RECT      rcItem;
  ULONG_PTR itemData;
} DRAWITEMSTRUCT, *PDRAWITEMSTRUCT, *LPDRAWITEMSTRUCT;

• CtlType 指定了控件的类型

• CtlID

  组合框、列表框、按钮或静态控件的标识符。 此成员不用于菜单项。

• itemID

  菜单项的菜单项标识符或列表框或组合框中项的索引。 对于空列表框或组合框，此成员可以是 -1。

  这允许应用程序仅在 rcItem 成员指定的坐标处绘制焦点矩形，即使控件中没有项也是如此。 这向用户指示列表框或组合框是否具有焦点。

  itemAction 成员中设置位的方式决定了矩形是否与列表框或组合框具有焦点一样绘制

• itemAction

  所需的绘图操作。 此成员可以是一个或多个值。

• itemState

  当前绘图操作发生后项的视觉状态。 此成员可以是下表中显示的值的组合。

• hwndItem

  组合框、列表框、按钮和静态控件的控件的句柄。 对于菜单，此成员是包含该项的菜单的句柄。

• hDC

  设备上下文的句柄;在控件上执行绘图操作时，必须使用此设备上下文。

• rcItem

  一个矩形，用于定义要绘制的控件的边界。 此矩形位于 hDC 成员指定的设备上下文中。 系统会自动剪辑所有者窗口在组合框、列表框和按钮的设备上下文中绘制的任何内容，但不会剪辑菜单项。 绘制菜单项时，所有者窗口不得在 rcItem 成员定义的矩形边界之外绘制。

• itemData

  与菜单项关联的应用程序定义值。 对于控件，此参数指定LB_SETITEMDATA或CB_SETITEMDATA消息最后分配给列表框或组合框的值。 如果列表框或组合框具有 LBS_HASSTRINGS或 CBS_HASSTRINGS样式，则此值最初为零。 否则，此值最初是传递给下列消息之一的 lParam 参数中的列表框或组合框的值：

  • CB_ADDSTRING
  • CB_INSERTSTRING
  • LB_ADDSTRING
  • LB_INSERTSTRING

  如果 CtlType是ODT_BUTTON 或 ODT_STATIC， 则itemData 为零。

2.2 WM_MEASUREITEM消息

第二个附加参数lParam描述了相关项的绘制信息，其实际类型是MEASUREITEMSTRUCT的指针类型

typedef struct tagMEASUREITEMSTRUCT {
  UINT      CtlType;
  UINT      CtlID;
  UINT      itemID;
  UINT      itemWidth;
  UINT      itemHeight;
  ULONG_PTR itemData;
} MEASUREITEMSTRUCT, *PMEASUREITEMSTRUCT, *LPMEASUREITEMSTRUCT;

大部分字段同DRAWITEMSTRUCT, 两个重要字段itemWidth, itemHeight 指定列表项的宽度和高度

2.3 重要代码

void SetListBoxItemRect(LPARAM lParam) {
    PMEASUREITEMSTRUCT pmr = (PMEASUREITEMSTRUCT)lParam;
    if (pmr->CtlID == ID_LIST) {
        pmr->itemHeight = 58;
    }
}

void DrawListBoxItem(LPARAM lParam) {
    TCHAR* pVarName;
    PDRAWITEMSTRUCT pdr = (PDRAWITEMSTRUCT)(lParam);
    COLORREF nColor = RGB(66, 66, 66);
    HBRUSH hBursh = NULL;   
    if(pdr->itemState & ODS_SELECTED ) // 选中状态
        hBursh = CreateSolidBrush(RGB(255, 128, 0));
    else
        hBursh = CreateSolidBrush(RGB(255, 255, 255));
    FillRect(pdr->hDC, &pdr->rcItem, hBursh);
    DeleteObject(hBursh);
    int itemLength = SendMessage(hListBox, LB_GETTEXTLEN, pdr->itemID, 0) + 1;
    pVarName = (TCHAR*)malloc(itemLength * sizeof(TCHAR));
    SendMessage(hListBox, LB_GETTEXT, pdr->itemID, (LPARAM)pVarName);

    if (pVarName == NULL) return;
    HBITMAP hBmp = LoadBitmap(hInst, (char*)info_arr[atoi(pVarName)].bitmapId);
    HDC Bhdc = CreateCompatibleDC(pdr->hDC);
    HGDIOBJ oldBMP = SelectObject(Bhdc, hBmp);
    StretchBlt(pdr->hDC, pdr->rcItem.left + 1, pdr->rcItem.top + 1, 56, 56, Bhdc, 0, 0, 100, 100, SRCCOPY);
    HFONT font1 = CreateFont(20,0,0,0,900,NULL,NULL,NULL,GB2312_CHARSET,NULL,NULL,NULL,NULL,"仿宋");
    HFONT font2 = CreateFont(20,0,0,0,800,NULL,NULL,NULL,GB2312_CHARSET,NULL,NULL,NULL,NULL,"方正舒体");
    SetBkMode(pdr->hDC, TRANSPARENT);
    HGDIOBJ oldfont = SelectObject(pdr->hDC, font1);
    nColor = RGB(0, 0, 0);
    SetTextColor(pdr->hDC, nColor);
    TextOut(pdr->hDC, pdr->rcItem.left + 65, pdr->rcItem.top + 5, info_arr[atoi(pVarName)].userName, strlen(info_arr[atoi(pVarName)].userName));
    SelectObject(pdr->hDC, font2);
    nColor = RGB(133, 193, 246);
    SetTextColor(pdr->hDC, nColor);
    TextOut(pdr->hDC, pdr->rcItem.left + 65, pdr->rcItem.top + 30, info_arr[atoi(pVarName)].newData, strlen(info_arr[atoi(pVarName)].newData));
    SelectObject(pdr->hDC, oldfont);
    SelectObject(Bhdc, oldBMP);
    DeleteObject(hBmp);
    DeleteObject(font1);
    DeleteObject(font2);
    DeleteDC(Bhdc);
    free(pVarName);
}

2.4 实现效果

参考

1. 基本使用：https://blog.csdn.net/qq_31178679/article/details/125904122
2. ListBox风格、消息说明：https://www.cnblogs.com/H-R-J/p/11882224.html
3. ListBox重绘: https://www.freesion.com/article/3893191680/
4. ListBox简单使用：https://www.codenong.com/cs109127861/
5. 微软文档：https://learn.microsoft.com/zh-cn/windows/win32/msi/listbox-control
6. DRAWITEMSTRUCT 结构： https://learn.microsoft.com/zh-cn/windows/win32/api/winuser/ns-winuser-drawitemstruct

项目地址

• https://github.com/wa-kakalala/QQMsgList