选项卡 (Windows控件)

本部分包含有关与选项卡控件一起使用的编程元素的信息。

概述

主题 目录
关于选项卡控件 选项卡控件类似于笔记本中的分隔条或文件柜中的标签。 通过使用选项卡控件,应用程序可以为窗口或对话框的相同区域定义多个页。
使用选项卡控件 本主题包含两个使用选项卡控件的示例。

主题 目录
TabCtrl_AdjustRect 计算给定窗口矩形的选项卡控件的显示区域,或计算对应于指定显示区域的窗口矩形。 可以使用此宏或显式发送 TCM_ADJUSTRECT 消息。
TabCtrl_DeleteAllItems 从选项卡控件中删除所有项。 可以使用此宏或显式发送 TCM_DELETEALLITEMS 消息。
TabCtrl_DeleteItem 从选项卡控件中删除项。 可以使用此宏或显式发送 TCM_DELETEITEM 消息。
TabCtrl_DeselectAll 重置选项卡控件中的项,清除已设置为 TCIS_BUTTONPRESSED 状态的任何项。 可以使用此宏或显式发送 TCM_DESELECTALL 消息。
TabCtrl_GetCurFocus 返回在选项卡控件中具有焦点的项的索引。 可以使用此宏或显式发送 TCM_GETCURFOCUS 消息。
TabCtrl_GetCurSel 确定选项卡控件中当前选定的选项卡。 可以使用此宏或显式发送 TCM_GETCURSEL 消息。
TabCtrl_GetExtendedStyle 检索当前用于选项卡控件的扩展样式。 可以使用此宏或显式发送 TCM_GETEXTENDEDSTYLE 消息。
TabCtrl_GetImageList 检索与选项卡控件关联的图像列表。 可以使用此宏或显式发送 TCM_GETIMAGELIST 消息。
TabCtrl_GetItem 检索有关选项卡控件中的选项卡的信息。 可以使用此宏或显式发送 TCM_GETITEM 消息。
TabCtrl_GetItemCount 检索选项卡控件中的选项卡数。 可以使用此宏或显式发送 TCM_GETITEMCOUNT 消息。
TabCtrl_GetItemRect 检索选项卡控件中选项卡的边界矩形。 可以使用此宏或显式发送 TCM_GETITEMRECT 消息。
TabCtrl_GetRowCount 检索选项卡控件中选项卡的当前行数。 可以使用此宏或显式发送 TCM_GETROWCOUNT 消息。
TabCtrl_GetToolTips 检索与选项卡控件关联的工具提示控件的句柄。 可以使用此宏或显式发送 TCM_GETTOOLTIPS 消息。
TabCtrl_GetUnicodeFormat 检索控件的 UNICODE 字符格式标志。 可以使用此宏或显式发送 TCM_GETUNICODEFORMAT 消息。
TabCtrl_HighlightItem 设置选项卡项的突出显示状态。 可以使用此宏或显式发送 TCM_HIGHLIGHTITEM 消息。
TabCtrl_HitTest 确定哪个选项卡(如果有)位于指定的屏幕位置。 可以使用此宏或显式发送 TCM_HITTEST 消息。
TabCtrl_InsertItem 在选项卡控件中插入新选项卡。 可以使用此宏或显式发送 TCM_INSERTITEM 消息。
TabCtrl_RemoveImage 从选项卡控件的图像列表中删除图像。 可以使用此宏或显式发送 TCM_REMOVEIMAGE 消息。
TabCtrl_SetCurFocus 将焦点设置为选项卡控件中的指定选项卡。 可以使用此宏或显式发送 TCM_SETCURFOCUS 消息。
TabCtrl_SetCurSel 选择选项卡控件中的选项卡。 可以使用此宏或显式发送 TCM_SETCURSEL 消息。
TabCtrl_SetExtendedStyle 设置选项卡控件将使用的扩展样式。 可以使用此宏或显式发送 TCM_SETEXTENDEDSTYLE 消息。
TabCtrl_SetImageList 将图像列表分配给选项卡控件。 可以使用此宏或显式发送 TCM_SETIMAGELIST 消息。
TabCtrl_SetItem 设置选项卡的某些或全部属性。 可以使用此宏或显式发送 TCM_SETITEM 消息。
TabCtrl_SetItemExtra 设置选项卡控件中为应用程序定义数据保留的每个选项卡的字节数。 可以使用此宏或显式发送 TCM_SETITEMEXTRA 消息。
TabCtrl_SetItemSize 在固定宽度或所有者绘制的选项卡控件中设置选项卡的宽度和高度。 可以使用此宏或显式发送 TCM_SETITEMSIZE 消息。
TabCtrl_SetMinTabWidth 设置选项卡控件中项的最小宽度。 可以使用此宏或显式发送 TCM_SETMINTABWIDTH 消息。
TabCtrl_SetPadding 设置选项卡控件中每个选项卡图标和标签周围 (填充) 的空间量。 可以使用此宏或显式发送 TCM_SETPADDING 消息。
TabCtrl_SetToolTips 将工具提示控件分配给选项卡控件。 可以使用此宏或显式发送 TCM_SETTOOLTIPS 消息。
TabCtrl_SetUnicodeFormat 设置控件的 Unicode 字符格式标志。 此消息允许在运行时更改控件使用的字符集,而无需重新创建控件。 可以使用此宏或显式发送 TCM_SETUNICODEFORMAT 消息。

