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>
<p> <p>
Change calls ShowCurrentPage to display the page in PageIndex, and hide the Change calls ShowCurrentPage to display the page in PageIndex, and hide the
previously visible page in the tabbed control. ActivateFirstControlOnPage is previously visible page in the tabbed control. MaybeSelectFirstControlOnPage is
called to select the focused control for the ActivePage or parent form. Change called to select the focused control for the ActivePage. Change calls DoChange
calls DoChange when the control is not being destroyed, or loaded in the LCL when the control is not being destroyed, or loaded in the LCL component
component streaming mechanism. streaming mechanism.
</p> </p>
<p> <p>
Change is called from the MoveTab method, and when selection change messages Change is called from the MoveTab method, and when selection change messages
@ -3656,14 +3656,14 @@ are handled for the control.
</p> </p>
</descr> </descr>
<version> <version>
Modified in LCL version 3.4 to call ActivateFirstControlOnPage before OnChange Modified in LCL version 3.4 to call MaybeSelectFirstControlOnPage before
is signalled for the active page. OnChange is signalled for the active page.
</version> </version>
<seealso> <seealso>
<link id="TCustomTabControl.ActivePage"/> <link id="TCustomTabControl.ActivePage"/>
<link id="TCustomTabControl.ActivateFirstControlOnPage"/>
<link id="TCustomTabControl.PageIndex"/> <link id="TCustomTabControl.PageIndex"/>
<link id="TCustomTabControl.TabIndex"/> <link id="TCustomTabControl.TabIndex"/>
<link id="TCustomTabControl.MaybeSelectFirstControlOnPage"/>
<link id="TCustomTabControl.DoChange"/> <link id="TCustomTabControl.DoChange"/>
<link id="TCustomTabControl.OnChange"/> <link id="TCustomTabControl.OnChange"/>
</seealso> </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> <short>Key modifier(s) used in the method.</short>
</element> </element>
<element name="TCustomTabControl.ActivateFirstControlOnPage"> <element name="TCustomTabControl.MaybeSelectFirstControlOnPage">
<short> <short>
Updates the ActiveControl on the parent form when the specified page becomes Updates the ActiveControl on the parent form when the specified page becomes
active. active.
</short> </short>
<descr> <descr>
<p> <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 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 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 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> </li>
</ul> </ul>
<p> <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 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. OnChange event handler is signalled.
</p> </p>
</descr> </descr>