WPF如何注册全局热键？几句话就能搞定！

已于 2024-05-16 02:08:34 修改
阅读量1.1k 收藏 4
点赞数 27
分类专栏： WPF类库项目【FastHotKeyForWPF】 文章标签： wpf
于 2024-05-12 14:58:28 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/For2789083329/article/details/138754411
版权

注意：最新版可以在专栏找到

虽然WPF可以通过KeyDown等事件实现快捷方式，但当焦点不位于程序内时（例如游戏全屏），就无法触发了。因此，我们会需要注册全局可用的快捷方式。

目录

方法一  WPF原生方法

方法二  使用WPF类库【FastHotKeyForWPF】

Ⅰ 低UI需求时，几句话就能注册、修改、删除热键

Ⅱ 有UI需求，特别是做【设置】界面时，使用【组件】快速构筑界面

必读事项

方法一  WPF原生方法

HwndSource类，外加自己定义的处理函数（这里则是最下方那个WhileKeyInvoked）

IntPtr WindowhWnd；
//窗口句柄，Windows据此区分打开的各种窗体

Window mainWindow = Application.Current.MainWindow;
WindowhWnd = new WindowInteropHelper(mainWindow).Handle;
//这里是获取主窗口（默认为MainWindow）的句柄

HwndSource source = HwndSource.FromHwnd(WindowhWnd);
source.AddHook(new HwndSourceHook(WhileKeyInvoked));
//这两行就是在消息循环中加了一个处理函数

private IntPtr WhileKeyInvoked(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
{
  //此函数的参数、返回值类型都是固定不变的，函数名可以自己起一个
  //它会在接收到系统消息后被触发
}

这种方式固然是OK的，但是，你需要足够了解 uint 值与按键的对应关系，并且需要手写大量的 if 或者 case 来判定是否是你要的值，然后再触发对应的处理函数……这写起来还是不够轻松。

方法二  使用WPF类库【FastHotKeyForWPF】

注意：以下全是【Version 1.1.3】的代码示例，最初的【V1.1.0】演示在最下方B站链接

Ⅰ 低UI需求时，几句话就能注册、修改、删除热键

using FastHotKeyForWPF;
using System.Windows;

namespace TestDemo
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        protected override void OnSourceInitialized(EventArgs e)
        {
            GlobalHotKey.Awake();
            //激活

            GlobalHotKey.Add(ModelKeys.CTRL, NormalKeys.F1, TestA);
            //注册CTRL+F1=>TestA

            GlobalHotKey.Add(ModelKeys.ALT, NormalKeys.E, TestB);
            //注册Alt+E=>TestB

            GlobalHotKey.EditHotKey_Keys(TestA, ModelKeys.ALT, NormalKeys.Q);
            //修改TestA，使它由组合键Alt+Q触发

            GlobalHotKey.EditHotKey_Function(ModelKeys.ALT, NormalKeys.E, TestA);
            //修改Alt+E，使它触发函数TestA

            GlobalHotKey.DeleteByFunction(TestB);
            //删除TestB名下注册的热键

            GlobalHotKey.DeleteById(2004);
            //删除注册编号为2004的热键

            GlobalHotKey.DeleteByKeys(ModelKeys.ALT, NormalKeys.E);
            //删除Alt+E注册的热键

            BindingRef.BindingAutoEvent(WhileReceiveValue);
            //任何TestB这种返回object的无参函数被注册、且被触发时，都会自动触发WhileReceiveValue以做进一步处理

            base.OnSourceInitialized(e);
        }

        protected override void OnClosed(EventArgs e)
        {
            GlobalHotKey.Destroy();
            //销毁

            base.OnClosed(e);
        }

        //被接管的第一个事件
        private void TestA()
        {
            MessageBox.Show("测试A");
        }

        //被接管的第二个事件
        private object TestB()
        {
            return "测试2";
        }

        //监测到返回值时发生的事件 
        private void WhileReceiveValue()
        {
            MessageBox.Show(BindingRef.Value.ToString());
        }
    }
}

Ⅱ 有UI需求，特别是做【设置】界面时，使用【组件】快速构筑界面

这里是后端C#部分：

using FastHotKeyForWPF;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;

namespace TestDemo
{
    public partial class MainWindow : Window
    {
        static ComponentInfo info = new ComponentInfo(20, Brushes.Black, Brushes.Wheat, new Thickness());
        //盒子共用一个基本信息，这里分别是字体大小、颜色/背景色/Margin的属性值

        KeySelectBox box1 = PrefabComponent.GetComponent<KeySelectBox>();
        KeySelectBox box2 = PrefabComponent.GetComponent<KeySelectBox>();
        //两个单键盒子，用于接收用户按下的Key
        //V1.1.3 GetComponent<T>修正，只支持Component接口下的类型

