【自绘ListBox】带图标的ListBox

最新推荐文章于 2025-07-02 13:11:54 发布
最新推荐文章于 2025-07-02 13:11:54 发布
阅读量5.4k 收藏 12
点赞数 2
CC 4.0 BY-SA版权
分类专栏： MFC控件自绘 文章标签： mfc自绘控件
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/hisinwang/article/details/45787037
本文介绍了一个自绘列表框的实现方法，包括如何在列表框中显示图标，并提供了详细的代码示例。通过设置不同的属性，可以灵活地控制列表框的行为。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

示例图片

这里写图片描述

源码下载

源码下载
示例程序下载

使用说明

提供的接口如下:

void SetImageList(CImageList* pImageList);
CImageList* GetImageList() const;
int GetItemImage(int nIndex);
int SetItemImage(int nIndex, int nImageIndex, BOOL bRepaint = TRUE);

int AddString(LPCTSTR lpszString, int nImageIndex = -1);
int DeleteString(UINT nIndex);
int InsertString(int nIndex, LPCTSTR lpszString, int nImageIndex);
void ResetContent();

DWORD_PTR GetItemData(int nIndex) const;
int SetItemData(int nIndex, DWORD_PTR dwItemData);
void* GetItemDataPtr(int nIndex) const;
int SetItemDataPtr(int nIndex, void* pData);

使用方法:

Owner Draw — Variable
Has Strings — True

CListBoxXI m_listbox1;
CImageList m_imglist1;
m_imglist1.Create(32, 32, ILC_COLOR32 | ILC_MASK, 2, 1);
m_imglist1.Add(AfxGetApp()->LoadIcon(IDI_ICON1));
m_imglist1.Add(AfxGetApp()->LoadIcon(IDI_ICON2));

m_listbox1.SetImageList(&m_imglist1);
m_listbox1.AddString("456", 1);
m_listbox1.AddString("123", 0);
m_listbox1.AddString("hello kitty", 0);

注意事项:

自绘也就是在DrawItem及MeasureItem中实现。

源码

[ListBoxXI.h]

#pragma once

// CListBoxXI

class CListBoxXI : public CListBox
{
    DECLARE_DYNAMIC(CListBoxXI)

public:
    CListBoxXI();
    virtual ~CListBoxXI();

    void SetImageList(CImageList* pImageList);
    CImageList* GetImageList() const;
    int GetItemImage(int nIndex);
    int SetItemImage(int nIndex, int nImageIndex, BOOL bRepaint = TRUE);

    int AddString(LPCTSTR lpszString, int nImageIndex = -1);
    int DeleteString(UINT nIndex);
    int InsertString(int nIndex, LPCTSTR lpszString, int nImageIndex);
    void ResetContent();

    DWORD_PTR GetItemData(int nIndex) const;
    int SetItemData(int nIndex, DWORD_PTR dwItemData);
    void* GetItemDataPtr(int nIndex) const;
    int SetItemDataPtr(int nIndex, void* pData);

protected:
    virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);
    virtual void MeasureItem(LPMEASUREITEMSTRUCT lpMeasureItemStruct);

    DECLARE_MESSAGE_MAP()

private:
    // 关联的CImageList
    CImageList *m_pImageList;
    CSize      m_imageSize;

    // 每项的关联数据
    struct LBDataXI
    {
        // 图像序号,如果为-1,则表示无图像
        int iImageIndex;

        // 关联数据的指针
        LPVOID pData;

        LBDataXI()
        {
            iImageIndex = -1;
            pData = NULL;
        }
    };

    // 删除关联数据
    void DeleteItemData(int nIndex);
};

[ListBoxXI.cpp]

/**********************************************************
 ListBoxXI.cpp : implementation file
 Written by WangYao (wangyao1052@163.com)
 Version: V1.0 2014-06-07
**********************************************************/

#include "stdafx.h"
#include "ListBoxXI.h"

#define LBXI_CX_BORDER   2
#define LBXI_CY_BORDER   2

// CListBoxXI

IMPLEMENT_DYNAMIC(CListBoxXI, CListBox)

CListBoxXI::CListBoxXI()
{
    m_pImageList = NULL;
    m_imageSize.cx = 0;
    m_imageSize.cy = 0;
}

