TabCtrl_InsertItem 是一个在 Win32 API 中用于向选项卡控件中插入一个新的标签项的函数，声明在 Commctrl.h 头文件中。其声明如下：
int TabCtrl_InsertItem(
  HWND            hwnd,
  int             iItem,
  const TCITEM *  pitem
);

这个函数的参数包括：
  •  hwnd: 指定选项卡控件的句柄。

  •  iItem: 要插入的标签项的索引，从零开始。如果为 -1，则表示在末尾插入。

  •  pitem: 一个指向 TCITEM 结构的指针，包含了新标签项的信息，例如文本、图像、状态等。


TCITEM 结构定义如下：
typedef struct tagTCITEM {
  UINT mask;
  DWORD dwState;
  DWORD dwStateMask;
  LPWSTR pszText;
  int    cchTextMax;
  int    iImage;
  LPARAM lParam;
} TCITEM, *LPTCITEM;

使用示例：
// 假设 hwndTab 是选项卡控件的句柄
TCITEM tabItem = { 0 };
tabItem.mask = TCIF_TEXT | TCIF_IMAGE; // 指定文本和图像
tabItem.pszText = L"New Tab";
tabItem.iImage = 0; // 图像索引

int newIndex = TabCtrl_InsertItem(hwndTab, -1, &tabItem);

if (newIndex != -1) {
    // 成功插入新的标签项，newIndex 中包含了新标签项的索引
} else {
    // 插入失败
}

这个函数通常用于在运行时向选项卡控件中插入新的标签项，以便在显示中动态添加标签。


转载请注明出处：http://www.zyzy.cn/article/detail/24816/Win32 API/Commctrl.h/TabCtrl_InsertItem