window_set_frame

Экран, окна и интерфейс · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Закрепляет окно (по window_id) в фиксированных границах {x,y,w,h} в глобальных точках, чтобы каждый снимок имел одинаковое кадрирование при разных запусках. Возвращает фактические границы после применения ограничений. Требуется разрешение Accessibility.

Обязательные входные данные

window_id
bounds

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "bounds": {
      "description": "{x,y,w,h} global points.",
      "type": "object"
    },
    "window_id": {
      "type": "string"
    }
  },
  "required": [
    "window_id",
    "bounds"
  ],
  "type": "object"
}

Пример для документации

Пример документации для window_set_frame. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

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

Windows

Назначение

Перемещает окно и изменяет его размер в соответствии с указанным прямоугольником. Передайте window_id (HWND из list_windows) и границы {x,y,w,h}. Возвращает фактические границы после перемещения. Только для Windows.

Обязательные входные данные

window_id
bounds

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
    },
    "window_id": {
      "description": "The window id (HWND as a decimal string) from list_windows.",
      "type": "string"
    }
  },
  "required": [
    "window_id",
    "bounds"
  ],
  "type": "object"
}

Пример для документации

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