Docs: LCL/comctrls. Updates TCustomTabControl topics for changes in 5e54b2f9, 148735d8.

* TCustomTabControl.MaybeSelectFirstControlOnPage
* TCustomTabControl.Change
This commit is contained in:
dsiders 2024-05-21 05:47:08 +01:00
parent 1836844e6e
commit 6f7146a46e

View File

@ -3645,10 +3645,10 @@ pages in the tabbed control.
</p>
<p>
Change calls ShowCurrentPage to display the page in PageIndex, and hide the
previously visible page in the tabbed control. ActivateFirstControlOnPage is
called to select the focused control for the ActivePage or parent form. Change
calls DoChange when the control is not being destroyed, or loaded in the LCL
component streaming mechanism.
previously visible page in the tabbed control. MaybeSelectFirstControlOnPage is
called to select the focused control for the ActivePage. Change calls DoChange
when the control is not being destroyed, or loaded in the LCL component
streaming mechanism.
</p>
<p>
Change is called from the MoveTab method, and when selection change messages
@ -3656,14 +3656,14 @@ are handled for the control.
</p>
</descr>
<version>
Modified in LCL version 3.4 to call ActivateFirstControlOnPage before OnChange
is signalled for the active page.
Modified in LCL version 3.4 to call MaybeSelectFirstControlOnPage before
OnChange is signalled for the active page.
</version>
<seealso>
<link id="TCustomTabControl.ActivePage"/>
<link id="TCustomTabControl.ActivateFirstControlOnPage"/>
<link id="TCustomTabControl.PageIndex"/>
<link id="TCustomTabControl.TabIndex"/>
<link id="TCustomTabControl.MaybeSelectFirstControlOnPage"/>
<link id="TCustomTabControl.DoChange"/>
<link id="TCustomTabControl.OnChange"/>
</seealso>
@ -3703,14 +3703,14 @@ method is called to handle the values in <var>Key</var> and <var>Shift</var>.
<short>Key modifier(s) used in the method.</short>
</element>
<element name="TCustomTabControl.ActivateFirstControlOnPage">
<element name="TCustomTabControl.MaybeSelectFirstControlOnPage">
<short>
Updates the ActiveControl on the parent form when the specified page becomes
active.
</short>
<descr>
<p>
<var>ActivateFirstControlOnPage</var> is a method used to ensure that the
<var>MaybeSelectFirstControlOnPage</var> is a method used to ensure that the
active control on a form is properly updated when the page on the tab control
is changed. It prevents the tabbed control from stealing focus if there is an
enabled child control on the page specified in <var>APage</var>. It sets the
@ -3739,9 +3739,9 @@ APage does not have any child controls.
</li>
</ul>
<p>
ActivateFirstControlOnPage is called from the Change method, and when a new
MaybeSelectFirstControlOnPage is called from the Change method, and when a new
value is assigned to the TabIndex property. It occurs after the current Page on
the tab control has been made visible and given focus. It occurs before the
the tab control has been made visible and given focus. It is called before the
OnChange event handler is signalled.
</p>
</descr>