WinAPI Tab Control控件遍历问题：无法同时遍历标签与子控件

我完全理解你遇到的困境——默认的WS_EX_CONTROLPARENT样式要么让你跳过Tab标签直接进子控件，要么只能遍历标签却碰不到面板里的按钮。要实现你想要的Tab1→Button1→Button2→Button3→Button Clear→Tab2→...循环遍历顺序，我们需要手动接管Tab键的遍历逻辑，结合两种样式的优势。

问题根源 #

• 当给Tab Control加上WS_EX_CONTROLPARENT时，系统会把它当作“容器控件”，Tab键遍历会直接进入它的子窗口（面板里的按钮），跳过Tab本身的标签项。
• 移除这个样式后，Tab标签可以被遍历，但系统不会自动遍历Tab Control内部的子控件，因为它不再被识别为容器。

解决方案 #

我们需要做以下几点修改：

1. 移除Tab Control的WS_EX_CONTROLPARENT扩展样式，保留主窗口的该样式，确保Tab标签能被正常遍历。
2. 拦截WM_GETDLGCODE消息，告诉系统我们要手动处理Tab键消息。
3. 编写自定义的控件遍历函数，按照你期望的顺序找到下一个/上一个要聚焦的控件。
4. 在主窗口消息循环中，处理Tab键的按下事件，调用自定义遍历函数。

修改后的完整代码 #

#include <windows.h>
#include <windowsx.h>
#include <tchar.h>
#include <commctrl.h>
#pragma comment(lib,"comctl32.lib")
#pragma comment(linker,"/manifestdependency:\"type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' processorArchitecture='*' publicKeyToken='6595b64144ccf1df' language='*'\"")

#define TAB_ITEMS 3
#define BUTTONS_PER_PANE 3
#define IDS_PER_PANE 20

typedef enum { id_tab = 100, id_pane, id_group_box, id_first_button, id_edit = 1000, id_clear } controls_id;
#define PANE_ID(pane) (id_pane + pane * IDS_PER_PANE)
#define GR_BOX_ID(pane) (id_group_box + pane * IDS_PER_PANE)
#define BUTTON_ID(pane,num) (id_first_button + pane * IDS_PER_PANE + num)

HWND hWin, hTab, hPane[TAB_ITEMS];
LONG_PTR def_comctl_proc = NULL;
int current_pane_id = 0;
int new_pane_id = 0;

// 自定义遍历：找到下一个要聚焦的控件（forward为TRUE是Tab，FALSE是Shift+Tab）
HWND GetNextControl(HWND current, BOOL forward) {
    // 先整理所有需要遍历的控件顺序
    HWND controls[100];
    int idx = 0;
    int current_idx = -1;

    // 按照期望顺序添加控件
    for (int i = 0; i < TAB_ITEMS; i++) {
        // 添加Tab控件（代表当前Tab标签）
        controls[idx++] = hTab;
        // 添加当前Tab面板的按钮
        for (int j = 0; j < BUTTONS_PER_PANE; j++) {
            controls[idx++] = GetDlgItem(hPane[i], BUTTON_ID(i, j));
        }
        // 添加Clear按钮
        controls[idx++] = GetDlgItem(hWin, id_clear);
    }

    // 找到当前控件在列表中的位置
    for (int i = 0; i < idx; i++) {
        if (controls[i] == current) {
            current_idx = i;
            break;
        }
    }

    // 处理循环遍历
    if (current_idx == -1) {
        // 如果当前不在列表中，默认回到第一个控件（Tab1）
        return controls[0];
    }

    int next_idx;
    if (forward) {
        next_idx = (current_idx + 1) % idx;
    } else {
        next_idx = (current_idx - 1 + idx) % idx;
    }

    // 特殊处理：如果下一个是Tab控件，自动切换到对应标签和面板
    if (controls[next_idx] == hTab) {
        // 计算要切换的Tab索引
        int tab_idx = (next_idx / (BUTTONS_PER_PANE + 1)) % TAB_ITEMS;
        TabCtrl_SetCurSel(hTab, tab_idx);
        // 切换面板显示状态
        ShowWindow(hPane[current_pane_id], SW_HIDE);
        ShowWindow(hPane[tab_idx], SW_SHOW);
        current_pane_id = tab_idx;
    }

    return controls[next_idx];
}

