Todas as ferramentas

window_focus

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

Traz uma janela (por window_id de list_windows) para a frente e ativa seu aplicativo. window_not_found se não puder ser resolvido. 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êsmacOS
{
  "properties": {
    "window_id": {
      "type": "string"
    }
  },
  "required": [
    "window_id"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para window_focus. 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.

{
  "window_id": "101"
}

Windows

Finalidade

Traz uma janela para a frente e dá foco. Passe window_id (o HWND de list_windows). Somente 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 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êsWindows
{
  "properties": {
    "window_id": {
      "description": "The window id (HWND as a decimal string) from list_windows.",
      "type": "string"
    }
  },
  "required": [
    "window_id"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para window_focus. 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.

{
  "window_id": "101"
}