CListBoxXI::~CListBoxXI()
{
}

//---------------------------------------------------------
// 函数: SetImageList
// 功能: 设置关联的ImageList
// 参数: 
//       pImageList --- ImageList的指针
// 返回: 无
//---------------------------------------------------------
void CListBoxXI::SetImageList(CImageList* pImageList)
{
    m_pImageList = pImageList;
    if (m_pImageList)
    {
        int cx;
        int cy;
        ImageList_GetIconSize(*m_pImageList, &cx, &cy);
        m_imageSize.cx = cx;
        m_imageSize.cy = cy;
    }
    else
    {
        m_imageSize.cx = 0;
        m_imageSize.cy = 0;
    }

    Invalidate();
}

//---------------------------------------------------------
// 函数: GetImageList
// 功能: 获取关联ImageList的指针
// 参数: 无
// 返回: 关联ImageList的指针,若没有关联ImageList返回NULL
//---------------------------------------------------------
CImageList* CListBoxXI::GetImageList() const
{
    return m_pImageList;
}

//---------------------------------------------------------
// 函数: GetItemImage
// 功能: 获取项的图片索引
// 参数: 
//       nIndex  --- 项索引(以0为起点)
// 返回:
//       以0为起始的图片索引序号
//       若存在错误,如nIndex超出范围,返回-1
//       若项没有关联图片,返回-1
//---------------------------------------------------------
int CListBoxXI::GetItemImage(int nIndex)
{
    LBDataXI* pLBData = (LBDataXI*)CListBox::GetItemData(nIndex);
    if (pLBData == (LBDataXI*)LB_ERR || pLBData == NULL)
    {
        return -1;
    }

    return pLBData->iImageIndex;
}

//---------------------------------------------------------
// 函数: SetItemImage
// 功能: 设置项的图片索引
// 参数: 
//       nIndex      --- 项索引(以0为起点)
//       nImageIndex --- 图片索引(以0为起点)
//       bRepaint    --- 是否重绘
// 返回:
//       成功返回0,失败返回-1
//---------------------------------------------------------
int CListBoxXI::SetItemImage(int nIndex, int nImageIndex, BOOL bRepaint)
{
    LBDataXI* pLBData = (LBDataXI*)CListBox::GetItemData(nIndex);
    if (pLBData == (LBDataXI*)LB_ERR || pLBData == NULL)
    {
        return -1;
    }
    pLBData->iImageIndex = nImageIndex;

    if (bRepaint)
    {
        Invalidate();
    }

    return 0;
}

//---------------------------------------------------------
// 函数: AddString
// 功能: 添加项
// 参数: lpszString  --- 字符串指针
//        nImageIndex --- 图片索引(以0为起点)
// 返回: 新增项的索引值
//        失败则返回LB_ERR或LB_ERRSPACE
//---------------------------------------------------------
int CListBoxXI::AddString(LPCTSTR lpszString, int nImageIndex)
{
    int nIndex = CListBox::AddString(lpszString);

    if (nIndex != LB_ERR && nIndex != LB_ERRSPACE)
    {
        LBDataXI *pData = new LBDataXI();
        pData->iImageIndex = nImageIndex;
        pData->pData = NULL;
        CListBox::SetItemData(nIndex, (DWORD_PTR)pData);
    }

    return nIndex;
}

//---------------------------------------------------------
// 函数: InsertString
// 功能: 在指定位置插入项
// 参数: 
//       nIndex      --- 指定位置
//       lpszString  --- 字符串指针
//       nImageIndex --- 图片索引(以0为起点)
// 返回: 
//       插入项索引值
//       失败则返回LB_ERR或LB_ERRSPACE
//---------------------------------------------------------
int CListBoxXI::InsertString(int nIndex, LPCTSTR lpszString, int nImageIndex)
{
    int nRet = CListBox::InsertString(nIndex, lpszString);
    if (nRet != LB_ERR && nRet != LB_ERRSPACE)
    {
        LBDataXI *pData = new LBDataXI();
        pData->iImageIndex = nImageIndex;
        pData->pData = NULL;
        CListBox::SetItemData(nIndex, (DWORD_PTR)pData);
    }

    return nRet;
}

