QT应用控件文本自动化测试：寻求替代Win32 API的Python/PyQt方案

Hey Kay, totally get where you're coming from—Win32 API works great for traditional Windows apps but struggles with Qt's custom widget hierarchy, since Qt handles a lot of its own rendering and window management under the hood. Here are some tailored alternatives that play nicely with Qt apps, using Python (with PyQt) or Qt/C++:

1. PyQt: Convert HWND to QWidget & Traverse the Qt Widget Tree #

Since you're already working with Python, this is a natural fit. You can still use Win32 API to grab the main window's HWND, then convert it to a Qt QWindow/QWidget to traverse the actual Qt widget hierarchy (not the Win32 window tree).

Example Code: #

import win32gui
from PyQt5.QtWidgets import QApplication, QWidget
from PyQt5.QtGui import QWindow

def get_main_qwidget(hwnd):
    # Ensure we have a Qt application instance
    app = QApplication.instance() or QApplication([])
    # Convert HWND to Qt QWindow
    qt_window = QWindow.fromWinId(hwnd)
    # Get the root QWidget attached to the window
    return qt_window.findChild(QWidget)

def traverse_qt_widgets(widget, indent=0):
    if not widget:
        return
    
    # Extract text based on widget type
    widget_text = ""
    if hasattr(widget, "text"):
        widget_text = widget.text()
    elif hasattr(widget, "windowTitle"):
        widget_text = widget.windowTitle()
    
    print(f"{'  '*indent}[{widget.objectName()}] {widget.metaObject().className()}: {widget_text}")
    
    # Recursively check child widgets
    for child in widget.children():
        if isinstance(child, QWidget):
            traverse_qt_widgets(child, indent + 1)

# Step 1: Grab main window HWND (use window title or class name)
main_hwnd = win32gui.FindWindow(None, "Your Qt App's Window Title")
if main_hwnd:
    main_widget = get_main_qwidget(main_hwnd)
    traverse_qt_widgets(main_widget)

Note: Make sure your PyQt version matches the Qt version used by the target app as closely as possible—this avoids compatibility issues with Qt's internal windowing logic.

2. Use Windows UI Automation (via Pywinauto) #

Qt apps automatically expose UI elements via Windows' UI Automation framework (when Qt's accessibility support is enabled, which is default). Tools like pywinauto can leverage this to access controls without needing direct Qt bindings.

Example Code: #

from pywinauto.application import Application

# Connect to the running Qt app (use title or process ID)
app = Application(backend="uia").connect(title="Your Qt App's Window Title")

# Get the main window object
main_win = app.window(title="Your Qt App's Window Title")

# Traverse all descendant controls and print their text
for control in main_win.descendants():
    try:
        control_class = control.class_name()
        control_text = control.window_text()
        print(f"{control_class}: {control_text}")
    except Exception as e:
        # Skip controls that don't expose text or have accessibility issues
        continue

Pros: No Qt version dependency, works with most Qt apps out of the box.

3. Qt Test Framework (For In-House Apps) #

If this is an app you're developing yourself, the Qt Test framework (available in C++ and via pytest-qt for Python) is the most reliable approach. It lets you directly access widget objects and validate their properties.

Python (pytest-qt) Example: #

from pytestqt.qt_compat import qt_api

def test_widget_text(qtbot):
    # Launch your app's main window (adjust based on your app's code)
    main_window = qt_api.QMainWindow()
    qtbot.addWidget(main_window)
    
    # Locate the target widget by object name
    status_label = main_window.findChild(qt_api.QLabel, "statusLabel")
    
    # Validate the text
    assert status_label.text() == "Expected Status Text"

C++ Qt Test Example Snippet:

#include <QTest>
#include <QMainWindow>
#include <QLabel>

class MyAppTest : public QObject
{
    Q_OBJECT
private slots:
    void testLabelText() {
        QMainWindow mainWin;
        QLabel* statusLabel = mainWin.findChild<QLabel*>("statusLabel");
        QCOMPARE(statusLabel->text(), QString("Expected Status Text"));
    }
};

QTEST_MAIN(MyAppTest)
#include "test.moc"

4. Qt Script Injection (Advanced, Limited Use) #

If the target app enables Qt Scripting, you can inject a script to query widget properties. This requires the app to have QScriptEngine enabled, which is rare for production apps—so this is a last-resort option.

Final Recommendations: #

• For third-party Qt apps: Start with pywinauto (UIA backend) for simplicity, then fall back to the PyQt HWND conversion method if needed.
• For in-house apps: Use the Qt Test framework for direct, reliable validation.

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