add CmdSetScreenshotHotkey to set/remove global screenshot hotkey (fixes #5518)

Dialog captures key combinations including PrtSc (via low-level
keyboard hook), shows current hotkey, and allows setting or removing
it. Updates the Shortcuts section in advanced settings with
Cmd = CmdScreenshot. Unregisters hotkey before dialog opens so keys
can be captured, restores on cancel.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: kjk

cmd/gen-commands.ts

@@ -224,6 +224,7 @@ export const commands = [
     "CmdPdShowInfo", "Show PDF Info",
     "CmdDocumentExtractText", "Extract Text From Document",
     "CmdDocumentShowOutline", "Show Document Bookmarks",
+    "CmdSetScreenshotHotkey", "Set Screenshot Hotkey",
     "CmdNone", "Do nothing",
 ];
 

docs/md/Commands.md

@@ -296,6 +296,7 @@ CmdPdfDeletePages,,Delete Pages From PDF,"Delete pages from a PDF file using pag
 CmdPdfExtractPages,,Extract Pages From PDF,"Extract pages from a PDF file using page ranges like 1,3-8,13-N where N is the last page, ver 3.7+"
 CmdPdfEncrypt,,Encrypt PDF,"Encrypt a PDF file with a password using AES-256 encryption, ver 3.7+"
 CmdPdfDecrypt,,Decrypt PDF,"Decrypt an encrypted PDF file, removing password protection, ver 3.7+"
+CmdSetScreenshotHotkey,,Set Screenshot Hotkey,"Open dialog to set or remove a global hotkey for taking screenshots, ver 3.7+"
 ```
 
 ## Debug

docs/md/Version-history.md

@@ -42,6 +42,7 @@ Available in [pre-release](https://www.sumatrapdfreader.org/prerelease) builds.
 - Can save images in different formats: PNG, JPEG, BMP, GIF, TIFF.
 - add `CmdPdfBake` (`Bake PDF File` in `Ctrl + k` [command palette](Command-Palette.md)) to bake interactive form and annotation content into static graphics in a new PDF file
 - add `Fullscreen` advanced setting with `ShowToolbar` and `ShowMenubar` options to show toolbar and menu bar in fullscreen mode. Use `F9` / `F8` to toggle them while in fullscreen
+- add `CmdSetScreenshotHotkey` (`Set Screenshot Hotkey` in `Ctrl + k` [command palette](Command-Palette.md)) to set or remove a global hotkey for taking screenshots
 - add `Show Errors` in right-click context menu for PDF documents that have mupdf warnings/errors
 - add `CmdToggleSmoothScroll` (`Toggle Smooth Scroll`) command to toggle `SmoothScroll` advanced setting
 - replace `HideScrollbars` and `UseOverlayScrollbar` settings with `Scrollbars` setting (values: `windows`, `smart`, `overlay`, `hidden`)

src/CommandPalette.cpp

@@ -119,6 +119,7 @@ static i32 gDocumentNotOpenWhitelist[] = {
     CmdDebugCorruptMemory,
     CmdScreenshot,
     CmdTabGroupRestore,
+    CmdSetScreenshotHotkey,
     0,
 };
 

src/Commands.cpp

@@ -234,6 +234,7 @@ static SeqStrings gCommandNames =
     "CmdPdShowInfo\0"
     "CmdDocumentExtractText\0"
     "CmdDocumentShowOutline\0"
+    "CmdSetScreenshotHotkey\0"
     "CmdNone\0"
     "\0";
 
@@ -458,6 +459,7 @@ static i32 gCommandIds[] = {
     CmdPdShowInfo,
     CmdDocumentExtractText,
     CmdDocumentShowOutline,
+    CmdSetScreenshotHotkey,
     CmdNone,
 };
 
@@ -682,6 +684,7 @@ SeqStrings gCommandDescriptions =
     "Show PDF Info\0"
     "Extract Text From Document\0"
     "Show Document Bookmarks\0"
+    "Set Screenshot Hotkey\0"
     "Do nothing\0"
     "\0";
 // clang-format on

src/Commands.h

@@ -229,7 +229,8 @@ enum {
     CmdPdShowInfo = 418,
     CmdDocumentExtractText = 419,
     CmdDocumentShowOutline = 420,
-    CmdNone = 421,
+    CmdSetScreenshotHotkey = 421,
+    CmdNone = 422,
 
     /* range for file history */
     CmdFileHistoryFirst,