Win32 API中EnumChildWindows第二个参数的Python使用疑问

EnumChildWindows的第二个参数是回调函数——系统每找到一个子窗口，就会自动调用这个函数一次，把找到的子窗口句柄和你传入的自定义数据（第三个参数）递进去。

回调函数的要求 #

• 必须接受两个参数：第一个是当前枚举到的子窗口句柄hwnd_child，第二个是你通过EnumChildWindows第三个参数传入的自定义数据
• 必须返回True（让系统继续枚举下一个子窗口）或False（立刻停止枚举）

最基础的用法：收集所有子窗口HWND到列表 #

先定义回调函数，把每个找到的子窗口句柄存到列表里：

def enum_child_callback(hwnd_child, child_list):
    # child_list就是我们传入的空列表，把当前子窗口句柄加进去
    child_list.append(hwnd_child)
    # 返回True，让系统继续找下一个
    return True

然后调用EnumChildWindows：

import win32gui

window_title_text = "你的目标窗口标题"
hwnd = win32gui.FindWindow(None, window_title_text) 

child_windows = []
# 第二个参数直接传我们定义的回调函数名
win32gui.EnumChildWindows(hwnd, enum_child_callback, child_windows)

# 现在child_windows里就是所有子窗口的HWND了，遍历处理
for hwnd in child_windows:
    control_text = win32gui.GetWindowText(hwnd)
    print(f"子窗口HWND: {hwnd}, 控件文本: {control_text}")

进阶：直接在回调里查找目标控件 #

如果你的目标是找到特定文本的控件，不用先收集所有句柄再遍历——可以在回调里直接判断，找到就停止枚举：

import win32gui

window_title_text = "你的目标窗口标题"
target_control_text = "要找的控件文本"
target_hwnd = None  # 用来存找到的目标控件句柄

def find_target_callback(hwnd_child, _):
    global target_hwnd
    current_text = win32gui.GetWindowText(hwnd_child)
    if current_text == target_control_text:
        target_hwnd = hwnd_child
        return False  # 找到就返回False，停止枚举
    return True

hwnd = win32gui.FindWindow(None, window_title_text) 
win32gui.EnumChildWindows(hwnd, find_target_callback, None)

if target_hwnd:
    print(f"找到目标控件，HWND: {target_hwnd}")
else:
    print("未找到目标控件")

为什么要这么设计？ #

系统枚举子窗口是逐个进行的，回调机制让你可以灵活处理每个子窗口——比如过滤不需要的句柄、提前终止枚举，不用等所有子窗口都枚举完再处理，效率更高。

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