Console
O console é a janela do próprio mecanismo para diagnosticar e testar coisas. Ele mostra o que o mecanismo relata (problemas na sua configuração, scripts que falharam, plug-ins que tiveram de ceder o desenho), mostra o que os seus scripts imprimem e tem um editor onde você pode escrever e executar um script na hora.
Abrir o console
Escolha Mostrar console no menu da bandeja (O ícone da bandeja), ou execute a função
interna UIShowConsole a partir de uma ação; por exemplo, vincule-a a uma tecla de atalho. Nada abre o
console automaticamente, a menos que você peça isso com Ao receber mensagem (abaixo).
Se a sua configuração estiver protegida por senha, o console pede a senha quando abre, a menos que ela
ainda esteja lembrada (Segurança). Enquanto o console está aberto, a senha
lembrada não expira. UIShowConsole aguarda até o console estar aberto, inclusive enquanto a senha é
pedida, e devolve false se ele não abriu, por exemplo porque o pedido de senha foi cancelado.
O console é fechado com o botão de fechar dele. Fechá-lo libera a memória que ele usava.
As três seções
Os botões no alto ① alternam entre três seções, cada uma com a própria barra de ferramentas.
| Seção | O que mostra | Barra de ferramentas |
|---|---|---|
| Sistema | O que o mecanismo relata: notas sobre a sua configuração do último carregamento, ações e scripts que falharam e por quê, um plug-in que não conseguiu desenhar e por isso o desenho interno assumiu, e coisas semelhantes. | Copiar, Limpar, Ao receber mensagem |
| Usuário | Tudo o que os seus scripts imprimem com UtilityPrint, de todas as ações. | Copiar, Limpar, Ao receber mensagem |
| Script | Um editor de scripts acima de um painel de saída. | Executar, Parar tudo, Ocultar console, Ajuda de scripts, Copiar, Colar, Limpar |
Copiar copia o texto selecionado, ou a seção inteira quando nada está selecionado. Limpar esvazia a seção.
Enquanto a seção Script está aparecendo, as linhas novas de Sistema e Usuário também aparecem no painel de saída dela, para que você possa acompanhar um script em execução sem trocar de seção.
Enquanto o console está fechado
As linhas que chegam enquanto o console está fechado não se perdem: elas ficam guardadas em arquivos temporários e são mostradas na próxima vez que você abre o console. Quando o Input.Observer sai, elas são excluídas, exceto o que o evento Mecanismo sendo encerrado imprime, que o console da próxima sessão mostra.
Ao receber mensagem ①, nas barras de ferramentas de Sistema e Usuário, escolhe o que uma linha nova faz enquanto o console está fechado:
| Opção | O que acontece |
|---|---|
| Não fazer nada | A linha aguarda até você abrir o console. O padrão. |
| Mostrar UIShowMessageBox | A linha também aparece em uma caixa de mensagem. |
| Abrir console | O console abre nessa seção. |
Com o console aberto, uma linha nova simplesmente é adicionada; ela nunca abre uma caixa nem troca de seção. As mesmas opções ficam na página Console como Novas mensagens do Sistema e Novas mensagens do Usuário.
Executar um script
- Abra a seção Script do console.
- Digite ou cole um script no editor. Ele usa a linguagem de script do Input.Observer (Linguagem de script).
- Escolha Executar ② ou pressione F5. Com texto selecionado, só a seleção é executada; caso contrário, o editor inteiro é executado.
- A saída e qualquer erro aparecem no painel de saída abaixo do editor. Ocultar console oculta ou mostra esse painel.
- Um script executado aqui funciona como uma ação: todas as funções internas estão disponíveis, e ele é executado até terminar ou ser parado. Parar tudo para todos os scripts e ações em execução, não só este.
- Este é o único lugar onde scripts são executados no Modo de segurança, para que você possa inspecionar e reparar coisas enquanto nada mais é executado (Solução de problemas).
- O editor completa os nomes das funções internas enquanto você digita; Ctrl+Espaço lista tudo, e digitar o nome de uma área e um ponto lista as funções internas dessa área. Depois que você escolhe uma função interna, uma dica mostra os parâmetros dela, com o atual destacado. O menu do clique direito tem Comentar e Remover comentário para as linhas selecionadas.
- O texto do editor é mantido entre sessões em
console.toml.
Ajuda de scripts ③ abre a referência da linguagem de script na janela de ajuda (A janela de ajuda), no idioma que o Input.Observer usa (ou em inglês quando não há ajuda nesse idioma).
A página Console
Modo Avançado. A página Console fica oculta no modo Simples. As configurações dela continuam valendo.
A página Console da janela de configuração contém as configurações do console. Elas têm efeito quando você escolhe Aplicar ou Salvar e fechar.
| Configuração | O que faz | Padrão | Intervalo |
|---|---|---|---|
| Limite de linhas do console | Quando uma seção contém esse número de linhas, as mais antigas são descartadas à medida que as novas chegam. 0 mantém tudo. Tem efeito com a próxima linha. | 5000 linhas | 0–1000000 |
| Liberar memória quando o console for fechado | Devolve ao Windows a memória do console assim que você o fecha. O próximo evento do mouse ou do teclado depois disso pode ser muito levemente mais lento. | Ligada | Ligada ou desligada |
| Novas mensagens do Sistema | O que uma linha nova de Sistema faz enquanto o console está fechado: Nada, Caixa de mensagem ou Abrir console (o mesmo que Ao receber mensagem, acima) | Nada | — |
| Novas mensagens do Usuário | O mesmo para as linhas de Usuário | Nada | — |
| Fonte das janelas do mecanismo | Fonte e tamanho dos rótulos e botões do console e das caixas de diálogo do mecanismo (senha, licença) | Segoe UI, 12 pt | 6–72 pt |
| Fonte do editor do mecanismo | Fonte e tamanho das seções do console e do editor de scripts dele | Consolas, 13 pt | 6–72 pt |
Um console aberto mantém as fontes dele até você fechá-lo e abri-lo de novo.