Sam隨堂筆記

2010-01-10

[C#] 使用Application.AddMessageFilter實作系統熱鍵 (或全域熱鍵)

  • 14279
  • 0
  • C#
  • 2010-01-11

[C#] 使用Application.AddMessageFilter實作系統熱鍵 (或全域熱鍵)

操作環境: , ,

 

有時候我們會需要這樣的功能:

就算程式沒有取得焦點
但只要user按下熱鍵就一定可以觸發我要的功能
就像螢幕截圖的熱鍵(Print Scrren)一樣

 

註:
如果你需要的是程式取得焦點才有作用的熱鍵
可以參考另一篇 [C#] 使用Application.AddMessageFilter實作Form的熱鍵

 

這篇除了實作系統熱鍵外
還會來點和第一篇不一樣的東西: 取消註冊過的熱鍵, 以及傳遞自訂事件參數

 

這邊一樣需要Application.AddMessageFilter來幫助我們過濾訊息
但必需搭配API才能達到系統熱鍵的功能

 

首先實作一個IMessageFilter和IDisposable介面的HotKey類別
實作IDisposable介面將會用來取消註冊過的熱鍵

class HotKey : IMessageFilter, IDisposable
{
    ...
}

 

再來我們需要四個API函數
這邊稍微說明一下原理
前兩個API函數會幫助我們跟系統取得一組id並註冊系統熱鍵
然後在user按下熱鍵時系統會發送訊息到程式
我們再利用Application.AddMessageFilter過濾訊息並比對id
就可以知道user按下熱鍵
後兩個API函數就是取消熱鍵用的

[System.Runtime.InteropServices.DllImport("kernel32.dll")]
public static extern UInt32 GlobalAddAtom(String lpString);
[System.Runtime.InteropServices.DllImport("user32.dll")]
public static extern UInt32 RegisterHotKey(IntPtr hWnd, UInt32 id, UInt32 fsModifiers, UInt32 vk);
 
[System.Runtime.InteropServices.DllImport("kernel32.dll")]
public static extern UInt32 GlobalDeleteAtom(UInt32 nAtom);
[System.Runtime.InteropServices.DllImport("user32.dll")]
public static extern UInt32 UnregisterHotKey(IntPtr hWnd, UInt32 id);

 

然後在HotKey建立時註冊熱鍵
並記下熱鍵的組合方式
後面自訂事件參數中會用到

IntPtr _hWnd = IntPtr.Zero;
UInt32 _hotKeyID;
Keys _hotKey = Keys.None;
Keys _comboKey = Keys.None;
 
public HotKey(IntPtr formHandle, Keys hotKey, Keys comboKey)
{
    _hWnd = formHandle; //Form Handle, 註冊系統熱鍵需要用到這個
    _hotKey = hotKey; //熱鍵
    _comboKey = comboKey; //組合鍵, 必須設定Keys.Control, Keys.Alt, Keys.Shift, Keys.None以及Keys.LWin等值才有作用
 
    UInt32 uint_comboKey; //由於API對於組合鍵碼的定義不一樣, 所以我們這邊做個轉換
    switch (comboKey)
    {
        case Keys.Alt:
            uint_comboKey = 0x1;
            break;
        case Keys.Control:
            uint_comboKey = 0x2;
            break;
        case Keys.Shift:
            uint_comboKey = 0x4;
            break;
        case Keys.LWin:
            uint_comboKey = 0x8;
            break;
        default: //沒有組合鍵
            uint_comboKey = 0x0;
            break;
    }
 
    _hotKeyID = GlobalAddAtom(Guid.NewGuid().ToString()); //向系統取得一組id
    RegisterHotKey((IntPtr)_hWnd, _hotKeyID, uint_comboKey, (UInt32)hotKey); //使用Form Handle與id註冊系統熱鍵
    Application.AddMessageFilter(this); //使用HotKey類別來監視訊息
}

 

然後實作IMessageFilter介面的PreFilterMessage方法監視訊息
當按下熱鍵時, 系統會向程式發送一個訊息
當收到這個訊息且id是我們註冊熱鍵使用的id
便會觸發自訂事件
另外事件傳遞的參數是自訂的, 後面會再提到

public delegate void HotkeyEventHandler(object sender, HotKeyEventArgs e); //HotKeyEventArgs是自訂事件參數
public event HotkeyEventHandler OnHotkey; //自訂事件
 
const int WM_GLOBALHOTKEYDOWN = 0x312; //當按下系統熱鍵時, 系統會發送的訊息
 
public bool PreFilterMessage(ref Message m)
{
    if (OnHotkey != null && m.Msg == WM_GLOBALHOTKEYDOWN && (UInt32)m.WParam == _hotKeyID) //如果接收到系統熱鍵訊息且id相符時
    {
        OnHotkey(this, new HotKeyEventArgs(_hotKey, _comboKey)); //呼叫自訂事件, 傳遞自訂參數
        return true; //並攔截這個訊息, Form將不再接收到這個訊息
    }
 
    return false;
}

 

再來是自訂事件參數, 必須繼承EventArgs類別
這邊自訂參數的目的是希望可以從事件中知道按下什麼鍵
所以設定了兩個欄位
一個欄位用來儲存熱鍵, 另一個儲存組合鍵

public class HotKeyEventArgs : EventArgs
{
    private Keys _hotKey;
    public Keys HotKey //熱鍵
    {
        get { return _hotKey; }
        private set { }
    }
 
    private Keys _comboKey;
    public Keys ComboKey //組合鍵
    {
        get { return _comboKey; }
        private set { }
    }
 
    public HotKeyEventArgs(Keys hotKey, Keys comboKey)
    {
        _hotKey = hotKey;
        _comboKey = comboKey;
    }
}

 

最後就是實作IDisposable介面的Dispose()方法
當我們呼叫Dispose()方法
或在物件消滅回收時
可以把註冊過的熱鍵取消掉

private bool disposed = false; 
 
public void Dispose()
{
    if (!disposed)
    {
        UnregisterHotKey(_hWnd, _hotKeyID); //取消熱鍵
        GlobalDeleteAtom(_hotKeyID); //刪除id
        OnHotkey = null; //取消所有關聯的事件
        Application.RemoveMessageFilter(this); //不再使用HotKey類別監視訊息
 
        GC.SuppressFinalize(this);
        disposed = true;
    }
}
 
~HotKey()
{
    Dispose();
}

 

到這邊便完成了系統熱鍵的HotKey類別
我們來測試看看
當按下button1時會註冊系統熱鍵
這邊讓hotkey1~4共用一個事件, 並使用事件參數e來判斷按下什麼熱鍵
而hotkey5獨立一個事件

HotKey hotkey1, hotkey2, hotkey3, hotkey4, hotkey5;
 
private void button1_Click(object sender, EventArgs e)
{
    hotkey1 = new HotKey(this.Handle, Keys.F2, Keys.None); //註冊F2為熱鍵, 如果不要組合鍵請傳Keys.None當參數
    hotkey1.OnHotkey += new HotKey.HotkeyEventHandler(hotkey1to4_OnHotkey); //hotkey1~4共用事件
 
    hotkey2 = new HotKey(this.Handle, Keys.F2, Keys.Control); //註冊Control+F2為熱鍵
    hotkey2.OnHotkey += new HotKey.HotkeyEventHandler(hotkey1to4_OnHotkey); //hotkey1~4共用事件
 
    hotkey3 = new HotKey(this.Handle, Keys.F2, Keys.Shift); //註冊Shift+F2為熱鍵
    hotkey3.OnHotkey += new HotKey.HotkeyEventHandler(hotkey1to4_OnHotkey); //hotkey1~4共用事件
 
    hotkey4 = new HotKey(this.Handle, Keys.F2, Keys.Alt); //註冊Alt+F2為熱鍵
    hotkey4.OnHotkey += new HotKey.HotkeyEventHandler(hotkey1to4_OnHotkey); //hotkey1~4共用事件
 
    hotkey5 = new HotKey(this.Handle, Keys.F2, Keys.LWin); //註冊Win+F2為熱鍵
    hotkey5.OnHotkey += new HotKey.HotkeyEventHandler(hotkey5_OnHotkey); //獨立事件
}
 
private void hotkey1to4_OnHotkey(object sender, HotKeyEventArgs e)
{
    MessageBox.Show("熱鍵" + e.ComboKey.ToString() + "+" + e.HotKey.ToString() + "被觸發了!", "共用事件");
}
 
private void hotkey5_OnHotkey(object sender, HotKeyEventArgs e)
{
    MessageBox.Show("熱鍵" + e.ComboKey.ToString() + "+" + e.HotKey.ToString() + "被觸發了!", "獨立事件");
}

 

然後按下button2時取消所有熱鍵

private void button2_Click(object sender, EventArgs e)
{
    hotkey1.Dispose();
    hotkey2.Dispose();
    hotkey3.Dispose();
    hotkey4.Dispose();
    hotkey5.Dispose();
}

 

這是執行結果
即使把Form整個隱藏了
系統熱鍵仍然會有作用

image image

image image

image

 

 

[範例Code下載]

 

 

 

by sam319