消息

主题 目录
TCM_ADJUSTRECT 计算给定窗口矩形的选项卡控件的显示区域,或计算对应于指定显示区域的窗口矩形。 可以显式发送此消息,也可以使用 TabCtrl_AdjustRect 宏。
TCM_DELETEALLITEMS 从选项卡控件中删除所有项。 可以显式发送此消息,也可以使用 TabCtrl_DeleteAllItems 宏。
TCM_DELETEITEM 从选项卡控件中删除项。 可以显式发送此消息,也可以使用 TabCtrl_DeleteItem 宏。
TCM_DESELECTALL 重置选项卡控件中的项,清除已设置为 TCIS_BUTTONPRESSED 状态的任何项。 可以显式发送此消息,也可以使用 TabCtrl_DeselectAll 宏。
TCM_GETCURFOCUS 返回在选项卡控件中具有焦点的项的索引。 可以显式发送此消息,也可以使用 TabCtrl_GetCurFocus 宏。
TCM_GETCURSEL 确定选项卡控件中当前选定的选项卡。 可以显式发送此消息,也可以使用 TabCtrl_GetCurSel 宏发送。
TCM_GETEXTENDEDSTYLE 检索当前用于选项卡控件的扩展样式。 可以显式发送此消息,也可以使用 TabCtrl_GetExtendedStyle 宏。
TCM_GETIMAGELIST 检索与选项卡控件关联的图像列表。 可以显式发送此消息,也可以使用 TabCtrl_GetImageList 宏。
TCM_GETITEM 检索有关选项卡控件中的选项卡的信息。 可以显式发送此消息,也可以使用 TabCtrl_GetItem 宏发送。
TCM_GETITEMCOUNT 检索选项卡控件中的选项卡数。 可以显式发送此消息,也可以使用 TabCtrl_GetItemCount 宏。
TCM_GETITEMRECT 检索选项卡控件中选项卡的边界矩形。 可以显式发送此消息,也可以使用 TabCtrl_GetItemRect 宏。
TCM_GETROWCOUNT 检索选项卡控件中选项卡的当前行数。 可以显式发送此消息,也可以使用 TabCtrl_GetRowCount 宏发送。
TCM_GETTOOLTIPS 检索与选项卡控件关联的工具提示控件的句柄。 可以显式发送此消息,也可以使用 TabCtrl_GetToolTips 宏。
TCM_GETUNICODEFORMAT 检索控件的 Unicode 字符格式标志。 可以显式发送此消息或使用 TabCtrl_GetUnicodeFormat 宏。
TCM_HIGHLIGHTITEM 设置选项卡项的突出显示状态。 可以显式发送此消息,也可以使用 TabCtrl_HighlightItem 宏。
TCM_HITTEST 确定哪个选项卡(如果有)位于指定的屏幕位置。 可以显式发送此消息,也可以使用 TabCtrl_HitTest 宏。
TCM_INSERTITEM 在选项卡控件中插入新选项卡。 可以显式发送此消息,也可以使用 TabCtrl_InsertItem 宏。
TCM_REMOVEIMAGE 从选项卡控件的图像列表中删除图像。 可以显式发送此消息,也可以使用 TabCtrl_RemoveImage 宏。
TCM_SETCURFOCUS 将焦点设置为选项卡控件中的指定选项卡。 可以显式发送此消息,也可以使用 TabCtrl_SetCurFocus 宏。
TCM_SETCURSEL 选择选项卡控件中的选项卡。 可以显式发送此消息,也可以使用 TabCtrl_SetCurSel 宏。
TCM_SETEXTENDEDSTYLE 设置选项卡控件将使用的扩展样式。 可以显式发送此消息,也可以使用 TabCtrl_SetExtendedStyle 宏发送。
TCM_SETIMAGELIST 将图像列表分配给选项卡控件。 可以显式发送此消息,也可以使用 TabCtrl_SetImageList 宏。
TCM_SETITEM 设置选项卡的某些或全部属性。 可以显式发送此消息,也可以使用 TabCtrl_SetItem 宏发送。
TCM_SETITEMEXTRA 设置选项卡控件中为应用程序定义数据保留的每个选项卡的字节数。 可以显式发送此消息,也可以使用 TabCtrl_SetItemExtra 宏。
TCM_SETITEMSIZE 在固定宽度或所有者绘制的选项卡控件中设置选项卡的宽度和高度。 可以显式发送此消息,也可以使用 TabCtrl_SetItemSize 宏发送。
TCM_SETMINTABWIDTH 设置选项卡控件中项的最小宽度。 可以显式发送此消息,也可以使用 TabCtrl_SetMinTabWidth 宏。
TCM_SETPADDING 设置选项卡控件中每个选项卡图标和标签周围 (填充) 的空间量。 可以显式发送此消息,也可以使用 TabCtrl_SetPadding 宏。
TCM_SETTOOLTIPS 将工具提示控件分配给选项卡控件。 可以显式发送此消息,也可以使用 TabCtrl_SetToolTips 宏。
TCM_SETUNICODEFORMAT 设置控件的 Unicode 字符格式标志。 此消息允许在运行时更改控件使用的字符集,而无需重新创建控件。 可以显式发送此消息或使用 TabCtrl_SetUnicodeFormat 宏。

