🧩

LocateChildWindow

CUTools

🔒 Sicherheitsstufe 1 - Lesen

📝 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.

⏱️

Zeitersparnis: Bis zu 15 Minuten pro Dialog

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

← Zurück zu CUTools