ℹ️

GetWindowState

CUTools

🔒 Sicherheitsstufe 1 - Lesen

📝 Beschreibung

Ermitteln Sie den aktuellen Zustand eines beliebigen Fensters! GetWindowState liefert Ihnen detaillierte Informationen über Fensterstatus, Position, Größe und Sichtbarkeit – perfekt für bedingte Automatisierungen und UI-Überwachung.

Prüfen Sie ob ein Fenster minimiert, maximiert, aktiv oder im Hintergrund ist. Wissen Sie immer genau, welche Anwendung wie angezeigt wird – die Basis für intelligente Fenstersteuerung!

🚀 Warum dieses Tool überzeugt

🔍 Fensterstatus prüfen in Echtzeit

📐 Position & Größe ermitteln

👁️ Sichtbarkeit überprüfen

🎯 Bedingte Aktionen ermöglichen

👤 Perfekt geeignet für:

Automatisierungs-Entwickler, QA-Tester und Power-User, die bedingte Abläufe basierend auf Fensterzuständen steuern müssen. Ideal für intelligente UI-Automation und Fenster-Management.

⏱️

Zeitersparnis: Bis zu 5 Minuten pro Prüfung

Statt manuell Fenster zu suchen und deren Status zu prüfen, erhalten Sie alle Informationen mit einem API-Aufruf – sofort verfügbar für Ihre Automatisierungslogik.

📊 JSON Parameter

windowHandle ERFORDERLICH (Integer)
Das Fenster-Handle (HWND) des zu prüfenden Fensters. Kann über ListWindows oder LocateAppWindow ermittelt werden.

💡 Beispielaufruf

{ "tool": "GetWindowState", "params": { "windowHandle": 123456 } }

💻 Beispiel-Verwendung

Typischer AI-Befehl

"Prüfe ob das Notepad-Fenster maximiert ist und bringe es in den Vordergrund, falls es minimiert ist."

🔄 Rückgabewerte

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

success (Boolean)
True wenn die Abfrage erfolgreich war

windowState (String)
Aktueller Zustand: "normal", "minimized", "maximized"

isVisible (Boolean)
Ob das Fenster sichtbar ist

isActive (Boolean)
Ob das Fenster aktiv/fokussiert ist

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 Abfrage 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