Vai al contenuto
Tutti gli strumenti

list_windows

Schermo, finestre e interfaccia · macOS · Windows

Effetto: lettura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Elenca le finestre visibili sullo schermo di qualsiasi app con window_id, bundle id e nome dell'app proprietaria, titolo, limiti (spazio globale, in alto a sinistra, punti), display_id (il CGDirectDisplayID, corrispondente a list_displays, così puoi risalire a quale display si trova una finestra), layer (0 = normale finestra di app; diverso da zero = pannello/overlay/menu) e is_focused. I TITOLI delle finestre richiedono l'autorizzazione Registrazione schermo: senza di essa restituisce un errore esplicito permission_required invece di un risultato senza titoli. Filtro facoltativo app_bundle_id: tieni presente che le app in stile Electron spesso possiedono le loro finestre da un processo HELPER con un bundle id diverso, quindi un filtro può restituire un elenco vuoto anche se l'app è chiaramente sullo schermo. on_screen_only È TRUE PER IMPOSTAZIONE PREDEFINITA ed esclude le finestre minimizzate, nascoste e di altri Space; passa false per vederle. include_overlays È FALSE PER IMPOSTAZIONE PREDEFINITA ed esclude le finestre con layer diverso da zero (Centro Notifiche, widget, menu); passa true per includerle: usa layer nel risultato per distinguerle dalle finestre normali. include_minimized_state È FALSE PER IMPOSTAZIONE PREDEFINITA (una ricerca Accessibilità aggiuntiva per app, quindi è facoltativa); passa true per aggiungere `minimized` (true/false) a ogni finestra E, quando on_screen_only è true (il valore predefinito), riportare anche le finestre minimizzate che quel filtro altrimenti scarterebbe: SENZA Accessibilità concessa `minimized` è `null` (sconosciuto) e non viene riaggiunta alcuna finestra minimizzata, mai un false indovinato, così puoi trovare/acquisire una finestra minimizzata senza prima portarla in primo piano. Quando il risultato è vuoto questo strumento restituisce una `note` che spiega quale filtro l'ha svuotato e cosa passare al suo posto: leggila invece di concludere che l'app non ha finestre. window_id è stabile nella sessione per usi successivi.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per list_windows. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{}

Windows

Scopo

Elenca le finestre aperte su questo computer: ID finestra, app proprietaria (nome exe), pid, titolo, limiti {x,y,w,h} e ID di visualizzazione. Solo Windows (usa la API di finestre Win32). Filtra per app con app_bundle_id (su Windows una corrispondenza di sottostringa sul nome exe). on_screen_only È TRUE PER IMPOSTAZIONE PREDEFINITA ed esclude le finestre minimizzate e senza titolo (come list_windows di mac-swift, #3634); passa false per vederle. include_minimized_state È FALSE PER IMPOSTAZIONE PREDEFINITA; passa true per aggiungere `minimized` (true/false) a ogni finestra E, quando on_screen_only è true (il valore predefinito), mantenere anche le finestre minimizzate che quel filtro altrimenti scarterebbe (#3663, parità con mac-swift): a differenza della ricerca del Mac vincolata ad Accessibilità, IsIconic non richiede alcuna autorizzazione su Windows, quindi `minimized` si risolve sempre e qui non è mai null/sconosciuto.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per list_windows. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{}