01、文章目录
文章目录
02、List Control介绍
列表视图控件List Control同样比较常见,它能够把任何字符串内容以列表的方式显示出来,这种显示方式的特点是整洁、直观,在实际应用中能为用户带来方便。
列表视图控件是对列表框控件List Box的改进和延伸。列表视图控件的列表项一般有图标(Icon)和标签(Label)两部分。图标是对列表项的图形描述,标签是文字描述。当然列表项可以只包含图标也可以只包含标签,这个是可以自己规定的。
List Box后面再说了,我没时间写,先应付工作先,边学边写。
列表视图控件有4种风格:Icon、Small Icon、List和Report。下面简单说下4种风格各自的特点:
- Icon大图标风格:列表项的图标通常为32×32像素,在图标的下面显示标签。
- Small Icon小图标风格:列表项的图标通常为16×16像素,在图标的右面显示标签。
- List列表风格:与小图标风格类似,图标和文字的对齐方式不同。
- Report报表风格:列表视图控件可以包含一个列表头来描述各列的含义。每行显示一个列表项,通常可以包含多个列表子项。最左边的列表子项的标签左边可以添加一个图标,而它右边的所有子项则只能显示文字。这种风格的列表视图控件很适合做各种报表。(也是我目前需要的)
03、List Control的通知消息
在MFC消息映射机制中的“各种Windows消息的消息处理函数”部分,就曾以列表视图控件为例简单讲了WM_NOTIFY通知消息及其消息映射入口和消息处理函数的形式。如果你忘记了可以跳转到那篇文章看一看,了解一下。
这里给出下面将要演示的列表视图控件实例中,通知码为NM_CLICK的通知消息的消息映射入口:
ON_NOTIFY(NM_CLICK, IDC_PROGRAM_LANG_LIST, &CExample29Dlg::OnNMClickProgramLangList)
还有消息处理函数自动生成时的形式:
void CExample29Dlg::OnNMClickProgramLangList(NMHDR *pNMHDR, LRESULT *pResult)
{
LPNMITEMACTIVATE pNMItemActivate = reinterpret_cast<LPNMITEMACTIVATE>(pNMHDR);
// TODO: Add your control notification handler code here
*pResult = 0;
}
我们看到,上面的代码中将NMHDR指针类型的pNMHDR强制转换为LPNMITEMACTIVATE类型的pNMItemActivate,那么我们就可以在函数中通过pNMHDR来访问NMHDR结构,也可以通过pNMItemActive指针变量来访问第一个元素为NMHDR结构体变量的扩充结构。
当然列表视图控件还有一些自己特有的通知消息,下面就介绍几个其中比较常用的。
LVN_ITEMCHANGING 和LVN_ITEMCHANGED:当列表视图的状态发生变化时,会发送这两个通知消息。例如,当用户选择了新的列表项时,程序就会收到这两个消息。
消息会附带一个指向NMLISTVIEW 结构的指针,消息处理函数可从该结构中获得状态信息。两个消息的不同之处在于,前者的消息处理函数如果返回TRUE,那么就阻止选择的改变,如果返回FALSE,则允许改变。
LVN_KEYDOWN:该消息表明了一个键盘事件。消息会附带一个指向NMLVKEYDOWN结构的指针,通过该结构程序可以获得按键的信息。
LVN_BEGINLABELEDIT 和LVN_ENDLABELEDIT:分别在用户开始编辑和结束编辑标题时发送。消息会附带一个指向NMLVDISPINFO结构的指针。在前者的消息处理函数中,可以调用GetEditControl成员函数返回一个指向用于编辑标题的编辑框的指针,如果处理函数返回FALSE,则允许编辑,如果返回TRUE,则禁止编辑。在后者的消息处理函数中,NMLVDISPINFO结构中的item.pszText指向编辑后的新标题,如果pszText 为NULL,那么说明用户放弃了编辑,否则,程序应负责更新表项的标题,这可以由SetItem或SetItemText函数来完成。
04、List Control的相关结构体
下面我们来介绍一下与列表视图控件有关的一些结构体。
- NMHDR结构体
C++代码:
typedef struct tagNMHDR {
HWND hwndFrom; // 控件窗口的句柄
UINT_PTR idFrom; // 控件ID
UINT code; // 控件的通知消息码
} NMHDR;
此结构体在很多情况下都是其他扩充结构体的第一个元素,比如上面的NMITEMACTIVATE结构体:
C++代码:
ypedef struct tagNMITEMACTIVATE {
NMHDR hdr;
int iItem;
int iSubItem;
UINT uNewState;
UINT uOldState;
UINT uChanged;
POINT ptAction;
LPARAM lParam;
UINT uKeyFlags;
} NMITEMACTIVATE, *LPNMITEMACTIVATE;
- LVITEM
该结构体包含了列表视图控件中列表项或列表子项的各种属性。
C++代码:
typedef struct _LVITEM {
UINT mask; // 掩码位的组合(下面有对应掩码的元素都已在括号中标出掩码),表明哪些元素是有效的
int iItem; // 列表项的索引
int iSubItem; // 列表子项的索引
UINT state; // 状态,下面会列出。(LVIF_STATE)
UINT stateMask; // 状态掩码,用来说明要获取或设置哪些状态。下面会列出
LPTSTR pszText; // 指向列表项或列表子项的标签字符串。(LVIF_TEXT)
int cchTextMax; // pszText指向缓冲区的字符的个数,包括字符串结束符。(LVIF_TEXT)
int iImage; // 图标的索引。(LVIF_IMAGE)
LPARAM lParam; // 32位的附加数据。(LVIF_PARAM)
#if (_WIN32_IE >= 0x0300)
int iIndent;
#endif
#if (_WIN32_WINNT >= 0x501)
int iGroupId;
UINT cColumns; // tile view columns
PUINT puColumns;
#endif
#if (_WIN32_WINNT >= 0x0600)
int* piColFmt;
int iGroup;
#endif
} LVITEM, *LPLVITEM;
下面是state和stateMask的取值及含义:
状态 | 对应的状态掩码 | 含义 |
---|---|---|
LVIS_CUT | 同左 | 列表项或列表子项被选择用来进行剪切和粘贴操作 |
LVIS_DROPHILITED | 同左 | 列表项或列表子项成为拖动操作的目标 |
LVIS_FOCUSED | 同左 | 列表项或列表子项具有输入焦点 |
LVIS_SELECTED | 同左 | 列表项或列表子项被选中 |
- LVCOLUMN结构体
该结构体仅适用于Report报表式列表视图控件。在向列表控件中插入一列时需要用到此结构体。它包含了列表控件某列的各种属性。
C++代码:
typedef struct _LVCOLUMN {
UINT mask; // 掩码位的组合(下面有对应掩码的元素都已在括号中标出掩码),表明哪些元素是有效的
int fmt; // 该列的表头和列表子项的标签正文显示格式,可以是LVCFMT_CENTER、LVCFMT_LEFT或LVCFMT_RIGHT。(LVCF_FMT)
int cx; // 以像素为单位的列的宽度。(LVCF_FMT)
LPTSTR pszText; // 指向列表头标题正文的字符串。(LVCF_TEXT)
int cchTextMax; // pszText指向缓冲区的字符的个数,包括字符串结束符。(LVCF_TEXT)
int iSubItem; // 该列的索引。(LVCF_SUBITEM)
#if (_WIN32_IE >= 0x0300)
int iImage;
int iOrder;
#endif
#if (_WIN32_WINNT >= 0x0600)
int cxMin;
int cxDefault;
int cxIdeal;
#endif
} LVCOLUMN, *LPLVCOLUMN;
显然这正是我要用到的结构体。
- NMLISTVIEW结构体
该结构体存放了列表视图控件通知消息的相关信息。列表视图控件的大部分通知消息都会附带指向该结构体的指针。
C++代码:
typedef struct tagNMLISTVIEW {
NMHDR hdr; // 标准的NMHDR 结构
int iItem; // 列表项的索引
int iSubItem; // 列表子项的索引
UINT uNewState; // 列表项或列表子项的新状态
UINT uOldState; // 列表项或列表子项原来的状态
UINT uChanged; // 取值与LVITEM的mask成员相同,用来表明哪些状态发生了变化
POINT ptAction; // 事件发生时鼠标的客户区坐标
LPARAM lParam; //32位的附加数据
} NMLISTVIEW, *LPNMLISTVIEW;
05、List Control的创建
MFC同样为列表视图控件的操作提供了CListCtrl类。
如果我们不想在对话框模板中直接拖入List Control来使用列表视图控件,而是希望动态创建它,则要用到CListCtrl类的成员函数Create函数,原型如下:(这里只做简单介绍,一般不用这种方式,除非原生控件)
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID
);
参数介绍:
- rect:列表视图控件的位置和尺寸
- pParentWnd:指向父窗口的指针
- nID:指定列表视图控件的ID
- dwStyle:用于设定列表视图控件的风格
每次说到原生创建方法,总是有dwStyle,很复杂,这里介绍一下,基本都是用标准的,很少有人用其他类型。
与前面的控件一样,除了以上风格一般我们还要为列表视图控件设置WS_CHILD和WS_VISIBLE风格。对于直接在对话框模板中创建的列表视图控件,其属性页中的属性与上述风格是对应的,例如,属性Alignment默认为Left,也就等价于指定了LVS_ALIGNLEFT风格。
06、CListCtrl类的主要成员函数
CListCtrl类有很多成员函数,这里就为大家介绍几个常用的主要成员函数。
-
UINT GetSelectedCount( ) const;
该函数返回列表视图控件中被选择列表项的数量。 -
POSITION GetFirstSelectedItemPosition( ) const;
获取列表视图控件中第一个被选择项的位置。返回的POSITION值可以用来迭代来获取其他选择项,可以当作参数传入下面的GetNextSelectedItem函数来获得选择项的索引。如果没有被选择项则返回NULL。 -
int GetNextSelectedItem(POSITION& pos) const;
该函数获取由pos指定的列表项的索引,然后将pos设置为下一个位置的POSITION值。参数pos为之前调用GetNextSelectedItem或GetFirstSelectedItemPosition得到的POSITION值的引用。返回值就是pos指定列表项的索引。 -
int GetItemCount( ) const;
获取列表视图控件中列表项的数量。 -
int InsertColumn(int nCol,const LVCOLUMN* pColumn ); int InsertColumn(int nCol,LPCTSTR lpszColumnHeading,int nFormat = LVCFMT_LEFT,int nWidth = -1,int nSubItem = -1 );
这两个函数用于在报表式列表视图控件中插入列。第一个函数中,nCol参数为插入列的索引,pColumn参数指向LVCOLUMN结构,其中包含了插入列的属性。第二个函数中,nCol参数也是插入列的索引,lpszColumnHeading参数为列标题字符串,nFormat参数为列中文本的对齐方式,可以是LVCFMT_LEFT、LVCFMT_RIGHT或LVCFMT_CENTER,nWidth参数为列宽,nSubItem为插入列对应列表子项的索引。两个函数在成功时都返回新列的索引,失败都返回-1。 -
BOOL DeleteColumn(int nCol);
该函数用于删除列表视图控件中的某列。参数nCol为删除列的索引。删除成功则返回TRUE,失败返回FALSE。 -
`int InsertItem(int nItem,LPCTSTR lpszItem);
向列表视图控件中插入新的列表项。参数nItem为要插入项的索引,参数lpszItem为要插入项的标签字符串。如果插入成功则返回新列表项的索引,否则返回-1。 -
BOOL DeleteItem(int nItem);
从列表视图控件中删除某个列表项。参数nItem指定了要删除的列表项的索引。删除成功则返回TRUE,否则返回FALSE。 -
CString GetItemText(int nItem,int nSubItem) const;
获取指定列表项或列表子项的显示文本。参数nItem指定了列表项的索引,参数nSubItem指定了列表子项的索引。
` -
BOOL SetItemText(int nItem,int nSubItem,LPCTSTR lpszText);
设置指定列表项或列表子项的显示文本。参数nItem和nSubItem同GetItemText。参数lpszText为要设置的显示文本字符串。如果设置成功则返回TRUE,否则返回FALSE。 -
DWORD_PTR GetItemData(int nItem) const;
该函数用于获取指定列表项的附加32位数据。参数nItem为列表项的索引。返回值就是由nItem指定列表项的附加32位数据。 -
BOOL SetItemData(int nItem,DWORD_PTR dwData);
该函数用于为指定列表项设置附加32位是数据。参数nItem为列表项的索引,参数dwData为列表项的附加32位数据。
07、代码实例
这里实例直接用的网上的,看了下,明白怎么用了就开始干活了。
给大家写一个简单的实例,说明CListCtrl类的几个成员函数及通知消息等的使用方法。因为在开发中最常用的要属报表风格的List Control了,所以给大家写的是一个报表List Control的例子。
此实例实现的功能:在单选列表视图控件中显示一个简单的编程语言排行榜,然后在用鼠标左键选择某列表项时,将选中列表项的文本显示到编辑框中。下面是具体实现步骤:
- 创建一个基于对话框的MFC工程,名称设置为“Example29”。
- 在自动生成的对话框模板IDD_EXAMPLE29_DIALOG中,删除“TODO: Place dialog controls here.”静态文本控件、“OK”按钮和“Cancel”按钮。添加一个List Control控件,ID设置为IDC_PROGRAM_LANG_LIST,View属性设为Report,即为报表风格,Single Selection属性设为True。再添加一个静态文本控件和一个编辑框,静态文本控件的Caption属性设为“选择的语言:”,编辑框的ID设为IDC_LANG_SEL_EDIT,Read Only属性设为True。此时的对话框模板如下图:
- 为列表视图控件IDC_PROGRAM_LANG_LIST添加CListCtrl类型的控件变量m_programLangList。
- 在对话框初始化时,我们将编程语言排行榜加入到列表视图控件中,那么需要修改CExample29Dlg::OnInitDialog()函数为:
C++代码:
BOOL CExample29Dlg::OnInitDialog()
{
CDialogEx::OnInitDialog();
// Add "About..." menu item to system menu.
// IDM_ABOUTBOX must be in the system command range.
ASSERT((IDM_ABOUTBOX & 0xFFF0) == IDM_ABOUTBOX);
ASSERT(IDM_ABOUTBOX < 0xF000);
CMenu* pSysMenu = GetSystemMenu(FALSE);
if (pSysMenu != NULL)
{
BOOL bNameValid;
CString strAboutMenu;
bNameValid = strAboutMenu.LoadString(IDS_ABOUTBOX);
ASSERT(bNameValid);
if (!strAboutMenu.IsEmpty())
{
pSysMenu->AppendMenu(MF_SEPARATOR);
pSysMenu->AppendMenu(MF_STRING, IDM_ABOUTBOX, strAboutMenu);
}
}
// Set the icon for this dialog. The framework does this automatically
// when the application's main window is not a dialog
SetIcon(m_hIcon, TRUE); // Set big icon
SetIcon(m_hIcon, FALSE); // Set small icon
// TODO: Add extra initialization here
CRect rect;
// 获取编程语言列表视图控件的位置和大小
m_programLangList.GetClientRect(&rect);
// 为列表视图控件添加全行选中和栅格风格
m_programLangList.SetExtendedStyle(m_programLangList.GetExtendedStyle() | LVS_EX_FULLROWSELECT | LVS_EX_GRIDLINES);
// 为列表视图控件添加三列
m_programLangList.InsertColumn(0, _T("语言"), LVCFMT_CENTER, rect.Width()/3, 0);
m_programLangList.InsertColumn(1, _T("2012.02排名"), LVCFMT_CENTER, rect.Width()/3, 1);
m_programLangList.InsertColumn(2, _T("2011.02排名"), LVCFMT_CENTER, rect.Width()/3, 2);
// 在列表视图控件中插入列表项,并设置列表子项文本
m_programLangList.InsertItem(0, _T("Java"));
m_programLangList.SetItemText(0, 1, _T("1"));
m_programLangList.SetItemText(0, 2, _T("1"));
m_programLangList.InsertItem(1, _T("C"));
m_programLangList.SetItemText(1, 1, _T("2"));
m_programLangList.SetItemText(1, 2, _T("2"));
m_programLangList.InsertItem(2, _T("C#"));
m_programLangList.SetItemText(2, 1, _T("3"));
m_programLangList.SetItemText(2, 2, _T("6"));
m_programLangList.InsertItem(3, _T("C++"));
m_programLangList.SetItemText(3, 1, _T("4"));
m_programLangList.SetItemText(3, 2, _T("3"));
return TRUE; // return TRUE unless you set the focus to a control
}
- 我们希望在选中列表项改变时,将最新的选择项实时显示到编辑框中,那么可以使用NM_CLICK通知消息。为列表框IDC_PROGRAM_LANG_LIST的通知消息NM_CLICK添加消息处理函数CExample29Dlg::OnNMClickProgramLangList,并修改如下:
void CExample29Dlg::OnNMClickProgramLangList(NMHDR *pNMHDR, LRESULT *pResult)
{
LPNMITEMACTIVATE pNMItemActivate = reinterpret_cast<LPNMITEMACTIVATE>(pNMHDR);
// TODO: Add your control notification handler code here
*pResult = 0;
CString strLangName; // 选择语言的名称字符串
NMLISTVIEW *pNMListView = (NMLISTVIEW*)pNMHDR;
if (-1 != pNMListView->iItem) // 如果iItem不是-1,就说明有列表项被选择
{
// 获取被选择列表项第一个子项的文本
strLangName = m_programLangList.GetItemText(pNMListView->iItem, 0);
// 将选择的语言显示与编辑框中
SetDlgItemText(IDC_LANG_SEL_EDIT, strLangName);
}
}
- 运行程序,弹出结果对话框,在对话框的列表框中用鼠标改变选中项时,编辑框中的显示会相应改变。效果图如下:
关于列表视图控件List Control的内容总算讲完了,内容不少,但实际上这些还只是一部分,在实际开发中会遇到各种问题,需要大家去查阅MSDN或上网找资料等来解决。
08、总结
由于工作需要,临时就写了一篇,在网上找各种资源,总结了一下。如果不全面,请网上查漏补缺。
版权声明:转载请注明出处,谢谢!