SetKey em ADVPL — Como Criar Atalhos de Teclado no Protheus

Tempo de leitura: 2 minutos

A experiência do usuário final no ERP Protheus é diretamente impactada pela agilidade na navegação. Quando desenvolvemos rotinas customizadas, muitas vezes ignoramos que pequenas funcionalidades, como o uso de atalhos de teclado, podem economizar horas de operação ao longo de um mês. A função SetKey em ADVPL é a ferramenta nativa para realizar esse mapeamento, permitindo que você associe teclas de função (F1 a F12) ou combinações específicas a blocos de código ou funções customizadas.

 

Neste artigo, vamos mergulhar no funcionamento técnico da

1
SetKey
, entender como ela manipula a pilha de execução do Protheus e, claro, aplicar exemplos práticos no padrão protheus.doc. Se você quer elevar o nível das suas interfaces e entregar uma experiência profissional para os seus usuários, dominar a criação de atalhos é um passo indispensável. Prepare seu VSCode e vamos ao código.

 

O que é e como funciona a função SetKey em ADVPL

A

1
SetKey
é uma função de sistema que permite definir ou consultar a ação associada a uma tecla. No ecossistema Protheus, ela funciona monitorando os eventos de teclado dentro de uma janela ativa. Quando o usuário pressiona uma tecla que foi previamente mapeada, o sistema interrompe momentaneamente o fluxo atual para executar o bloco de código (
1
Code Block
) associado.

 

Sintaxe e Parâmetros da SetKey

 

Sintaxe:

SetKey(nCodTec,bAcao)
 
 

Parâmetro(s):

Retorno:

Exemplo da função Setkey em ADVPL:

#include 'protheus.ch'
#include 'rwmake.ch'
#INCLUDE "TBICONN.CH"
/*{Protheus.doc} User Function fSetKey
    (Essa função tem por finalidade mostrar a função SetKey em ADVPL)
    @type  Function
    @author Adilio Costa
    @since 29/10/2024
    @version 1.0
@?Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@?Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@?Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@?Conheça os Cursos e Formações do ProtheusAdvpl:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/

@Participe de nossas comunidades no WhatsApp:
-Comunidade Protheus Backoffice:https://chat.whatsapp.com/KMUIAjwZ6EZ6eAHsLkPTyb
-Comunidade Protheus-RH:https://chat.whatsapp.com/L5dUyAna6xU4ylG5DUgfOW
-Comunidade Protheus-Programação:https://chat.whatsapp.com/LsD6z0apdqKHlOz67bcaEn
-Comunidade Protheus-Framework:https://chat.whatsapp.com/BzUFpjaSnTC3vtsfa77jmG

|Se esse conteúdo foi útil pra você nos ajude divulgando 
ele e nossas redes sociais!!|

*/

User Function fSetKey()

	Local cTecF2:= VK_F2
	Local cTecF4:= VK_F4
	Local bAcao2 := {||MsgInfo("Você teclou F2","Função SetKey")}
	Local bAcao4 := {||MsgInfo("Você teclou F4","Função SetKey")}

		//Executa a tecla F2 do teclado
		SetKey(cTecF2,bAcao2)

		//Executa a tecla F4 do teclado
		SetKey(cTecF4,bAcao4)
Return

Bem, finalizamos mais um post aqui no blog. Espero que você tenha entendido, qualquer dúvida nos envie um e-mail para adiliocosta@protheusadvpl.com.br. Grande abraço e fica com Deus.

Links de referência(s):

🚀 Quer dominar o Protheus de verdade?
Entre para o ProtheusAdvpl e receba conteúdos exclusivos sobre desenvolvimento, infraestrutura, módulos e carreira no Protheus

✔ Conteúdos organizados por categorias (Programação, Framework, Backoffice e RH)
✔ Dicas práticas usadas no dia a dia do Protheus
✔ Acesso a materiais, post e atualizações do Blog
🔐 Seu email está seguro. Sem spam. Só conteúdo profissional.