RegisterHotKey, UnRegisterHotKey.

بسم الله الرحمن الرحيم 

السلام عليكم ورحمة الله وبركاته

اللهم علمنا ما ينفعنا وانفعنا بما علمتنا انك انت العليم الحكيم

====>What Is The hot key ?<====

هو مفتاح(Key) أو مجموعة من الأزرار/المفاتيح عن ضغطها معاً تقوم بتنفيذ امر معين

وتدعى غالبا بالإختصارات

====>RegisterHotKey<====

Name : RegisterHotKey

Lib : User32.dll

Return Value : Boolean

الوظيفة : تقوم بتعيين او تسجيل "Hot Key" 

---->Declaration<----

VB.NET

 <DllImport("user32.dll", SetLastError := True)> _ Private Shared Function RegisterHotKey(hWnd As IntPtr, id As Integer, fsModifiers As UInteger, vk As UInteger) As <MarshalAs(UnmanagedType.Bool)> Boolean End Function

C Sharp

 [DllImport("user32.dll", SetLastError = true)] [return: MarshalAs(UnmanagedType.Bool)] static extern bool RegisterHotKey(IntPtr hWnd, int id, uint fsModifiers, uint vk);

C++

Just Include Windows.h

الدالة لها أربع معاملات (Parameters)

hWnd : إختياري (يمكن أن يكون{NULL}) المقبض (handle) الخاص بالنافذة التي ستستقبل رسالة (WM_HOTKEY) عند الضغط على المفتاح/المفاتيح إذا كان (NULL) فسيتم إرسال الرسالة إلى العملية (Process) التي قامت بإنشاء المفتاح.

id : المعرف (identifier) رقم "عشوائي".

fsModifiers :  المفاتيح/الأزرار التي يجب أن تكون "مضغوطة" مع المفتاح المحدد في المعامل الرابع.

None = 0 Alt = 1 Control = 2 Shift = 4 NoRepeat = 16384 WinKey = 8

إذا كانت قيمة هذا المعامل 16384 لن يقوم النظام بإرسال رسالة WM_HOTKEY اكثر من مرة عن الضغط على الأزرار بشكل متواصل

 vk : رقم/رمز المفتاح.

---->Usage<----

VB.NET

Imports System.Runtime.InteropServices Imports System.Windows.Forms Module Module1 'Add Library (System.Windows.Forms) as reference to use Message Structure <DllImport("user32.dll")> _ Public Function GetMessage( _ ByRef lpMsg As Message, _ ByVal hWnd As IntPtr, _ ByVal wMsgFilterMin As UInteger, _ ByVal wMsgFilterMax As UInteger) As <MarshalAs(UnmanagedType.Bool)> Boolean End Function <DllImport("user32.dll", SetLastError:=True)> _ Private Function RegisterHotKey(hWnd As IntPtr, id As Integer, fsModifiers As UInteger, vk As UInteger) As <MarshalAs(UnmanagedType.Bool)> Boolean End Function Enum KeyModifier As Integer None = 0 Alt = 1 Control = 2 Shift = 4 WinKey = 8 NoRepeat = &H4000 End Enum Sub Main() Const WM_HOTKEY As Integer = &H312 Dim MSG_ID As Integer = CInt(System.Threading.Thread.CurrentThread.ManagedThreadId.ToString & New Random().Next(1000, 9999)) Console.WriteLine("Registering Hot Key " & IIf(RegisterHotKey(Nothing, MSG_ID, KeyModifier.Alt Or KeyModifier.NoRepeat, System.Windows.Forms.Keys.V), "Successed", "Failed")) Dim MSG As Message While GetMessage(MSG, Nothing, 0, 0) If MSG.Msg = WM_HOTKEY AndAlso MSG.WParam = MSG_ID Then Console.WriteLine("Hot Key Pressed") End If End While End Sub End Module

C Sharp

