diff --git a/docs/xml/lcl/comctrls.xml b/docs/xml/lcl/comctrls.xml index 551a67250a..50a8783859 100644 --- a/docs/xml/lcl/comctrls.xml +++ b/docs/xml/lcl/comctrls.xml @@ -4194,6 +4194,70 @@ Ordinal position for the page object removed from the page list. + + +Updates the ActiveControl on the parent form when the specified page becomes +active. + + +

+ActivateFirstControlOnPage 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 APage. It sets the +ActiveControl property on the parent form to the first child control in APage +(when available). +

+

+No actions are performed in the method if any of the following conditions are +detected: +

+ +

+ActivateFirstControlOnPage 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 +OnChange event handler is signalled. +

+ + +Added in LCL version 4.0. + + + + + + + + + +GetParentForm +TCustomForm.ActiveControl +TWinControl.FindNextControl + + + + +Tab page with child controls examined in the method. + + + Signals the OnChanging event handler prior to updates to PageIndex.