Windows开发实战：如何高效获取当前窗口句柄的5种方法对比

7次阅读

共计 3448 个字符，预计需要花费 9 分钟才能阅读完成。

在 Windows 桌面应用开发中，准确获取当前活动窗口句柄（Window Handle）是许多实际场景的基础需求。比如在开发自动化测试工具时，我们需要精确控制被测应用程序的窗口；又或者在开发窗口管理工具时，需要动态调整各个窗口的位置和大小。这些场景都离不开对当前窗口句柄的获取。本文将介绍 5 种常用的方法，并对比它们的优缺点，帮助新手开发者快速掌握这一关键技术。

GetForegroundWindow是 Win32 API 中最基础的获取当前活动窗口的方法。它直接返回当前处于前台的窗口句柄，使用非常简单。

适用场景：适用于简单的单线程应用场景，不需要考虑多线程或多显示器的情况。

关键 API 函数解析：

HWND GetForegroundWindow()：返回当前前台窗口的句柄。

代码示例（C++）：

#include <windows.h>

int main() {HWND hwnd = GetForegroundWindow();
    if (hwnd == NULL) {
        // 错误处理
        DWORD error = GetLastError();
        printf("GetForegroundWindow failed with error %d\n", error);
        return 1;
    }
    printf("Current foreground window handle: %p\n", hwnd);
    return 0;
}

性能数据：

平均调用耗时：< 1ms
优点：简单直接，调用速度快
缺点：在多线程或多显示器环境下可能不够准确

GetGUIThreadInfo可以获取指定线程的 GUI 信息，包括当前活动窗口和焦点窗口。

适用场景：适用于多线程环境，尤其是需要处理多个 GUI 线程的场景。

关键 API 函数解析：

BOOL GetGUIThreadInfo(DWORD idThread, PGUITHREADINFO pgui)：获取指定线程的 GUI 信息。

代码示例（C++）：

#include <windows.h>

int main() {
    GUITHREADINFO gti;
    gti.cbSize = sizeof(GUITHREADINFO);
    if (!GetGUIThreadInfo(0, &gti)) {
        // 错误处理
        DWORD error = GetLastError();
        printf("GetGUIThreadInfo failed with error %d\n", error);
        return 1;
    }
    printf("Current active window handle: %p\n", gti.hwndActive);
    return 0;
}

性能数据：

平均调用耗时：1-2ms
优点：可以处理多线程环境
缺点：需要额外的结构体初始化

EnumWindows可以枚举所有顶层窗口，结合 GetWindowText 可以找到特定的窗口。

适用场景：适用于需要根据窗口标题或其他属性查找特定窗口的场景。

关键 API 函数解析：

BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam)：枚举所有顶层窗口。
int GetWindowText(HWND hWnd, LPTSTR lpString, int nMaxCount)：获取窗口标题。

代码示例（C++）：

#include <windows.h>
#include <tchar.h>

BOOL CALLBACK EnumWindowsProc(HWND hwnd, LPARAM lParam) {TCHAR title[256];
    GetWindowText(hwnd, title, 256);
    if (_tcslen(title) > 0) {_tprintf(_T("Window handle: %p, Title: %s\n"), hwnd, title);
    }
    return TRUE;
}

int main() {EnumWindows(EnumWindowsProc, 0);
    return 0;
}

性能数据：

平均调用耗时：10-50ms（取决于窗口数量）
优点：可以获取所有窗口信息
缺点：性能开销较大

UI Automation 是微软提供的跨框架 UI 访问技术，支持 WPF、WinForms 等多种 UI 框架。

适用场景：适用于需要跨框架访问 UI 元素的场景。

关键 API 函数解析：

IUIAutomation::ElementFromHandle：从窗口句柄获取 UI 元素。

代码示例（C#）：

using System;
using System.Windows.Automation;

class Program {static void Main() {AutomationElement element = AutomationElement.FromHandle(GetForegroundWindow());
        Console.WriteLine("Current window name:" + element.Current.Name);
    }

    [System.Runtime.InteropServices.DllImport("user32.dll")]
    static extern IntPtr GetForegroundWindow();}

性能数据：

平均调用耗时：5-10ms
优点：跨框架支持
缺点：需要额外的 COM 组件

低级 Hook 技术可以拦截系统消息，获取窗口状态变化的信息。

适用场景：适用于需要实时监控窗口状态变化的场景。

关键 API 函数解析：

SetWindowsHookEx：设置钩子。

代码示例（C++）：

#include <windows.h>

HHOOK g_hook;

LRESULT CALLBACK CallWndProc(int nCode, WPARAM wParam, LPARAM lParam) {if (nCode == HC_ACTION) {CWPSTRUCT* pMsg = (CWPSTRUCT*)lParam;
        if (pMsg->message == WM_ACTIVATE) {printf("Window activated: %p\n", pMsg->hwnd);
        }
    }
    return CallNextHookEx(g_hook, nCode, wParam, lParam);
}

int main() {g_hook = SetWindowsHookEx(WH_CALLWNDPROC, CallWndProc, NULL, GetCurrentThreadId());
    if (g_hook == NULL) {DWORD error = GetLastError();
        printf("SetWindowsHookEx failed with error %d\n", error);
        return 1;
    }
    // 消息循环
    MSG msg;
    while (GetMessage(&msg, NULL, 0, 0)) {TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    UnhookWindowsHookEx(g_hook);
    return 0;
}

性能数据：