如何通过Win API提取Windows应用ListBox控件项文本？排查提取失败问题

为什么检查工具看不到文本、代码返回空结果？ #

• 非标准Win32 ListBox控件：很多应用会自定义外观类似ListBox的控件，这类控件不继承标准ListBox的消息处理逻辑，因此不响应LB_GETCOUNT、LB_GETTEXT等Win32消息，也不会暴露标准辅助功能文本属性。用Spy++查看控件类名，若不是ListBox则可确认。
• 跨进程内存操作未正确处理：如果是标准ListBox，但你的Python进程与目标应用进程位数不匹配（比如32位Python操作64位应用），或发送LB_GETTEXT时未使用跨进程内存缓冲区，会导致无法读取到文本——LB_GETTEXT要求缓冲区位于目标进程的内存空间，直接传递本地进程的缓冲区地址会失效，进而返回空结果或项数为0。
• 辅助功能属性未正确实现：部分应用（尤其是自定义控件）未遵循Windows辅助功能规范，没有在控件的自动化提供者中暴露Name或Value等文本属性，导致Accessibility Insights无法检测到文本。

如何提取ListBox控件的项文本？ #

方案1：修正跨进程的Win32消息调用（仅适用于标准ListBox） #

如果Spy++确认是标准ListBox类，需要处理跨进程内存操作，示例代码如下：

import win32gui
import win32api
import win32process
import win32con

def get_listbox_items(hwnd_listbox):
    # 获取控件所在进程ID和句柄
    pid = win32process.GetWindowThreadProcessId(hwnd_listbox)[1]
    h_process = win32api.OpenProcess(win32con.PROCESS_ALL_ACCESS, False, pid)
    
    # 获取项数量
    count = win32api.SendMessage(hwnd_listbox, win32con.LB_GETCOUNT, 0, 0)
    items = []
    
    for i in range(count):
        # 获取项文本长度
        text_len = win32api.SendMessage(hwnd_listbox, win32con.LB_GETTEXTLEN, i, 0)
        if text_len == -1:
            continue
        # 分配目标进程内的内存缓冲区
        buffer = win32api.VirtualAllocEx(h_process, None, text_len + 1, win32con.MEM_COMMIT, win32con.PAGE_READWRITE)
        # 发送LB_GETTEXT获取文本到缓冲区
        win32api.SendMessage(hwnd_listbox, win32con.LB_GETTEXT, i, buffer)
        # 读取缓冲区内容
        buffer_data = win32process.ReadProcessMemory(h_process, buffer, text_len + 1)
        item_text = buffer_data.decode('utf-16le')  # Windows控件文本多为UTF-16LE编码
        items.append(item_text)
        # 释放内存
        win32api.VirtualFreeEx(h_process, buffer, 0, win32con.MEM_RELEASE)
    
    win32api.CloseHandle(h_process)
    return items

注意：确保Python进程位数与目标应用一致，否则跨进程内存操作会失败。

方案2：使用UI Automation（UIA）框架（适用于标准/自定义控件） #

UIA是Windows官方的自动化框架，能兼容大多数控件（包括自定义控件，只要应用实现了基本的UIA支持）。可以用pywinauto库的UIA backend实现：

from pywinauto import Application

# 连接到目标应用，指定UIA backend
app = Application(backend='uia').connect(title='目标窗口标题')
# 定位ListBox控件（可根据控件类型、名称等属性调整定位逻辑）
list_box = app.window(title='目标窗口标题').child_control(control_type='List')
# 获取所有项的文本
items = list_box.items()
item_texts = [item.text() for item in items]

如果控件定位困难，可以用Windows SDK自带的Inspect工具查看控件的UIA属性，辅助精准定位。

方案3：枚举控件子元素（适用于部分自定义ListBox） #

部分自定义ListBox会将每个项作为独立的子控件（比如Static、Button类），可以通过枚举子窗口获取文本：

import win32gui

def enum_child_callback(hwnd, extra_data):
    text = win32gui.GetWindowText(hwnd)
    if text:
        extra_data.append(text)
    return True

def get_custom_list_items(hwnd_listbox):
    items = []
    win32gui.EnumChildWindows(hwnd_listbox, enum_child_callback, items)
    return items

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