VC控件——ListControl

ListCtrl控件由四种列表的显示方式构成：

Icons: 控件显示项的列表，使用32*32（像素）大小的icons

Small
Icons：和剩下的两项相似的想法，它使用16*16（像素）大小的图标来显示一个单一的列表项

List:这种列表，使用small icons，也是组织列；这种情况下，在第二列填充之前必须填充第一列

Report：安排项的目的是提供列表开发者的信息

（1）
创建List Control

法1：列表初始化：

添加变量m_list .create(WS_CHILD|WS_VISIBLE,CRect(10,10,320,280),this,0x285;

创建控件的时候，增加LVS_ICON LVS_SMALLICON
LVS_REPORT LVS_REPORT等

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

DWORD SetExtendedStyle(DWORD dwNewStyle);

LVS_ALIGNLEFT 显示格式是大图标或小图标时，标签放在图标的左边

LVS_ALIGNTOP 显示格式是大图标或小图标时，标题放在图标的上边

LVS_AUTOARRANGE 显示格式是大图标或小图标时，自动排列控件中的列表项

LVS_EDITLABELS 用户可以修改标签文本

LVS_ICON 指定大图标显示格式

LVS_LIST 指定列表显示格式

LVS_NOCOLUMNHEADER 在报表格式中不显示列的表头

LVS_NOLABELWRAP 显示格式是大图标时，使标签文本单行显示。默认是多行显示

LVS_NOSCROLL 列表视图控件无滚动条，此风格不能与LVS_LIST或LVS_REPORT组合使用

LVS_NOSORTHEADER 报表格式的列表视图控件的表头不能作为排序按钮使用

LVS_OWNERDRAWFIXED 由控件的拥有者负责绘制表项

LVS_REPORT 指定报表显示格式

LVS_SHAREIMAGELISTS 使列表视图共享图像序列

LVS_SHOWSELALWAYS 即使控件失去输入焦点，仍显示出项的选择状态

LVS_SINGLESEL 指定只能有一个列表项被选中。默认时可以多项选择

LVS_SMALLICON 指定小图标显示格式

LVS_SORTASCENDING 按升序排列列表项

LVS_SORTDESCENDING 按降序排列列表项

添加项（单元项）：

结构体： typedefstruct
{

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

int
iItem;指定改变项的索引，第一个item应该为0，第二个item为1等等。

int
iSubItem;当前值的的子项，如果当前项是主导项，iSumItem应该存储从0开始的数组

UINT state;

UINT stateMask;

LPTSTR pszText;
要显示项的字符串，你可以通过cchTextMask指定文本的长度

int cchTextMax;

int iImage;

LPARAM lParam;

} LVITEM,*LPLVITEM;

lvItem.mask=
LVIF_TEXT;

lvItem.iItem=0;

lvItem.iSubItem=0;

lvItem.pszText=
strNumber;m_list.InsertItem(&lvItem);

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

创建一个ListCtrl的列，

你可以使用CListCtrl::InsertColumn()方法，它的一种声明为：

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

nCol:将要创建列的索引

pColumn:指向LVCOLUMN结构体指针，结构体定义如下：

typedefstruct
_LVCOLUMN {

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

int
fmt;格式化列的文本（默认值LVCFMT_LEFT），居中（LVCFMT_CENTER），或者右对齐（LVCFMT_RIGHT）

int
cx;cx 用来指定列文本的宽度

LPTSTR pszText;pszText 是将要显示的列的字符串

int
cchTextMax;

int
iSubItem;

} LVCOLUMN, FAR*LPLVCOLUMN;

LVCOLUMN
lvColumn;

int
nCol; 例如

lvColumn.mask=
LVCF_FMT| LVCF_TEXT|
LVCF_WIDTH;

lvColumn.fmt=
LVCFMT_LEFT;

lvColumn.cx=120;

lvColumn.pszText=
TEXT("Full
Name");

nCol=
m_StoreItems.InsertColumn(0,&lvColumn);

你也可以用CListCtrl::InsertColumn()方法的另一个版本，你可以用下面的版本，来为控件创建列：

int
InsertColumn(int
nCol,
列的索引，必须要指定的；

LPCTSTR lpszColumnHeading,
在列的开始要显示的字符串，和LVCOLUMN::pszText成员相似；

LPCTSTR
lpszColumnHeading,
在列的开始要显示的字符串，和LVCOLUMN::pszText成员相似；

int
nFormat= LVCFMT_LEFT,用来指定lpszColumnHeading的水平对齐方式。默认为左对齐(LVCFMT_LEFT)，居中为

int
nWidth=-1,以像素为单位来设定列的宽度，如果你不想指定它的大小，可设置为-1

int
nSubItem=-1);用来设定当前列子项的索引。

int InsertColumn( int nCol, LPCTSTR lpszColumnHeading, int nFormat , int nWidth, int nSubItem)插入列。
nCol为列的位置，从零开始，lpszColumnHeading为显示的列名，nFormat为显示对齐方式， nWidth为显示宽度，nSubItem为分配给该列的列索引。

成员函数：

lStyle
= GetWindowLong(m_list.m_hWnd, GWL_STYLE);//获取当前窗口style

lStyle
&= ~LVS_TYPEMASK; //清除显示方式位

lStyle
|= LVS_REPORT; //设置style

SetWindowLong(m_list.m_hWnd, GWL_STYLE, lStyle);//设置style

DWORD
dwStyle = m_list.GetExtendedStyle();

dwStyle |= LVS_EX_FULLROWSELECT;//选中某行使整行高亮（只适用与report风格的listctrl）

dwStyle |= LVS_EX_GRIDLINES;//网格线（只适用与report风格的listctrl）

dwStyle |= LVS_EX_CHECKBOXES;//item前生成checkbox控件

m_list.SetExtendedStyle(dwStyle); //设置扩展风格

插入数据 m_list.InsertColumn( 0, "ID", LVCFMT_LEFT, 40 );//插入列

m_list.InsertColumn( 1, "NAME", LVCFMT_LEFT, 50 );

int nRow = m_list.InsertItem(0, “11”);//插入行

m_list.SetItemText(nRow, 1, “jacky”);//设置数据

设置为Report属性后，若要ListControl显示为列表状，则在Init函数中，添加：

ListView_SetExtendedListViewStyle(m_listctrl.m_hWnd,LVS_EX_GRIDLINES|LVS_EX_ONECLICKACTIVATE|LVS_EX_FULLROWSELECT);

int InsertItem( int nItem, LPCTSTR lpszItem ); 插入行

nItem：指明插入位置

lpszItem：为显示字符。

除
LVS_REPORT 风格外其他三种风格都只需要直接调用 InsertItem 就可以了，但如果使用报表风格就必须先设置列表控件中的列信息

。

int
InsertColumn( int nCol, LPCTSTR lpszColumnHeading, int nFormat , int nWidth, int nSubItem); 插入列

iCol：为列的位置，从零开始

lpszColumnHeading：为显示的列名

nFormat：为显示对齐方式

nWidth：为显示宽度

nSubItem：为分配该列的列索引。

BOOL
SetItemText( int nItem, int nSubItem, LPTSTR lpszText );设置每列的显示字符

nItem：为行位置

nSubItem：为列位置

lpszText：为显示字符

下面的代码演示了如何设置多列并插入数据：

m_list.SetImageList(&m_listSmall,LVSIL_SMALL);//设置
ImageList

m_list.InsertColumn(0,"Col
1",LVCFMT_LEFT,300,0);//设置列

m_list.InsertColumn(1,"Col
2",LVCFMT_LEFT,300,1);

m_list.InsertColumn(2,"Col
3",LVCFMT_LEFT,300,2);

m_list.InsertItem(0,"Item
1_1");//插入行

m_list.SetItemText(0,1,"Item
1_2");//设置该行的不同列的显示字符

m_list.SetItemText(0,2,"Item
1_3")

总结：1.
ListCtrl 风格

LVS_ICON:
为每个item显示大图标

LVS_SMALLICON:
为每个item显示小图标

LVS_LIST:
显示一列带有小图标的item

LVS_REPORT:
显示item详细资料

直观的理解：windows资源管理器，“查看”标签下的“大图标，小图标，列表，详细资料”

--------------------------------------------------------------------------------

2.
设置listctrl 风格及扩展风格

LONG
lStyle;

lStyle
= GetWindowLong(m_list.m_hWnd, GWL_STYLE);//获取当前窗口style

lStyle
&= ~LVS_TYPEMASK; //清除显示方式位

lStyle
|= LVS_REPORT; //设置style

SetWindowLong(m_list.m_hWnd,
GWL_STYLE, lStyle);//设置style

DWORD
dwStyle = m_list.GetExtendedStyle();

dwStyle
|= LVS_EX_FULLROWSELECT;//选中某行使整行高亮（只适用与report风格的listctrl）

dwStyle
|= LVS_EX_GRIDLINES;//网格线（只适用与report风格的listctrl）

dwStyle
|= LVS_EX_CHECKBOXES;//item前生成checkbox控件

m_list.SetExtendedStyle(dwStyle);
//设置扩展风格

--------------------------------------------------------------------------------

3.
插入数据

m_list.InsertColumn(
0, "ID", LVCFMT_LEFT, 40 );//插入列

m_list.InsertColumn(
1, "NAME", LVCFMT_LEFT, 50 );

int
nRow = m_list.InsertItem(0, “11”);//插入行

m_list.SetItemText(nRow,
1, “jacky”);//设置数据

--------------------------------------------------------------------------------

4.
一直选中item

选中style中的Show
selection always，或者在上面第2点中设置LVS_SHOWSELALWAYS

--------------------------------------------------------------------------------

5.
选中和取消选中一行

int
nIndex = 0;

//选中

m_list.SetItemState(nIndex,
LVIS_SELECTED|LVIS_FOCUSED, LVIS_SELECTED|LVIS_FOCUSED);

//取消选中

m_list.SetItemState(nIndex,
0, LVIS_SELECTED|LVIS_FOCUSED);

--------------------------------------------------------------------------------

6.
得到listctrl中所有行的checkbox的状态

m_list.SetExtendedStyle(LVS_EX_CHECKBOXES);

CString
str;

for(int
i=0; i<m_list.GetItemCount(); i )

{

if(
m_list.GetItemState(i, LVIS_SELECTED) == LVIS_SELECTED || m_list.GetCheck(i))

{

str.Format(_T("第%d行的checkbox为选中状态"),
i);

AfxMessageBox(str);

}

}

CString
strIns;

strIns="delete
from tmpStatByGround";

m_pRs.CreateInstance(__uuidof(Recordset));

m_pRs->CursorLocation
= adUseClient;

m_pRs->Open((LPCTSTR)strIns,
vDispatch, adOpenKeyset,

adLockOptimistic,
adCmdUnknown);

--------------------------------------------------------------------------------

7.
得到listctrl中所有选中行的序号

方法一：

CString
str;

for(int
i=0; i<m_list.GetItemCount(); i )

{

if(
m_list.GetItemState(i, LVIS_SELECTED) == LVIS_SELECTED )

{

str.Format(_T("选中了第%d行"),
i);

AfxMessageBox(str);

}

}

方法二：

POSITION
pos = m_list.GetFirstSelectedItemPosition();

if
(pos == NULL)

TRACE0("No
items were selected!\n");

else

{

while
(pos)

{

int
nItem = m_list.GetNextSelectedItem(pos);

TRACE1("Item
%d was selected!\n", nItem);

//
you could do your own processing on nItem here

}

}

--------------------------------------------------------------------------------

8.
得到item的信息

TCHAR
szBuf[1024];

LVITEM
lvi;

lvi.iItem
= nItemIndex;

lvi.iSubItem
= 0;

lvi.mask
= LVIF_TEXT;

lvi.pszText
= szBuf;

lvi.cchTextMax
= 1024;

m_list.GetItem(&lvi);

--------------------------------------------------------------------------------

9.
得到listctrl的所有列的header字符串内容

LVCOLUMN
lvcol;

char
str[256];

int
nColNum;

CString
strColumnName[4];//假如有4列

nColNum
= 0;

lvcol.mask
= LVCF_TEXT;

lvcol.pszText
= str;

lvcol.cchTextMax
= 256;

while(m_list.GetColumn(nColNum,
&lvcol))

{

strColumnName[nColNum]
= lvcol.pszText;

nColNum
;

}

--------------------------------------------------------------------------------

10.
使listctrl中一项可见，即滚动滚动条

m_list.EnsureVisible(i,
FALSE);

--------------------------------------------------------------------------------

11.
得到listctrl列数

int
nHeadNum = m_list.GetHeaderCtrl()->GetItemCount();

--------------------------------------------------------------------------------

12.
删除所有列

方法一：

while
( m_list.DeleteColumn (0))

因为你删除了第一列后，后面的列会依次向上移动。

方法二：

int
nColumns = 4;

for
(int i=nColumns-1; i>=0; i--)

m_list.DeleteColumn
(i);

--------------------------------------------------------------------------------

13.
得到单击的listctrl的行列号

添加listctrl控件的NM_CLICK消息相应函数

void
CTest6Dlg::OnClickList1(NMHDR* pNMHDR, LRESULT* pResult)

{

//
方法一：

/*

DWORD
dwPos = GetMessagePos();

CPoint
point( LOWORD(dwPos), HIWORD(dwPos) );

m_list.ScreenToClient(&point);

LVHITTESTINFO
lvinfo;

lvinfo.pt
= point;

lvinfo.flags
= LVHT_ABOVE;

int
nItem = m_list.SubItemHitTest(&lvinfo);

if(nItem
!= -1)

{

CString
strtemp;

strtemp.Format("单击的是第%d行第%d列",
lvinfo.iItem, lvinfo.iSubItem);

AfxMessageBox(strtemp);

}

*/

//
方法二:

/*

NM_LISTVIEW*
pNMListView = (NM_LISTVIEW*)pNMHDR;

if(pNMListView->iItem
!= -1)

{

CString
strtemp;

strtemp.Format("单击的是第%d行第%d列",

pNMListView->iItem,
pNMListView->iSubItem);

AfxMessageBox(strtemp);

}

*/

*pResult
= 0;

}

--------------------------------------------------------------------------------

14.
判断是否点击在listctrl的checkbox上

添加listctrl控件的NM_CLICK消息相应函数

void
CTest6Dlg::OnClickList1(NMHDR* pNMHDR, LRESULT* pResult)

{

DWORD
dwPos = GetMessagePos();

CPoint
point( LOWORD(dwPos), HIWORD(dwPos) );

m_list.ScreenToClient(&point);

LVHITTESTINFO
lvinfo;

lvinfo.pt
= point;

lvinfo.flags
= LVHT_ABOVE;

UINT
nFlag;

int
nItem = m_list.HitTest(point, &nFlag);

//判断是否点在checkbox上

if(nFlag
== LVHT_ONITEMSTATEICON)

{

AfxMessageBox("点在listctrl的checkbox上");

}

*pResult
= 0;

}

--------------------------------------------------------------------------------

15.
右键点击listctrl的item弹出菜单

添加listctrl控件的NM_RCLICK消息相应函数

void
CTest6Dlg::OnRclickList1(NMHDR* pNMHDR, LRESULT* pResult)

{

NM_LISTVIEW*
pNMListView = (NM_LISTVIEW*)pNMHDR;

if(pNMListView->iItem
!= -1)

{

DWORD
dwPos = GetMessagePos();

CPoint
point( LOWORD(dwPos), HIWORD(dwPos) );

CMenu
menu;

VERIFY(
menu.LoadMenu( IDR_MENU1 ) );

CMenu*
popup = menu.GetSubMenu(0);

ASSERT(
popup != NULL );

popup->TrackPopupMenu(TPM_LEFTALIGN
| TPM_RIGHTBUTTON, point.x, point.y, this );

}

*pResult
= 0;

}

--------------------------------------------------------------------------------

16.
item切换焦点时(包括用键盘和鼠标切换item时)，状态的一些变化顺序

添加listctrl控件的LVN_ITEMCHANGED消息相应函数

void
CTest6Dlg::OnItemchangedList1(NMHDR* pNMHDR, LRESULT* pResult)

{

NM_LISTVIEW*
pNMListView = (NM_LISTVIEW*)pNMHDR;

//
TODO: Add your control notification handler code here

CString
sTemp;

if((pNMListView->uOldState
& LVIS_FOCUSED) == LVIS_FOCUSED &&

(pNMListView->uNewState
& LVIS_FOCUSED) == 0)

{

sTemp.Format("%d
losted focus",pNMListView->iItem);

}

else
if((pNMListView->uOldState & LVIS_FOCUSED) == 0 &&

(pNMListView->uNewState
& LVIS_FOCUSED) == LVIS_FOCUSED)

{

sTemp.Format("%d
got focus",pNMListView->iItem);

}

if((pNMListView->uOldState
& LVIS_SELECTED) == LVIS_SELECTED &&

(pNMListView->uNewState
& LVIS_SELECTED) == 0)

{

sTemp.Format("%d
losted selected",pNMListView->iItem);

}

else
if((pNMListView->uOldState & LVIS_SELECTED) == 0 &&

(pNMListView->uNewState
& LVIS_SELECTED) == LVIS_SELECTED)

{

sTemp.Format("%d
got selected",pNMListView->iItem);

}

*pResult
= 0;

}

--------------------------------------------------------------------------------

17.
listctrl的 subitem 添加图标

注意:
首先要用 InsertItem() 插入一行的第一列, 然后才能用 SetItem 设置其他项

m_list.SetExtendedStyle(LVS_EX_SUBITEMIMAGES);

m_userlist.SetItem(..);

--------------------------------------------------------------------------------

18.
在CListCtrl显示文件，并根据文件类型来显示图标

网上找到的代码，自己试用并改正过,
share

步骤1:
设置 list 的图像列表为 系统图像列表

BOOL
SetSystemImageList( CListCtrl & list )

{

HIMAGELIST
himlSmall;

HIMAGELIST
himlLarge;

SHFILEINFO
sfi;

char
cSysDir[MAX_PATH];

CString
strBuf;

memset(cSysDir,
0, MAX_PATH);

GetWindowsDirectory(cSysDir,
MAX_PATH);

strBuf
= cSysDir ;

//
SHGetFileInfo:

//
If uFlags contains SHGFI_SYSICONINDEX, the return value is a handle to

//
an image list that contains the large icon images.

//
If SHGFI_SMALLICON is included with SHGFI_SYSICONINDEX, the return value

//
is the handle to an image list that contains the small icon images.

//

himlSmall
= (HIMAGELIST)SHGetFileInfo ( (LPCSTR)cSysDir,

0,

&sfi,

sizeof(SHFILEINFO),

SHGFI_SYSICONINDEX
| SHGFI_SMALLICON );

himlLarge
= (HIMAGELIST)SHGetFileInfo((LPCSTR)cSysDir,

0,

&sfi,

sizeof(SHFILEINFO),

SHGFI_SYSICONINDEX
| SHGFI_LARGEICON);

if
(himlSmall && himlLarge)

{

::SendMessage(list.m_hWnd,
LVM_SETIMAGELIST,

(WPARAM)LVSIL_SMALL,
(LPARAM)himlSmall);

::SendMessage(list.m_hWnd,
LVM_SETIMAGELIST,

(WPARAM)LVSIL_NORMAL,
(LPARAM)himlLarge);

}

return
TRUE;

}

步骤2:
给列表添加指定的文件, 同时获得该文件的的图标索引, 给 list 添加图标

int
GetIconIndex(LPCTSTR lpszPath, BOOL bIsDir, BOOL bSelected) ; // 向前声明

void
AddFiles(CListCtrl & list, LPCTSTR lpszFileName, BOOL bAddToDocument)

{

int
nIcon = GetIconIndex(lpszFileName, FALSE, TRUE);

CString
strSize;

CFileFind
filefind;

//
get file size

if
( filefind.FindFile(lpszFileName))

{

filefind.FindNextFile();

strSize.Format("%d",
filefind.GetLength());

}

else

strSize
= "0";

//
split path and filename

CString
strFileName = lpszFileName;

CString
strPath;

int
nPos = strFileName.ReverseFind('\\');

if
(nPos != -1)

{

strPath
= strFileName.Left(nPos);

strFileName
= strFileName.Mid(nPos 1);

}

//
insert to list

int
nItem = list.GetItemCount();

//list.InsertItem(nItem,
strFileName, nIcon);

//list.SetItemText(nItem,
1, strSize);

//

//
此处可以根据实际需要修改代码

//

}

--------------------------------------------------------------------------------

19.
listctrl内容进行大数据量更新时，避免闪烁

m_list.SetRedraw(FALSE);

//更新内容

m_list.SetRedraw(TRUE);

m_list.Invalidate();

m_list.UpdateWindow();

20.
清除 ListCtrl 以重新初始化:

//
删除所有行

m_ctrllist.DeleteAllItems()
;

//
删除所有列

int
iColCount = m_ctrllist.GetHeaderCtrl()->GetItemCount() ;

//
方法 1

//
原理: 删除第一列后, 其他列向前移动

while(
m_ctrllist.DeleteColumn(0) ) ;

//
方法 2

for
(int i=0; i < iColCount ; i )

{

m_ctrllist.DeleteColumn(0);

}

//
方法 3

for
(int i=iColCount-1; i >= 0; i-- )

{

m_ctrllist.DeleteColumn(
i );

}