🎨

LocateGUIElement

CUTools

🔒 Sicherheitsstufe 1 - Lesen

📝 Beschreibung

Finden Sie spezifische GUI-Elemente wie Buttons, Eingabefelder oder Labels! LocateGUIElement ermöglicht die automatische Lokalisierung von UI-Controls anhand verschiedener Kriterien – UI-Automation ohne Koordinaten-Rätselraten!

Mit Unterstützung für Automations-IDs, Namen, Klassen und Text-Inhalte identifizieren Sie jedes interaktive Element – die Grundlage für robuste und wartbare UI-Automatisierung!

🚀 Warum dieses Tool überzeugt

🔍 Elemente finden per ID/Name

🎯 Precise Lokalisierung von Controls

🤖 Robuste Automation ohne Koordinaten

📍 Bildschirmkoordinaten ermitteln

👤 Perfekt geeignet für:

RPA-Entwickler, QA-Automation-Engineers und fortgeschrittene UI-Tester. Ideal für robuste Test-Automation, die auch funktioniert wenn sich die UI leicht ändert.

⏱️

Zeitersparnis: Bis zu 20 Minuten pro Testlauf

Statt mit festen Koordinaten zu arbeiten, die bei jeder UI-Änderung brechen, finden Sie Elemente dynamisch – robuste Tests, die lange halten!

📊 JSON Parameter

parentHandle OPTIONAL (Integer)
Das übergeordnete Fenster. Wenn nicht angegeben, wird der gesamte Desktop durchsucht.

automationId OPTIONAL (String)
Die Automation-ID des Elements (bei modernen UI-Frameworks)

name OPTIONAL (String)
Der Name/Label des Elements (z.B. "OK", "Benutzername")

className OPTIONAL (String)
Die Windows-Klasse des Elements (z.B. "Button", "Edit")

controlType OPTIONAL (String)
Der Control-Typ (z.B. "Button", "TextBox", "ComboBox")

index OPTIONAL (Integer)
Index wenn mehrere passende Elemente existieren. Standard: 0

💡 Beispielaufruf

{ "tool": "LocateGUIElement", "params": { "parentHandle": 123456, "name": "OK", "controlType": "Button" } }

💻 Beispiel-Verwendung

Typischer AI-Befehl

"Finde das Eingabefeld 'Benutzername' im Login-Formular und gib 'admin' ein."

🔄 Rückgabewerte

Das Tool gibt ein Objekt mit den folgenden Eigenschaften zurück:

success (Boolean)
True wenn ein Element gefunden wurde

found (Boolean)
Ob ein passendes Element existiert

elementHandle (Integer)
Handle des gefundenen GUI-Elements

name (String)
Name/Label des Elements

controlType (String)
Typ des Controls

screenX (Integer)
X-Koordinate auf dem Bildschirm

screenY (Integer)
Y-Koordinate auf dem Bildschirm

width (Integer)
Breite des Elements

height (Integer)
Höhe des Elements

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