Saltar al contenido
Todas las herramientas

list_windows

Pantalla, ventanas e interfaz · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Enumera las ventanas en pantalla de cualquier aplicación con window_id, ID del paquete y nombre de la aplicación propietaria, título, límites (espacio global, parte superior izquierda, puntos), display_id (el CGDirectDisplayID: coincide con list_displays, para que pueda buscar en qué pantalla está una ventana), layer (0 = ventana normal de aplicación; distinto de cero = panel/superposición/menú) e is_focused. Los TÍTULOS de las ventanas requieren permiso de grabación de pantalla; sin él, esto devuelve un error permission_required explícito en lugar de un resultado sin título. Filtro app_bundle_id opcional: tenga en cuenta que las aplicaciones de estilo Electron a menudo poseen sus ventanas desde un proceso HELPER con un identificador de paquete diferente, por lo que un filtro puede volver vacío mientras la aplicación está claramente en la pantalla. `on_screen_only` es `true` de forma predeterminada y excluye ventanas minimizadas, ocultas y de otros espacios; pasa `false` para verlas. include_overlays es FALSE DE FORMA PREDETERMINADA y excluye las ventanas de capa distinta de cero (Centro de notificaciones, widgets, menús); pase true para incluirlas; use layer en el resultado para distinguirlas de las ventanas normales. include_minimized_state es FALSE DE FORMA PREDETERMINADA (una consulta de Accesibilidad adicional por aplicación, por lo que es opcional); pase true para agregar `minimized` (true/false) a cada ventana Y, cuando on_screen_only es true (el valor predeterminado), recuperar también las ventanas minimizadas que ese filtro descartaría; SIN Accesibilidad concedida, `minimized` es `null` (desconocido) y no se recupera ninguna ventana minimizada, nunca un false supuesto, de modo que puede encontrar o capturar una ventana minimizada sin traerla antes al frente. Cuando el resultado está vacío, esta herramienta devuelve un `note` que explica qué filtro lo vació y qué pasar en su lugar; léalo en lugar de concluir que la aplicación no tiene ventanas. window_id se mantiene estable dentro de la sesión para una orientación posterior.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para list_windows. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{}

Windows

Propósito

Enumera las ventanas abiertas en esta máquina: ID de ventana, aplicación propietaria (nombre del exe), pid, título, límites {x,y,w,h} e ID de visualización. Solo para Windows (utiliza la API de ventanas Win32). Filtre por aplicación con app_bundle_id (una coincidencia de subcadena del nombre del exe en Windows). on_screen_only es TRUE DE FORMA PREDETERMINADA y excluye las ventanas minimizadas y sin título (refleja list_windows de mac-swift, #3634); pase false para verlas. include_minimized_state es FALSE DE FORMA PREDETERMINADA; pase true para agregar `minimized` (true/false) a cada ventana Y, cuando on_screen_only es true (el valor predeterminado), conservar también las ventanas minimizadas que ese filtro descartaría (paridad #3663 con mac-swift); a diferencia de la consulta de Accesibilidad de Mac, IsIconic no necesita ningún permiso en Windows, por lo que `minimized` siempre se resuelve y aquí nunca es null/desconocido.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para list_windows. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{}