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

Docs: LCL/grids. Updates TCustomGrid.KeyPress topic for changes in 4d4d4060. Issue #41503.

Browse Source 
(cherry picked from commit 0d3a623812)
This commit is contained in:
dsiders 2025-04-05 10:09:50 -04:00 committed by Maxim Ganetsky
parent 213e28c312
commit df6bafc20f
1 changed files with 33 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
docs/xml/lcl/grids.xml
View File

@ -14391,38 +14391,61 @@ EditorOptions for the control.
<element name="TCustomGrid.KeyUp.Shift" link="#lcl.controls.TWinControl.KeyUp.Shift"/> <element name="TCustomGrid.KeyUp.Shift" link="#lcl.controls.TWinControl.KeyUp.Shift"/>
<element name="TCustomGrid.KeyPress"> <element name="TCustomGrid.KeyPress">
<short>Applies the specified key press character to the control.</short> <short>
Applies the specified key press character to the control.
</short>
<descr> <descr>
<p> <p>
<var> KeyPress</var> is a method used to apply the character in Key to the <var>KeyPress</var> is a method used to apply the character in <var>Key</var>
grid control. KeyPress is overridden to ensure that a key which originated to the grid control. KeyPress is overridden to ensure that a key which
from the grid control is applied properly to the cell <var>Editor</var> (when originated from the grid control is applied properly to the cell
needed). It calls the inherited method on entry. <var>Editor</var> (when needed). It calls the inherited method on entry to
signal the <var>OnKeyPress</var> event handler (when assigned).
</p> </p>
<p> <p>
The following key press values in <var>Key</var> are handled in the method: KeyPress uses the value in <var>EditorKey</var> to determine if Key applies to
an active cell Editor on the control. If KeyDown did not flag the value for
the Editor control, the following values in Key are handled in the method:
</p> </p>
<dl> <dl>
<dt>Enter (#13)</dt> <dt>Enter (#13)</dt>
<dd> <dd>
Gets and displays the cell Editor when EditMode is <b>False</b> and the Gets and displays the cell Editor when EditMode is <b>False</b> and the
column allows editing. column allows editing. This includes signalling the OnSelectEditor event
handler (when assigned).
</dd> </dd>
<dt>Backspace (^H) and characters in the range #32..#255 (data)</dt> <dt>Backspace (^H), and characters in the range #32..#255 (data)</dt>
<dd> <dd>
Applies the key press to the Editor. Calls EditorShowChar to apply the key press to the Editor (when editing is
enabled).
</dd> </dd>
</dl> </dl>
<p> <p>
When Key is handled in the method, it is set to #0 prior to exit. When Key is handled in the method, it is set to #0 prior to exit.
</p> </p>
<remark>
The SendCharToEditor implementation in the Windows widgetset was modified
in LCL version 4.0. It changed the message delivery mechanism from
PostMessageW (asynchronous) to SendMessageW (synchronous) to avoid duplicate
or unintentional message delivery to the grid and/or cell editor controls.
</remark>
</descr> </descr>
<seealso> <seealso>
<link id="TCustomGrid.KeyDown"/>
<link id="TCustomGrid.EditorKey"/>
<link id="TCustomGrid.EditorShow"/>
<link id="TCustomGrid.EditorCanAcceptKey"/>
<link id="TCustomGrid.EditorIsReadOnly"/>
<link id="TCustomGrid.SelectEditor"/>
<link id="TCustomGrid.OnSelectEditor"/>
<link id="#lcl.controls.TWinControl.KeyPress">TWinControl.KeyPress</link> <link id="#lcl.controls.TWinControl.KeyPress">TWinControl.KeyPress</link>
<link id="#lcl.controls.TWinControl.OnKeyPress">TWinControl.OnKeyPress</link>
</seealso> </seealso>
</element> </element>
<element name="TCustomGrid.KeyPress.Key"> <element name="TCustomGrid.KeyPress.Key">
<short>Key press character examined in the method.</short> <short>
Key press character examined in the method.
</short>
</element> </element>
<element name="TCustomGrid.LoadContent"> <element name="TCustomGrid.LoadContent">