C#全局鍵盤監聽(Hook)


一.為什么需要全局鍵盤監聽?

在某些情況下應用程序需要實現快捷鍵執行特定功能,例如大家熟知的QQ截圖功能Ctrl+Alt+A快捷鍵,只要QQ程序在運行(無論是擁有焦點還是處於后台運行狀態),都可以按下快捷鍵使用此功能...

這個時候在程序中添加鍵盤監聽肯定不能滿足需求了,當用戶焦點不在App上時(如最小化,或者用戶在處理其它事物等等)鍵盤監聽就失效了

二.怎樣才能實現全局鍵盤監聽?

這里需要用到Windows API,源碼如下:(可以作為一個工具類[KeyboardHook.cs]收藏起來)

[特別說明:下面的源碼來自某網友,很久以前收集的,也找不到出處了,如有版權問題請聯系我]

using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.InteropServices;
using System.Windows.Forms;
using System.Reflection;

namespace 壁紙管家
{
    /// <summary>
    /// 鍵盤鈎子
    /// [以下代碼來自某網友,並非本人原創]
    /// </summary>
    class KeyboardHook
    {
        public event KeyEventHandler KeyDownEvent;
        public event KeyPressEventHandler KeyPressEvent;
        public event KeyEventHandler KeyUpEvent;

        public delegate int HookProc(int nCode, Int32 wParam, IntPtr lParam);
        static int hKeyboardHook = 0; //聲明鍵盤鈎子處理的初始值
        //值在Microsoft SDK的Winuser.h里查詢
        public const int WH_KEYBOARD_LL = 13;	//線程鍵盤鈎子監聽鼠標消息設為2,全局鍵盤監聽鼠標消息設為13
        HookProc KeyboardHookProcedure; //聲明KeyboardHookProcedure作為HookProc類型
        //鍵盤結構 
        [StructLayout(LayoutKind.Sequential)]
        public class KeyboardHookStruct
        {
            public int vkCode;	//定一個虛擬鍵碼。該代碼必須有一個價值的范圍1至254
            public int scanCode; // 指定的硬件掃描碼的關鍵
            public int flags;  // 鍵標志
            public int time; // 指定的時間戳記的這個訊息
            public int dwExtraInfo; // 指定額外信息相關的信息
        }
        //使用此功能,安裝了一個鈎子
        [DllImport("user32.dll", CharSet = CharSet.Auto, CallingConvention = CallingConvention.StdCall)]
        public static extern int SetWindowsHookEx(int idHook, HookProc lpfn, IntPtr hInstance, int threadId);


        //調用此函數卸載鈎子
        [DllImport("user32.dll", CharSet = CharSet.Auto, CallingConvention = CallingConvention.StdCall)]
        public static extern bool UnhookWindowsHookEx(int idHook);


        //使用此功能,通過信息鈎子繼續下一個鈎子
        [DllImport("user32.dll", CharSet = CharSet.Auto, CallingConvention = CallingConvention.StdCall)]
        public static extern int CallNextHookEx(int idHook, int nCode, Int32 wParam, IntPtr lParam);

        // 取得當前線程編號(線程鈎子需要用到) 
        [DllImport("kernel32.dll")]
        static extern int GetCurrentThreadId();

        //使用WINDOWS API函數代替獲取當前實例的函數,防止鈎子失效
        [DllImport("kernel32.dll")]
        public static extern IntPtr GetModuleHandle(string name);