//---------------------------------------------------------
// 函数: DeleteString
// 功能: 删除项
// 参数: 
//       nIndex  --- 索引
// 返回: 
//       成功则返回当前还剩的项数
//       失败则返回LB_ERR
//---------------------------------------------------------
int CListBoxXI::DeleteString(UINT nIndex)
{
    DeleteItemData(nIndex);

    return CListBox::DeleteString(nIndex);
}

//---------------------------------------------------------
// 函数: ResetContent
// 功能: 清空内容
//---------------------------------------------------------
void CListBoxXI::ResetContent()
{
    int nCnt = CListBox::GetCount();
    for (int i = 0; i < nCnt; ++i)
    {
        DeleteItemData(i);
    }

    CListBox::ResetContent();
}

//---------------------------------------------------------
// 函数: GetItemData
// 功能: 获取项关联的数据
// 参数:
//       nIndex --- 索引
// 返回:
//       关联的数据,失败则返回LB_ERR
//---------------------------------------------------------
DWORD_PTR CListBoxXI::GetItemData(int nIndex) const
{
    LBDataXI* pLBData = (LBDataXI*)CListBox::GetItemData(nIndex);
    if (pLBData == (LBDataXI*)LB_ERR || pLBData == NULL)
    {
        return LB_ERR;
    }

    return (DWORD_PTR)pLBData->pData;
}

//---------------------------------------------------------
// 函数: SetItemData
// 功能: 设置项关联的数据
// 参数:
//       nIndex     --- 索引
//       dwItemData --- 关联的数据 
// 返回:
//       成功返回LB_OKAY, 失败返回LB_ERR
//---------------------------------------------------------
int CListBoxXI::SetItemData(int nIndex, DWORD_PTR dwItemData)
{
    LBDataXI* pLBData = (LBDataXI*)CListBox::GetItemData(nIndex);
    if (pLBData == (LBDataXI*)LB_ERR || pLBData == NULL)
    {
        return LB_ERR;
    }

    pLBData->pData = (LPVOID)dwItemData;
    return LB_OKAY;
}

//---------------------------------------------------------
// 函数: GetItemDataPtr
// 功能: 获取项关联的数据
// 参数:
//       nIndex --- 索引
// 返回:
//       关联的数据,失败则返回LB_ERR
//---------------------------------------------------------
void* CListBoxXI::GetItemDataPtr(int nIndex) const
{
    LBDataXI* pLBData = (LBDataXI*)CListBox::GetItemDataPtr(nIndex);
    if (pLBData == (LBDataXI*)LB_ERR || pLBData == NULL)
    {
        return (void*)LB_ERR;
    }

    return pLBData->pData;
}

//---------------------------------------------------------
// 函数: SetItemDataPtr
// 功能: 设置项关联的数据
// 参数:
//       nIndex --- 索引
//       pData  --- 关联的数据
// 返回:
//       成功返回LB_OKAY, 失败则返回LB_ERR
//---------------------------------------------------------
int CListBoxXI::SetItemDataPtr(int nIndex, void* pData)
{
    LBDataXI* pLBData = (LBDataXI*)CListBox::GetItemDataPtr(nIndex);
    if (pLBData == (LBDataXI*)LB_ERR || pLBData == NULL)
    {
        return LB_ERR;
    }

    pLBData->pData = pData;
    return LB_OKAY;
}

void CListBoxXI::DeleteItemData(int nIndex)
{
    LBDataXI* pLBData = (LBDataXI*)CListBox::GetItemData(nIndex);
    if (pLBData != (LBDataXI*)LB_ERR)
    {
        delete pLBData;
        CListBox::SetItemData(nIndex, (DWORD_PTR)NULL);
    }
}

