Naar de inhoud
Alle hulpmiddelen

window_set_frame

Scherm, vensters en interface · macOS · Windows

Effect: schrijven. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Zet een venster (via window_id) vast op vaste grenzen {x,y,w,h} in globale punten, zodat elke opname bij elke uitvoering identiek wordt gekadreerd. Retourneert de werkelijke grenzen nadat de beperking is toegepast. Weigert de eigen vensters van LMCP (webautomatiseringssessies, tray) met own_window; gebruik daarvoor web_show. Vereist toegankelijkheidstoestemming.

Vereiste invoer

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor window_set_frame. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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

Windows

Doel

Verplaatst een venster en wijzigt het formaat naar de opgegeven rechthoek. Geef window_id (HWND uit list_windows) en bounds {x,y,w,h} mee. Geeft de werkelijke grenzen na de verplaatsing terug. De eerste aanroep geeft een voorbeeld terug met het venster en verplaatst niets; confirm=true verplaatst het. Alleen Windows.

Vereiste invoer

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor window_set_frame. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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