diff --git a/components/lazcontrols/docs/laznumedit.xml b/components/lazcontrols/docs/laznumedit.xml index ffcc538d8e..cd576500dd 100644 --- a/components/lazcontrols/docs/laznumedit.xml +++ b/components/lazcontrols/docs/laznumedit.xml @@ -1214,45 +1214,59 @@ Character for the key press notification. - -Handles UTF-8-encoded key press events for the control. +Handles UTF-8 key press events for the control.

-Ensures that multi-byte UTF-8 characters are ignored for the control. +Utf8KeyPress is an overridden method in TLazIntegerEdit. It calls the +alternate handler routine in _Utf8KeyPress (implemented in TLazIntegerEditGen) +to examine, handle, or preprocess the UTF-8 character. The OnUTF8KeyPress +event handler is signalled (when assigned). The alternate handler ensures that +that multi-byte UTF-8 characters are ignored for the control; the value in +Utf8Char is set to an empty string ('') if it contains more than 1 byte value.

- + + +TWinControl.Utf8KeyPress +TWinControl.OnUtf8KeyPress +
-UTF-8 character for the key press notification. +UTF-8-encoded character for the key press notification. -Gets the text displayed in the control. +Gets the text displayed for the control.

-Gets the value for the Text property using the handle for the control, or by -converting Value to the required DisplayBase when a handle has not been -assigned. +RealGetText is an overridden TCaption function in TLazIntegerEdit used to get +the value for the control Caption. It calls the alternate handler routine +(_RealGetText) in TLazIntegerEditGen to get the return value. If the control +handle has been allocated, the inherited RealGetText method in ancestor +classes is called to get the return value. It the handle has not been +allocated, the Value property is converted to a string which includes the +optional prefix for the radix.

- + + TCustomEdit.Text +TControl.Caption
-Value for the Text property. +Value used for the Text property. @@ -1260,33 +1274,119 @@ Value for the Text property. Updates the value in Text when the window handle is created. - - + +

+InitializeWnd is an overridden method in TLazIntegerEdit. It calls the +alternate routine in the generic base class (_InitializeWnd) on entry. The +inherited method (in TCustomEdit) is called to initialize members in the +widget instance including its Handle and control flag values. +

+

+InitializeWnd ensures that the Text displayed for the control is updated to +reflect the Value property converted to the selected DisplayBase with the +corresponding prefix. +

+
+ + +TCustomEdit.InitializeWnd + -Updates Value prior to freeing the window handle. +Updates the Value for the control prior to freeing the window handle for the +control. - - + +

+FinalizeWnd is an overridden method in TLazIntegerEdit. It ensures that the +control Value is updated using the Text for the control after conversion back +to a Decimal (base-10) value. This action is performed prior to calling the +inherited FinalizeWnd method (in TWinControl) to update the control Caption +and free its Handle. +

+
+ + + + +TWinControl.FinalizeWnd +TControl.Caption +
-Updates Value with the contents of Text when the control loses input focus. +Updates Value with the contents in Text when the control loses input focus. - - + +

+DoExit is an overridden method in TLazIntegerEdit. It ensures that the Value +for the control is updated when the control loses input focus. DoExit calls +the alternate handler (_DoExit) in TLazIntegerEditGen to perform the actions +needed. +

+

+The Value property is updated by converting the Text for control back to its +Decimal (base-10) representation. Values in MinValue and MaxValue are enforced +when Value is updated. +

+

+DoExit calls the inherited method (in TCustomEdit) to reset the AutoSelected +property, and to signal the OnExit event handler (when assigned). +

+

+DoExit is called when the CM_EXIT control message is handled for the control. +

+
+ + + + + + + +TCustomEdit.DoExit +TWinControl.DoExit +TWinControl.OnExit +
-Updates Value with the contents of Text when editing has been completed for the -control. +Updates the control Value when editing has been completed for the control. - - + +

+EditingDone is an overridden method in TLazIntegerEdit. It ensures that the +Value property is updated when editing has been completed for the control. The +alternate handler routine (_EditingDone) in the generic base class +(TLazIntegerEditGen) is called to perform the actions needed. +

+

+Value is updated by converting the control Text back to its Decimal (base-10) +representation. Values in the MinValue and MaxValue properties are enforced +when Value is updated. +

+

+EditingDone in an ancestor class (TControl) is called when the ReadOnly +property is set to False, and the OnEditingDone event handler is +signalled (when assigned). +

+

+Editing is called when the VK_RETURN key is handled for the control. +

+
+ + + + + + +TControl.EditingDone +TControl.OnEditingDone +
- @@ -1428,83 +1522,121 @@ _KeyPress handler for the control. - - - - - - - - - - - - - - - - - + + + + + + + - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + +