diff --git a/docs/xml/lcl/buttons.xml b/docs/xml/lcl/buttons.xml index e928b8af53..365ec2eaa6 100644 --- a/docs/xml/lcl/buttons.xml +++ b/docs/xml/lcl/buttons.xml @@ -1288,13 +1288,31 @@ - ActionChange - Changes the action associated with the control. + Performs action when a new value is assigned to the Action property for the control. - + +

+ ActionChange is overridden in TCustomBitBtn to ensure that values from the new action instance in Sender are stored to properties in the control. ActionChange is the routine which implements the OnChange event handler for the ActionLink in the control. It is signalled (from TControl) when a new value is assigned to the Action property, or when the control is loaded using LCL component streaming. +

+

+ Sender is the new action instance for the event, or Nil when the value in Action has been removed (set to Nil). +

+

+ CheckDefaults indicates whether existing properties values in the control are used as default values. When set to False, the values from the action instance are applied to the control. Values from the action may be used (when assigned) if the properties in the control are unassigned - even when CheckDefaults is True. +

+

+ ActionChange calls the inherited method to update property values like Caption, Enabled, Hint, Visible, HelpContext and HelpKeyword. When Sender is a TCustomAction instance, the values in ImageIndex and Images are also updated with the values from the action (when assigned). +

+ - + New action instance for the event. + + + + True to use existing properties as default values, False to use properties from the new action. + @@ -1586,7 +1604,9 @@ - Indicates the policy for showing or hiding the glyph image of this button. + + Indicates the policy for showing or hiding the glyph image for the button. + TGlyphShowMode @@ -2100,7 +2120,7 @@ Calls MeasureDraw to gets the values for the variable parameters in PreferredWidth and PreferredHeight.

- Please note: The WithThemeSpace parameter is NOT used in the current implementation. + Please note that the WithThemeSpace parameter is NOT used in the current implementation. @@ -2349,7 +2369,7 @@ - True to use existing action properties as default values, False to use properties from the new action. + True to use existing properties as default values, False to use properties from the new action. @@ -2472,13 +2492,27 @@ - FindDownButton - returns the button that is down. + Gets the speed button with the same GroupIndex that has its Down property set. - - + +

+ FindDownButton locates a TCustomSpeedButton instance on the parent form which has the same GroupIndex and its Down property is set to True. FindDownButton visits each of the child controls on the parent form to find the speed buttons in the list of controls. +

+

+ The return value contains the TCustomSpeedButton instance located. The return value is Nil if another speed button does not exist, is not in the same group, or is not Down. +

+

+ No actions are performed in the method if the Down property in the current class instance is set, or when GroupIndex is 0 (zero). The return value is the current class instance in this circumstance. +

+ + + + + TControl.Parent + - + The speed button in the group which is down. @@ -2603,7 +2637,7 @@ - Indicates if the accelerator charactershould be shown (i.e. underlined character denoting key to be pressed for quick action). + Indicates if the accelerator character should be shown (i.e. underlined character denoting key to be pressed for quick action).