using System; using System.Runtime.InteropServices; using System.Windows.Forms; internal static class Module1 { //Add Library (System.Windows.Forms) as reference to use Message Structure [DllImport("user32.dll")] [return: MarshalAs(UnmanagedType.Bool)] public extern static bool GetMessage(ref Message lpMsg, IntPtr hWnd, uint wMsgFilterMin, uint wMsgFilterMax); [DllImport("user32.dll", SetLastError = true)] [return: MarshalAs(UnmanagedType.Bool)] private extern static bool RegisterHotKey(IntPtr hWnd, int id, uint fsModifiers, uint vk); public enum KeyModifier : int { None = 0, Alt = 1, Control = 2, Shift = 4, WinKey = 8, NoRepeat = 0x4000 } private static int test = 0; private static int MSG_ID = 0; public static void UpdateNumbers() { test = new Random().Next(1000, 9999); MSG_ID = Convert.ToInt32(System.Threading.Thread.CurrentThread.ManagedThreadId.ToString() + test.ToString()); } public static void Main() { const int WM_HOTKEY = 0x312; UpdateNumbers(); Console.WriteLine("Registering Hot Key " + (RegisterHotKey(IntPtr.Zero, MSG_ID, Convert.ToUInt32(KeyModifier.Alt | KeyModifier.NoRepeat), (uint)System.Windows.Forms.Keys.V) ? "Successed" : "Failed")); Message MSG = new Message(); while (GetMessage(ref MSG, IntPtr.Zero, 0, 0)) { if (MSG.Msg == WM_HOTKEY && (int)MSG.WParam == MSG_ID) { Console.WriteLine("Hot Key Pressed"); } } } }

C++

#include <Windows.h> #include <stdio.h> #include <iostream> using namespace std; void main(){ cout << RegisterHotKey(NULL, 1245, MOD_ALT | MOD_NOREPEAT, 0x42); MSG PressedMSG = { 0 }; while (GetMessage(&PressedMSG, NULL, 0, 0) != 0) { if (PressedMSG.wParam == 1245) { cout << "WM_HOTKEY Pressed" << endl; } }

---->Notes<----

إذا كان المفتاح مسجلا من قبل ستفشل الدالة وتعيد خطأ (False)

مدى المعرف(Identifier) للتطبيقات من 0 إلى 49151 ،أما بالنسبة للمكتبات(Dynamic link Library {.dll}) فالمدى من 49152 إلى 65535.

الدالة لا يمكنها إنشاء مفتاح لنافذة أنشات من (thread) آخر.

====>UnRegisterHotKey<====

Name : UnRegisterHotKey

Lib : User32.dll

Return Value : Boolean

الوظيفة : تقوم بإلغاء "Hot Key" تم تسجيله سابقا.

---->Declaration<----

VB.NET

<DllImport("user32.dll", SetLastError := True)> _ Private Shared Function UnregisterHotKey(hWnd As IntPtr, id As Integer) As <MarshalAs(UnmanagedType.Bool)> Boolean End Function

C Sharp

[DllImport("user32.dll", SetLastError = true)] [return: MarshalAs(UnmanagedType.Bool)] static extern bool UnregisterHotKey(IntPtr hWnd, int id);

C++

Just Include Windows.h

الدالة لها معاملان (Parameters)

hWnd : المقبض (Handle) الخاص بالنافذة التي سجل المفتاح معها (التي ترسل عليها رسالة WM_HOTKEY عند الضغط على المفتاح).

id : المعرف (identifier) الخاص بالمفتاح حتى يتم إلغاءه.

---->Usage<----

 VB.NET

Dim HotKey_ID As Integer = 12346 Console.WriteLine("UnRegistering Hot Key " & IIf(UnregisterHotKey(Nothing, HotKey_ID), "Successed", "Failed")) Console.ReadKey() 

C Sharp

int HotKey_ID = 12346; Console.WriteLine("UnRegistering Hot Key " + (UnregisterHotKey(IntPtr.Zero, HotKey_ID) ? "Successed" : "Failed")); Console.ReadKey();

C++

int HotKey_ID = 12345; cout << UnregisterHotKey(NULL, HotKey_ID);

إن أصبت فمن الله ، وإن اخطئت فمني ومن الشيطان  اترككم في امان الله ورعايته 

والسلام عليكم ورحمة الله وبركاته

DoneByA