From a2bf3c8d58195f7b9a82090c9d54bd47d382276f Mon Sep 17 00:00:00 2001
From: dsiders
Date: Wed, 20 Nov 2024 20:35:54 +0000
Subject: [PATCH] Docs: LCL/controls. Updates TWinControl.OnKeyDown topic to
document global shortcut keys.
* Related to discussions in Issue #40436.
---
docs/xml/lcl/controls.xml | 29 +++++++++++++++++++++++++++++
1 file changed, 29 insertions(+)
diff --git a/docs/xml/lcl/controls.xml b/docs/xml/lcl/controls.xml
index 1207e01ee3..4d43a72489 100644
--- a/docs/xml/lcl/controls.xml
+++ b/docs/xml/lcl/controls.xml
@@ -25133,6 +25133,35 @@ Use OnKeyUp to perform actions needed when the key is released.
Use OnKeyPress or OnUTF8KeyPress to implement a handler routine for printable
character values.
+
+Some key combinations are used as global shortcut keys for a given widgetset
+(QT, GTK, Cocoa), window manager (KDE, Gnome, Windows), or display protocol
+(X11, Wayland, WinAPI). These global shortcuts are platform-specific and
+generally perform system navigation or window management. They may be handled
+by the desktop / window manager and not forwarded to an application, form, or
+control. Some common examples include: Ctrl+F4, Alt+F4, Ctrl+Command+Q, and
+others. For more details, please refer to the developer documentation for the
+platform (widgetset) or desktop window manager.
+
+