diff options
Diffstat (limited to 'plugins/HwHotKeys/src/HwHotKeys_DllMain.cpp')
| -rw-r--r-- | plugins/HwHotKeys/src/HwHotKeys_DllMain.cpp | 74 |
1 files changed, 37 insertions, 37 deletions
diff --git a/plugins/HwHotKeys/src/HwHotKeys_DllMain.cpp b/plugins/HwHotKeys/src/HwHotKeys_DllMain.cpp index 01ed11e26f..22814e4c9d 100644 --- a/plugins/HwHotKeys/src/HwHotKeys_DllMain.cpp +++ b/plugins/HwHotKeys/src/HwHotKeys_DllMain.cpp @@ -1,6 +1,6 @@ /* ============================================================================
Hardware HotKeys plugin for Miranda NG.
-Copyright Eugene f2065, http://f2065.narod.ru, f2065 mail.ru, ICQ 35078112
+Copyright © Eugene f2065, http://f2065.narod.ru, f2065 mail.ru, ICQ 35078112
This program is free software; you can redistribute it and / or
modify it under the terms of the GNU General Public License
@@ -23,47 +23,47 @@ Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111 - 1307, USA. HINSTANCE hInstance;
int hLangpack;
-HWND hDialogWnd = nullptr; // ,
+HWND hDialogWnd = nullptr; // хэндл окна настроек, он глобально используется для вывода туда в реалтайме сканкодов клавы из хука
HHOOK hHook;
CLIST_INTERFACE *pcli;
-// - //,
+// там хранятся настройки - сканкоды кнопок для закрытия/показа/чтения, на которые должны реагировать соответствующие действия
DWORD code_Close = 0;
DWORD code_HideShow = 0;
DWORD code_ReadMsg = 0;
-// _tmp
+// в _tmp копируются настройки на время диалога настроек
DWORD code_Close_tmp = 0;
DWORD code_HideShow_tmp = 0;
DWORD code_ReadMsg_tmp = 0;
-// :
-// 0...7 - ( KbdLLHookStruct.scanCode&0xFF)
-// 8 - , LLKHF_EXTENDED ((LOBYTE(KbdLLHookStruct.flags)&1) -
-// ( 101- 255 , .. F13-F20).
-// , 9- ( *key_tab[0x200]).
-// 9-19 - .
-// 20-31 - , Shift/Ctrl/Alt/Win. 4 - 12 . 3 - , , .
-// key_flag_sr
-
-// 10 - "" .
-// 0...7 - ( KbdLLHookStruct.scanCode&0xFF)
-// 8 - , LLKHF_EXTENDED ((LOBYTE(KbdLLHookStruct.flags)&1) -
-// ( 101- 255 , .. F13-F20).
-// 9 - 0...7 , VK- (KbdLLHookStruct.vkCode), 8 0.
-// USB- , 0 - VK-.
-// ( *key_tab[0x300]).
-// 10-19 - .
-// 20-31 - , Shift/Ctrl/Alt/Win. 4 - 12 . 3 - , , .
-// key_flag_sr
-
-
-
-
-DWORD key_code = 0; //
+// формат сканкодов тут такой:
+// младшие 0...7 биты - это аппаратный сканкод (как он приходит в KbdLLHookStruct.scanCode&0xFF)
+// 8 бит - это как бы часть сканкода, флаг LLKHF_EXTENDED ((LOBYTE(KbdLLHookStruct.flags)&1) - часть кнопок с этим флагом
+// (авторам 101-кнопочной клавы не хватило 255 сканкодов, т.к. там много старых кнопок которые уже давно вымерли типа F13-F20).
+// итак, плагин оперирует 9-битными сканкодами (имена кнопок всех этих сканкодов прописаны в таблице *key_tab[0x200]).
+// биты 9-19 - не используются.
+// биты 20-31 - это флаги регистров, Shift/Ctrl/Alt/Win. На 4 кнопки - 12 битов. Потому что каждая кнопка 3 имеет бита - левая, правая, или любая.
+// битовые маски регистров опеределены в key_flag_sr и соседних именах
+
+// плагин оперирует 10 - битными "сканкодами" собственного формата.
+// младшие 0...7 биты - это обычно аппаратный сканкод (как он приходит в KbdLLHookStruct.scanCode&0xFF)
+// 8 бит - это как бы часть сканкода, флаг LLKHF_EXTENDED ((LOBYTE(KbdLLHookStruct.flags)&1) - часть кнопок с этим флагом
+// (авторам 101-кнопочной клавы не хватило 255 сканкодов, т.к. там много старых кнопок которые уже давно вымерли типа F13-F20).
+// 9 бит - это значит что в битах 0...7 не аппаратный сканкод, а VK-код (KbdLLHookStruct.vkCode), и 8 бит при этом всегда 0.
+// сделано это потому что некоторые USB-клавиатуры не выдают в хук аппаратные скандоды, и если там 0 - то будет использован VK-код.
+// (имена кнопок всех этих сканкодов прописаны в таблице *key_tab[0x300]).
+// биты 10-19 - не используются.
+// биты 20-31 - это флаги регистров, Shift/Ctrl/Alt/Win. На 4 кнопки - 12 битов. Потому что каждая кнопка 3 имеет бита - левая, правая, или любая.
+// битовые маски регистров опеределены в key_flag_sr и соседних именах
+
+
+
+
+DWORD key_code = 0; // там постоянно обновляется сканкод текущей нажатой комбинации
DWORD key_code_raw = 0;
-DWORD key_code_assign = 0; // , .
+DWORD key_code_assign = 0; // во время настроек там хранится сканкод последней нажатой комбинации, который можно назначить для действия.
-CHAR key_name_buffer[150]; // . ANSI.
-// - L_Shift + L_Ctrl + L_Alt + L_Win + R_Shift + R_Ctrl + R_Alt + R_Win + MSO_Print, HP_TouchPadOff - 100 .
+CHAR key_name_buffer[150]; // буфер куда печатается имя кнопки в настройках. ANSI.
+// Самая длинная в теории строка - «L_Shift + L_Ctrl + L_Alt + L_Win + R_Shift + R_Ctrl + R_Alt + R_Win + MSO_Print, HP_TouchPadOff» - менее 100 букв.
// ============================================================================
@@ -85,7 +85,7 @@ PLUGININFOEX PluginInfoEx = { __COPYRIGHT,
__AUTHORWEB,
UNICODE_AWARE,
- // {315B3800-8258-44C4-B60E-58C50B9303B6} - GUID HwHotKeys
+ // {315B3800-8258-44C4-B60E-58C50B9303B6} - GUID для плагина HwHotKeys
{ 0x315b3800, 0x8258, 0x44c4, { 0xb6, 0xe, 0x58, 0xc5, 0xb, 0x93, 0x3, 0xb6 } }
};
@@ -98,21 +98,21 @@ extern "C" __declspec(dllexport) PLUGININFOEX * MirandaPluginInfoEx(DWORD) extern "C" __declspec(dllexport) int Load(void)
{
- // ( )
+ // загружаем (из БД) настройки плагина
code_Close = db_get_dw(0, __DbModName, "Close", 0);
code_HideShow = db_get_dw(0, __DbModName, "HideShow", 0);
code_ReadMsg = db_get_dw(0, __DbModName, "ReadMsg", 0);
- // - mir_getLP(PlgInfoEx)
+ // установка кода локализации - макрос mir_getLP(PlgInfoEx)
mir_getLP(&PluginInfoEx);
- // - CLIST_INTERFACE *pcli;
+ // Интерфейс контактлиста - макрос заполняет CLIST_INTERFACE *pcli;
pcli = Clist_GetInterface();
- //
+ // регистрация диалога опций
HookEvent(ME_OPT_INITIALISE, initializeOptions);
- //
+ // установка хука для низкоуровневой обработки хоткеев
hHook = SetWindowsHookExA(WH_KEYBOARD_LL, key_hook, hInstance, 0);
// StringCbPrintfA(key_name_buffer, 100, "hHook = 0x%x, Err = %u", hHook, GetLastError);
|