一步一步学List Control控件的用法(第二步)----创建第一行
第二步 创建第一行
1、 在上一节中我们创建了一个列,那我们可以按照同样的方法多创建几个列。在
m_ListCtrl.InsertColumn(0, _T("姓名"), LVCFMT_LEFT, 90);
代码后边添入下列三行代码:
m_ListCtrl.InsertColumn(1,_T("性别"),LVCFMT_LEFT,40);
m_ListCtrl.InsertColumn(2,_T("联系方式"),LVCFMT_LEFT,160);
m_ListCtrl.InsertColumn(3,_T("备注"),LVCFMT_LEFT,180);
大家可以发现,只有第一个参数和最后一个参数不同,这两个参数的作用在上一节我们也介绍过了。第一个参数是新建列的索引值,是从0开始的,也就是说第一列的索引值是0,第二列的索引值是1,第三列的索引值是2,以此类推,是不是很像数组的下表啊?
2、 大家可以运行下看看结果,会出现4个列,列名分别为:姓名,性别,联系方式,备注。
3、 既然我们已经创建好了列,那我们来创建行吧。
4、 首先要知道List Control在显示为Report样式时,主项为第一项,后面紧跟着的为子项。主项和子项的数据写入不同,这将在后面提到。所以说,在我们的例子当中姓名就是主项了,而其余的项就都是子项了。
5、 在我们刚才添加的代码后边继续添加代码:
m_ListCtrl.InsertItem(0,_T("王二小"));
这里我们来看下这个函数的定义:
int InsertItem(const LVITEM* pItem)
int InsertItem(int nItem,LPCTSTR lpszItem)
int InsertItem(int nItem, LPCTSTR lpszItem,int nImage)
int InsertItem(UINT nMask,
int nItem,
LPCTSTR lpszItem,
UINT nState,
UINT nStateMask,
int nImage,
LPARAM lParam
)
返回值:
如果成功,则返回新建列的索引值,否则为-1。
参数:
pItem |
指向指定项属性LVITEM结构的指针,如联机文档“平台SDK”中所述。 |
nItem |
被插入项的索引值。 |
lpszItem |
包含项标签的字符串的地址,或当项为回调项时,该变量为LPSTR_TEXT CALLBACK。要了解更多有关回调项的信息,请参阅CListCtrl::GetCall backMask. |
nImage |
项图象的索引值,或当项为回调项时,该变量为I_IMAGECALLBACK。要了解更多有关回调项的信息,请参阅CListCtrl::GetCallbackMask |
nMask |
参数nMask指定了哪个项属性作为参数传递是有效的。它可以是联机文档“平台SDK” 中LVITEM结构所描述的一个或多个掩码值。有效的数据能够通过位与运算来组合。 |
nState |
指示项的状态、状态图象及轮廓图象。请参阅联机文档“平台SDK”中的LVITEM来获取更多信息,并参阅有效标志列表中的列表视图项状态。 |
nStateMask |
指示状态成员中的哪一位将被获取或修改。请参阅联机文档“平台SDK”中的LVITEM来获取更多信息。 |
nImage |
图象列表之内项的图象的索引。 |
lParam |
与项相关联的应用指定的32位值。如果该参数被指定,那么必须设置nMask的属性为LVIF_PARAM。 |
说明:向列表视图控件中新插入一项。
很显然,我们采用的是第二个函数,具有三个参数的函数。
6、 我们这行代码的作用就是,插入主项:王二小,即在第一行第一列姓名中添加了王二小。
7、 那我们要如何插入子项呢?我们继续添加代码如下:
m_ListCtrl.SetItemText(0,1,_T("男"));
我们先来看下这个函数的定义:
BOOL SetItemText(int nItem,int nSubItem,LPTSTR lpszText)
返回值:如果成功,则返回非零值,否则为0。
参数:
nItem |
要设定文本项的索引值。 |
nSubItem |
子项的索引,若为零,则设置项标签。 |
lpszText |
指向包含新项文本字符串的指针。 |
说明:改变列表视图项或子项的文本。
这个就很好理解了,参数很少,这个就是为了添加子项。由于是子项,需要确定添加的位置,所以肯定需要二维的坐标来确定自己的位置,所以需要两个索引。类似于二维数组的下标。在我们的函数参数中,0,1,表示第1行第2列,而男就是要添加的内容了。
8、 我们按照这个方法继续添加代码如下:
m_ListCtrl.SetItemText(0,2,_T("15888888888"));
m_ListCtrl.SetItemText(0,3,_T("儿童团"));
9、 调试程序,我们将可以看到具有完整的一行数据的结果。如下图:
10、同样,我们可以采取同样的方法,创建添加多行数据。