MFC list control控件的相关函数

http://www.jizhuomi.com/software/197.html

http://baike.baidu.com/link?url=de5C2hOuDAzYzi9wAuXc13Etyd44sDraatg6ZcD91YIMELkIcxi2TB1lQcLGJXLxKXGZjWP0OurEImzoMqSwsUWoU-kFVYjVYITplvI5zvu&qq-pf-to=pcqq.group

 

构造函数

ClistCtrl

构造一个CListCtrl对象。

Create

创建列表控件并将其附加给CListCtrl对象。

属性

GetBkColor

获取列表视图控件的背景色。

SetBkColor

设置列表视图控件的背景色。

 

GetImageList

获取用于绘制列表视图项的图象列表的句柄。

SetImageList

指定一个图象列表到列表视图控件。

 

GetItemCount

int GetItemCount( ) const;

获取列表视图控件中的项的数量。

 

GetItem

获取列表视图项的属性。

 

GetCallbackMask

获取列表视图控件的回调掩码。

SetCallbackMask

设置列表视图控件的回调掩码。

 

GetNextItem

查找指定特性和指定指定项关系的列表视图项。

 

GetFirstSelectedItemPosition

POSITION GetFirstSelectedItemPosition( ) const;

在列表视图控件中获取第一个选择的列表视图项的位置。

GetNextSelectedItem

int GetNextSelectedItem(POSITION& pos) const;

为重复而获取下一个选择的列表视图。

获取由pos指定的列表项的索引，然后将pos设置为下一个位置的POSITION值。

返回值就是pos指定列表项的索引。

 

GetItemRect

获取项的有界矩形。

 

SetItemPosition

在列表视图控件中移动一项到指定位置。

GetItemPosition

获取列表视图项的位置。

 

GetStringWidth

指定需要显示所有指定字符串的最小列宽。

 

GetEditControl

获取用于编辑一个项文本的编辑控件的句柄。

 

GetColumn

获取控件的列的属性。

SetColumn

设置列表视图列的属性。

 

GetColumnWidth

获取报表视图或列表视图中的列的宽度。

SetColumnWidth

改变报表视图或列表视图中的列的宽度。

 

GetCheck

获取与某项相关的状态图象的当前显示状态。

SetCheck

设置与某项相关的状态图象的当前显示状态。

 

GetViewRect

获取列表视图控件中所有项的有界矩形。

 

GetTextColor

获取列表视图控件的文本颜色。

SetTextColor

设置列表视图控件的文本颜色。

 

GetTextBkColor

获取列表视图控件的文本背景色。

SetTextBkColor

设置列表视图控件的文本背景色。

 

GetTopIndex

获取最高级项的索引。

 

GetCountPerPage

计算可正好垂直放入列表视图控件中的项的数目。

 

GetOrigin

获取列表视图控件的最初的当前视图。

 

SetItemState

改变列表视图控件的项的状态。

// 选中 m_list.SetItemState(nIndex,LVIS_SELECTED|LVIS_FOCUSED, LVIS_SELECTED|LVIS_FOCUSED); 

// 取消选中      m_list.SetItemState(nIndex,0, LVIS_SELECTED|LVIS_FOCUSED); 

GetItemState

获取列表视图控件的项的状态。

 

GetItemText

CString GetItemText(int nItem,int nSubItem) const;

获取列表视图项或子项的文本。

参数nItem指定了列表项的索引，参数nSubItem指定了列表子项的索引。 

SetItemText

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

设置列表视图项或子项的文本。

参数nItem和nSubItem同GetItemText。如果设置成功则返回TRUE，否则返回FALSE。

 

SetItemCount

准备一个列表视图控件以添加大量的项。

 

GetItemData

DWORD_PTR GetItemData(int nItem) const;

获取与某项相关的应用所指定的值。

参数nItem为列表项的索引。返回值就是由nItem指定列表项的附加32位数据。

SetItemData

