Todas las herramientas

window_focus

Pantalla, ventanas e interfaz · macOS · Windows

Efecto: escritura. 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

Trae una ventana (por window_id de list_windows) al frente y activa su aplicación. window_not_found si no se puede resolver. Requiere permiso de accesibilidad.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

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ésmacOS
{
  "properties": {
    "window_id": {
      "type": "string"
    }
  },
  "required": [
    "window_id"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para window_focus. 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.

{
  "window_id": "101"
}

Windows

Propósito

Trae una ventana al frente y le da enfoque. Pase window_id (el HWND de list_windows). Sólo Windows.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

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ésWindows
{
  "properties": {
    "window_id": {
      "description": "The window id (HWND as a decimal string) from list_windows.",
      "type": "string"
    }
  },
  "required": [
    "window_id"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para window_focus. 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.

{
  "window_id": "101"
}