Keyboard handler for Lotus Notes
--------------------------------

Here is how it works:

1. For your form in Options section you have this code to load LSX module:

Option Public
Uselsx "*kbhook"

2. In Declarations section you decalre global handler variable:

Dim h As KbHandler

3. In your Form text field Entering event Lotuscript code you install keyboard hadler with message prompt/string you want to analyze later:

Set h = New Kbhandler
On Event kbevent From h Call kbEventHandler
Call h.installKbHook(13, "myEnter", False)

3.1. Last parameter used in installKbHook specifies if you want to dismiss pressed key after your handling. If it's False -
handling will be passed to Lotus, if True - it will be eliminated.

4. In your Form text field Exiting event Lotuscript code you deinstall keyboard handler:

Call h.uninstallKbHook(13)

5. Enter press keyboard processing will happens via event handling code (here is for demo purpose only):
 
Msgbox "Enter was pressed"

6. Attached DLL should be placed somewhere on your disk, let say in C:\LSX directory and additionally registered via similar to this file with .reg extension merging into your Windows registry:

REGEDIT4

** registration info for the KBHOOK lsx module

[HKEY_LOCAL_MACHINE\SOFTWARE\Lotus\Components\LotusScriptExtensions\2.0]

"KBHOOK"="C:\\LSX\\KBHOOK.DLL"
 

7. After registration start Lotus Notes, open demo TestEnter.nsf database and select in Menu Create/EnterCheck and try to press Enter key. You should see Message box with text: „Enter was pressed“. 
7.1. In Demo version you'll see several additional message boxes: "Installing hook...", "Unhook them finally!"