        KeysSelectBox box3 = PrefabComponent.GetComponent<KeysSelectBox>();
        //一个双键盒子，用于接收用户按下的Keys
        //这个是V1.1.3 新组件，能同时接收两个用户按下的键

        public MainWindow()
        {
            InitializeComponent();
        }

        protected override void OnSourceInitialized(EventArgs e)
        {
            GlobalHotKey.Awake();
            //激活

            GlobalHotKey.IsDeBug = true;
            //DeBug模式下，部分地方会打印过程值，例如注册成功时会打印一次

            Box1.Child = box1;
            Box2.Child = box2;
            Box3.Child = box3;
            //三个Border容器用于填装这些预制组件

            box1.UseFatherSize<Border>();
            box2.UseFatherSize<Border>();
            box3.UseFatherSize<Border>();
            //自适应父级容器的大小
            //V1.1.3 字体大小也会自适应

            box1.UseStyleProperty("MyBox", new string[] { "BorderThickness", "BorderBrush" });
            box2.UseStyleProperty("MyBox", new string[] { "BorderThickness", "BorderBrush" });
            box3.UseStyleProperty("MyBox", new string[] { "BorderThickness", "BorderBrush" });
            //MyBox是前端XAML定义的资源样式，这个函数可以应用指定名称的属性，当然，不指定后面的string[]就是全部应用
            //V1.1.3 之前，不能指定属性，而且会覆盖其它内容，如Trigger器

            box1.UseFocusTrigger(WhileEnter, WhileLeave);
            box2.UseFocusTrigger(WhileEnter, WhileLeave);
            box3.UseFocusTrigger(WhileEnter, WhileLeave);
            //设置鼠标进出控件时发生的事件，是V1.1.3 新增功能之一，这里默认都是一个样子

            BindingRef.Connect(box1, box2, TestA);
            //box1、box2 将接管热键组【 box1 + box2 => TestA 】

            BindingRef.Connect(box3, TestB);
            //box3 将接管热键组【 box3 => TestB 】

            BindingRef.BindingAutoEvent(WhileReceiveValue);
            //BindingRef监测到任何具备返回值的热键处理函数（如TestB）被触发后，都将自动触发WhileReceiveValue（）

            PrefabComponent.ProtectSelectBox<KeySelectBox>();
            PrefabComponent.ProtectSelectBox<KeysSelectBox>();
            PrefabComponent.UnProtectSelectBox<KeySelectBox>();
            PrefabComponent.UnProtectSelectBox<KeysSelectBox>();
            box1.Protect();
            box1.UnProtect();
            box3.Protect();
            box3.UnProtect();
            //V1.1.3 新增Box的锁定功能,PrefabComponent提供了全局保护，每个组件也拥有自己的保护方法
            //全局保护的优先级高

            base.OnSourceInitialized(e);
        }

        protected override void OnClosed(EventArgs e)
        {
            GlobalHotKey.Destroy();
            //销毁

            base.OnClosed(e);
        }

        //鼠标进入时发生事件
        private void WhileEnter(TextBox box)
        {
            box.Foreground = Brushes.Cyan;
            box.Background = Brushes.Black;
        }

        //鼠标离开时发生事件
        private void WhileLeave(TextBox box)
        {
            box.Foreground = Brushes.Black;
            box.Background = Brushes.Wheat;
        }

        //被接管的第一个事件
        private void TestA()
        {
            MessageBox.Show("测试A");
        }

        //被接管的第二个事件
        private object TestB()
        {
            return "测试2";
        }

        //监测到返回值时发生的事件 
        private void WhileReceiveValue()
        {
            MessageBox.Show(BindingRef.Value.ToString());
        }
    }
}

 然后是前端XAML部分

<Window x:Class="TestDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:TestDemo"
        mc:Ignorable="d"
        Title="MainWindow" Height="470" Width="800">
    <Window.Resources>
        <!--这是你自定义的资源样式，后续可以为组件使用样式中定义的属性-->
        <Style x:Key="MyBox" TargetType="TextBox">
            <Setter Property="Background" Value="Wheat"></Setter>
            <Setter Property="FontSize" Value="10"></Setter>
            <Setter Property="BorderThickness" Value="1"/>
            <Setter Property="BorderBrush" Value="Red"/>
        </Style>
    </Window.Resources>
    <Viewbox>
        <Grid Height="450" Width="800">
            <!--这两个Border是用来给预制组件KeySelectBox定位的-->
            <Border x:Name="Box1" Margin="37,120,540,280" Height="50"/>
            <Border x:Name="Box2" Margin="297,120,280,280" Height="50"/>

            <!--这个Border是用来给预制组件KeysSelectBox定位的,它能同时接收两个Key，自然也只需要一个父级容器-->
            <Border x:Name="Box3" Margin="37,284,280,116" Height="50"/>
        </Grid>
    </Viewbox>
