编程使用系统热键{演示RegisterHotKey()和UnregisterHotKey()}

PurpleEndurer　原创

RegisterHotKey()
================================
函数功能：该函数定义一个系统范围的热键。

函数原型：BOOL RegisterHotKey（HWND hWnd，intid，UINT fsModifiers，UINT vk）；

参数说明：
hWnd：接收热键产生WM_HOTKEY消息的窗口句柄。若该参数NULL，传递给调用线程的WM_HOTKEY消息必须在消息循环中中进行处理。
id：定义热键的标识符。调用线程中的其他热键不能使用同样的标识符。应用功能程序必须定义一个0X0000-0xBFFF范围的值。一个共享的动态链接库（DLL）必须定义一个0xC000-0xFFFF范围的值伯GlobalAddAtom函数返回该范围）。为了避免与其他动态链接库定义的热键冲突，一个DLL必须使用GlobalAddAtom函数获得热键的标识符。
fsModifoers：定义为了产生WM_HOTKEY消息而必须与由nVirtKey参数定义的键一起按下的键。该参数可以是如下值的组合：
MOD_ALT：按下的可以是任一Alt键。MOD_CONTROL：按下的可以是任一Ctrl键。
MOD_SHIFT：按下的可以是任一Shift键。
MOD_WIN：按下的可以是任一Windows按键。这些键可以用Microsoft Windows日志记录下来。
vk：定义热键的虚拟键码。

返回值：若函数调用成功，返回一个非O值。若函数调用失败，则返回值为0。若要获得更多的错误信息，可以调用GetLastError函数。

备注：当某键被接下时，系统在所有的热键中寻找匹配者。一旦找到一个匹配的热键，系统将把WM_HOTKEY消息传递给登记了该热键的线程的消息队列。该消息被传送到队列头部，因此它将在下一轮消息循环中被移去。该函数不能将热键同其他线程创建的窗口关联起
来。
若为一热键定义的击键己被其他热键所定义，则RegisterHotKey函数调用失败。
若hWnd参数标识的窗口已用与id参数定义的相同的标识符登记了一个热键，则参数fsModifiers和vk的新值将替代这些参数先前定义的值。
Windows CE：Windows CE 2.0以上版本对于参数fsModifiers支持一个附加的标志位。叫做MOD_KEYUP。
若设置MOD_KEYUP位，则当发生键被按下或被弹起的事件时，窗口将发送WM_HOTKEY消息。
RegisterHotKey可以被用来在线程之间登记热键。

速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：winuser.h；库文件：user32.lib。


UnregisterHotKey()
===========================
函数功能：该函数在系统中注消热键。

函数原型：BOOL UnregisterHotKey( HWND hWnd, int id);

参数：该函数的参数和 RegisiterHotKey 的那两个参数意义大体相同。

 

;<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
; 文件名: HotKey1.asm
; 功　能: 演示RegisterHotKey()和UnregisterHotKey()
;         点击“注册热键Alt+Insert!  注册成功后按
;         Alt+Insert可打开记事本!”按钮，
;         把Alt+Insert注册为系统热键
;         如果注册不成功，则提示出错信息！
;         如果注册成功，则按Alt+Insert键，
;         可将当前程序窗口恢复到前台
;         并启动计事本！
;
;源程序和可执行文件下载: http://purpleendurer.ys168.com
;
; 开发环境: Win 2000 Pro + MASM32 V8   
;
; Date                log
;-------------------------------------------------
;2006-03-06    创建！
;<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

.386
.model flat, stdcall
option casemap:none
include /masm32/include/windows.inc
include /masm32/include/user32.inc
include /masm32/include/kernel32.inc
include /masm32/include/shell32.inc
includelib /masm32/lib/user32.lib
includelib /masm32/lib/kernel32.lib
includelib /masm32/lib/shell32.lib

WinMain proto :DWORD, :DWORD, :DWORD, :DWORD

m_m2m MACRO d1, d2
    push d2
    pop d1
ENDM


.const
c_ButtonID equ 1


.data
g_szWinClsName db "DemoWinClass", 0
g_szAppName  db "系统热键演示程序 by PurpleEndurer", 0
g_szBtnClsName db "button", 0
g_szFailRegisterKey db "不能"
g_szRegisterKey db "注册热键Alt+Insert!  注册成功后按Alt+Insert可打开记事本!", 0
g_szFailUnRegisterKey db "不能"
g_szUnregisterKey db "注销热键Alt+Insert!", 0
g_bRegisted dword FALSE
g_szOpen db "Open", 0
g_szNotePad db "NotePad", 0

.data?
hInstance HINSTANCE ?
CommandLine LPSTR ?
g_hwndButton HANDLE ?

.code
start:
    invoke GetModuleHandle, NULL
    mov    hInstance, eax
    invoke GetCommandLine
    mov    CommandLine, eax
    invoke WinMain, hInstance, NULL, CommandLine, SW_SHOWDEFAULT
    invoke ExitProcess, eax

