paweld/lazarus
1
0
Fork 0
mirror of https://gitlab.com/freepascal.org/lazarus/lazarus.git synced 2025-08-24 13:39:08 +02:00
Code Issues Packages Projects Releases Wiki Activity

Docs: LCL/dbctrls. Modifies KeyDown topics in TDBEdit and TDBMemo for changes in f358fd7d17, dcacf7aaac. Issue #40985.

Browse Source 
* Adds a description of the macOS-specific keys detected and ignored for non-editable fields.
This commit is contained in:
dsiders 2024-06-15 20:35:08 +01:00
parent 1b18f09376
commit 700ad868db
1 changed files with 87 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

87
docs/xml/lcl/dbctrls.xml
View File

@ -1418,7 +1418,50 @@ Calls the <var>UpdateRecord</var> method in the internal
<var>TFieldDataLink</var> instance when it is in an edit state. <var>TFieldDataLink</var> instance when it is in an edit state.
</dd> </dd>
</dl> </dl>
<p>
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:
</p>
<dl>
<dt>VK_0..VK_9</dt>
<dd>numeric characters not on the numeric keypad</dd>
<dt>VK_A..VK_Z</dt>
<dd>alphabetic characters</dd>
<dt>VK_NUMPAD0..VK_NUMPAD9</dt>
<dd>numeric digits on the numeric keypad</dd>
<dt>VK_MULTIPLY, VK_DIVIDE, VK_ADD, VK_SUBTRACT</dt>
<dd>operators on the numeric keypad</dd>
<dt>VK_SEPARATOR, VK_DECIMAL </dt>
<dd>padded and non-padded Decimal separators</dd>
<dt>VK_OEM_1</dt>
<dd>';:' keycap on the US standard keyboard</dd>
<dt>VK_OEM_2</dt>
<dd>'/?' keycap on the US standard keyboard</dd>
<dt>VK_OEM_3</dt>
<dd>'`~' keycap on the US standard keyboard</dd>
<dt>VK_OEM_4</dt>
<dd>'[{' keycap on the US standard keyboard</dd>
<dt>VK_OEM_5</dt>
<dd>'\|' keycap on the US standard keyboard</dd>
<dt>VK_OEM_6</dt>
<dd>']}' keycap on the US standard keyboard</dd>
<dt>VK_OEM_7</dt>
<dd>
'&apos;&quot;' (Apostrophe and Quote) keycap on the US standard keyboard
</dd>
<dt>VK_OEM_8</dt>
<dd>miscellaneous character; varies by keyboard layout</dd>
</dl>
<p>
For these macOS-specific keys, the value in Key is set to 0 if the field cannot
be modified.
</p>
</descr> </descr>
<version>
Modified in LCL version 3.6 to handle additional data keys on the macOS
(Darwin) platform.
</version>
<seealso> <seealso>
<link id="TFieldDataLink.Reset"/> <link id="TFieldDataLink.Reset"/>
<link id="TFieldDataLink.Editing"/> <link id="TFieldDataLink.Editing"/>
@ -6878,6 +6921,7 @@ other handlers implemented in the ancestor class.
<link id="#lcl.stdctrls.TCustomEdit.OnChange">TCustomEdit.OnChange</link> <link id="#lcl.stdctrls.TCustomEdit.OnChange">TCustomEdit.OnChange</link>
</seealso> </seealso>
</element> </element>
<element name="TDBMemo.KeyDown"> <element name="TDBMemo.KeyDown">
<short>Handles key down events in the data-aware control.</short> <short>Handles key down events in the data-aware control.</short>
<descr> <descr>
@ -6910,7 +6954,50 @@ internal <var>TFieldDataLink</var> is not editable, the value in Key is set
<b>VK_UNKNOWN</b>. <b>VK_UNKNOWN</b>.
</dd> </dd>
</dl> </dl>
<p>
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:
</p>
<dl>
<dt>VK_0..VK_9</dt>
<dd>numeric characters not on the numeric keypad</dd>
<dt>VK_A..VK_Z</dt>
<dd>alphabetic characters</dd>
<dt>VK_NUMPAD0..VK_NUMPAD9</dt>
<dd>numeric digits on the numeric keypad</dd>
<dt>VK_MULTIPLY, VK_DIVIDE, VK_ADD, VK_SUBTRACT</dt>
<dd>operators on the numeric keypad</dd>
<dt>VK_SEPARATOR, VK_DECIMAL </dt>
<dd>padded and non-padded Decimal separators</dd>
<dt>VK_OEM_1</dt>
<dd>';:' keycap on the US standard keyboard</dd>
<dt>VK_OEM_2</dt>
<dd>'/?' keycap on the US standard keyboard</dd>
<dt>VK_OEM_3</dt>
<dd>'`~' keycap on the US standard keyboard</dd>
<dt>VK_OEM_4</dt>
<dd>'[{' keycap on the US standard keyboard</dd>
<dt>VK_OEM_5</dt>
<dd>'\|' keycap on the US standard keyboard</dd>
<dt>VK_OEM_6</dt>
<dd>']}' keycap on the US standard keyboard</dd>
<dt>VK_OEM_7</dt>
<dd>
'&apos;&quot;' (Apostrophe and Quote) keycap on the US standard keyboard
</dd>
<dt>VK_OEM_8</dt>
<dd>miscellaneous character; varies by keyboard layout</dd>
</dl>
<p>
For these macOS-specific keys, the value in Key is set to 0 if the field cannot
be modified.
</p>
</descr> </descr>
<version>
Modified in LCL version 3.6 to handle additional data keys on the macOS
(Darwin) platform.
</version>
<seealso> <seealso>
<link id="#lcl.controls.TWinControl.KeyDown">TWinControl.KeyDown</link> <link id="#lcl.controls.TWinControl.KeyDown">TWinControl.KeyDown</link>
</seealso> </seealso>