void CListBoxXI::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
    CDC* pDC = CDC::FromHandle(lpDrawItemStruct->hDC);
    pDC->SetBkMode(TRANSPARENT);
    RECT& rcItem = lpDrawItemStruct->rcItem;

    CString cstrItemText;
    CListBox::GetText(lpDrawItemStruct->itemID, cstrItemText);

    LBDataXI* pData = (LBDataXI*)CListBox::GetItemDataPtr(lpDrawItemStruct->itemID);
    if (NULL == pData)
    {
        return;
    }

    // 是否处于选中状态
    BOOL bIsSelected = (lpDrawItemStruct->itemAction | ODA_SELECT) 
        && (lpDrawItemStruct->itemState & ODS_SELECTED);

    // 是否处于焦点状态
    BOOL bIsFocused = (lpDrawItemStruct->itemAction | ODA_FOCUS) 
        && (lpDrawItemStruct->itemState & ODS_FOCUS);

    // 绘制背景
    if (bIsSelected)
    {
        COLORREF oldColor = pDC->GetBkColor();
        pDC->FillSolidRect(&rcItem, ::GetSysColor(COLOR_HIGHLIGHT));
        pDC->SetBkColor(oldColor);
    }
    else
    {
        pDC->FillSolidRect(&rcItem, pDC->GetBkColor());
    }

    // 绘制ICON
    CRect rcIcon(rcItem.left, rcItem.top, rcItem.left, rcItem.top);
    if (m_pImageList)
    {
        HICON hIcon = m_pImageList->ExtractIcon(pData->iImageIndex);
        if (hIcon)
        {
            rcIcon.right = rcItem.left + m_imageSize.cx + 2 * LBXI_CX_BORDER;
            rcIcon.bottom = rcItem.top + m_imageSize.cy + 2 * LBXI_CY_BORDER;

            CPoint pos(rcIcon.left + LBXI_CX_BORDER, rcIcon.top + LBXI_CY_BORDER);
            pDC->DrawState(pos, m_imageSize, hIcon, DSS_NORMAL, (CBrush*)NULL);
            ::DestroyIcon(hIcon);
        }
    }

    // 绘制Text
    if (bIsSelected)
    {
        pDC->SetTextColor(::GetSysColor(COLOR_HIGHLIGHTTEXT));
    }
    else
    {
        pDC->SetTextColor(::GetSysColor(COLOR_WINDOWTEXT));
    }
    CRect rcText(rcItem);
    rcText.left = rcIcon.right;
    rcText.top = rcIcon.top;
    pDC->DrawText(cstrItemText, rcText, DT_LEFT | DT_VCENTER | DT_SINGLELINE | DT_WORDBREAK);
}

void CListBoxXI::MeasureItem(LPMEASUREITEMSTRUCT lpMeasureItemStruct)
{
    CDC *pDC = GetDC();
    LPCTSTR lpszText = (LPCTSTR)lpMeasureItemStruct->itemData;
    CSize szText = pDC->GetTextExtent(lpszText);
    ReleaseDC(pDC);

    lpMeasureItemStruct->itemHeight = 
        szText.cy > m_imageSize.cy + 2 * LBXI_CY_BORDER ? szText.cy :  m_imageSize.cy + 2 * LBXI_CY_BORDER;
}

BEGIN_MESSAGE_MAP(CListBoxXI, CListBox)
END_MESSAGE_MAP()

