C#通过Win32 API操作窗口句柄：枚举、查找与控件交互实践

微软专家

在Windows桌面开发中，经常需要与外部进程的窗口或控件进行交互，比如自动化测试、辅助工具或系统集成。C#可以通过P/Invoke调用Win32 API来实现窗口句柄的操作，包括枚举已打开的窗口、按标题或类名查找窗体、遍历子控件以及发送模拟点击。本文将基于这些API封装一个实用的WndHelper帮助类，并介绍其核心方法与使用场景。

首先需要添加System.Runtime.InteropServices引用，并定义必要的委托和API签名。核心的user32.dll函数包括：EnumWindows用于枚举所有顶层窗口；EnumChildWindows用于遍历指定父窗口的子窗口；FindWindow和FindWindowEx用于按类名和窗口名精确查找；GetParent、IsWindowVisible、GetWindowText、GetClassName和GetWindowRect用于获取窗口状态和属性。

2. using System;
3. using System.Collections.Generic;
4. using System.Drawing;
5. using System.Runtime.InteropServices;
6. using System.Text;
8. public class WndHelper
9. {
10.     private delegate bool WndEnumProc(IntPtr hWnd, int lParam);
12.     [DllImport("user32")]
13.     private static extern bool EnumWindows(WndEnumProc lpEnumFunc, int lParam);
15.     [DllImport("user32.dll")]
16.     [return: MarshalAs(UnmanagedType.Bool)]
17.     private static extern bool EnumChildWindows(IntPtr hwndParent, WndEnumProc lpEnumFunc, int lParam);
19.     [DllImport("user32.dll", EntryPoint = "FindWindow", SetLastError = true)]
20.     private static extern IntPtr FindWindow(string lpClassName, string lpWindowName);
22.     [DllImport("user32.dll", EntryPoint = "FindWindowEx", SetLastError = true)]
23.     private static extern IntPtr FindWindowEx(IntPtr hwndParent, uint hwndChildAfter, string lpszClass, string lpszWindow);
25.     [DllImport("user32")]
26.     private static extern IntPtr GetParent(IntPtr hWnd);
28.     [DllImport("user32")]
29.     private static extern bool IsWindowVisible(IntPtr hWnd);
31.     [DllImport("user32")]
32.     private static extern int GetWindowText(IntPtr hWnd, StringBuilder lptrString, int nMaxCount);
34.     [DllImport("user32")]
35.     private static extern int GetClassName(IntPtr hWnd, StringBuilder lpString, int nMaxCount);
37.     [DllImport("user32")]
38.     private static extern bool GetWindowRect(IntPtr hWnd, ref LPRECT rect);
40.     [StructLayout(LayoutKind.Sequential)]
41.     private readonly struct LPRECT
42.     {
43.         public readonly int Left;
44.         public readonly int Top;
45.         public readonly int Right;
46.         public readonly int Bottom;
47.     }
48. }

复制代码

为了方便存储窗口信息，定义WindowInfo结构体，包含句柄、类名、标题、可见性和边界矩形。通过计算Bounds可以判断窗口是否最小化（Left和Top均为-32000）。

2. public readonly struct WindowInfo
3. {
4.     public WindowInfo(IntPtr hWnd, string className, string title, bool isVisible, Rectangle bounds)
5.     {
6.         Hwnd = hWnd;
7.         ClassName = className;
8.         Title = title;
9.         IsVisible = isVisible;
10.         Bounds = bounds;
11.     }
13.     public IntPtr Hwnd { get; }
14.     public string ClassName { get; }
15.     public string Title { get; }
16.     public bool IsVisible { get; }
17.     public Rectangle Bounds { get; }
18.     public bool IsMinimized => Bounds.Left == -32000 && Bounds.Top == -32000;
19. }

复制代码

枚举所有顶层窗口时，EnumWindows的回调函数会为每个窗口调用一次。在回调中，通过GetParent判断是否为顶层窗口（从Windows 8起EnumWindows只返回桌面应用顶层窗口，可省去该判断），然后获取类名、标题、可见性和矩形信息，构造成WindowInfo添加到列表中。

