MFC控件——ListCtrl控件[翻译]

元旦发帖&＃xff0c;首先祝大家元旦快乐&＃xff01;

声明&＃xff1a;

1、本文为翻译文章&＃xff0c;水平有限&＃xff0c;错误之处&＃xff0c;烦请指正(chinajiezhang&＃64;gmail.com)。

2、使用VS2005&＃xff0c;所以在某些细节上和原作者不太一样

3、工程中使用图片和作者略有不同

4、文章如有争议&＃xff0c;以原作者文章为准

5、转载请标明出处

原文链接&＃xff1a;http://www.functionx.com/visualc/controls/listcontrol.htm

一、ListControl概述

概述&＃xff1a;

ListCtrl控件由四种列表的显示方式构成&＃xff0c;它最典型的用法是使用icon来显示。ListCtrl通常显示下面四种项目(item)&＃xff1a;

Icons: 控件显示项的列表&＃xff0c;使用32*32&＃xff08;像素&＃xff09;大小的icons&＃xff0c;推荐使用这么大小的icon&＃xff0c;如果你想用图标来概述你的观点。

Small Icons&＃xff1a;和剩下的两项相似的想法&＃xff0c;它使用16*16&＃xff08;像素&＃xff09;大小的图标来显示一个单一的列表项。再次&＃xff0c;没有提供关于这个列表的详细说明。这种列表是用来组织和其他主题在不同的列&＃xff0c;如果列表有序&＃xff0c;序列编排为按字母顺序从左到右。

List:这种列表&＃xff0c;使用small icons&＃xff0c;也是组织列&＃xff1b;这种情况下&＃xff0c;在第二列填充之前必须填充第一列。如果列表有序&＃xff0c;序列编排为自顶向下的顺序。

Report&＃xff1a;安排项的目的是提供列表开发者的信息。

二、实践学习&＃xff1a;List Control介绍

1&＃xff0e; 用Visual C&＃43;&＃43;或者Visual Studio 创建一个名为DeptStore2的MFC应用程序

2&＃xff0e; 基于Dialog创建它

3&＃xff0e; 删除“TODO: 在此放置对话框控件。”行和确定按钮。

4&＃xff0e; 将“取消”按钮的标题改为“关闭”

&＃xff08;1&＃xff09;      创建List Control

ListCtrl控件在MFC类库用CListCtrl类来实现。在设计的时候&＃xff0c;创建一个ListCtrl&＃xff0c;在toolbox中点击按钮 后单击对话框中想要放置的区域。通常来说&＃xff0c;需要拉伸默认ListCtrl的默认大小&＃xff0c;因为它通常需要一个更大的区域。

为了编程创建一个ListCtrl&＃xff0c;声明CListCtrl变量或者CListCtrl指针。初始化控件调用它的Create方法&＃xff0c;示例如下&＃xff1a;

译者提示&＃xff1a;这是内存泄露的做法&＃xff0c;也许作者意图只是为了说明应在OnInitDialog添加代码&＃xff0c;正确的做法在CDeptStore2Dlg中添加变量m_lstCtrl&＃xff0c;之后在OnInitDialog中new&＃xff0c;最后在析构函数中delete。

在之前提到&＃xff0c;ListCtrl可以显示四种情况之一&＃xff0c;在设计的时候应该在窗口属性中指定想要的风格&＃xff0c;在属性中选择combo box,默认值是Icon&＃xff0c;他可能是情况是&＃xff1a;

Icon:当编程创建控件的时候&＃xff0c;增加LVS_ICON风格&＃xff1b;

Small Icon:类似的可以动态添加LVS_SMALLICON风格&＃xff1a;

List&＃xff1a;当创建的时候可以类似的添加LVS_REPORT风格&＃xff1b;

Report:这种情况清楚的显示了列&＃xff0c;同样应添加LVS_REPORT风格。

除了常规的几种风格外&＃xff0c;Win32类库为ListCtrl提供了扩展风格&＃xff0c;提供了一个扩展风格&＃xff0c;调用CListCtrl::SetExtendStyle()方法&＃xff0c;它的语法为&＃xff1a;

DWORD SetExtendedStyle(DWORD dwNewStyle);

当调用这个函数的时候&＃xff0c;把指定的扩展风格或者他们的组合风格作为参数来传递。其中的一些值是&＃xff1a;

LVS_EX_CHECKBOXES:在左侧显示选择框(check box)

LVS_EX_FULLROWSELECT&＃xff1a;这种风格允许Report View的整行来被选择而不是仅仅一项&＃xff1b;

LVS_EX_GRIDLINES:相对上一种风格来说增加了水平和垂直分割线。

LVS_EX_TRACKSELECT&＃xff1a;当设置这种风格的时候&＃xff0c;用户可以隔项选取。

列表控件仅仅能在控件内显示&＃xff0c;如果这儿他们太多或者各项的总宽度比控件可以显示的区域大&＃xff0c;应该给它配备水平滚动条和垂直滚动条&＃xff0c;或者两个都有。如果你想阻止滚动条的显示&＃xff0c;设置无滚动条的属性为true或者创建属性为LVS_NOSCROLL风格。