        public void Start()
        {
            // 安裝鍵盤鈎子
            if (hKeyboardHook == 0)
            {
                KeyboardHookProcedure = new HookProc(KeyboardHookProc);
                hKeyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardHookProcedure, GetModuleHandle(System.Diagnostics.Process.GetCurrentProcess().MainModule.ModuleName), 0);
                //hKeyboardHook = SetWindowsHookEx(WH_KEYBOARD_LL, KeyboardHookProcedure, Marshal.GetHINSTANCE(Assembly.GetExecutingAssembly().GetModules()[0]), 0);
                //************************************ 
                //鍵盤線程鈎子 
                //SetWindowsHookEx( 2,KeyboardHookProcedure, IntPtr.Zero, GetCurrentThreadId());//指定要監聽的線程idGetCurrentThreadId(),
                //鍵盤全局鈎子,需要引用空間(using System.Reflection;) 
                //SetWindowsHookEx( 13,MouseHookProcedure,Marshal.GetHINSTANCE(Assembly.GetExecutingAssembly().GetModules()[0]),0); 
                // 
                //關於SetWindowsHookEx (int idHook, HookProc lpfn, IntPtr hInstance, int threadId)函數將鈎子加入到鈎子鏈表中,說明一下四個參數: 
                //idHook 鈎子類型,即確定鈎子監聽何種消息,上面的代碼中設為2,即監聽鍵盤消息並且是線程鈎子,如果是全局鈎子監聽鍵盤消息應設為13, 
                //線程鈎子監聽鼠標消息設為7,全局鈎子監聽鼠標消息設為14。lpfn 鈎子子程的地址指針。如果dwThreadId參數為0 或是一個由別的進程創建的 
                //線程的標識,lpfn必須指向DLL中的鈎子子程。 除此以外,lpfn可以指向當前進程的一段鈎子子程代碼。鈎子函數的入口地址,當鈎子鈎到任何 
                //消息后便調用這個函數。hInstance應用程序實例的句柄。標識包含lpfn所指的子程的DLL。如果threadId 標識當前進程創建的一個線程,而且子 
                //程代碼位於當前進程,hInstance必須為NULL。可以很簡單的設定其為本應用程序的實例句柄。threaded 與安裝的鈎子子程相關聯的線程的標識符
                //如果為0,鈎子子程與所有的線程關聯,即為全局鈎子
                //************************************ 
                //如果SetWindowsHookEx失敗
                if (hKeyboardHook == 0)
                {
                    Stop();
                    throw new Exception("安裝鍵盤鈎子失敗");
                }
            }
        }
        public void Stop()
        {
            bool retKeyboard = true;


            if (hKeyboardHook != 0)
            {
                retKeyboard = UnhookWindowsHookEx(hKeyboardHook);
                hKeyboardHook = 0;
            }

            if (!(retKeyboard)) throw new Exception("卸載鈎子失敗!");
        }
        //ToAscii職能的轉換指定的虛擬鍵碼和鍵盤狀態的相應字符或字符
        [DllImport("user32")]
        public static extern int ToAscii(int uVirtKey, //[in] 指定虛擬關鍵代碼進行翻譯。 
                                         int uScanCode, // [in] 指定的硬件掃描碼的關鍵須翻譯成英文。高階位的這個值設定的關鍵,如果是(不壓)
                                         byte[] lpbKeyState, // [in] 指針,以256字節數組,包含當前鍵盤的狀態。每個元素(字節)的數組包含狀態的一個關鍵。如果高階位的字節是一套,關鍵是下跌(按下)。在低比特,如果設置表明,關鍵是對切換。在此功能,只有肘位的CAPS LOCK鍵是相關的。在切換狀態的NUM個鎖和滾動鎖定鍵被忽略。
                                         byte[] lpwTransKey, // [out] 指針的緩沖區收到翻譯字符或字符。 
                                         int fuState); // [in] Specifies whether a menu is active. This parameter must be 1 if a menu is active, or 0 otherwise. 

        //獲取按鍵的狀態
        [DllImport("user32")]
        public static extern int GetKeyboardState(byte[] pbKeyState);


        [DllImport("user32.dll", CharSet = CharSet.Auto, CallingConvention = CallingConvention.StdCall)]
        private static extern short GetKeyState(int vKey);

        private const int WM_KEYDOWN = 0x100;//KEYDOWN 
        private const int WM_KEYUP = 0x101;//KEYUP
        private const int WM_SYSKEYDOWN = 0x104;//SYSKEYDOWN
        private const int WM_SYSKEYUP = 0x105;//SYSKEYUP

