Add keyboard function keys

Sources/DesktopManager.Example/KeyboardInputExample.cs

@@ -0,0 +1,20 @@
+using System;
+using System.Runtime.InteropServices;
+
+namespace DesktopManager.Example;
+
+/// <summary>
+/// Demonstrates basic keyboard input using <see cref="KeyboardInputService"/>.
+/// </summary>
+internal static class KeyboardInputExample {
+    /// <summary>Runs the keyboard input example.</summary>
+    public static void Run() {
+        if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) {
+            Console.WriteLine("Keyboard input examples require Windows.");
+            return;
+        }
+
+        Console.WriteLine("Pressing WIN+R to open Run dialog...");
+        KeyboardInputService.PressShortcut(VirtualKey.VK_LWIN, VirtualKey.VK_R);
+    }
+}

Sources/DesktopManager.Example/Program.cs

@@ -78,6 +78,9 @@ static void Main(string[] args) {
             // Demonstrate window keep-alive features
             WindowKeepAliveExample.Run();
 
+            // Demonstrate keyboard input features
+            KeyboardInputExample.Run();
+
             // Run monitor watcher example for 30 seconds
             MonitorWatcherExample.RunAsync(TimeSpan.FromSeconds(30)).Wait();
 

Sources/DesktopManager.Tests/KeyboardInputServiceTests.cs

@@ -0,0 +1,33 @@
+using System.Runtime.InteropServices;
+
+namespace DesktopManager.Tests;
+
+[TestClass]
+/// <summary>
+/// Tests for <see cref="KeyboardInputService"/>.
+/// </summary>
+public class KeyboardInputServiceTests {
+    [TestMethod]
+    /// <summary>
+    /// Test for PressKey_DoesNotThrow.
+    /// </summary>
+    public void PressKey_DoesNotThrow() {
+        if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) {
+            Assert.Inconclusive("Test requires Windows");
+        }
+
+        KeyboardInputService.PressKey(VirtualKey.VK_F24);
+    }
+
+    [TestMethod]
+    /// <summary>
+    /// Test for PressShortcut_DoesNotThrow.
+    /// </summary>
+    public void PressShortcut_DoesNotThrow() {
+        if (!RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) {
+            Assert.Inconclusive("Test requires Windows");
+        }
+
+        KeyboardInputService.PressShortcut(VirtualKey.VK_F23, VirtualKey.VK_F24);
+    }
+}

Sources/DesktopManager/DesktopManager.csproj

@@ -52,6 +52,8 @@
 
   <ItemGroup>
       <Compile Include="..\Shared\SupportedOSPlatformAttribute.cs" />
+      <Compile Update="KeyboardInputService.cs" />
+      <Compile Update="VirtualKey.cs" />
   </ItemGroup>
 
     <ItemGroup>

Sources/DesktopManager/KeyboardInputService.cs

@@ -0,0 +1,74 @@
+using System;
+using System.Runtime.InteropServices;
+using System.Runtime.Versioning;
+
+namespace DesktopManager;
+
+/// <summary>
+/// Provides methods for simulating keyboard input.
+/// </summary>
+[SupportedOSPlatform("windows")]
+public static class KeyboardInputService {
+    /// <summary>
+    /// Presses a single key using SendInput.
+    /// </summary>
+    /// <param name="key">Key to press.</param>
+    public static void PressKey(VirtualKey key) {
+        MonitorNativeMethods.INPUT[] inputs = new MonitorNativeMethods.INPUT[2];
+        inputs[0].Type = MonitorNativeMethods.INPUT_KEYBOARD;
+        inputs[0].Data.Keyboard = new MonitorNativeMethods.KEYBDINPUT {
+            Vk = (ushort)key,
+            Scan = 0,
+            Flags = 0,
+            Time = 0,
+            ExtraInfo = IntPtr.Zero
+        };
+        inputs[1].Type = MonitorNativeMethods.INPUT_KEYBOARD;
+        inputs[1].Data.Keyboard = new MonitorNativeMethods.KEYBDINPUT {
+            Vk = (ushort)key,
+            Scan = 0,
+            Flags = MonitorNativeMethods.KEYEVENTF_KEYUP,
+            Time = 0,
+            ExtraInfo = IntPtr.Zero
+        };
+        MonitorNativeMethods.SendInput((uint)inputs.Length, inputs, Marshal.SizeOf<MonitorNativeMethods.INPUT>());
+    }
+
+    /// <summary>
+    /// Presses a shortcut combination of keys.
+    /// </summary>
+    /// <param name="keys">Keys to press in order.</param>
+    public static void PressShortcut(params VirtualKey[] keys) {
+        if (keys == null || keys.Length == 0) {
+            throw new ArgumentException("No keys specified", nameof(keys));
+        }
+
+        MonitorNativeMethods.INPUT[] inputs = new MonitorNativeMethods.INPUT[keys.Length * 2];
+        int index = 0;
+        foreach (VirtualKey key in keys) {
+            inputs[index].Type = MonitorNativeMethods.INPUT_KEYBOARD;
+            inputs[index].Data.Keyboard = new MonitorNativeMethods.KEYBDINPUT {
+                Vk = (ushort)key,
+                Scan = 0,
+                Flags = 0,
+                Time = 0,
+                ExtraInfo = IntPtr.Zero
+            };
+            index++;
+        }
+
+        for (int i = keys.Length - 1; i >= 0; i--) {
+            inputs[index].Type = MonitorNativeMethods.INPUT_KEYBOARD;
+            inputs[index].Data.Keyboard = new MonitorNativeMethods.KEYBDINPUT {
+                Vk = (ushort)keys[i],
+                Scan = 0,
+                Flags = MonitorNativeMethods.KEYEVENTF_KEYUP,
+                Time = 0,
+                ExtraInfo = IntPtr.Zero
+            };
+            index++;
+        }
+
+        MonitorNativeMethods.SendInput((uint)inputs.Length, inputs, Marshal.SizeOf<MonitorNativeMethods.INPUT>());
+    }
+}