LocateChildWindow
CUTools
Beschreibung
Finden Sie untergeordnete Fenster (Child-Windows) in einer Anwendung! LocateChildWindow lokalisiert Dialoge, Panels, eingebettete Fenster und Controls - keine versteckten Fenster mehr, die Ihren Workflow blockieren!
Mit Unterstützung für Fensterklassen, Control-IDs und hierarchische Suche navigieren Sie durch komplexe UI-Strukturen - die Schlüsselkomponente für fortgeschrittene UI-Automation!
Warum dieses Tool überzeugt
- Child-Windows finden in Hierarchie
- Controls lokalisieren per Klasse
- Dialoge & Panels identifizieren
- Handle für direkte Interaktion
Perfekt geeignet für:
UI-Automation-Entwickler, QA-Tester und fortgeschrittene Power-User, die mit komplexen Anwendungen arbeiten. Ideal für Dialog-Interaktion, Control-Automatisierung und tiefgehende UI-Tests.
Unterstützung im Arbeitsablauf; Zeitersparnis hängt von der Aufgabe ab
Statt manuell durch verschachtelte Dialoge zu navigieren, finden Sie das gewünschte Child-Window sofort und interagieren direkt - ohne Umwege über den Hauptdialog.
JSON Parameter
- parentHandle ERFORDERLICH (Integer)Das Fenster-Handle (HWND) des übergeordneten Fensters. Kann über LocateAppWindow ermittelt werden.
- className OPTIONAL (String)Die Windows-Klasse des Child-Windows (z.B. "Button", "Edit", "#32770" für Dialoge)
- windowTitle OPTIONAL (String)Titel oder Teil des Titels des Child-Windows
- controlId OPTIONAL (Integer)Die Control-ID des Elements (für Dialog-Controls)
- index OPTIONAL (Integer)Index wenn mehrere passende Child-Windows existieren (0-basiert). Standard: 0
Beispielaufruf
{
"tool": "LocateChildWindow",
"params": {
"parentHandle": 123456,
"className": "Button",
"windowTitle": "OK"
}
}
Beispiel-Verwendung
Typischer AI-Befehl
- "Finde den OK-Button im Speichern-Dialog von Notepad und klicke darauf."
Rückgabewerte
Das Tool gibt ein Objekt mit den folgenden Eigenschaften zurück:
- success (Boolean)
True wenn ein Child-Window gefunden wurde - found (Boolean)
Ob ein passendes Child-Window existiert - windowHandle (Integer)
Fenster-Handle (HWND) des gefundenen Child-Windows - className (String)
Windows-Klasse des gefundenen Elements - windowTitle (String)
Titel des gefundenen Child-Windows - controlId (Integer)
Control-ID des Elements - x (Integer)
X-Position relativ zum Parent - y (Integer)
Y-Position relativ zum Parent - error (String, optional)
Fehlermeldung falls die Suche fehlgeschlagen ist
Verwandte Tools
CUTools herunterladen
Erhalten Sie Zugriff auf alle 17 Computer Use Tools für Windows-Automation.
Jetzt downloaden