Ir para o conteúdo
Todas as ferramentas

window_set_frame

Ecrã, janelas e interface · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Fixa uma janela (por window_id) em limites fixos {x,y,w,h} em pontos globais, para que cada tomada seja enquadrada de forma idêntica nas execuções. Retorna os limites reais pós-restrição. Recusa as janelas do próprio LMCP (sessões de automação web, bandeja) com own_window; use web_show para elas. Requer permissão de acessibilidade.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para window_set_frame. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Move e redimensiona uma janela para o retângulo indicado. Passe window_id (HWND de list_windows) e bounds {x,y,w,h}. Retorna os limites reais depois do movimento. A primeira chamada retorna uma prévia com o nome da janela e não move nada; confirm=true move-a. Somente para Windows.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para window_set_frame. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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