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 postados, e não 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
keys
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": {
"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, por exemplo "ctrl+s", "ctrl+shift+n", "return", "alt+f4", "escape". Modificadores: ctrl, shift, alt, win (cmd é aceito como alias de ctrl). O último token é a tecla. unknown_key se a tecla não for reconhecida. Passe element_ref para mirar em um elemento (que recebe o foco primeiro); sem ele, as teclas vão para o aplicativo em foco, informado em sent_to.
Entradas obrigatórias
keys
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": {
"element_ref": {
"description": "Optional. Focus this element (from ui_find_element) before sending; refused with focus_failed, nothing sent, if the focus does not land in its app or its app is not the window in front; focus_lost (with sent_to and target) when another window was in front after the keys. Without it the keys go to whatever has the focus — check sent_to.",
"type": "string"
},
"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"
}