Todas as ferramentas

ui_keystroke

Ecrã, janelas e interface · macOS · Windows

Efeito: execução. 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

Envia uma combinação de teclas, por ex. "cmd+shift+5", "return", "cmd+,", "escape". Modificadores: cmd, shift, alt/option, ctrl, fn. O último token é a chave. Retorna {sent, delivery:"posted_not_confirmed"} — `sent` significa que os principais eventos foram POSTED, NOT e que o aplicativo agiu sobre eles: CGEvent não traz nenhuma confirmação de entrega e o efeito de um pressionamento de tecla é arbitrário, então nada pode ser lido para provar isso. Confirme o efeito com ui_get_element / ui_read_tree em vez de confiar em `sent`. Os modificadores são liberados após o combo, então um ui_type seguinte não é engolido. unknown_key se a chave não for reconhecida. 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": {
    "keys": {
      "description": "e.g. cmd+shift+5, return, cmd+,",
      "type": "string"
    }
  },
  "required": [
    "keys"
  ],
  "type": "object"
}

Exemplo documental

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

{
  "keys": "escape"
}

Windows

Finalidade

Envia uma combinação de teclas para o aplicativo em foco, por exemplo. "ctrl+s", "ctrl+shift+n", "return", "alt+f4", "escape". Modificadores: ctrl, shift, alt, win (cmd é aceito como alias para ctrl). O último token é a chave. unknown_key se a chave não for reconhecida.

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 — Windows
{
  "properties": {
    "keys": {
      "description": "e.g. ctrl+s, return, ctrl+shift+n",
      "type": "string"
    }
  },
  "required": [
    "keys"
  ],
  "type": "object"
}

Exemplo documental

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

{
  "keys": "escape"
}