LRESULT CALLBACK PaneProc(HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam) {
    if (Msg == WM_COMMAND) {
        WORD button = LOWORD(wParam);
        int ind;
        // 获取面板索引
        for (ind = 0; ind < TAB_ITEMS; ind++)
            if (hWnd == hPane[ind])
                break;
        // 处理按钮点击
        if (button >= BUTTON_ID(ind, 0) && button < BUTTON_ID(ind, BUTTONS_PER_PANE)) {
            TCHAR bff[32];
            _stprintf_s(bff, _T("Pane %u, Button %u"), ind + 1, (button - BUTTON_ID(ind, 0)) + 1);
            SetDlgItemText(hWin, id_edit, bff);
        }
        return TRUE;
    }
    // 告诉系统我们要处理Tab键
    else if (Msg == WM_GETDLGCODE) {
        return DLGC_WANTTAB | CallWindowProc((WNDPROC)def_comctl_proc, hWnd, Msg, wParam, lParam);
    }
    return CallWindowProc((WNDPROC)def_comctl_proc, hWnd, Msg, wParam, lParam);
}

void CreateControls(HWND hWnd) {
    HINSTANCE hInst = GetModuleHandle(NULL);
    TCHAR bff[32];
    TCITEM tie;
    int dx, dy, tdx, tdy;
    RECT rc, rc_tab;
    GetClientRect(hWnd, &rc);
    dx = rc.right - rc.left;
    dy = rc.bottom - rc.top;

    // 移除Tab Control的WS_EX_CONTROLPARENT，让Tab标签可被遍历
    hTab = CreateWindowEx(0, WC_TABCONTROL, _T(""), WS_VISIBLE | WS_CHILD | WS_CLIPSIBLINGS | WS_TABSTOP, 0, 0 ,dx, 120, hWnd, (HMENU)id_tab, hInst, NULL);

    // 创建Tab项及面板控件
    for (int i = 0; i < TAB_ITEMS; i++) {
        // 插入Tab标签
        ZeroMemory(&tie, sizeof(TCITEM));
        _stprintf_s(bff, _T("Tab %u"), i + 1);
        tie.mask = TCIF_TEXT | TCIF_IMAGE;
        tie.pszText = bff;
        tie.iImage = -1;
        TabCtrl_InsertItem(hTab, i, &tie);
        // 创建面板窗口
        GetClientRect(hTab, &rc_tab);
        tdx = rc_tab.right - rc_tab.left;
        tdy = rc_tab.bottom - rc_tab.top;
        TabCtrl_AdjustRect(hTab, FALSE, &rc_tab);
        hPane[i] = CreateWindowEx(WS_EX_CONTROLPARENT, WC_STATIC, _T(""), WS_VISIBLE | WS_CHILD | WS_CLIPSIBLINGS | WS_TABSTOP, rc_tab.left, rc_tab.top, rc_tab.right - rc_tab.left, rc_tab.bottom - rc_tab.top, hTab, (HMENU)PANE_ID(i), hInst, NULL);
        // 设置面板窗口过程
        def_comctl_proc = SetWindowLongPtr(hPane[i], GWLP_WNDPROC, (LONG_PTR)PaneProc);
        // 创建分组框
        _stprintf_s(bff, _T("Pane %u controls"), i + 1);
        CreateWindowEx(NULL, WC_BUTTON, bff, WS_VISIBLE | WS_CHILD | BS_GROUPBOX, 10, 10, 10 + BUTTONS_PER_PANE*80, 70, hPane[i], (HMENU)GR_BOX_ID(i), hInst, NULL);
        // 创建面板内的按钮
        for (int j = 0; j < BUTTONS_PER_PANE; j++) {
            _stprintf_s(bff, _T("Button\r\n--- &%u ---"), j + 1);
            CreateWindowEx(NULL, WC_BUTTON, bff, WS_VISIBLE | WS_CHILD | WS_TABSTOP | BS_MULTILINE, 20 + j*80, 30, 70, 40, hPane[i], (HMENU)BUTTON_ID(i, j), hInst, NULL);
        }
        // 只显示第一个面板
        ShowWindow(hPane[i], i ? SW_HIDE : SW_SHOW);
    }
    TabCtrl_SetCurSel(hTab, 0);
    // 创建消息编辑框
    CreateWindowEx(WS_EX_CLIENTEDGE, WC_EDIT, _T(""), WS_VISIBLE | WS_CHILD | ES_AUTOHSCROLL | ES_READONLY, 10, 130, 200, 20, hWnd, (HMENU)id_edit, hInst, NULL);
    // 创建Clear按钮
    CreateWindowEx(NULL, WC_BUTTON, _T("&Clear"), WS_VISIBLE | WS_CHILD | WS_TABSTOP, 220, 129, 70, 22, hWnd, (HMENU)id_clear, hInst, NULL);
}