</Window>

 做完上面的事情后，你将实现如下效果

上方的【LeftCtrl + A】所对应的两个Box，就是我们刚才定义的box1和box2,它们被  BindingRef.Connect()后，就能根据接收到的用户按键，自动地管理TestA函数由谁触发了！

然后是下方的Box

是的，这就已经注册完了！当你在任何其它地方按下CTRL+C都能触发你自定义的函数TestB了！

并且当你传给这些Box其它Key时，会自动修改热键的触发方式，算是全权接管热键操作了呢。

必读事项

1.这个类库将作为我在大学期间的试验田，以期望将一些思路与技术付诸实践，因此它的更新可能会比较频繁，但是也请不要担心，核心功能函数的调用方式将尽力维持不变。

2.项目目前在NuGet包管理器就可以直接下载，GitHub与Gitee都有仓库，但由于作者只有一个人，要同时维护专栏+文档+视频，所以【项目＞文档＞专栏＞视频】，可以在专栏找到最新版的介绍！

3.希望大家可以尝试用一下这个类库，你们的反馈才是我最宝贵的收获！（仓库文档有写我的联系方式，当然，直接一点可以在B站私信我）


前往B站观看演示视频  默认是【Version 1.1.0】的介绍视频，但合集内会跟进新版本。

前往github查阅文档

前往gitee查阅文档

