TabCtrl_GetItem宏 (commctrl.h)

检索有关选项卡控件中的选项卡的信息。 可以使用此宏或显式发送 TCM_GETITEM 消息。

语法

BOOL TabCtrl_GetItem(
   HWND     hwnd,
   int      iItem,
   LPTCITEM pitem
);

参数

hwnd

类型:HWND

选项卡控件的句柄。

iItem

类型:int

选项卡的索引。

pitem

类型:LPTCITEM

指向 TCITEM 结构的指针,该结构指定要检索和接收有关选项卡的信息。发送消息时,掩码 成员指定要返回的属性。 如果 掩码 成员指定TCIF_TEXT值,则 pszText 成员必须包含接收项文本的缓冲区的地址,cchTextMax 成员必须指定缓冲区的大小。

返回值

类型:BOOL

如果成功,则返回 TRUE;否则返回 FALSE

言论

如果在 TCITEM 结构的 掩码 成员中设置TCIF_TEXT标志,则控件可能会更改结构 pszText 成员指向新文本,而不是使用请求的文本填充缓冲区。 该控件可将 pszText 成员设置为 NULL,以指示没有与项关联的文本。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 commctrl.h