window_set_frame

Écran, fenêtres et interface · macOS · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Épingle une fenêtre (par window_id) à des limites fixes {x,y,w,h} en points globaux, de sorte que chaque prise soit encadrée de manière identique d'une exécution à l'autre. Renvoie les limites post-contraintes réelles. Refuse les propres fenêtres de LMCP (sessions d'automatisation web, tray) avec own_window ; utilisez web_show pour celles-ci. Nécessite une autorisation d’accessibilité.

Entrées requises

window_id
bounds

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour window_set_frame. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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

Windows

Objectif

Déplace et redimensionne une fenêtre selon le rectangle donné. Passez window_id (HWND issu de list_windows) et bounds {x,y,w,h}. Renvoie les bounds réels après le déplacement. Le premier appel renvoie un aperçu indiquant la fenêtre et ne déplace rien ; confirm=true la déplace. Windows uniquement.

Entrées requises

window_id
bounds

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

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