阿晴最好看！
关注
专栏目录
在Winform和WPF中注册全局快捷键实现思路及代码
01-20
快捷键辅助类 代码如下: class HotKey { /// /// 如果函数执行成功，返回值不为0。 /// 如果函数执行失败，返回值为0。要得到扩展错误信息，调用GetLastError。.NET方法:Marshal.GetLastWin32Error() /// /// 要定义热键的窗口的句柄 /// 定义热键ID（不能与其它ID重复） /// 标识热键是否在按Alt、Ctrl、Shif
WPF之全局快捷键
weixin_30746117的博客
08-01 1098
目录 1.WPF快捷键实现方式 2.全局快捷键设置界面 3.Windows API调用 4.注册全局快捷键 5.快捷键触发 WPF快捷键实现方式 WPF快捷键实现主要有自定义快捷键命令和全局快捷键两种方式。 自定义快捷键命令方式是通过KeyBinding为命令绑定快捷键，按键组合可使用“+”进行连接。可以通过Modifiers+Key和...
NHotkey 使用指南
gitblog_00343的博客
08-26 680
NHotkey 使用指南 NHotkeyA managed library to handle global hotkeys in Windows Forms and WPF applications项目地址:https://gitcode.com/gh_mirrors/nh/NHotkey 项目介绍 NHotkey 是一个专为 .NET 开发的管理库，旨在简化在 Windows Forms 和...
WPF 注册全局热键
a483717168的博客
06-07 458
在wpf中是没有注册热键的API的需要调用到以下两个函数。
WPF 使用全局键盘(快捷键)
lvxingzhe3的博客
03-23 4267
WPF 使用快捷键启动事件三种方式
WPF 快捷键
时意
07-29 1641
CanExecute="CommandBinding_CanExecute" Executed="CommandBinding_Executed"/>
C# wpf 实现截屏框热键截屏功能
codeofcc的博客
09-07 1454
在《C# wpf 使用DockPanel实现截屏框》中我们实现了一个截屏框，接下来就要实现相应的截屏功能了。获取截屏区域然后使用GDI+截屏，在这里不少的细节需要处理，比如响应热键弹出截屏界面、点击拖出截屏框、截屏区域任意反向拖动、处理不同dpi下的坐标位置等等。以上就是今天要讲的内容，本文介绍了wpf截屏框热键截屏的方法。
WPF系统全局热键
11-03
在Windows Presentation Foundation（WPF）框架中，实现系统全局热键是为应用程序提供快捷方式，使得用户无需将焦点置于应用程序窗口内，也能通过特定的按键组合执行特定操作。这种功能在许多应用程序中都非常常见，...
WPF 全局热键例子
12-18
**WPF全局热键例子详解** 在Windows Presentation Foundation（WPF）中，全局热键（Global Hotkeys）是指能够在应用程序的任何窗口或甚至在应用程序不处于焦点时响应特定按键组合的功能。这种技术允许用户通过...
NHotkey：一个托管库，用于处理Windows Forms和WPF应用程序中的全局热键
02-05
快捷键 即使WPF或WinForms应用程序没有焦点，也可以轻松处理快捷键。 使用熟悉的KeyBinding语法在XAML中声明热键。 Nuget软件包： 对于WPF： 对于Windows窗体： Windows窗体用法添加对NHotkey.dll和NHotkey.Windows...
WPF 全局快捷键 GlobalHotKeyDemo
02-21
这通常用于实现像“Ctrl+Alt+S”这样的组合键，无论焦点在哪个应用程序上，只要按下该组合键，就能激活我们的WPF应用中的某个功能。本文将深入探讨如何在WPF项目中实现全局快捷键，并提供一个名为"GlobalHotKeyDemo...
WPF类库【FastHotKeyForWPF】在【Version 1.1.5】中更新了哪些内容？这个类库如何让你在WPF快速构建全局热键相关功能？
For2789083329的博客
05-16 552
【Version 1.1.5】重要更新
8.WPF命令
博客
11-08 711
8.WPF命令
Wpf实现快捷键的一种方式
mengningyun6826的博客
05-10 493
/</</在按钮Button中使用。
WPF(MVVM) 热键快捷键设置
baidu_38131614的博客
09-07 2848
WPF(MVVM) 热键快捷键设置
[ FastHotKeyForWPF ] 库的 Version2.0.1更新 ，WPF项目注册全局热键更爽了
For2789083329的博客
07-26 521
/此处可获取热键的具体信息上面两个是库原生控件，下面两个是借助抽象基类与接口拓展出的控件，热键方面功能与库控件完全相同，但是请注意，拓展控件的 CTRL/ALT已经不区分左右了，这是由于其UpdateText()在拓展过程中被重写了.( 具体可查看文档给出的代码示例 )
WPF全局快捷键使用
weixin_44879611的博客
11-27 1081
全局快捷键的使用 使用全局快捷键后，可以不切换到WPF窗口即可执行该窗口中的一些操作 需要添加的引用 using System.Runtime.InteropServices; using System.Windows.Interop; 声明的相应代码 1 static class Hotkey 2 { 3 #region 系统api 4 ...
wpf menu 菜单 快捷键
weixin_53370274的博客
05-08 1392
界面快捷键资源 Ctrl+F F3可加入其它，自行定义 Page可改为Windows xaml文件 <Page.Resources> <RoutedUICommand x:Key="F3" Text="查找内容"/> <RoutedUICommand x:Key="Search" Text="查找内容"/> </Page.Resources> <Page.InputBindings> <KeyB
WPF使用内置命令与注册命令
浪子花梦
07-25 805
WPF 内置了许多有用的命令，而这些命令和有的类型已经产生了关联，比较TextBox 与 复制、粘贴等命令关联，下面我们看看如何使用这种内置命令 . . . 我们在编辑这个菜单里面使用内置命令，如下所示： 这些命令能够响应 TextBox文本框类型，而他们是有默认快捷键的，如下所示： 所以我们可以利用这些命令对文本框中的文本作出一些基本的操作 . . . 而有的内置命令（或者其它命令）是文本框没有激活的，需要我们自动来将命令注册到 TextBox中，比如有的命令：查找（ ...
如何在WPF中添加多个热键到一个TextBox？
最新发布
10-25
在WPF中，如果你想在一个TextBox中添加多个热键，可以在`HotkeyBehavior`类中稍作修改，将`InputKeys`属性改为一个`Key`类型的集合，然后在`OnPreviewTextInput`方法中检查输入的键是否在集合中。这里有一个示例： ```csharp public class MultiHotkeyBehavior : Behavior<TextBox> { public List<Key> InputKeys { get; set; } public MultiHotkeyBehavior(params Key[] keys) { InputKeys = new List<Key>(keys); } protected override void OnAttached() { base.OnAttached(); AssociatedObject.PreviewTextInput += OnPreviewTextInput; } protected override void OnDetaching() { base.OnDetaching(); AssociatedObject.PreviewTextInput -= OnPreviewTextInput; } private void OnPreviewTextInput(object sender, TextCompositionEventArgs e) { if (InputKeys.Any(key => key == e.TextComposition.Text)) { // 处理对应的热键动作 e.Handled = true; } } } // 使用时，在XAML中： <TextBox x:Name="MultiHotkeyTextBox" behaviors:MultiHotkeyBehavior.InputKeys="F1, F2, F3"> <!-- 其他属性 --> </TextBox> ``` 这样，每个指定的键都会被视为独立的热键，只要其中一个匹配，就会触发相应的处理。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值