NHotPhrase 62.0.0

dotnet add package NHotPhrase --version 62.0.0                
NuGet\Install-Package NHotPhrase -Version 62.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NHotPhrase" Version="62.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NHotPhrase --version 62.0.0                
#r "nuget: NHotPhrase, 62.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install NHotPhrase as a Cake Addin
#addin nuget:?package=NHotPhrase&version=62.0.0

// Install NHotPhrase as a Cake Tool
#tool nuget:?package=NHotPhrase&version=62.0.0                

NHotPhrase

A managed library to handle global "hot phrases" in Windows Forms.

See Home for a simplified yet customized approach.

A hot phrase is a key sequence that activates a piece of your code from any other windows application. Uses include anywhere you could usea global hot key.

So where a hotkey is something like

  • Push ctrl + alt + 1 and then release all 3 which might cause your email address to be typed into the current application

A hot phrase would be

  • First press and release the ctrl key,
  • Then press and release the alt key,
  • Then press and release the 1 key
  • Then type your email (or whatever you want) into the current application.

An example hot phrase from NHotPhrase.WindowsForms.Demo does this

  • Click CapsLock,
  • Click CapsLock again,
  • Type "WRG" (or "wrg" it's not case sensitive)
  • Then whatever text is in the DemoForm's text box will be typed into the current application.

The code for this might look like

        // Write some text
        Manager.Keyboard.AddOrReplace(
            HotPhraseKeySequence
                .Named("Write some text")
                .WhenKeyPressed(Keys.CapsLock)
                .ThenKeyPressed(Keys.CapsLock)
                .ThenKeyPressed(Keys.W)
                .ThenKeyPressed(Keys.R)
                .ThenKeyPressed(Keys.G)
                .ThenCall(OnWriteEmail)

<< Then when the user presses caps lock twice, then W, then R, then G the following code could be called

    private void OnWriteEmail(object? sender, HotPhraseEventArgs e)
    {
        // Since the user typed WRG, let's get rid of that
        SendKeys.SendWait("{BACKSPACE}{BACKSPACE}{BACKSPACE}");
        Thread.Sleep(2);

        // Make sure what's in the text box is ready for sending through SendKeys
        var textPartsToSend = TextToSend.Text.MakeReadyForSendKeys();
        if (textPartsToSend.Count <= 0) return;

        foreach (var part in textPartsToSend)
        {
            // The text to send has been broken into strings of no longer than 8 characters or one command
            // This gives the receiving application pleaty of time to process it (but still pretty quickly)
            SendKeys.SendWait(part);
            Thread.Sleep(2);
        }
        // Instead of sending text, the code could pop up a dialog and ask the user to pick something from a list
        // My XLG and Quick Scripts 
    }
                

A hot phrase could be press and release just ctrl, then shift, then alt to trigger a piece of your code. The possible combinations are practically limitless.

So why? Well, I've always wanted the ability to activate a piece of my code globally without tripping up existing hotkeys. I've got a couple of other programs, xlg and quick scripts which have regeneration and run functions which I can now tie to a global phrase.

Maybe it's just me who wants to do this, but hey. I'd love to hear how you use this guy.

Thanks to NHotkey for the base code and layout. I changed a lot because there's a fundamentally different approach when clicking one key combination as opposed to a sequence of keys. I tried to take care to make sure NHotKeys and NHotPhrases could exist side by side.

Wildcards

A wildcard is 1 or more (optional) characters or numbers that must have been typed after the sequence.

For instance:

        // Write some text plus any wildcards
        Manager.Keyboard.AddOrReplace(
            HotPhraseKeySequence
                .Named("Write some text and wildcards")
                .WhenKeysPressed(Keys.CapsLock, Keys.CapsLock, Keys.N)
                .FollowedByWildcards(WildcardMatchType.Digits, 1)
                .ThenCall(OnWriteTextWithWildcards)
        );

<<

  • User presses capslock twice, then the N key, then presses a single digit. The engine matches and calls the following code
    public static void OnWriteTextWithWildcards(object? sender, HotPhraseEventArgs e)
    {
        if (e.State.MatchResult == null)
            return;

        var wildcards = e.State.MatchResult.Value;
        var wildcardsLength = wildcards?.Length ?? 0;
        if (wildcardsLength == 0) return;
        
        SendKeysKeyword.SendBackspaces(2);
        $"Your wildcard is {wildcards}".SendString();
        switch (e.State.MatchResult.ValueAsInt())
        {
            case 1:
                "\n\n\tThis is specific to wildcard 1\n\n".SendString();
                break;
            case 5:
                "\n\n\tThis is specific to wildcard 5\n\n\tsomevalue@bold.one\n\n".SendString();
                break;
        }
    }

<<

Product Compatible and additional computed target framework versions.
.NET net6.0-windows7.0 is compatible.  net7.0-windows was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on NHotPhrase:

Package Downloads
NHotPhrase.WindowsForms

A managed library to handle global hot phrases in Windows Forms applications. This package contains the concrete HotkeyManager implementation for Windows Forms.

NHotPhrase.Wpf

A managed library to handle global hotkeys in WPF applications. This package contains the concrete HotkeyManager implementation for WPF.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
62.0.0 390 12/17/2022
6.0.0 485 4/1/2022
1.0.2 337 7/17/2021
1.0.1 430 6/18/2021
1.0.0 388 6/8/2021