Specifies or receives the attributes of a tab item. It is used with the TCM_INSERTITEM, TCM_GETITEM, and TCM_SETITEM messages. This structure supersedes the TC_ITEM structure.
用于指定或者接受tab控件的条目的属性。它常和消息TCM_INSERTITEM、TCM_GETITEM、TCM_SETITEM一起使用。这个结构体取代了TC_ITEM结构体
typedef struct { UINT mask; #if (_WIN32_IE >= 0x0300) DWORD dwState; DWORD dwStateMask; #else UINT lpReserved1; UINT lpReserved2; #endif LPTSTR pszText; int cchTextMax; int iImage; LPARAM lParam; } TCITEM, *LPTCITEM;
掩码(mask)可以有以下的值组合而成。
TCIF_IMAGE:使iImage成员有效。
TCIF_PARAM:使lParam成员有效。
TCIF_RTLREADING:由pszText指定的字符串会显示在与父窗口字符相反的方向。
TCIF_STATE:版本4.70.使dwState成员有效。
TCIF_TEXT:使pszText成员有效。
dwState:
版本4.70。如果信息将被返回,则记录条目当前的状态。如果信息是用来设置条目的,那么这个成员包含着设置条目状态的值。在消息TCM_INSERTITEM中,这个成员会被忽略。
dwStateMask:
版本4.70。指定dwState可以包含的有效信息。在消息TCM_INSERTITEM中,这个成员会被忽略。
lpReserved1、lpReserved2:保留。
pszText:当设置条目信息的时候,指向包含tab控件文本的以NULL结束的字符串。当返回条目信息的时候,这个成员指定了接受tan控件文本的缓冲区的地址。
cchTextMax:成员pszText指向的缓冲区的大小。如果结构体在接受信息,那么这个成员会被忽略。
iImage:tab控件的图像列表的索引。如果控件没图像,那么就为-1。
lParam:与tab控件条目关联的应用定义数据(Application-defined data)。