🎯

LocateAppWindow

CUTools

🔒 Sicherheitsstufe 1 - Lesen

📝 Beschreibung

Finden Sie das Hauptfenster einer beliebigen Anwendung! LocateAppWindow lokalisiert Fenster anhand des Prozessnamens oder Fenstertitels und liefert Handle, Position und Größe – egal wo sie auf dem Desktop versteckt sind!

Mit flexiblen Suchoptionen für teilweise Übereinstimmungen und Filter nach Sichtbarkeit finden Sie jedes Fenster – die Grundlage für alle weiteren Fensteroperationen!

🚀 Warum dieses Tool überzeugt

🔍 Schnelle Lokalisierung per Name

📐 Position & Größe ermitteln

🔎 Teilweise Übereinstimmung möglich

🎯 Handle für weitere Operationen

👤 Perfekt geeignet für:

Entwickler, Automatisierungs-Experten und Power-User, die gezielt bestimmte Anwendungsfenster finden und steuern müssen. Ideal für UI-Automation, Test-Szenarien und Workflow-Optimierung.

⏱️

Zeitersparnis: Bis zu 10 Minuten pro Suche

Statt manuell nach versteckten oder minimierten Fenstern zu suchen, finden Sie sie sofort anhand des Namens – mit allen Details für sofortige Weiterverarbeitung.

📊 JSON Parameter

processName OPTIONAL (String)
Name des Prozesses (z.B. "notepad.exe", "chrome.exe"). Entweder processName oder windowTitle muss angegeben werden.

windowTitle OPTIONAL (String)
Titel oder Teil des Fenstertitels. Entweder processName oder windowTitle muss angegeben werden.

exactMatch OPTIONAL (Boolean)
Ob exakte Übereinstimmung erforderlich ist. Standard: false (Teilübereinstimmung erlaubt)

💡 Beispielaufruf

{ "tool": "LocateAppWindow", "params": { "processName": "notepad.exe" } }

Beispiel mit Fenstertitel:

{ "tool": "LocateAppWindow", "params": { "windowTitle": "Unbenannt", "exactMatch": false } }

💻 Beispiel-Verwendung

Typischer AI-Befehl

"Finde das Chrome-Fenster mit dem Titel 'Dokument' und positioniere es auf dem linken Monitor."

🔄 Rückgabewerte

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

success (Boolean)
True wenn ein Fenster gefunden wurde

found (Boolean)
Ob ein passendes Fenster existiert

windowHandle (Integer)
Fenster-Handle (HWND) des gefundenen Fensters

windowTitle (String)
Tatsächlicher Titel des gefundenen Fensters

processName (String)
Name des zugehörigen Prozesses

x (Integer)
X-Position des Fensters

y (Integer)
Y-Position des Fensters

width (Integer)
Breite des Fensters

height (Integer)
Höhe des Fensters

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