Docs: LCL/comctrls. Updates TCustomTabControl topics for changes in db41ce26.

* TCustomTabControl.Change
* TCustomTabControl.InternalSetPageIndex
* TCustomTabControl.MaybeSelectFirstControlOnPage
This commit is contained in:
dsiders 2024-03-11 20:15:43 +01:00
parent d42ddb59f8
commit c8dcda511d

View File

@ -4203,10 +4203,14 @@ active.
<p>
<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
ActiveControl property on the parent form to the first child control in APage
(when available).
is changed. It prevents the tabbed control from stealing focus if the active
control on the parent form is not the tabbed control or one of its child
controls.
</p>
<p>
<var>APage</var> is used to find the next control in the tab order for the
page. If a control is found, it is assigned as the ActiveControl on the parent
form.
</p>
<p>
No actions are performed in the method if any of the following conditions are
@ -4230,12 +4234,16 @@ APage does not have any child controls.
</li>
</ul>
<p>
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 is called before the
OnChange event handler is signalled.
MaybeSelectFirstControlOnPage is called from the Change method, and occurs
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 is
called before the OnChange event handler is signalled.
</p>
</descr>
<errors>
Raises an EAssertionFailed exception if a value has not been assigned to the
APage argument.
</errors>
<version>
Added in LCL version 4.0.
</version>