HotKeyEvent rawkey,modifier,event_id[,event_data,event_x,event_y,event_z,event_source]

Parameters

rawkey - raw scan code of the key to trigger the event
modifier - Modifier flags
event_id,event_data,event_x,event_y,event_z,event_source - event to be generated when the hotkey is pressed.

Description

HotKeyEvent allows you to specify a 'canned' event to be generated whenever a particular key is pressed.

This is great for implementing shortcut keys that correspond to menu, gadget or window events.

Modifier flags are:

1 : Shift key
2 : Control key
4 : Alt key

An existing hotkey event can be removed like this:
HotKeyEvent rawkey,modifier,0

See also: WaitEvent,EventID,EventData.

Example

;create a window
window=CreateWindow( "",0,0,640,480 )

;create file menu
file_menu=CreateMenu( "File",0,WindowMenu(window) )

;create open menu
open_menu=CreateMenu( "Open",1,file_menu )

;update menus
UpdateWindowMenu window

;create hotkey - F1 generates a menu_action event with EventData() of 1
HotKeyEvent 59,0,$1001,1

;another hotkey - ESC generates a window_close event from the main window
HotKeyEvent 1,0,$803,0,0,0,0,window

;let 'em know what we're up to!
Notify "Hot keys installed - ESC to close window, F1 to select File/Open menu"

While WaitEvent()<>$803 ;loop until window closed
If EventID()=$1001 ;menu event?
If EventData()=1 ;file/open menu?
Notify "File/Open selected!"
EndIf
EndIf
Wend

Index

Click here to view the latest version of this page online