CTabCtrl::GetItem

BOOL GetItem( int nItem, TC_ITEM* pTabCtrlItem ) const;

返回值:如果成功则返回TRUE;否则返回FALSE。

参数:
nItem标签的从零开始的索引。
pTabCtrlItem指向一个TCITEM结构的指针,该结构用来指定要获取的信息。也用来获取该标签的信息。此结构也被InsertItem,GetItem和SetItem成员函数使用。

说明:
此成员函数用来获取一个标签控件中的某个标签的信息。当消息被发送后,mask成员指定要返回哪一个属性。如果mask成员指定TCIF_TEXT值,则pszText成员必须包含用来接收该项文本的缓冲区的地址,cchTextMax成员必须指定缓冲区的大小。
mask指定要获取或设置的是哪些TCITEM结构成员。这个成员可以是零或下列值的一个组合:
·TCIF_TEXTpszText成员是有效的。
·TCIF_IMAGEiImage成员是有效的。
·TCIF_PARAMlParam成员是有效的。
·TCIF_RTLREADING用从右到左的读取顺序在Hebrew或Arabic系统中显示pszText的文本。
·TCIF_STATEdwState成员是有效的。
pszText指向一个以空字符结尾的字符串的指针,如果此结构包含了一个标签的信息,则该字符串包含了该标签文本。如果此结构正在接收信息,则这个成员指定了用来接收该标签文本的缓冲区的地址。
cchTextMaxpszText指向的缓冲区的大小。如果此结构不是在接收信息,则忽略这个成员。
iImage是此标签控件的图像列表中的索引,如果此标签没有图像则这个成员的值为-1。
lParam应用程序定义的与此标签相关联的数据。如果每一个标签有多于四个字节的应用程序定义的数据,则应用程序必须定义一个结构并用这个结构来代替TCITEM结构。应用程序定义的结构的第一个成员必须是一个TCITEMHEADER结构。这个TCITEMHEADER结构与TCITEM结构一样,但是没有lParam成员。你的结构与TCITEMHEADER结构的大小差别必须等于每一个标签的额外的字节数。

请参阅:CTabCtrl::InsertItem, CTabCtrl::SetItem