Naar de inhoud
Alle hulpmiddelen

list_windows

Scherm, vensters en interface · macOS · Windows

Effect: lezen. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Toont de zichtbare vensters van elke app met window_id, bundle-id en naam van de eigenaar-app, titel, grenzen (globale ruimte, linksboven, punten), display_id (de CGDirectDisplayID — komt overeen met list_displays, zodat u kunt opzoeken op welk scherm een venster staat), layer (0 = normaal appvenster; niet nul = paneel/overlay/menu) en is_focused. Venster-TITELS vereisen de machtiging Schermopname — zonder die machtiging retourneert dit een expliciete permission_required-fout in plaats van een resultaat zonder titels. Optioneel filter app_bundle_id — let op dat apps in Electron-stijl hun vensters vaak bezitten vanuit een HELPER-proces met een andere bundle-id, zodat een filter leeg kan terugkomen terwijl de app duidelijk op het scherm staat. on_screen_only STAAT STANDAARD OP TRUE en sluit geminimaliseerde, verborgen en vensters op andere Spaces uit; geef false mee om ze te zien. include_overlays STAAT STANDAARD OP FALSE en sluit vensters met een laag die niet nul is uit (Berichtencentrum, widgets, menu's); geef true mee om ze op te nemen — gebruik layer in het resultaat om ze van normale vensters te onderscheiden. include_minimized_state STAAT STANDAARD OP FALSE (een extra Toegankelijkheid-opzoeking per app, dus optioneel); geef true mee om `minimized` (true/false) aan elk venster toe te voegen EN, wanneer on_screen_only true is (de standaard), ook de geminimaliseerde vensters terug te brengen die dat filter anders zou weglaten — ZONDER verleende Toegankelijkheid is `minimized` gelijk aan `null` (onbekend) en worden geen geminimaliseerde vensters teruggebracht, nooit een geraden false, zodat u een geminimaliseerd venster kunt vinden/vastleggen zonder het eerst naar voren te halen. Wanneer het resultaat leeg is, retourneert deze tool een `note` die uitlegt welk filter het leeg maakte en wat in plaats daarvan moet worden meegegeven — lees die in plaats van te concluderen dat de app geen vensters heeft. window_id is binnen de sessie stabiel voor later gebruik.

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor list_windows. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{}

Windows

Doel

Toont de geopende vensters op deze computer: venster-ID, eigenaar-app (naam van uitvoerbaar bestand), pid, titel, grenzen {x,y,w,h} en scherm-ID. Alleen Windows (gebruikt de Win32-venster-API). Filter op app met app_bundle_id (op Windows een overeenkomst op een deel van de naam van het uitvoerbare bestand). on_screen_only STAAT STANDAARD OP TRUE en sluit geminimaliseerde vensters en vensters zonder titel uit (komt overeen met list_windows van mac-swift, #3634); geef false mee om ze te zien. include_minimized_state STAAT STANDAARD OP FALSE; geef true mee om `minimized` (true/false) aan elk venster toe te voegen EN, wanneer on_screen_only true is (de standaard), ook de geminimaliseerde vensters te behouden die dat filter anders zou weglaten (#3663, pariteit met mac-swift) — anders dan de door Toegankelijkheid afgeschermde opzoeking op de Mac heeft IsIconic op Windows geen machtiging nodig, dus `minimized` wordt hier altijd bepaald en is nooit null/onbekend.

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor list_windows. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{}