// CListBoxXI message handlers
ListBox自绘
04-20
对listbox的一个基本要求的自绘，VS2005下编译通过，包括改变item的高度，默认背景色，点击item时的背景及文字背景色的更改。还可做更多的扩展，这里只是基本的自绘示例。
自绘Clistbox控件实现小图标显示
最新发布
weixin_34535286的博客
07-30 965
要掌握CListbox控件的自绘技术，首先需要了解MFC的消息映射机制，然后需要重写控件的消息处理函数，如OnDrawItem和，以便在这些函数中编写自定义的绘制代码。此外，还需要熟悉如何处理图标和文字信息的绘制，并配置合适的控件风格，以确保自绘制的视觉效果符合设计要求。本章将详细介绍自绘CListbox控件的每个步骤，并提供代码示例，帮助读者快速掌握相关技术。CListCtrl类是MFC（Microsoft Foundation Classes）库中用于创建和操作列表控件的一个重要类。它是。
WPF学习笔记（21）ListBox、ListView与控件模板
lzt1027的博客
07-02 466
ltemsPresenter类在控件模板中显示集合数据的一个占位符，以便在运行时将其替换为所有集合数据。而ContentPresenter则只能显示单一内容。
【自绘ListBox之一】带Icon的ListBox控件
Hisin Wang的专栏
11-17 3115
参考： CListBoxST源码 Demo源程序： CIconListBox_demo Demo程序图片: 使用示例: 手动更改ListBox控件的属性如下，因为以下特性不能通过代码动态修改。 m_listbox.AddString(TEXT("123"), IDI_ICON_1); m_listbox.AddString(TEXT("456"), IDI_ICON_2); m_listbox
LISTBOX自绘带图标功能
02-27
继承MFC中的CLISTBOX类，VC6中开发。多了显示图标功能，有源代码，可拿去直接用。
自绘Clistbox 每行显示小图标
02-04
本资源是自画clistbox控件，实现在每行的左面显示图标右面显示文字，类似qq的好友列表
自绘制listbox
weixin_34124577的博客
02-01 288
2019独角兽企业重金招聘Python工程师标准>>> ...
自绘透明ListBox
liulina603的专栏
05-31 3115
下载源代码 整体效果图： (先放背景图，再放listbox控件，否则有问题） 一. 前言     任何一个有经验的windows工程师都觉得在windows中，透明度不是一个很细小的任务。一个透明的listbox控件也不例外。事实上ListBox会比其他控件难一点。原因是ListBox自带滚动条。但是总体来说，实现起来是一个非常简单的概念。     例如，实现一个透明的static
ListBox自绘模式的实现
DVBStudio的专栏
02-05 2803
本文介绍LisBox的自绘模式的实现.Listbox分为单列模式和多列模式.ListBox,Button等的自绘模式都是通过重载WM_DRAWITEM消息实现.以下代码为MiniWin-GUI系统的实现,WIN32通用本文实现为单列模式,多列模式的实现只需要在创建ListBox控件的时候指定LBS_MULTICOLUMN样式.并通过LB_SETCOLUMNWIDTH消息设置没列的宽度,就可,对
mfc listbox简单自绘
03-17
在实际项目中，自绘Listbox可以用于实现各种定制效果，比如带有图标的列表项、渐变背景、自定义字体样式等。通过结合MFC的消息机制和GDI绘图功能，可以创造出极具特色的用户界面。 通过阅读和理解上述内容，你应该...
实现带图标自绘功能的ListBox控件教程
带ICON的自绘ListBox允许开发者对图标进行位置调整、大小缩放以及与其他绘图内容的组合。 ### 标签知识点： #### MFC 自绘ListBox MFC（Microsoft Foundation Classes）是一个C++库，它封装了Windows API，并提供...
给listbox 列表项加图标(图片)
10-05
在baidu和google上，VB6给listbox 加图标（图片）的程序一个都没有，只好自已编了一个程序，补了VB6空白。不足三十行代码程序，非常巧妙给VB6自带的listbox控件加上了图标，图标可以是任意图片！程序代码简洁明了，一看就懂，其中涉及如何改变列表项的行间距。
CListBox自绘
11-15
自绘的实现，以此为基础画出自己的控件。实现自己的需求
实现在listbox中加入图标
07-17
实现在listbox中加入图标，vc6.0平台
VC Listbox自绘，实现不同高度以及自动换行
02-14
VC Listbox自绘，实现不同高度以及自动换行，我是使用VC6.0写的
ListBox的自绘
03-19
重写ListBox类，实现自动换行，改写MeasureItem和DrawItem两个函数即可
带ICON的自绘ListBox
11-17
在这个场景中，"带ICON的自绘ListBox"是指一个特殊的ListBox控件，它不仅能够显示文本，还能显示图标，增强了用户界面的视觉效果。这种自绘技术允许程序员自定义控件的外观，超越了标准控件的默认样式。 自绘...
自绘 ListBox
09-25
这两个类会处理自绘ListBox的相关逻辑，包括消息处理、绘制方法等。 `stdafx.cpp`和`stdafx.h`包含预编译头文件，这些文件通常包含常用库的引用和宏定义，以提高编译速度。 `CustDrawListBox.vcxproj.filters`是...
今天发现里一个非常好用的Listbox自绘类，带不同文字字体和图片，觉得很有必要记下来...
heshaai6843的博客
07-02 887
代码简写 MyListBox.h class CUseListBox : public CListBox { typedef struct _ListBox_Data { CString strAppend; //第二排附加数据 LPTSTR hIcon; //图标 _ListBox_Data(...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值