2. private static List<WindowInfo> windowList;
4. public static IReadOnlyList<WindowInfo> FindAllWindows(Predicate<WindowInfo> match = null)
5. {
6.     windowList = new List<WindowInfo>();
7.     EnumWindows(OnWindowEnum, 0);
8.     return windowList.FindAll(match ?? DefaultPredicate);
9. }
11. private static bool OnWindowEnum(IntPtr hWnd, int lparam)
12. {
13.     if (GetParent(hWnd) == IntPtr.Zero)
14.     {
15.         var classNameBuilder = new StringBuilder(512);
16.         GetClassName(hWnd, classNameBuilder, classNameBuilder.Capacity);
17.         var className = classNameBuilder.ToString();
19.         var titleBuilder = new StringBuilder(512);
20.         GetWindowText(hWnd, titleBuilder, titleBuilder.Capacity);
21.         var title = titleBuilder.ToString().Trim();
23.         var isVisible = IsWindowVisible(hWnd);
25.         LPRECT rect = default;
26.         GetWindowRect(hWnd, ref rect);
27.         var bounds = new Rectangle(rect.Left, rect.Top, rect.Right - rect.Left, rect.Bottom - rect.Top);
29.         windowList.Add(new WindowInfo(hWnd, className, title, isVisible, bounds));
30.     }
31.     return true;
32. }
34. private static readonly Predicate<WindowInfo> DefaultPredicate = x => x.IsVisible && !x.IsMinimized && x.Title.Length > 0;

复制代码

调用示例：获取所有可见窗口并打印信息，或按标题过滤。

2. var windows = WndHelper.FindAllWindows();
3. foreach (var w in windows)
4.     Console.WriteLine($"{w.Title} - {w.Bounds.X},{w.Bounds.Y}");
6. // 按标题包含“Test”过滤
7. var testWindows = WndHelper.FindAllWindows(x => x.Title.Contains("Test"));

复制代码

查找特定窗口句柄时，优先使用FindWindow（按类名和窗口名查找顶层窗口）和FindWindowEx（按父窗口、类名和窗口名查找子窗口）。注意第三个参数lpszClass是Windows类名，不是C#的类名，如果不知道可传null，但可能会匹配多个；最好通过GetClassName确认。另外，如果按钮或控件绑定了快捷键（如“否(&N)”），查找时也必须传入完整的带&的字符串。

2. // 查找标题为“测试”的顶层窗口
3. IntPtr hWnd = WndHelper.FindWindow(null, "测试");
4. if (hWnd != IntPtr.Zero)
5. {
6.     // 查找子按钮“点击测试”（假设按钮文本为此）
7.     IntPtr btnHandle = WndHelper.FindWindowEx(hWnd, IntPtr.Zero, null, "点击测试");
8.     if (btnHandle != IntPtr.Zero)
9.     {
10.         // 发送点击消息（假设WndHelper中有SendClick方法）
11.         WndHelper.SendClick(btnHandle);
12.     }
13. }
15. // 查找MessageBox弹窗中的“否(&N)”按钮
16. IntPtr msgBoxHwnd = WndHelper.FindWindow(null, "测试");
17. if (msgBoxHwnd != IntPtr.Zero)
18. {
19.     IntPtr noBtn = WndHelper.FindWindowEx(msgBoxHwnd, IntPtr.Zero, null, "否(&N)");
20.     if (noBtn != IntPtr.Zero)
21.         WndHelper.SendClick(noBtn);
22. }

复制代码

注意：FindWindow和FindWindowEx在winuser.h中定义为FindWindowW（Unicode）或FindWindowA（ANSI），直接使用不带后缀的版本即可，编译器会根据项目设置自动选择。

多线程使用时，上述实现中的静态字段windowList可能产生竞争条件。建议改为在每次调用时创建局部列表，并通过回调参数传递，或者使用Concurrent集合。

以上方法适用于Windows桌面应用的窗口自动化、测试工具开发或系统监控场景。通过组合EnumWindows、FindWindow和FindWindowEx，可以灵活地定位目标窗口及其子控件，然后利用SendMessage或PostMessage模拟用户操作。

热心网友1

非常干货的分享，代码结构清晰，注释也到位。Win32 API配合P/Invoke确实是做窗口自动化绕不开的老路子，你用WindowInfo封装避免了重复调API确实省心。想追问一个点：FindWindowEx里那个uint类型的hChildAfter（代码里写的是uint hwndChildAfter），实际调用时一般传0或IntPtr.Zero，但这里用uint会不会在一些64位进程中导致精度丢失？另外如果目标窗口是UWP或WinUI 3的，光靠Win32句柄可能抓不到子控件吧？有没有什么变通思路？