Comando
SapKeys()
Envia uma combinação de teclas (virtual key) para a janela SAP GUI ativa.
SapKeys(controlId, tecla [, appId])
Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
controlId | Sim | Identificador de qualquer controle SAP para obter a referência à janela (GuiFrameWindow). O envio é feito na janela, não no controle específico. |
tecla | Sim | Tecla ou combinação a enviar: Enter, F1,Ctrl+S, Ctrl+Shift+F1, etc. Utilize a janela de configuração do comando no DevStudio para obter as combinações possíveis. |
appId | Não | Identificador da instância SAP gerenciada. |
Exemplos
// Enter para confirmar/executar:
SapKeys('wnd[0]', 'Enter', 'sap')
// F3 para voltar (Back):
SapKeys('wnd[0]', 'F3', 'sap')
// Ctrl+S para salvar:
SapKeys('wnd[0]', 'Ctrl+S', 'sap')
// F8 para executar relatório:
SapKeys('wnd[0]', 'F8', 'sap')
// F4 para pesquisa (Match Code/F4 Help):
SapKeys('wnd[0]/usr/txt[0]#GuiTextField', 'F4', 'sap')
// PageDown para próxima página:
SapKeys('wnd[0]', 'PageDown', 'sap')
// Ctrl+F para localizar:
SapKeys('wnd[0]', 'Ctrl+F', 'sap')
Observações
As teclas são mapeadas para VKeys da API SAP GUI Scripting (interface GuiFrameWindow.SendVKey). A tecla é enviada para a janela ativa da sessão SAP — o controlId é usado apenas para localizar a janela, não o controle específico que receberá o foco.