所有工具

window_set_frame

屏幕、窗口与界面 · macOS · Windows

效果: 写入. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置,并不表示它在所有安装中都已启用。

macOS

用途

根据 window_id 将窗口固定到全局点坐标中的指定边界 {x,y,w,h},使每次运行的画面构图保持一致。返回应用约束后的实际边界。需要辅助功能权限。

必填输入

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作;请检查效果并取得授权。

英文规范技术架构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(来自 list_windows 的 HWND)和边界 {x,y,w,h}。返回移动后的实际边界。仅限 Windows。

必填输入

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作;请检查效果并取得授权。

英文规范技术架构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"
}

文档示例

window_set_frame 的文档示例。请勿执行此示例。所示参数属于虚构数据集;在实际调用前,请解析真实标识符并获得授权。

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