WinMain proc hInst:HINSTANCE, hPrevInst:HINSTANCE, CmdLine:LPSTR, CmdShow:DWORD
    LOCAL wc:WNDCLASSEX
    LOCAL msg:MSG
    LOCAL hwnd:HWND
    mov   wc.cbSize, SIZEOF WNDCLASSEX
    mov   wc.style, CS_HREDRAW or CS_VREDRAW
    mov   wc.lpfnWndProc, OFFSET WndProc
    mov   wc.cbClsExtra, NULL
    mov   wc.cbWndExtra, NULL
    push  hInstance
    pop   wc.hInstance
    mov   wc.hbrBackground, COLOR_WINDOW+1
    mov   wc.lpszMenuName, NULL
    mov   wc.lpszClassName, OFFSET g_szWinClsName
    invoke LoadIcon, NULL, IDI_APPLICATION
    mov   wc.hIcon, eax
    mov   wc.hIconSm, eax
    invoke LoadCursor, NULL, IDC_ARROW
    mov   wc.hCursor, eax
    invoke RegisterClassEx, addr wc
    INVOKE CreateWindowEx, NULL, ADDR g_szWinClsName, ADDR g_szAppName, /
           WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, /
           CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, NULL, NULL, /
           hInst, NULL
    mov   hwnd, eax
    invoke ShowWindow, hwnd, SW_SHOWNORMAL
    invoke UpdateWindow, hwnd
    .WHILE TRUE
        invoke GetMessage, ADDR msg, NULL, 0, 0
        .BREAK .IF (!eax)
        invoke TranslateMessage, ADDR msg
        invoke DispatchMessage, ADDR msg
    .ENDW
    mov     eax, msg.wParam
    ret
WinMain endp

WndProc proc hWnd:HWND, uMsg:UINT, wParam:WPARAM, lParam:LPARAM
    .IF uMsg==WM_DESTROY
            .if g_bRegisted==TRUE
                ; BOOL UnregisterHotKey( HWND hWnd, int id);
                invoke UnregisterHotKey, hWnd, hWnd
            .endif
            invoke PostQuitMessage, NULL
    .ELSEIF uMsg==WM_CREATE
        ;创建按钮
        invoke CreateWindowEx, NULL, ADDR g_szBtnClsName, ADDR g_szRegisterKey, /
                        WS_CHILD or WS_VISIBLE or BS_DEFPUSHBUTTON,/
                        25, 25, 560, 50, hWnd, c_ButtonID, hInstance, NULL
        mov  g_hwndButton, eax

    .ELSEIF uMsg==WM_COMMAND
        mov eax, wParam
        .IF lParam!=0
            .IF ax==c_ButtonID
                shr eax, 16
                .IF ax==BN_CLICKED
                    .if g_bRegisted==TRUE
                        invoke UnregisterHotKey, hWnd, hWnd
                        .IF eax==0
                            invoke MessageBox, hWnd, ADDR g_szFailUnRegisterKey, ADDR g_szAppName, MB_ICONERROR
                            ret
                        .ENDIF
                        m_m2m g_bRegisted, FALSE
                        ;修改按钮的文本
                        invoke SetWindowText, g_hwndButton, ADDR g_szRegisterKey
                    .else
                        ; BOOL RegisterHotKey(
                        ;   HWND hWnd,         // window to receive hot-key notification
                        ;   int id,            // identifier of hot key
                        ;   UINT fsModifiers,  // key-modifier flags
                        ;   UINT vk            // virtual-key code);
                        ; 参数:
                        ; id为你自己定义的一个ID值，对一个线程来讲其值必需在0x0000 - 0xBFFF范围之内,
                        ;   对DLL来讲其值必需在0xC000 - 0xFFFF 范围之内，在同一进程内该值必须唯一
                        ; fsModifiers指明与热键联合使用按键，可取值为：
                        ;   MOD_ALT  任一 Alt 键按下
                        ;   MOD_CONTROL 任一 Control 键按下
                        ;   MOD_SHIFT  任一 Shift 键按下
                        ;   MOD_WIN  任一 WIN 键按下
                        ; vk指明热键的虚拟键

                        ;注册HotKey,用窗口句柄hWnd作为id
                        invoke RegisterHotKey, hWnd, hWnd, MOD_ALT, VK_INSERT
                        .IF eax==0
                                            invoke MessageBox, hWnd, ADDR g_szFailRegisterKey, ADDR g_szAppName, MB_ICONERROR
                                    ret
                        .ENDIF
                        m_m2m g_bRegisted, TRUE
                        ;修改按钮的文本
                        invoke SetWindowText, g_hwndButton, ADDR g_szUnregisterKey
                    .endif
                .ENDIF
            .ENDIF
        .ENDIF
    .ELSEIF uMsg==WM_HOTKEY
        ; RegisterHotKey()成功执行后,当热键(本程序中为Alt+Insert)被按下时,
            ; 程序会收到WM_HOTKEY消息
        ; 消息的参数和含义为：
        ;  idHotKey = (int) wParam;              // identifier of hot key
        ;  fuModifiers = (UINT) LOWORD(lParam);  // key-modifier flags
        ;  uVirtKey = (UINT) HIWORD(lParam);     // virtual-key code
        ; 这三个值分别和调用RegisterHotKey时的id, fsModifiers, vk对
        ;--------------------------------------------------------
        ; 注:如果注册了多个HotKey,在这里还需要进行判断并做相应的处理

        ;把本程序窗口恢复到前台
                invoke ShowWindow, hWnd, SW_RESTORE
                invoke SetForegroundWindow, hWnd

        ;打开记事本
                invoke ShellExecute, hWnd, ADDR g_szOpen, ADDR g_szNotePad, NULL, NULL, SW_RESTORE
    .ELSE
        invoke DefWindowProc, hWnd, uMsg, wParam, lParam
        ret
    .ENDIF
    xor eax, eax
    ret
WndProc endp

end start