Parâmetros dos passos
Quando você seleciona um passo, os campos dele abrem abaixo, um para cada detalhe de que o passo precisa. Cada campo tem um rótulo em palavras simples. Aponte para um campo para ver uma dica de ferramenta que diz para que ele serve.
Tipos de campo
| Campo | Aparência | Aceita |
|---|---|---|
| Texto | uma caixa de texto | qualquer texto |
| Número inteiro | uma caixa de texto | um número inteiro, como 250 ou -3, um número hexadecimal que começa com 0x, como 0xB3, ou uma constante nomeada, como VirtualKey.MediaPlayPause |
| Número | uma caixa de texto | um número com ponto como separador decimal, como 0.5, qualquer que seja o seu formato regional |
| Verdadeiro ou falso | uma chave | ligada (true) ou desligada (false) |
| Uma escolha de valores nomeados | uma lista suspensa ② | um dos nomes listados, como MouseButton.Primary; você também pode digitar nela |
| Janela | uma caixa de texto | uma janela do menu de valores ou de uma variável, normalmente Janela de destino |
| Teclas (Enviar teclas) | uma caixa de captura de teclas | a combinação de teclas que você pressiona |
Em qualquer tipo de campo, você também pode digitar $ e o nome de uma variável para usar um valor
que um passo anterior salvou (Variáveis).
Um número no campo de um passo sempre usa ponto como separador decimal e nenhum separador de milhares, qualquer que seja o seu formato regional.
Constantes nomeadas
Um campo Número inteiro ou Número também aceita uma constante nomeada: um namespace, um ponto e um
nome, como VirtualKey.MediaPlayPause ou AudioEndpoint.Playback, os mesmos nomes que um script usa
(Constantes nomeadas). Digite-a exatamente, com as mesmas maiúsculas
e sem espaços. O passo salva o nome e a ação usa o número dela quando é executada. Um campo Texto
mantém esse nome como o texto que você digitou.
O campo Teclas
Enviar teclas tem uma caixa de captura em vez de uma caixa de texto. Clique nela (Clique para
definir um atalho) e depois pressione a combinação. Somente a combinação é registrada; nada é
enviado enquanto você a define. Teclas que uma combinação de teclas não consegue nomear, como as
teclas de mídia, são recusadas com uma mensagem. Para pressioná-las, use o passo Pressionar e soltar
tecla (KeyboardPressKey) com o nome da tecla, como VirtualKey.MediaPlayPause
(Receitas prontas).
Passos novos começam preenchidos
Os campos Janela de um passo novo começam como Janela de destino: a janela sobre a qual o gesto foi desenhado, ou a janela em foco no caso de uma tecla de atalho ou de um texto digitado. As chaves dele começam desligadas. Todos os outros campos começam vazios, para você preencher.
Escolher um valor no menu
Todos os campos, exceto Teclas e as chaves, têm uma pequena seta no fim (Escolher um valor). Ela abre um menu de valores que cabem no campo ①. Além dos campos próprios de um passo, o menu está nos campos Valor e Comparado com de uma condição e no Valor único dela (Condições), em Vezes de uma repetição (Repetir passos) e em Valor de um passo Definir variável (Variáveis).
| Seção | Valores |
|---|---|
| Do que iniciou a ação | Janela de destino, Controle de destino, Nome do gesto, Nome da ação, Nome do grupo de aplicativos, Botão do gesto, e os valores do gesto Borda esquerda do gesto, Borda superior do gesto, Largura do gesto e Altura do gesto |
| Lido quando a etapa é executada | Janela ativa, Posição X do mouse, Posição Y do mouse, Texto da área de transferência, Data e hora atuais |
| Salvo por etapas anteriores | as variáveis que os passos acima deste salvam |
O menu lista somente valores do tipo do campo: um campo Número também aceita números inteiros, e um campo que aceita qualquer coisa aceita todos. Vezes oferece somente números inteiros; os campos de uma condição e o valor de Definir variável oferecem todas as leituras. Quando nada cabe, o menu diz Nada para escolher neste campo.
Um valor escolhido aparece como um chip com o nome dele no lugar da caixa de texto. Aponte para o chip para ver o que ele é e como um script o escreve. O botão Limpar dele esvazia o campo para que você possa digitar de novo.
Os valores em Do que iniciou a ação leem o gatilho: para uma ação iniciada por uma tecla de atalho ou por um texto digitado, os valores do gesto ficam vazios ou são 0. Todos os valores são oferecidos em qualquer lugar onde passos são executados, porque um snippet pode ser chamado de qualquer lugar.
Em uma chave, uma variável que você digitou antes aparece como um chip; limpar o chip desliga a chave.
Verificações enquanto você digita
Cada campo é verificado enquanto você digita. Um problema aparece em vermelho abaixo do campo, e a borda do campo fica vermelha:
| Mensagem | Significado |
|---|---|
| Este valor é obrigatório. | O nome da variável de um passo Definir variável está vazio. |
| Digite um número inteiro (decimal ou hexadecimal 0x), uma constante nomeada ou uma $variável. | Um campo Número inteiro contém outra coisa. |
| Não existe nenhuma constante nomeada com esse nome. Verifique a grafia e as maiúsculas, como em VirtualKey.MediaPlayPause. | Um campo Número inteiro ou Número contém um namespace, um ponto e um nome que não é uma constante nomeada. |
| Digite um número ou uma $variável. | Um campo Número contém outra coisa. |
| Digite true ou false, ou uma $variável. | Um campo de verdadeiro ou falso digitado como texto contém outra coisa. |
| Um passo não pode executar uma função interna dentro de um argumento. Mova-a primeiro para uma variável. | O campo contém uma chamada de função interna com algo entre os parênteses (abaixo). |
Enquanto um campo contém texto digitado que não passa na verificação, como letras em um campo Número
inteiro ou Número, um nome que não é uma constante nomeada, ou qualquer coisa que não seja true ou
false em um campo de verdadeiro ou falso, os passos não são salvos: a ação mantém os últimos passos
salvos, e Passos não salvos: o passo N tem um campo inválido aparece abaixo da lista até você
corrigir o campo (Problemas).
Um campo vazio não mostra nenhuma mensagem e nunca impede o salvamento; os passos são salvos com o campo vazio. Quando a ação é executada, um passo com um campo de número, de verdadeiro ou falso ou de janela vazio interrompe a ação ali, e a saída Sistema do console diz que esse argumento tem o tipo errado. Um campo Texto vazio é executado como texto vazio, o que, para algumas funções internas (um nome de arquivo, um título de janela a procurar), significa que o passo não faz nada.
Mover para uma variável
Um campo contém um valor, uma variável ou uma das leituras do menu de valores, nunca uma chamada de
função interna com argumentos. Se você digitar uma, como WindowGetTitle($w), o campo oferece Mover
para uma variável. Isso adiciona logo acima deste um passo que executa a chamada e salva o resultado
com um nome tirado do campo (como window, depois window2), e coloca essa variável no campo.
Uma chamada sem nada entre os parênteses, como ClipboardGetText(), não tem problema: é o mesmo que
escolher essa leitura no menu de valores. Isso vale para todos os campos que têm o menu de valores,
inclusive os campos de uma condição, Vezes e o valor de Definir variável.
Guardar o resultado de um passo
A maioria das funções internas dá um resultado: o texto que leram, a janela que encontraram ou se
funcionaram. Salvar resultado como ③ o guarda com um nome, para que passos posteriores possam
usá-lo como $nome. Deixe vazio para ignorar o resultado.
Um passo que guarda o resultado mostra "→ $nome" no fim do resumo. Os nomes seguem as regras de Variáveis.
Tipos errados na execução
O editor verifica a forma do que você digita, não todas as regras da função interna. Quando a ação é executada, um valor do tipo errado (por exemplo, uma variável que contém texto onde uma função interna precisa de um número inteiro) ou um valor que a função interna recusa interrompe a ação com um erro no console de diagnóstico. Consulte Erros.