一旦list控件创建&＃xff0c;使用者可以选择一个选项通过点击它&＃xff0c;然后选择更多的项&＃xff0c;使用者也可以辅助ctrl来随机选择或者辅助shift连续选取&＃xff0c;下面是一个随机选取的一个样例&＃xff1a;

如果你不想用户每次选择多项的话&＃xff0c;你可以设置通过增加LVS_SINGLESEL单选属性为true。

任何项被选中的时候都是高亮的&＃xff0c;当用户点击另一个控件或者另一个应用程序的时候&＃xff0c;你是否可以确定你想那些被选项仍旧被选中呢&＃xff1f;典型的情况是在设计的时候通过选择“Always”属性来实现。默认情况下&＃xff0c;设置为false&＃xff0c;意味着当控件失去焦点或者它的父窗口无效的情况下&＃xff0c;被选项将不会显示&＃xff08;高亮&＃xff09;。否则&＃xff0c;你可以把这个属性设置为true&＃xff0c;这样即使它失去焦点也也可以是选中状态。这个属性也可以通过设置LVS_SHOWSELALWAYS风格来实现。

三、实践学习&＃xff1a;创建一个ListCtrl

1.在ToolBox上&＃xff0c;单击ListCtrl控件然后点击对话框&＃xff0c;将ID改为IDC_STORE_ITEMS

2.右击控件&＃xff0c;添加变量

3.设置变量为:m_StoreItems

4.点击完成

ListCtrl的项

通过添加&＃xff08;使用toolboax&＃xff09;或者动态创建一个ListCtrl之后&＃xff0c;下一个环节你应该让它来显示项。这个可以通过调用CListCtrl::InsertItem()方法&＃xff0c;它的一种声明如下&＃xff1a;

int InsertItem(const LVITEM* pItem);

这个版本需要一个LVITEM的指针作为参数&＃xff0c;LVITEM定义如下&＃xff1a;

mask&＃xff1a;用来指定你想给当前项设置的类型。

iItem:指定改变项的索引&＃xff0c;第一个item应该为0&＃xff0c;第二个item为1等等。

iSumItem:当前值的的子项&＃xff0c;如果当前项是主导项&＃xff0c;iSumItem应该存储从0开始的数组。

pszText&＃xff1a;要显示项的字符串&＃xff0c;你可以通过cchTextMask指定文本的长度。

初始化LVITEM之后&＃xff0c;调用InsertItem()方法来为list添加一个项。以下是范例&＃xff1a;

LVITEM结构体的值将决定新项的功能。例如&＃xff0c;一旦增加了一个项&＃xff0c;你可能想要准备删除前面的项、剪切和粘贴操作&＃xff0c;在这种情况下&＃xff0c;你应该将设置为LVIS_CUT&＃xff1b;如果你想实现拖放操作&＃xff0c;你可以设置LVIS_DROPHILIGHTED&＃xff1b;如果想让项获得焦点&＃xff0c;设置LVIS_FOCUSED&＃xff1b;包含LVIS_SELECTED属性的情况下可以被选中。

除了上面的CListCtrl::InsertItem()版本&＃xff0c;CListCtrl类还提供了如下版本&＃xff1a;

int InsertItem(int nItem, LPCTSTR lpszItem);

这是一个早期最简洁的版本。nItem表示新增项的索引。和LVITEM::iItem成员类似&＃xff0c;如果参数为0&＃xff0c;新增项是首项。lpszItem参数值是当前项内容的字符串。

四、实战学习&＃xff1a;构建(Populating)ListCtrl

1&＃xff0e;             新建一个dialog box&＃xff0c;选择主菜单项->右击工程->增加资源

2&＃xff0e;             在增加资源对话框中选择dialog

3&＃xff0e;             修改对话框的ID为&＃xff1a;IDD_STOREITEMS_DLG

4&＃xff0e;             设计对话框如下&＃xff1a;

5.　　　　右击对话框&＃xff0c;选择添加类

6&＃xff0e;　　　 设置类的名字为CNewStoreItemDlg基类为CDialog

7.　　　　点击完成

8.　　　　为edit control增加一个CString变量&＃xff0c;命名为m_ItemNumber

9.　　　　切换到第一个对话框&＃xff0c;在ListCtrl下面&＃xff0c;增加一个按钮&＃xff0c;设置它的属性如下&＃xff1a;

标题&＃xff1a;新建项

ID:IDC_NEWITEM

10.　　双击新建项按钮&＃xff0c;生成它的OnBnClicked事件。

11.　　在文件的前面&＃xff0c;键入&＃xff1a;#include "NewStoreItemDlg.h"

12.　　 如下实现事件内容&＃xff1a;

13&＃xff0e;　　运行应用程序&＃xff0c;测试新建项

报告方式显示&＃xff08;The Report View&＃xff09;

