Zum Inhalt springen
Alle Werkzeuge

list_windows

Bildschirm, Fenster und Oberfläche · macOS · Windows

Wirkung: Lesen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Listet Bildschirmfenster jeder App auf, mit window_id, Bundle-ID und Name der besitzenden App, Titel, Grenzen (globaler Raum, oben links, Punkte), display_id (die CGDirectDisplayID – entspricht list_displays, sodass Sie nachschlagen können, auf welchem Display sich ein Fenster befindet), layer (0 = normales App-Fenster; ungleich null = Panel/Overlay/Menü) und is_focused. Für Fenster-TITEL ist die Berechtigung zur Bildschirmaufnahme erforderlich – ohne sie wird ein expliziter permission_required-Fehler zurückgegeben und kein Ergebnis ohne Titel. Optionaler app_bundle_id-Filter – beachten Sie, dass Apps im Electron-Stil ihre Fenster oft von einem HELPER-Prozess mit anderer Bundle-ID besitzen, sodass ein Filter leer zurückkommen kann, obwohl die App deutlich auf dem Bildschirm zu sehen ist. on_screen_only ist STANDARDMÄSSIG TRUE und schließt minimierte, versteckte und auf anderen Spaces liegende Fenster aus; übergeben Sie false, um sie zu sehen. include_overlays ist STANDARDMÄSSIG FALSE und schließt Fenster mit einer Ebene ungleich null aus (Mitteilungszentrale, Widgets, Menüs); übergeben Sie true, um sie einzubeziehen – nutzen Sie layer im Ergebnis, um sie von normalen Fenstern zu unterscheiden. include_minimized_state ist STANDARDMÄSSIG FALSE (eine zusätzliche Bedienungshilfen-Abfrage pro App, daher optional); übergeben Sie true, um jedem Fenster `minimized` (true/false) hinzuzufügen UND, wenn on_screen_only true ist (Standard), auch die minimierten Fenster zurückzubringen, die dieser Filter sonst verwerfen würde – OHNE erteilte Bedienungshilfen ist `minimized` gleich `null` (unbekannt) und es werden keine minimierten Fenster zurückgebracht, nie ein geratenes false, sodass Sie ein minimiertes Fenster finden/erfassen können, ohne es zuvor nach vorn zu holen. Wenn das Ergebnis leer ist, gibt dieses Tool ein `note` zurück, das erklärt, welcher Filter es geleert hat und was stattdessen zu übergeben ist – lesen Sie es, anstatt zu schließen, die App habe keine Fenster. window_id ist innerhalb der Sitzung für spätere Zugriffe stabil.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Kanonisches technisches Schema auf Englisch — macOS
{
  "properties": {
    "app_bundle_id": {
      "description": "Only return windows owned by this app bundle id.",
      "type": "string"
    },
    "include_minimized_state": {
      "description": "Add `minimized` (true/false) to each window via an Accessibility lookup; null without Accessibility granted (default false).",
      "type": "boolean"
    },
    "include_overlays": {
      "description": "Include non-zero-layer windows — Notification Center, desktop widgets, menus (default false).",
      "type": "boolean"
    },
    "on_screen_only": {
      "description": "Only on-screen windows (default true).",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für list_windows. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{}

Windows

Zweck

Listet die geöffneten Fenster auf diesem Computer auf: Fenster-ID, besitzende App (exe-Name), PID, Titel, Grenzen {x,y,w,h} und Display-ID. Nur Windows (verwendet die Win32-Fenster-API). Filtern Sie nach App mit app_bundle_id (unter Windows ein Teilstring-Abgleich auf den exe-Namen). on_screen_only ist STANDARDMÄSSIG TRUE und schließt minimierte und titellose Fenster aus (entspricht list_windows von mac-swift, #3634); übergeben Sie false, um sie zu sehen. include_minimized_state ist STANDARDMÄSSIG FALSE; übergeben Sie true, um jedem Fenster `minimized` (true/false) hinzuzufügen UND, wenn on_screen_only true ist (Standard), auch die minimierten Fenster beizubehalten, die dieser Filter sonst verwerfen würde (#3663, Parität mit mac-swift) – anders als die durch Bedienungshilfen geschützte Abfrage auf dem Mac benötigt IsIconic unter Windows keine Berechtigung, sodass `minimized` hier immer aufgelöst wird und nie null/unbekannt ist.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Kanonisches technisches Schema auf Englisch — Windows
{
  "properties": {
    "app_bundle_id": {
      "description": "Filter to windows owned by this app. On Windows, a case-insensitive substring of the exe name (e.g. 'chrome').",
      "type": "string"
    },
    "include_minimized_state": {
      "description": "Add `minimized` (true/false) to each window, and keep minimized windows under on_screen_only:true instead of dropping them (default false).",
      "type": "boolean"
    },
    "on_screen_only": {
      "description": "Only return visible, non-minimized, non-empty-title windows (default true).",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für list_windows. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{}