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> <p>
<var>MaybeSelectFirstControlOnPage</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 the active
enabled child control on the page specified in <var>APage</var>. It sets the control on the parent form is not the tabbed control or one of its child
ActiveControl property on the parent form to the first child control in APage controls.
(when available). </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>
<p> <p>
No actions are performed in the method if any of the following conditions are 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> </li>
</ul> </ul>
<p> <p>
MaybeSelectFirstControlOnPage is called from the Change method, and when a new MaybeSelectFirstControlOnPage is called from the Change method, and occurs
value is assigned to the TabIndex property. It occurs after the current Page on when a new value is assigned to the TabIndex property. It occurs after the
the tab control has been made visible and given focus. It is called before the current Page on the tab control has been made visible and given focus. It is
OnChange event handler is signalled. called before the OnChange event handler is signalled.
</p> </p>
</descr> </descr>
<errors>
Raises an EAssertionFailed exception if a value has not been assigned to the
APage argument.
</errors>
<version> <version>
Added in LCL version 4.0. Added in LCL version 4.0.
</version> </version>