Passos, Script e AutoHotkey
O que uma ação faz pode ser escrito de três formas. Escrita como, no cartão O que ela faz da página Ações, escolhe qual delas é executada.
| Modo | O que é | Escolha-o quando |
|---|---|---|
| Passos | Uma lista de passos que você escolhe e preenche, uma linha cada. Nenhum código para digitar. | Você quer montar a ação sem escrever código. A maioria das ações cabe aqui: enviar teclas, digitar texto, mover ou fechar janelas, aguardar, fazer uma pergunta. |
| Script | A própria linguagem de script do Input.Observer, digitada em um editor de código. | Você precisa de aritmética, montar texto a partir de partes, repetições que contam com uma variável, ou qualquer coisa que o Passos não consiga expressar. |
| AutoHotkey | Um script do AutoHotkey v2, executado pelo próprio AutoHotkey. | Você já tem código do AutoHotkey, ou precisa de algo que só o AutoHotkey faz. |
Passos e Script são executados dentro do Input.Observer e chamam as mesmas funções internas: o Passos é uma forma visual de escrever o que um script escreveria. Consulte Passos e a Referência da linguagem de script.
Cada modo mantém o próprio conteúdo
Uma ação contém um conteúdo de Passos, um conteúdo de Script e um conteúdo de AutoHotkey lado a lado. Alternar Escrita como ① muda qual deles é executado. Isso nunca exclui os outros, então você pode voltar.
Se o modo que você selecionar estiver vazio enquanto outro modo tem conteúdo, um aviso abaixo da chave diz que executar a ação não faz nada, e oferece um botão para usar o modo que tem conteúdo.
Mudar de Passos para Script
Quando você muda de Passos para Script enquanto a ação tem passos e o conteúdo de Script dela está vazio, o Input.Observer oferece traduzir os passos: Converter os passos em um script? Escolha Converter para colocar a tradução no editor de Script.
- Os passos ficam como estão. Voltar para Passos os mostra inalterados.
- Nada converte de volta. Um script não pode ser transformado em passos.
- Passos que usam Repetir enquanto…, Repetir até…, Sair da repetição ou Parar os passos não são oferecidos para tradução, porque o Script não tem instruções equivalentes. Você ainda pode mudar; o conteúdo de Script simplesmente começa vazio.
- O AutoHotkey nunca é convertido para outro modo nem a partir de outro modo.
- Quando os passos são uma gravação da página Gravador, a caixa de diálogo também diz que o script ignora Velocidade de reprodução e Detalhe do trajeto do mouse na reprodução: as esperas dele ocorrem na velocidade gravada e cada movimento do mouse gravado é reproduzido (Configurações do gravador).
De Passos para Script mostra no que cada tipo de passo se transforma.
AutoHotkey
O AutoHotkey é um programa separado que o Input.Observer inicia quando uma ação do AutoHotkey é executada. Ele não está incluído; você mesmo instala o AutoHotkey v2 e informa ao Input.Observer onde ele está.
- Instale o AutoHotkey v2.
- Na página Geral, ative Ativar AutoHotkey e defina Executável do AutoHotkey como o
arquivo de programa dele, como
AutoHotkey64.exe. - AutoHotkey passa a aparecer em Escrita como. Aplique as alterações para que o mecanismo use a nova configuração.
As regras:
- AutoHotkey é oferecido em Escrita como somente enquanto Ativar AutoHotkey estiver ligada, ou quando a ação já é executada como AutoHotkey. Uma ação do AutoHotkey com o AutoHotkey desligado não faz nada, e a página avisa isso.
- Use uma compilação normal do AutoHotkey. As compilações com
_UIAno nome, comoAutoHotkey64_UIA.exe, não conseguem executar scripts a partir do Input.Observer. - Quando o AutoHotkey está ligado, mas o programa dele não é encontrado na inicialização ou quando a configuração é recarregada, o Input.Observer pede que você escolha Procurar o executável do AutoHotkey ou Deixar como está.
- Cada execução inicia um novo processo do AutoHotkey com o seu script. Ele não pode chamar as funções internas do Input.Observer. Com Aguardar a conclusão ligado, a ação é executada até o script terminar sozinho, e a tecla de atalho para parar todas as ações o encerra (Scripts que continuam em execução).
- Antes do seu script, o Input.Observer define variáveis que descrevem o gatilho, como
IO_ActionName,IO_TriggerKinde a janela do gesto ou da tecla de atalho (Variáveis do AutoHotkey). A lista Variáveis disponíveis aqui do editor mostra as que os gatilhos da ação fornecem; clique em uma para inseri-la. - O que o script escreve na saída padrão dele aparece no console de diagnóstico, começando com
AHK:(O console de diagnóstico).
Uma ação de Passos ou de Script também pode executar um trecho de código do AutoHotkey com a função
interna AutoHotkeyExecuteScript, que aguarda a conclusão dele, ou iniciar um com
AutoHotkeyStartScript, que não aguarda. Valem a mesma configuração e o mesmo executável.
Scripts que continuam em execução
Um script do AutoHotkey com teclas de atalho, hotstrings ou um temporizador continua em execução depois da última linha. Para iniciar um assim pelo Input.Observer, desligue Aguardar a conclusão abaixo do editor do AutoHotkey. A opção aparece onde houver um conteúdo do AutoHotkey: ações, scripts Antes e Depois, eventos globais e snippets.
| Aguardar a conclusão ligado | Aguardar a conclusão desligado | |
|---|---|---|
| A ação | É executada até o script terminar | Termina assim que o AutoHotkey é iniciado |
| O que o script escreve | Aparece no console de diagnóstico, começando com AHK: | Não é exibido |
| Um erro de sintaxe | Aparece no console de diagnóstico | O AutoHotkey mostra a própria caixa de erro |
| A tecla de atalho para parar todas as ações | Encerra o script | Deixa-o em execução |
| Salvar as configurações ou Recarregar configuração | Encerra o script, junto com as outras ações em execução | Deixa-o em execução, a menos que o evento Configuração carregada o tenha iniciado |
| O Input.Observer sai | Encerra o script | Encerra o script |
Um script que Configuração carregada iniciou é encerrado quando as configurações são salvas ou recarregadas, porque esse evento é executado de novo e inicia uma cópia nova. Sem isso, cada salvamento deixaria mais uma cópia em execução. Para manter uma cópia de um script em execução durante toda a sessão, coloque-o em Configuração carregada com Aguardar a conclusão desligado.
AutoHotkeyStartScript funciona do mesmo jeito que a opção desligada e retorna o id do processo do
AutoHotkey que iniciou.
Variáveis do AutoHotkey
Toda execução do AutoHotkey começa com algumas linhas que o Input.Observer adiciona antes do seu
script, definindo variáveis IO_ a partir do que disparou a ação. Isso vale para uma ação escrita como
AutoHotkey e para o código executado com AutoHotkeyExecuteScript ou AutoHotkeyStartScript, que
recebe as variáveis da ação que o chamou.
Toda execução define estas três:
| Variável | Contém |
|---|---|
IO_ActionName | O nome da ação. Para um evento global, Global_Event_ seguido do nome do evento no arquivo de configuração, como Global_Event_release ou Global_Event_foreground_changed. Vazia quando nada disparou a execução, como um script executado pelo console. |
IO_AppGroupName | O nome do grupo de aplicativos em que a ação foi encontrada, como Global. Vazia para um evento global. |
IO_TriggerKind | O que disparou a execução: Gesture, Hotkey, TextExpansion, MouseButton (um gatilho de combinação de botões, ou um evento global de botão do mouse ou de Botão de desenho solto), Wheel (um gatilho de roda ou um evento global da roda) ou None. |
As outras dependem do gatilho, e somente as desse gatilho são definidas:
| Gatilho | Variável | Contém |
|---|---|---|
| Gesto | IO_GestureWindow | A janela sobre a qual o gesto começou |
IO_GestureButton | O botão de desenho: left, right, middle, x1 ou x2, ou key para a tecla de desenho | |
IO_GestureStartX, IO_GestureStartY | Onde o traço começou | |
IO_GestureEndX, IO_GestureEndY | Onde ele terminou | |
IO_GestureBoundsLeft, IO_GestureBoundsTop, IO_GestureBoundsRight, IO_GestureBoundsBottom | O retângulo em torno do traço inteiro | |
IO_GesturePoints | Cada ponto do traço na ordem do desenho, como uma matriz de matrizes [x, y] | |
| Tecla de atalho | IO_HotkeyWindow | A janela que estava na frente quando a tecla de atalho foi pressionada |
IO_HotkeyVkCode | O código de tecla virtual do Windows da tecla final, como 75 para K | |
IO_HotkeyModifiers | As teclas modificadoras da combinação, somadas: Ctrl 1, Shift 2, Alt 4, Win 8 (Ctrl+Alt é 5) | |
| Expansão de texto | IO_TextExpansionWindow | A janela em que você digitou |
IO_TextExpansionPattern | A abreviação que você digitou | |
| Evento de botão do mouse | IO_MouseWindow | A janela sob o ponteiro |
IO_MouseButton | O botão: left, right, middle, x1 ou x2; para Botão de desenho solto depois de um gesto desenhado com a tecla de desenho, key | |
IO_MouseX, IO_MouseY | Onde o ponteiro estava | |
| Gatilho de roda ou evento da roda | IO_WheelWindow | Para um gatilho de roda, a janela sobre a qual você pressionou o botão de desenho; para um evento da roda, a janela sob o ponteiro |
IO_WheelDelta | Quanto a roda girou, como o Windows informa: 120 por entalhe de uma roda comum (rodas de rolagem suave e touchpads enviam passos menores), positivo para longe de você (ou para a direita), negativo para perto de você (ou para a esquerda). Um gatilho de roda sempre recebe 120 ou -120 | |
IO_WheelHorizontal | true para um giro lateral da roda, false para um comum | |
IO_WheelX, IO_WheelY | Onde o ponteiro estava | |
IO_WheelButton | Para um gatilho de roda, o botão de desenho que você manteve pressionado: left, right, middle, x1 ou x2, ou key para a tecla de desenho. Vazia para um evento da roda |
- As janelas são identificadores de janela, números que o AutoHotkey lê como um id de janela:
"ahk_id " IO_GestureWindownomeia a janela emWinActivate,WinGetTitlee nas outras funções de janela. - As posições são coordenadas de tela em pixels físicos, a partir do canto superior esquerdo do
monitor principal. Defina
CoordMode "Mouse", "Screen"antes de usá-las com as funções de mouse do AutoHotkey, que caso contrário trabalham em relação à janela ativa. - O texto chega exatamente como era; aspas, acentos graves e quebras de linha no nome de uma ação ou de um grupo são escapados para você.
- Uma variável que o gatilho não fornece não é definida de jeito nenhum, e o AutoHotkey para o
script quando lê uma variável não definida. Uma ação com vários tipos de gatilho, ou um snippet
chamado por ações diferentes, deve verificar antes
IO_TriggerKind, ou usarIsSet(IO_GestureWindow).
Por exemplo, uma ação executada a partir de um gesto ou de uma tecla de atalho, que traz para a frente a janela em que foi usada e mostra o título dela:
CoordMode "Mouse", "Screen"
win := IO_TriggerKind = "Gesture" ? IO_GestureWindow : IO_HotkeyWindow
WinActivate "ahk_id " win
MsgBox WinGetTitle("ahk_id " win), IO_ActionName
Mecanismos de script de plug-ins
Um plug-in pode adicionar um mecanismo de script próprio. Ele então aparece em Escrita como com o nome do plug-in, e o texto que você digita ali vai para o plug-in exatamente como foi escrito; o Input.Observer não o verifica. Consulte Plug-ins.
- Nenhum plug-in registrado fornece o mecanismo, por exemplo porque o plug-in foi removido: Escrita como marca o mecanismo como não registrado, e um aviso abaixo dele diz que o script é ignorado quando executado. A ação então não faz nada, e nenhuma mensagem informa isso.
- O plug-in está registrado, mas não pode executar o script, por exemplo porque está desabilitado, parado ou reiniciando: a ação não é executada e não é repetida depois. Uma linha na seção Sistema do console indica o plug-in e o mecanismo (Console), e uma notificação do Windows indica a ação e o plug-in. A notificação só aparece enquanto Notificações do Windows estiver ativado (Configurações gerais).
No modo Simples
O modo Simples mostra Escrita como somente para uma ação que já tem um script ou um conteúdo de AutoHotkey. Para qualquer outra ação, o cartão mostra os passos diretamente. Para escrever uma ação nova como script, mude a janela para o modo Avançado (A janela de configuração).