📌 Guia de Hotkeys – Inserção Instantânea de Texto

Versão: 1.1.37.02
Autor: Douglas Silva
Data: 10 de Setembro de 2025

---

📖 Descrição

Este script em AutoHotkey utiliza a área de transferência (clipboard) para inserir texto de forma instantânea, evitando a lentidão do comando Send.
Ele salva o conteúdo original do clipboard, insere o texto desejado e restaura o conteúdo anterior, garantindo que você não perca nada.

---

🛠️ Como Usar

1. Salve este arquivo com a extensão .ahk.
2. Execute o arquivo com o AutoHotkey.
3. Digite a palavra-chave (ex.: minha-tag-html) para disparar o comando.

---

📚 Passo a Passo Detalhado

1️⃣ O Hotkey e o Início do Bloco

A primeira linha define o atalho. Ao digitar a palavra-chave, o script será disparado.
O :: marca o início do código que será executado.

:*:\sua-palavra-chave::

---

2️⃣ Salvando a Área de Transferência (Clipboard)

Antes de colar qualquer texto, salve o conteúdo original do clipboard para restaurá-lo depois.

• ClipboardAll → Captura tudo que está no clipboard (texto, imagem etc.)
• := → Operador de atribuição (coloca o conteúdo à direita na variável à esquerda).

; Salva o conteúdo atual da área de transferência
ConteudoOriginalClipboard := ClipboardAll

---

3️⃣ Definindo a Variável de Texto

Aqui você cria a variável com o texto que será colado.

• suaVariavel := → Nome descritivo para o conteúdo.
• ( LTrim → Remove espaços no início de cada linha, mantendo o texto limpo.

; Variável com o texto que será colado
suaVariavel :=
( LTrim
"Texto, que pode ter
  várias linhas,
  sem se preocupar com
  a indentação."
)

---

4️⃣ Definindo o Conteúdo no Clipboard

Agora que o texto está definido, jogue-o para o clipboard.

; Coloca o texto da sua variável no clipboard
Clipboard := suaVariavel

---

5️⃣ Aguardando a Atualização e Colando o Texto

Dê um tempo para o sistema atualizar o clipboard e em seguida cole o conteúdo.

; Pausa o script brevemente para garantir a atualização do clipboard
Sleep, 50

; Cola o texto no local onde o cursor está
Send, ^v

---

6️⃣ Restaurando a Área de Transferência

Por fim, devolva o conteúdo original do clipboard para não afetar o usuário.

; Restaura o conteúdo original do clipboard
Clipboard := ConteudoOriginalClipboard

; Limpa a variável para liberar memória
ConteudoOriginalClipboard := ""

---

7️⃣ O Comando return

Finaliza a rotina do hotkey.

; Finaliza a rotina do hotkey
return

---

⌨️ Exemplo Completo

🔑 Hotkey: minha-tag-html

Descrição: Exemplo de código HTML que será colado no local do cursor.

:*:\minha-tag-html::
    ; Passo 2: Salva o conteúdo atual do clipboard
    ConteudoOriginalClipboard := ClipboardAll

    ; Passo 3: Cria a variável com o HTML
    html :=
    ( LTrim
    "<div class='container'>
        <h1>Título</h1>
        <p>Parágrafo de exemplo.</p>
    </div>"
    )

    ; Passo 4: Coloca o HTML no clipboard
    Clipboard := html

    ; Passo 5: Aguarda e cola o conteúdo
    Sleep, 50
    Send, ^v

    ; Passo 6: Restaura o conteúdo do clipboard
    Clipboard := ConteudoOriginalClipboard
    ConteudoOriginalClipboard := ""

    ; Passo 7: Finaliza a rotina
    return

🔑 Hotkey: colar-TAB

Descrição: Exemplo para colar e-mail, pular com Tab e colar a senha.

:*:\email::
    ; Passo 2: Salva o conteúdo atual do clipboard
    ConteudoOriginalClipboard := ClipboardAll

    ; Passo 3: Coloca o email no clipboard e o cola
    Clipboard := "email"
    Sleep, 50
    Send, ^v

    ; Passo 4: Envia a tecla Tab para o próximo campo
    Send, {Tab}

    ; Passo 5: Coloca a senha no clipboard e a cola
    Clipboard := "senha"
    Sleep, 50
    Send, ^v

    ; Passo 6: Restaura o conteúdo do clipboard
    Clipboard := ConteudoOriginalClipboard
    ConteudoOriginalClipboard := ""

    ; Passo 7: Finaliza a rotina
    return

---

✅ Benefícios

• Performance: evita o delay do Send.
• Segurança: não perde o conteúdo original do clipboard.
• Flexibilidade: fácil adicionar novos snippets.

---

📌 Observações

• Siga os 7 passos acima para criar novos hotkeys.
• Mantenha nomes descritivos para variáveis (ex.: textoIsencao, querySQL).
• Sempre use ( LTrim ) para evitar indentação indesejada no texto final.
• Limpe variáveis após o uso para evitar consumo de memória.