Vai al contenuto
Tutti gli strumenti

window_set_frame

Schermo, finestre e interfaccia · macOS · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

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

macOS

Scopo

Fissa una finestra (tramite window_id) a limiti fissi {x,y,w,h} in punti globali, così ogni ripresa ha la stessa identica inquadratura tra un'esecuzione e l'altra. Restituisce i limiti effettivi dopo l'applicazione dei vincoli. Rifiuta le finestre proprie di LMCP (sessioni di automazione web, tray) con own_window; per quelle usa web_show. Richiede l'autorizzazione Accessibilità.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

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": {
    "bounds": {
      "description": "{x,y,w,h} global points.",
      "type": "object"
    },
    "window_id": {
      "description": "Window to move or resize, from list_windows.",
      "type": "string"
    }
  },
  "required": [
    "window_id",
    "bounds"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per window_set_frame. 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.

{
  "bounds": {
    "h": 720,
    "w": 1280,
    "x": 100,
    "y": 100
  },
  "window_id": "101"
}

Windows

Scopo

Sposta e ridimensiona una finestra secondo il rettangolo indicato. Passa window_id (HWND da list_windows) e bounds {x,y,w,h}. Restituisce i limiti effettivi dopo lo spostamento. La prima chiamata restituisce un'anteprima che indica la finestra e non sposta nulla; confirm=true la sposta. Solo Windows.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — Windows
{
  "properties": {
    "bounds": {
      "description": "Target rectangle in pixels.",
      "properties": {
        "h": {
          "type": "integer"
        },
        "w": {
          "type": "integer"
        },
        "x": {
          "type": "integer"
        },
        "y": {
          "type": "integer"
        }
      },
      "required": [
        "x",
        "y",
        "w",
        "h"
      ],
      "type": "object"
    },
    "confirm": {
      "description": "Must be true to act on the window. Without it, returns a preview.",
      "type": "boolean"
    },
    "window_id": {
      "description": "The window id (HWND as a decimal string) from list_windows.",
      "type": "string"
    }
  },
  "required": [
    "window_id",
    "bounds"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per window_set_frame. 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.

{
  "bounds": {
    "h": 720,
    "w": 1280,
    "x": 100,
    "y": 100
  },
  "confirm": false,
  "window_id": "101"
}