选项卡（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_INSERTITEM、TCM_GETITEM 和 TCM_SETITEM 消息一起使用。 此结构可取代 TC_ITEM 结构。
TCITEMHEADER	指定或接收选项卡的属性。它与 TCM_INSERTITEM、TCM_GETITEM 和 TCM_SETITEM 消息一起使用。 此结构可取代 TC_ITEMHEADER 结构。

常量

主题	目录
选项卡控件扩展样式	选项卡控件现在支持扩展样式。 这些样式通过 TCM_GETEXTENDEDSTYLE 和 TCM_SETEXTENDEDSTYLE 消息进行操作，不应与传递给 CreateWindowEx 的扩展窗口样式混淆。
选项卡控件项状态	选项卡控制项目现在支持项目状态，以支持 TCM_DESELECTALL 消息。 此外，TCITEM 结构还支持项目状态值。
选项卡控件样式	本节列出了支持的选项卡控件样式。