BOOLSetItemData(int nItem,DWORD_PTR dwData);

设置项的应用指定的值。

参数nItem为列表项的索引，参数dwData为列表项的附加32位数据。

 

GetSelectedCount

UINT GetSelectedCount( ) const;

获取列表视图控件中选择项的数量。

 

SetColumnOrderArray

设置列表视图控件的列序（左或右）。

GetColumnOrderArray

获取列表视图控件的列序（左或右）。

 

SetIconSpacing

设置列表视图控件中的图标的距离。

 

GetHeaderCtrl

获取列表视图控件的标题控件。

得带listctrl列数m_list. GetHeaderCtrl()->GetItemCount();

 

GetHotCursor

获取在热调试对列表视图控件有效时使用的游标。

SetHotCursor

设置在热调试对列表视图控件有效时使用的游标。

 

GetSubItemRect

获取列表视图控件中某项的有界矩形。

 

GetHotItem

获取当前在游标下的列表视图项。

SetHotItem

设置列表视图控件的当前热项。

 

GetSelectionMark

获取列表视图控件的选择屏蔽。

SetSelectionMark

设置列表视图控件的选择屏蔽。

 

GetExtendedStyle

获取列表视图控件的当前扩展风格。

SetExtendedStyle

设置列表视图控件的当前扩展风格。m_list.SetExtendedStyle(LVS_EX_CHECKBOXES); 1添加选项框

 

 

SubItemHitTest

指定哪个列表视图项在指定位置。

 

GetWorkAreas

获取列表视图控件的当前工作区。

 

GetNumberOfWorkAreas

获取列表视图控件的当前工作区数量。

 

SetItemCountEx

设置虚列表视图控件的项的数量。

 

SetWorkAreas

设置列表视图控件中图标可以显示的区域。

 

ApproximateViewRect

指定显示列表视图控件项所需的宽度和高度。

 

GetBkImage

获取列表视图控件的当前背景图象。

SetBkImage

设置列表视图控件的当前背景图象。

 

GetHoverTime

获取列表视图控件的当前逗留时间。

SetHoverTime

设置列表视图控件的当前逗留时间。

操作

InsertItem

 int InsertItem(int nItem,LPCTSTR lpszItem);

在列表视图控件中插入一个新项。

参数nItem为要插入项的索引，参数lpszItem为要插入项的标签字符串。如果插入成功则返回新列表项的索引，否则返回-1。

DeleteItem

BOOL DeleteItem(int nItem);

从控件中删除一项。

参数nItem指定了要删除的列表项的索引。删除成功则返回TRUE，否则返回FALSE。

 

DeleteAllItems

从控件中删除所有项。

 

FindItem

查找具有指定的字符的列表视图项。

 

SortItems

使用应用定义的比较函数排序列表视图项。

 

HitTest

指定哪个列表视图在指定的位置上。

 

EnsureVisible

保证项是可见的。

 

Scroll

滚动列表视图控件的内容。

 

ReDrawItems

强迫列表视图控件刷新一些项。

 

Update

强迫控件刷新一个指定的项。

 

Arrange

调整一栏里的项。

 

EditLabel

开始项文本该处编辑。

 

InsertColumn

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结构，其中包含了插入列的属性。第二个函数中,lpszColumnHeading参数为列标题字符串，nFormat参数为列中文本的对齐方式，可以是LVCFMT_LEFT、LVCFMT_RIGHT或LVCFMT_CENTER，nWidth参数为列宽，nSubItem为插入列对应列表子项的索引。

两个函数在成功时都返回新列的索引，失败都返回-1。

DeleteColumn

BOOL DeleteColumn(int nCol);

从列表视图控件中删除一列。

参数nCol为删除列的索引。删除成功则返回TRUE，失败返回FALSE。

 

CreateDragImage

为指定的项构造一个拖动图象列表。

可覆盖的函数

DrawItem()

当自绘制控件的可视部分改变时被调用。