From 682e7eaffee40b1ac4e3e7170d8ec2af6e96210a Mon Sep 17 00:00:00 2001 From: dsiders Date: Sat, 15 Jun 2024 20:35:08 +0100 Subject: [PATCH] Docs: LCL/dbctrls. Modifies KeyDown topics in TDBEdit and TDBMemo for changes in f358fd7d17, dcacf7aaac. Issue #40985. * Adds a description of the macOS-specific keys detected and ignored for non-editable fields. (cherry picked from commit 700ad868db6728ae0209ceeab6182ad7e45c4b8c) --- docs/xml/lcl/dbctrls.xml | 87 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) diff --git a/docs/xml/lcl/dbctrls.xml b/docs/xml/lcl/dbctrls.xml index 61ec19abcc..e01af9d22c 100644 --- a/docs/xml/lcl/dbctrls.xml +++ b/docs/xml/lcl/dbctrls.xml @@ -1418,7 +1418,50 @@ Calls the UpdateRecord method in the internal TFieldDataLink instance when it is in an edit state. +

+For the macOS (Darwin) platform, additional virtual key codes are detected (and +discarded) if the contents of the field in the linked dataset cannot be +modified. These keys include: +

+
+
VK_0..VK_9
+
numeric characters not on the numeric keypad
+
VK_A..VK_Z
+
alphabetic characters
+
VK_NUMPAD0..VK_NUMPAD9
+
numeric digits on the numeric keypad
+
VK_MULTIPLY, VK_DIVIDE, VK_ADD, VK_SUBTRACT
+
operators on the numeric keypad
+
VK_SEPARATOR, VK_DECIMAL
+
padded and non-padded Decimal separators
+
VK_OEM_1
+
';:' keycap on the US standard keyboard
+
VK_OEM_2
+
'/?' keycap on the US standard keyboard
+
VK_OEM_3
+
'`~' keycap on the US standard keyboard
+
VK_OEM_4
+
'[{' keycap on the US standard keyboard
+
VK_OEM_5
+
'\|' keycap on the US standard keyboard
+
VK_OEM_6
+
']}' keycap on the US standard keyboard
+
VK_OEM_7
+
+''"' (Apostrophe and Quote) keycap on the US standard keyboard +
+
VK_OEM_8
+
miscellaneous character; varies by keyboard layout
+
+

+For these macOS-specific keys, the value in Key is set to 0 if the field cannot +be modified. +

+ +Modified in LCL version 3.6 to handle additional data keys on the macOS +(Darwin) platform. + @@ -6878,6 +6921,7 @@ other handlers implemented in the ancestor class. TCustomEdit.OnChange + Handles key down events in the data-aware control. @@ -6910,7 +6954,50 @@ internal TFieldDataLink is not editable, the value in Key is set VK_UNKNOWN. +

+For the macOS (Darwin) platform, additional virtual key codes are detected (and +discarded) if the contents of the field in the linked dataset cannot be +modified. These keys include: +

+
+
VK_0..VK_9
+
numeric characters not on the numeric keypad
+
VK_A..VK_Z
+
alphabetic characters
+
VK_NUMPAD0..VK_NUMPAD9
+
numeric digits on the numeric keypad
+
VK_MULTIPLY, VK_DIVIDE, VK_ADD, VK_SUBTRACT
+
operators on the numeric keypad
+
VK_SEPARATOR, VK_DECIMAL
+
padded and non-padded Decimal separators
+
VK_OEM_1
+
';:' keycap on the US standard keyboard
+
VK_OEM_2
+
'/?' keycap on the US standard keyboard
+
VK_OEM_3
+
'`~' keycap on the US standard keyboard
+
VK_OEM_4
+
'[{' keycap on the US standard keyboard
+
VK_OEM_5
+
'\|' keycap on the US standard keyboard
+
VK_OEM_6
+
']}' keycap on the US standard keyboard
+
VK_OEM_7
+
+''"' (Apostrophe and Quote) keycap on the US standard keyboard +
+
VK_OEM_8
+
miscellaneous character; varies by keyboard layout
+
+

+For these macOS-specific keys, the value in Key is set to 0 if the field cannot +be modified. +

 + +Modified in LCL version 3.6 to handle additional data keys on the macOS +(Darwin) platform. + TWinControl.KeyDown