无论你是用第一还是第二个版本&＃xff0c;InsertItem只允许你去创建你要显示的图标&＃xff0c;小图标&＃xff0c;或者控件的List Views的项。如果你计划去显示在Report View&＃xff08;或者允许用户在几种显示方式中转换&＃xff09;或者你想要提供更多的信息为每一个项&＃xff0c;你必须要创建一个关于每一个项信息的报告。

在ListCtrl可能的显示方式中&＃xff0c;其中有一种可以显示列。这种使用报告的方式。这种方式不需要一个列表&＃xff0c;而是提供一个列表的项的详细信息。如果你打算在你的ListCtrl控件中显示&＃xff0c;那么你应该去创建列。&＃xff08;要么&＃xff0c;你可以省略创建列而是每个分离的列的首项&＃xff0c;可以使用CHeaderCtrl类来实现。否则&＃xff0c;ListCtrl提供创建列为它的报告显示&＃xff09;

To create the column(s) of a list control, you can use the CListCtrl::InsertColumn() method. One of its syntaxes is:

创建一个ListCtrl的列&＃xff0c;你可以使用CListCtrl::InsertColumn()方法&＃xff0c;它的一种声明为&＃xff1a;

int InsertColumn(int nCol, const LVCOLUMN* pColumn);

nCol:将要创建列的索引

pColumn:指向LVCOLUMN结构体指针&＃xff0c;结构体定义如下&＃xff1a;

mask: 用来指定你想要的列的属性

Fmt: 格式化列的文本。例如&＃xff0c;它可以使列左对齐&＃xff08;默认值LVCFMT_LEFT&＃xff09;&＃xff0c;居中&＃xff08;LVCFMT_CENTER&＃xff09;&＃xff0c;或者右对齐&＃xff08;LVCFMT_RIGHT&＃xff09;。如果你想为这个值设置一个值&＃xff0c;那么在初始化mask变量的时候增加LVCF_FMT属性。

cx 用来指定列文本的宽度。如果你初始化&＃xff0c;它的长度将被初始化为刚好能显示文本的长度。因此&＃xff0c;除非你有一个好的理由去省略它&＃xff0c;你应该总是指定它的值。如果你打算去初始化这个值&＃xff0c;那么在初始化mask变量的时候增加LVCF_WIDTH属性。

pszText 是将要显示的列的字符串。和其他成员一样&＃xff0c;此变量不是必须要初始化的&＃xff0c;除了每一个列的第一个元素。这个成员可能是最重要的列的特征&＃xff0c;因为它告诉用户这一列的作用。它的值是一个"\0"结尾的字符串。和其他MFC应用程序中的字符串一样&＃xff0c;该字符串可以是一个字符串表项。它也可以从一个字符串数组中获取。为此变量初始化值&＃xff0c;在初始化mask时应增加LVCF_TEXT变量&＃xff0c;它的长度可以通过cchTextMax成员来设置。

初始化LVCOLUMN之后&＃xff0c;把它作为InsertColumn的第二个参数进行传递。下面是示例&＃xff1a;

&＃xff08;译者注&＃xff1a;需要修改ListCtrl为Report型&＃xff09;

iOrder:用来标识列的地址&＃xff08;列的索引&＃xff09;

你也可以用CListCtrl::InsertColumn()方法的另一个版本&＃xff0c;你可以用下面的版本&＃xff0c;来为控件创建列&＃xff1a;

这个版本是上个版本的简化版。

nCol: 列的索引&＃xff0c;必须要指定的&＃xff1b;

lpszColumnHeading:在列的开始要显示的字符串&＃xff0c;和LVCOLUMN::pszText成员相似&＃xff1b;

nFormat&＃xff1a;用来指定lpszColumnHeading的水平对齐方式。默认为左对齐(LVCFMT_LEFT)&＃xff0c;居中为LVCFMT_CENTER&＃xff0c;右对齐为LVCFMT_RIGHT&＃xff1b;

nWidth:以像素为单位来设定列的宽度&＃xff0c;如果你不想指定它的大小&＃xff0c;可设置为-1&＃xff1b;

nSubItem:用来设定当前列子项的索引。

列配置好之后&＃xff0c;你必须要提供在特定列下显示的字符串项。为了实现这一功能&＃xff0c;你必须先设定你要增加项的信息。InsertColumn()方法将会返回一个整形值来标识你增加列的信息。接着为每一列指定将要显示的项的字符串&＃xff0c;调用CListCtrl::SetItemText()方法。它的声明为&＃xff1a;

BOOL SetItemText(int nItem, int nSubItem, LPTSTR lpszText);

nItem:你要增加行的索引&＃xff0c;它可以通过InsertColumn()的返回值获得。每一项的信息存储在一个以"\0"结尾的数组。

nSubItem:当前项所在的位置。&＃xff08;译者注&＃xff1a;通过nItem和nSumItem确定项的位置&＃xff0c;在平面中第nItem行&＃xff0c;第nSumItem列&＃xff09;

lpszText:当前项的信息

示例&＃xff1a;

未完&＃xff0c;待续……