通过

Tab （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 包含有关 Tab 控件中按键的信息。 它与 TCN_KEYDOWN 通知代码一起使用。 此结构取代 TC_KEYDOWN 结构。
TCHITTESTINFO 包含有关命中测试的信息。 此结构取代 TC_HITTESTINFO 结构。
TCITEM 指定或接收选项卡项的属性。 它与 TCM_INSERTITEM、TCM_GETITEM和 TCM_SETITEM 消息一起使用。 此结构取代 TC_ITEM 结构。
TCITEMHEADER 指定或接收选项卡的属性。它与 TCM_INSERTITEM、TCM_GETITEM和 TCM_SETITEM 消息一起使用。 此结构取代 TC_ITEMHEADER 结构。

常数

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