LRESULT CALLBACK WndProcedure(HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam) {
    switch (Msg) {
        case WM_CREATE:
            CreateControls(hWnd);
            break;
        case WM_COMMAND:
            if (LOWORD(wParam) == id_clear)
                SetDlgItemText(hWin, id_edit, _T("")) ;
            break;
        case WM_NOTIFY:
        {
            NMHDR& nmh = *(LPNMHDR)lParam;
            if (nmh.idFrom == id_tab) {
                switch (nmh.code) {
                    case TCN_SELCHANGING:
                        return FALSE;
                    case TCN_SELCHANGE:
                        new_pane_id = TabCtrl_GetCurSel(nmh.hwndFrom);
                        ShowWindow(hPane[current_pane_id], SW_HIDE);
                        ShowWindow(hPane[new_pane_id], SW_SHOW);
                        SetFocus(GetDlgItem(hPane[new_pane_id], BUTTON_ID(new_pane_id, 0)));
                        current_pane_id = new_pane_id;
                        break;
                }
                return TRUE;
            }
        }
        break;
        // 处理Tab键按下事件
        case WM_KEYDOWN:
            if (wParam == VK_TAB) {
                BOOL forward = !(GetKeyState(VK_SHIFT) & 0x8000);
                HWND current = GetFocus();
                HWND next = GetNextControl(current, forward);
                if (next) {
                    SetFocus(next);
                    return TRUE;
                }
            }
            break;
        // 告诉系统我们要接管Tab键处理
        case WM_GETDLGCODE:
            return DLGC_WANTTAB | DefWindowProc(hWnd, Msg, wParam, lParam);
        case WM_DESTROY:
            PostQuitMessage(0);
            break;
        default:
            return (DefWindowProc(hWnd, Msg, wParam, lParam));
    }
    return FALSE;
}

LPCTSTR ClsName = _T("Tab_Control_Tester");
LPCTSTR WndName = _T("Tab Control Tester");

INT WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) {
    MSG Msg;
    WNDCLASSEX WndClsEx;
    RECT rc;
    int dx = 320, dy = 200;
    WndClsEx.cbSize = sizeof(WNDCLASSEX);
    WndClsEx.style = CS_HREDRAW | CS_VREDRAW;
    WndClsEx.lpfnWndProc = WndProcedure;
    WndClsEx.cbClsExtra = 0;
    WndClsEx.cbWndExtra = 0;
    WndClsEx.hIcon = LoadIcon(NULL, IDI_APPLICATION);
    WndClsEx.hCursor = LoadCursor(NULL, IDC_ARROW);
    WndClsEx.hbrBackground = (HBRUSH)COLOR_BTNSHADOW;
    WndClsEx.lpszMenuName = NULL;
    WndClsEx.lpszClassName = ClsName;
    WndClsEx.hInstance = hInstance;
    WndClsEx.hIconSm = NULL;
    RegisterClassEx(&WndClsEx);

    {
        INITCOMMONCONTROLSEX icc = { sizeof(INITCOMMONCONTROLSEX), ICC_WIN95_CLASSES };
        InitCommonControlsEx(&icc);
    }

    Msg.wParam = 0;
    GetWindowRect(GetDesktopWindow(),&rc);
    if (rc.right < dx) dx = rc.right - 96;
    if (rc.bottom < dy) dy = rc.bottom - 96;
    hWin = CreateWindowEx(WS_EX_CONTROLPARENT, ClsName, WndName, WS_OVERLAPPEDWINDOW, (rc.right - dx)/2, (rc.bottom - dy)/2, dx, dy, NULL, NULL, hInstance, NULL);
    if (!hWin) goto _exit_WinMain;

    ShowWindow(hWin, SW_SHOWNORMAL);
    UpdateWindow(hWin);

    while (GetMessage(&Msg, NULL, 0, 0)) {
        if (!IsDialogMessage(hWin, &Msg)) {
            TranslateMessage(&Msg);
            DispatchMessage(&Msg);
        }
    }

_exit_WinMain:
    return (int)Msg.wParam;
}

关键修改说明 #

1. 移除Tab Control的WS_EX_CONTROLPARENT：让Tab标签本身可以被Tab键遍历到，用户可通过左右箭头切换标签。
2. 添加GetNextControl函数：严格按照你期望的顺序生成遍历列表，处理循环逻辑，同时在遍历到Tab控件时自动切换对应面板。
3. 拦截WM_KEYDOWN和WM_GETDLGCODE：手动接管Tab键事件，调用自定义遍历逻辑，告诉系统我们要处理Tab键。
4. 优化TCN_SELCHANGE逻辑：切换Tab时自动将焦点设置到当前面板的第一个按钮，保证遍历流畅性。

现在运行修改后的代码，就能实现你想要的循环遍历顺序了。

内容的提问来源于stack exchange，提问作者Duke Nukem