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. Requer permissão de acessibilidade.
Entradas obrigatórias
window_idbounds
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.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em inglês — macOS
{
"properties": {
"bounds": {
"description": "{x,y,w,h} global points.",
"type": "object"
},
"window_id": {
"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 fornecido. Passe window_id (HWND de list_windows) e limites {x,y,w,h}. Retorna os limites reais pós-movimentação. Somente Windows.
Entradas obrigatórias
window_idbounds
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.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
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"
},
"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
},
"window_id": "101"
}