通知

主题 目录
NM_CLICK (选项卡) 通知选项卡控件的父窗口,用户已单击控件中的鼠标左键。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_DBLCLK (选项卡) 通知选项卡控件的父窗口,用户已双击控件中的鼠标左键。 此通知以 WM_NOTIFY 消息的形式发送。
NM_RCLICK (选项卡) 通知选项卡控件的父窗口,用户已单击控件中的鼠标右键。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_RDBLCLK (选项卡) 通知选项卡控件的父窗口,用户已双击控件中的鼠标右键。 此通知代码以 WM_NOTIFY 消息的形式发送。
NM_RELEASEDCAPTURE (选项卡) 通知选项卡控件的父窗口,该控件正在释放鼠标捕获。 此通知代码以 WM_NOTIFY 消息的形式发送。
TCN_FOCUSCHANGE 通知选项卡控件的父窗口按钮焦点已更改。 此通知代码以 WM_NOTIFY 消息的形式发送。
TCN_GETOBJECT 当选项卡控件具有 TCS_EX_REGISTERDROP 扩展样式并且对象被拖动到控件中的选项卡项上时,由选项卡控件发送。 此通知代码以 WM_NOTIFY 消息的形式发送。
TCN_KEYDOWN 通知选项卡控件的父窗口已按下键。 此通知代码以 WM_NOTIFY 消息的形式发送。
TCN_SELCHANGE 通知选项卡控件的父窗口当前选定的选项卡已更改。 此通知代码以 WM_NOTIFY 消息的形式发送。
TCN_SELCHANGING 通知选项卡控件的父窗口当前所选选项卡即将更改。 此通知代码以 WM_NOTIFY 消息的形式发送。

结构

主题 目录
NMTCKEYDOWN 包含有关选项卡控件中按键的信息。 它与 TCN_KEYDOWN 通知代码一起使用。 此结构取代 TC_KEYDOWN 结构。
TCHITTESTINFO 包含有关命中测试的信息。 此结构取代 TC_HITTESTINFO 结构。
TCITEM 指定或接收选项卡项的属性。 它与 TCM_INSERTITEMTCM_GETITEMTCM_SETITEM 消息一起使用。 此结构取代 了TC_ITEM 结构。
TCITEMHEADER 指定或接收选项卡的属性。它与 TCM_INSERTITEMTCM_GETITEMTCM_SETITEM 消息一起使用。 此结构取代 了TC_ITEMHEADER 结构。

常量

主题 目录
Tab 控件扩展样式 选项卡控件现在支持扩展样式。 这些样式是使用 TCM_GETEXTENDEDSTYLETCM_SETEXTENDEDSTYLE 消息操作的,不应与传递给 CreateWindowEx 的扩展窗口样式混淆。
选项卡控件项状态 选项卡控件项现在支持项状态以支持 TCM_DESELECTALL 消息。 此外, TCITEM 结构还支持项状态值。
选项卡控件样式 本部分列出了支持的选项卡控件样式。