Улучшено управление жизненным циклом хоткеев, README

Добавлен HashSet для отслеживания привязок в GlobalHotKeysCollection и методы для корректного управления жизненным циклом GlobalHotKeyBinding при изменениях коллекции. Реализовано удаление идентификаторов хоткеев из внутренней таблицы при их снятии регистрации. Добавлена очистка обработчика сообщений при отсутствии хоткеев. В проект добавлен README.MD с примерами использования и описанием компонентов.

Author: Infarh

MathCore.WPF/AttachedProperties/HotKeys/GlobalHotKeysCollection.cs

@@ -45,6 +45,8 @@ internal static (Keys Key, ModifierKeys Modifer) GetModifiers(Keys Key, Modifier
         return (key, modifers);
     }
 
+    private readonly HashSet<GlobalHotKeyBinding> _Bindings = [];
+
     /// <summary>Инициализация новой коллекции горячих клавиш</summary>
     public GlobalHotKeysCollection() => ((INotifyCollectionChanged)this).CollectionChanged += OnCollectionChanged;
 
@@ -57,22 +59,62 @@ private void OnCollectionChanged(object? Sender, NotifyCollectionChangedEventArg
         switch (e.Action)
         {
             case NotifyCollectionChangedAction.Add:
-                if (e.NewItems?.Cast<GlobalHotKeyBinding>() is { } added)
-                    foreach (var item in e.NewItems.Cast<GlobalHotKeyBinding>()) item.SetHost(this);
+                AddBindings(e.NewItems);
                 break;
             case NotifyCollectionChangedAction.Remove:
-                if (e.OldItems?.Cast<GlobalHotKeyBinding>() is { } removed)
-                    foreach (var item in removed) item.SetHost(null);
+                RemoveBindings(e.OldItems);
                 break;
             case NotifyCollectionChangedAction.Replace:
-                if (e.NewItems?.Cast<GlobalHotKeyBinding>() is { } @new)
-                    foreach (var item in @new) item.SetHost(this);
-                if (e.OldItems?.Cast<GlobalHotKeyBinding>() is { } old)
-                    foreach (var item in old) item.SetHost(null);
+                AddBindings(e.NewItems);
+                RemoveBindings(e.OldItems);
+                break;
+            case NotifyCollectionChangedAction.Reset:
+                ResetBindings();
                 break;
         }
     }
 
+    private void AddBindings(IList? Items)
+    {
+        if (Items is null) return;
+
+        foreach (GlobalHotKeyBinding item in Items)
+        {
+            item.SetHost(this);
+            _Bindings.Add(item);
+        }
+    }
+
+    private void RemoveBindings(IList? Items)
+    {
+        if (Items is null) return;
+
+        foreach (GlobalHotKeyBinding item in Items)
+        {
+            item.SetHost(null);
+            _Bindings.Remove(item);
+        }
+    }
+
+    private void ResetBindings()
+    {
+        var current_bindings = new HashSet<GlobalHotKeyBinding>(this);
+
+        foreach (var binding in _Bindings)
+        {
+            if (current_bindings.Contains(binding)) continue;
+
+            binding.SetHost(null);
+            Unregister(binding);
+        }
+
+        foreach (var binding in current_bindings)
+            binding.SetHost(this);
+
+        _Bindings.Clear();
+        _Bindings.UnionWith(current_bindings);
+    }
+
     protected override Freezable CreateInstanceCore()
     {
         var collection = new GlobalHotKeysCollection();
@@ -131,6 +173,24 @@ private static ushort GetHotKeyId((Keys Key, ModifierKeys Modifer) Key)
         return key_id;
     }
 
+    private static void RemoveHotKeyId(ushort KeyId)
+    {
+        (Keys Key, ModifierKeys Modifer) key_to_remove = default;
+        var has_key = false;
+
+        foreach (var pair in __HotKeyIds)
+        {
+            if (pair.Value != KeyId) continue;
+
+            key_to_remove = pair.Key;
+            has_key = true;
+            break;
+        }
+
+        if (has_key)
+            __HotKeyIds.Remove(key_to_remove);
+    }
+
     /// <summary>Таблица идентификаторов зарегистрированных горячих клавиш</summary>
     private static readonly HashSet<ushort> __RegisteredHotKeys = [];
 
@@ -190,8 +250,15 @@ private static void UnregisterHotKey(ushort KeyId)
         User32.UnregisterHotKey(IntPtr.Zero, KeyId);
         __RegisteredHotKeys.Remove(KeyId);
 
+        RemoveHotKeyId(KeyId);
         Kernel32.GlobalDeleteAtom(KeyId);
 
+        if (__HotKeyBindings is { Count: 0 })
+        {
+            ComponentDispatcher.ThreadPreprocessMessage -= OnFilterMessage;
+            __HotKeyBindings = null;
+        }
+
         Debug.WriteLine("Hot key {0} unregistered at system");
     }
 

MathCore.WPF/AttachedProperties/HotKeys/README.MD

@@ -0,0 +1,52 @@
+# GlobalHotKeys
+
+Компоненты для регистрации глобальных горячих клавиш в WPF с привязкой к `ICommand`.
+
+## Состав
+
+- `GlobalHotKeysCollection` — коллекция горячих клавиш, подключаемая через attached‑свойство `UI.HotKeys`
+- `GlobalHotKeyBinding` — описание одной горячей клавиши (клавиша, модификаторы, команда, параметр)
+
+## Использование в XAML
+
+```xml
+<Window
+    xmlns:local="clr-namespace:MathCore.WPF">
+    <local:UI.HotKeys>
+        <local:GlobalHotKeysCollection>
+            <local:GlobalHotKeyBinding
+                Key="F5"
+                Command="{Binding RefreshCommand}" />
+            <local:GlobalHotKeyBinding
+                Key="S"
+                Modifer="Control"
+                Command="{Binding SaveCommand}" />
+        </local:GlobalHotKeysCollection>
+    </local:UI.HotKeys>
+</Window>
+```
+
+## Использование в коде
+
+```csharp
+var hot_keys = UI.GetHotKeys(this);
+
+hot_keys.Add(new GlobalHotKeyBinding
+{
+    Key = Keys.F5,
+    Command = RefreshCommand
+});
+
+hot_keys.Add(new GlobalHotKeyBinding
+{
+    Key = Keys.S,
+    Modifer = ModifierKeys.Control,
+    Command = SaveCommand,
+    CommandParameter = "autosave"
+});
+```
+
+## Примечания
+
+- Коллекция автоматически освобождает зарегистрированные хоткеи при выгрузке `Window`
+- Горячие клавиши обрабатываются на уровне системных сообщений, поэтому работают вне фокуса элементов управления