Add ShortcutHotkey struct to better manage the hotkey experience.

Author: mjr4077au

src/PSADT/PSADT.Interop/HOTKEYF.cs

@@ -0,0 +1,35 @@
+using System;
+
+namespace PSADT.Interop
+{
+    /// <summary>
+    /// Defines modifier key flags used to specify keyboard shortcuts (hotkeys) in the Windows API.
+    /// </summary>
+    /// <remarks>This enumeration allows combining multiple modifier keys, such as SHIFT, CONTROL, and ALT,
+    /// using bitwise operations to register complex hotkey combinations. The values correspond to those defined by the
+    /// Win32 API, ensuring compatibility when interacting with native Windows functionality.</remarks>
+    [System.Diagnostics.CodeAnalysis.SuppressMessage("Naming", "CA1712:Do not prefix enum values with type name", Justification = "This is as they're defined within the Win32 API.")]
+    [Flags]
+    internal enum HOTKEYF : uint
+    {
+        /// <summary>
+        /// Represents the SHIFT key modifier for hotkeys.
+        /// </summary>
+        HOTKEYF_SHIFT = Windows.Win32.PInvoke.HOTKEYF_SHIFT,
+
+        /// <summary>
+        /// Represents the CONTROL key modifier for hotkeys.
+        /// </summary>
+        HOTKEYF_CONTROL = Windows.Win32.PInvoke.HOTKEYF_CONTROL,
+
+        /// <summary>
+        /// Represents the ALT key modifier for hotkeys.
+        /// </summary>
+        HOTKEYF_ALT = Windows.Win32.PInvoke.HOTKEYF_ALT,
+
+        /// <summary>
+        /// Represents the extended hotkey flag used in the Windows API.
+        /// </summary>
+        HOTKEYF_EXT = Windows.Win32.PInvoke.HOTKEYF_EXT,
+    }
+}

src/PSADT/PSADT.Interop/NativeMethods.txt

@@ -74,6 +74,10 @@ HKEY_CURRENT_CONFIG
 HKEY_CURRENT_USER
 HKEY_LOCAL_MACHINE
 HKEY_USERS
+HOTKEYF_ALT
+HOTKEYF_CONTROL
+HOTKEYF_EXT
+HOTKEYF_SHIFT
 HRESULT_FROM_WIN32
 HTBORDER
 HTBOTTOM
@@ -2132,6 +2136,7 @@ VerLanguageName
 VerQueryValue
 VirtualAlloc
 VirtualFree
+VIRTUAL_KEY
 VS_FIXEDFILEINFO
 WaitForSingleObject
 Windows.Win32.UI.Controls.IImageList

src/PSADT/PSADT/ShortcutManagement/ShellLinkFile.cs

@@ -312,22 +312,40 @@ public string? Arguments
         /// Gets or sets the hotkey for the shortcut.
         /// </summary>
         /// <value>
-        /// The hotkey as a 16-bit value where the low-order byte is the virtual key code
-        /// and the high-order byte contains modifier flags.
+        /// The hotkey combination as a string (e.g., "Ctrl+Shift+Alt+Q").
+        /// Returns <see langword="null"/> if no hotkey is assigned.
         /// </value>
+        /// <exception cref="ArgumentException">Thrown when the hotkey string format is invalid.</exception>
         /// <exception cref="COMException">Thrown when the COM operation fails.</exception>
-        public ushort? Hotkey
+        /// <example>
+        /// <code>
+        /// // Set hotkey using WScript.Shell-compatible string format
+        /// shortcut.Hotkey = "ALT+CTRL+F";
+        /// shortcut.Hotkey = "Ctrl+Shift+Q";
+        /// 
+        /// // Read and display hotkey
+        /// Console.WriteLine(shortcut.Hotkey); // Output: "Ctrl+Shift+Q"
+        /// </code>
+        /// </example>
+        public string? Hotkey
         {
             get
             {
                 ObjectDisposedException.ThrowIf(_disposed, this);
                 _shellLink.GetHotkey(out ushort hotkey);
-                return hotkey > 0 ? hotkey : null;
+                return hotkey > 0 ? ShortcutHotkey.FromValue(hotkey).ToString() : null;
             }
             set
             {
                 ObjectDisposedException.ThrowIf(_disposed, this);
-                _shellLink.SetHotkey(value ?? 0);
+                if (string.IsNullOrWhiteSpace(value))
+                {
+                    _shellLink.SetHotkey(0);
+                }
+                else
+                {
+                    _shellLink.SetHotkey(ShortcutHotkey.Parse(value!).Value);
+                }
             }
         }