        private int KeyboardHookProc(int nCode, Int32 wParam, IntPtr lParam)
        {
            // 偵聽鍵盤事件
            if ((nCode >= 0) && (KeyDownEvent != null || KeyUpEvent != null || KeyPressEvent != null))
            {
                KeyboardHookStruct MyKeyboardHookStruct = (KeyboardHookStruct)Marshal.PtrToStructure(lParam, typeof(KeyboardHookStruct));
                // raise KeyDown
                if (KeyDownEvent != null && (wParam == WM_KEYDOWN || wParam == WM_SYSKEYDOWN))
                {
                    Keys keyData = (Keys)MyKeyboardHookStruct.vkCode;
                    KeyEventArgs e = new KeyEventArgs(keyData);
                    KeyDownEvent(this, e);
                }

                //鍵盤按下
                if (KeyPressEvent != null && wParam == WM_KEYDOWN)
                {
                    byte[] keyState = new byte[256];
                    GetKeyboardState(keyState);

                    byte[] inBuffer = new byte[2];
                    if (ToAscii(MyKeyboardHookStruct.vkCode, MyKeyboardHookStruct.scanCode, keyState, inBuffer, MyKeyboardHookStruct.flags) == 1)
                    {
                        KeyPressEventArgs e = new KeyPressEventArgs((char)inBuffer[0]);
                        KeyPressEvent(this, e);
                    }
                }

                // 鍵盤抬起 
                if (KeyUpEvent != null && (wParam == WM_KEYUP || wParam == WM_SYSKEYUP))
                {
                    Keys keyData = (Keys)MyKeyboardHookStruct.vkCode;
                    KeyEventArgs e = new KeyEventArgs(keyData);
                    KeyUpEvent(this, e);
                }

            }
            //如果返回1,則結束消息,這個消息到此為止,不再傳遞。
            //如果返回0或調用CallNextHookEx函數則消息出了這個鈎子繼續往下傳遞,也就是傳給消息真正的接受者 
            return CallNextHookEx(hKeyboardHook, nCode, wParam, lParam);
        }
        ~KeyboardHook()
        {
            Stop();
        }
    }
}

三.如何使用上面的工具類?

//0.准備工作
//把上面的工具類添加到項目中

//1.首先導入需要的命名空間
using System.Runtime.InteropServices;   //調用WINDOWS API函數時要用到
using Microsoft.Win32;  //寫入注冊表時要用到

//2.安裝Hook,在程序入口中寫上下面的代碼(本例中用了WinForm,在Form的構造方法中安裝Hook即可)
//安裝鍵盤鈎子
k_hook = new KeyboardHook();
k_hook.KeyDownEvent += new KeyEventHandler(hook_KeyDown);//鈎住鍵按下
k_hook.Start();//安裝鍵盤鈎子

//3.判斷輸入鍵值(實現KeyDown事件)
private void hook_KeyDown(object sender, KeyEventArgs e)
        {
            //判斷按下的鍵(Alt + A)
            if (e.KeyValue == (int)Keys.A && (int)Control.ModifierKeys == (int)Keys.Alt)
            {
                System.Windows.Forms.MessageBox.Show("按下了指定快捷鍵組合");
            }
}
//注意幾種不同的鍵值判斷:
//1>.單普通鍵(例如A)
//2>.單控制鍵+單普通鍵(例如Ctrl+A)
//3>.多控制鍵+單普通鍵(例如Ctrl+Alt+A)
//上面的代碼中演示了2,其它情況以此類推,無非就是添幾個條件再&&起來就好

3.搞定了,開始測試

四.使用全局鍵盤監聽需要注意的問題(請讀者朋友務必看看)

1.在應用程序中使用全局鍵盤監聽,會被360發現,彈窗提示用戶“有程序正在監聽鍵盤輸入,是否阻止?”

所以如果程序中必須要用Hook應該告訴用戶不會泄露其信息等等

或者直接把App提交給360審核

否則殺軟的提示會對用戶體驗造成極大的影響

P.S.本機只在360安全衛士環境下做了測試,其它殺軟未知,應該也會提示類似的危險信息,故慎重使用Hook


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM