diff --git a/components/lazcontrols/docs/checkboxthemed.xml b/components/lazcontrols/docs/checkboxthemed.xml index 5f6eba07e4..4415fb254e 100644 --- a/components/lazcontrols/docs/checkboxthemed.xml +++ b/components/lazcontrols/docs/checkboxthemed.xml @@ -296,7 +296,7 @@

- DoEnter is an overridden method in TCustomCheckBoxThemed. It calls the inherited method on entry to signal the OnEnter event handler (when assigned). It calls Invalidate to force the control to be redrawn. + DoEnter is an overridden method in TCustomCheckBoxThemed. It calls the inherited method on entry to signal the OnEnter event handler (when assigned). It calls Invalidate to cause the control to be redrawn.

diff --git a/docs/xml/lcl/comboex.xml b/docs/xml/lcl/comboex.xml index d47fcde577..07d59119b5 100644 --- a/docs/xml/lcl/comboex.xml +++ b/docs/xml/lcl/comboex.xml @@ -908,7 +908,9 @@ Updates the collection when the specified item has been changed. - Forces the owner of the collection (the control) to be redrawn when needed. +

+ Causes the owner of the collection (the control) to be redrawn when needed. +

diff --git a/docs/xml/lcl/comctrls.xml b/docs/xml/lcl/comctrls.xml index 4d2ec09ba1..6d5eb88b8d 100644 --- a/docs/xml/lcl/comctrls.xml +++ b/docs/xml/lcl/comctrls.xml @@ -13034,7 +13034,7 @@ end; AlphaSort updates values in the SortDirection, SortType, and SortColumn properties. Flag values for the control are updated to include lffPreparingSorting prior to setting the property values; this suppresses reordering until the changes are completed.

- SortDirection is toggled to force a new sort order to be applied. The final value is sdAscending. + SortDirection is toggled to s a new sort order to be applied. The final value is sdAscending.

SortType is set to stText to use the TListItem.Caption values to determine the order for the list items. In the default comparison routine. case is significant. Use OnCompare to implement an alternate comparison routine. @@ -16062,7 +16062,7 @@ end; TextChanged is an overridden method in TToolButton used to perform actions needed when the caption text for the tool button has been changed. No actions are performed in the method if the parent tool bar has not been assigned for the tool button.

- When ShowCaptions is enabled, the Invalidate method is called to force the tool button to be redrawn. + When ShowCaptions is enabled, the Invalidate method is called to cause the tool button to be redrawn.

TextChanged is called when the CM_TEXTCHANGED control message is handled for the control. @@ -17292,7 +17292,7 @@ end; Repositions the tool button at the specified position in Buttons.

- Forces the entire tool bar to be redrawn. Not used in the current implementation. + Causes the entire tool bar to be redrawn. Not used in the current implementation.

@@ -17307,7 +17307,7 @@ end;

- Forces the entire tool bar to be redrawn. Not used in the current implementation. + Causes the entire tool bar to be redrawn. Not used in the current implementation.

@@ -19467,7 +19467,7 @@ AToolbar.ButtonHeight := 30; Ends an update process for the control.

- EndUpdate is an overridden method in TCustomCoolBar. It calls the inherited method to decrement the internal update counter for the control. When the update counter reaches 0, the CalculateAndAlign method is called to size and layout the visible bands on the control. Temporarily disables auto-sizing while the control recalculates and aligns its bands. Calls Invalidate to force the control to be redrawn. + EndUpdate is an overridden method in TCustomCoolBar. It calls the inherited method to decrement the internal update counter for the control. When the update counter reaches 0, the CalculateAndAlign method is called to size and layout the visible bands on the control. Temporarily disables auto-sizing while the control recalculates and aligns its bands. Calls Invalidate to cause the control to be redrawn.

@@ -19479,7 +19479,7 @@ AToolbar.ButtonHeight := 30; Causes the control to be redrawn.

- Invalidate is an overridden method in TCustomCoolBar which forces the control to be redrawn using the settings in the EdgeInner, EdgeOuter, and EdgeBorders properties. CalculateAndAlign is called to size and layout the visible bands on the control. The inherited Invalidate method is called to update the widgetset class when its Handle has been allocated. + Invalidate is an overridden method in TCustomCoolBar which causes the control to be redrawn using the settings in the EdgeInner, EdgeOuter, and EdgeBorders properties. CalculateAndAlign is called to size and layout the visible bands on the control. The inherited Invalidate method is called to update the widgetset class when its Handle has been allocated.

@@ -22423,7 +22423,7 @@ AToolbar.ButtonHeight := 30; Focused is a Boolean property which indicates if the node has focus in the associated TreeView control. The value for the property is True when nsFocused has been included in the States property.

- Setting a new value for the property causes the values in States to be updated. When set to True, nsFocused is included in States. When set to False, nsFocused is excluded from States. The Update method is called to force the TreeView control to be redrawn. + Setting a new value for the property causes the values in States to be updated. When set to True, nsFocused is included in States. When set to False, nsFocused is excluded from States. The Update method is called to redraw the TreeView control.

@@ -22474,7 +22474,7 @@ AToolbar.ButtonHeight := 30; Height uses a default value if it contains 0 (zero) or a negative integer value. If an associated TreeView control has been assigned, the value in its DefaultItemHeight property is used as the property value. If TreeView in unassigned, the value in the DefaultTreeNodeHeight constant is used.

- Setting a new value for the property causes the States property in the associated TreeView control to be updated (when assigned). The values tvsScrollbarChanged and tvsTopsNeedsUpdate are included in the control States. The Update method is called to force the TreeView to be redrawn. The Changed method is called with the ncHeightChanged node change reason. + Setting a new value for the property causes the States property in the associated TreeView control to be updated (when assigned). The values tvsScrollbarChanged and tvsTopsNeedsUpdate are included in the control States. The Update method is called to redraw the TreeView. The Changed method is called with the ncHeightChanged node change reason.

Height is used along with Top to calculate the return value for the Bottom method. It is also used in the implementation of methods like DisplayRect and DisplayExpandSignRect. @@ -22647,7 +22647,7 @@ AToolbar.ButtonHeight := 30; Setting a new value for the property causes the values in States to be updated. Similarly, the TreeView control is updated to used the node in the Selected or Selections property.

- The Update method is called to force the TreeView control to be redrawn. + The Update method is called to redraw the TreeView control.

@@ -22811,7 +22811,7 @@ AToolbar.ButtonHeight := 30; Setting a new value for the property causes the States property to be updated. Selected is set to False when the value in Visible is changed.

- Values are included in the States property for the associated TreeView control (when assigned) to indicate that the size and layout for the tree nodes in the control have been changed. The Update method is called to force the control to be refreshed. The Changed method is called with the ncVisibility node change reason. + Values are included in the States property for the associated TreeView control (when assigned) to indicate that the size and layout for the tree nodes in the control have been changed. The Update method is called to refresh the control. The Changed method is called with the ncVisibility node change reason.

@@ -25484,7 +25484,7 @@ AToolbar.ButtonHeight := 30; The OnEdited event handler is signalled (when assigned) to validate or modify the new text value, and the text is stored in Node.

- EndEditing calls the Invalidate method to force the control to be redrawn. + EndEditing calls the Invalidate method to redraw the control.

@@ -25913,7 +25913,7 @@ AToolbar.ButtonHeight := 30; GetImageSize is called to get the height needed for Images or StateImages used in the control. Values in ImageSize and StateImageSize are updated with the scaled image heights including default spacing. The calculated value is enlarged for the Image sizes if needed.

- UpdateDefaultItemHeight updates the States property to include values that indicate the item height for nodes has changed. The Invalidate method is called to force the control to be redrawn. + UpdateDefaultItemHeight updates the States property to include values that indicate the item height for nodes has changed. The Invalidate method is called to redraw the control.

UpdateDefaultItemHeight is called from methods like: InitializeWnd, Loaded, SetOptions, and DoPaint. @@ -26025,7 +26025,7 @@ AToolbar.ButtonHeight := 30; Handles the LM_SETFOCUS message for the control.

- Calls the Invalidate method to force the control to be redrawn. Calls the inherited method prior to exit. + Calls the Invalidate method to redraw the control. Calls the inherited method prior to exit.

diff --git a/docs/xml/lcl/controls.xml b/docs/xml/lcl/controls.xml index 49983b60c9..a1d605f026 100644 --- a/docs/xml/lcl/controls.xml +++ b/docs/xml/lcl/controls.xml @@ -11739,11 +11739,11 @@ - Force a delayed Repaint of the control, by marking its visible area of the control as invalid. + Causes a delayed Repaint of the control by marking its visible area of the control as invalid.

- Calls the InvalidateControl method to invalidate the bounds rectangle for the control using the clipping rectangle for the Parent. + Calls the InvalidateControl method to invalidate the bounds rectangle for the control using the clipping rectangle for the Parent. The control is redrawn when there are no pending messages in the message queue.

@@ -18578,6 +18578,9 @@ if MyControl.CanSetFocus then

Invalidate is an overridden method in TWinControl. It re-implements the inherited method to call the Invalidate method in the widgetset class instance when its Handle has been allocated. It does not call the inherited method.

+

+ The control is redrawn when there are no pending window messages in the message queue. +

diff --git a/docs/xml/lcl/dbgrids.xml b/docs/xml/lcl/dbgrids.xml index 43d5c7cd55..b7500a9200 100644 --- a/docs/xml/lcl/dbgrids.xml +++ b/docs/xml/lcl/dbgrids.xml @@ -920,7 +920,7 @@ Clear is a procedure used to remove all of the Items stored in the list. Clear calls the TDataset.FreeBookmark method for each of the TBookmark instances in Items. The length of the Bookmark is set to 0 to decrease the reference count for the memory allocation.

- Clear uses the Invalidate method in the associated Grid control to force it to be redrawn. + Clear uses the Invalidate method in the associated Grid control and causes it to be redrawn.

@@ -2208,7 +2208,7 @@

- Update causes the TDBGrid control which owns the column collection to be redrawn. The value in Grid must be assigned, or no actions are performed in the method. In addition, the Grid control will not be updated if component streaming is active (csLoading in its ComponentState). Update calls TDBGrid.LayoutChanged to force the Grid control to be redrawn. + Update causes the TDBGrid control which owns the column collection to be redrawn. The value in Grid must be assigned, or no actions are performed in the method. In addition, the Grid control will not be updated if component streaming is active (csLoading in its ComponentState). Update calls TDBGrid.LayoutChanged to cause the Grid control to be redrawn.

@@ -3466,7 +3466,7 @@

- InvalidateSizes is a procedure used to force the grid to recalculate column sizes and to repaint its display area. InvalidateSizes updates the GridFlags for the control to include the value gfVisualChange. + InvalidateSizes is a procedure which causes the grid to recalculate column sizes and to repaint its display area. InvalidateSizes updates the GridFlags for the control to include the value gfVisualChange.

@@ -5270,7 +5270,7 @@

- UpdateActive forces the control to be redrawn when the active row in the linked dataset is changed. UpdateActive requires an active dataset in DataLink with a selected record. No actions are performed in the method when the dataset is closed or contains no rows. UpdateActive calls InvalidateCell when the selected row in the control has changed. InvaidateRow is called to update the selected row in the control. + UpdateActive causes the control to be redrawn when the active row in the linked dataset is changed. UpdateActive requires an active dataset in DataLink with a selected record. No actions are performed in the method when the dataset is closed or contains no rows. UpdateActive calls InvalidateCell when the selected row in the control has changed. InvaidateRow is called to update the selected row in the control.

diff --git a/docs/xml/lcl/grids.xml b/docs/xml/lcl/grids.xml index 95811ad117..4c4094e4c6 100644 --- a/docs/xml/lcl/grids.xml +++ b/docs/xml/lcl/grids.xml @@ -6749,7 +6749,7 @@ OnTitleFontChanged is a procedure which implements the event handler signalled when the TitleFont for fixed cells has been changed. OnTitleFontChanged is assigned to the OnChange event handler in TitleFont in the constructor for the class instance.

- OnTitleFontChanged sets the value in TitleFontIsDefault to False to reflect the change in the font setting. When Columns have been enabled (VisibleCount contains a non-zero value), the TitleFontChanged method in Columns is called. The ColumnsChanged method is called to force the grid to be updated. If Columns have not been enabled, the VisualChange method is called to update the grid control. + OnTitleFontChanged sets the value in TitleFontIsDefault to False to reflect the change in the font setting. When Columns have been enabled (VisibleCount contains a non-zero value), the TitleFontChanged method in Columns is called. The ColumnsChanged method is called and causes the grid to be updated. If Columns have not been enabled, the VisualChange method is called to update the grid control.

@@ -8165,7 +8165,7 @@

- ColWidthsChanged has an empty implementation in TCustomGrid. It is not currently used in any descendent classes in the LCL. It can be overridden in custom controls to perform any actions needed when one or more of the column widths has been changed. One common use is to invalidate the grid control to force it to be redrawn. + ColWidthsChanged has an empty implementation in TCustomGrid. It is not currently used in any descendent classes in the LCL. It can be overridden in custom controls to perform any actions needed when one or more of the column widths has been changed. One common use is to invalidate the grid control and cause it to be redrawn.

ColWidthsChanged is called when a new value is specified for the indexed ColWidths property and Columns have been enabled for the control. @@ -8591,7 +8591,7 @@ DoEnter is an overridden method in TCustomGrid. The inherited DoEnter method is called on entry to signal the OnEnter event handler (when assigned).

- It ensures that the active selection and optional editor control are restored when grid control receives focus. If the Editor is not locked for update, and is always visible, the Editor class is re-selected and it is displayed in the active cell. When the Editor is not always visible (goAlwaysShowEditor is not in Options), InvalidateFocused is called to force the active cell or row selection to be redrawn. + It ensures that the active selection and optional editor control are restored when grid control receives focus. If the Editor is not locked for update, and is always visible, the Editor class is re-selected and it is displayed in the active cell. When the Editor is not always visible (goAlwaysShowEditor is not in Options), InvalidateFocused is called to request the active cell or row selection to be redrawn.

DoEnter is called from the CMEnter method when it handles the corresponding control message. @@ -9970,7 +9970,7 @@ FontChanged is an overridden method used to perform actions needed when the Font for the control has been changed.

- FontChanged ensures that the internal default heights for rows and columns are reset to 0 (zero). This forces the default column and row heights to be recalculated when the DoAutoAdjustLayout method is called. + FontChanged ensures that the internal default heights for rows and columns are reset to 0 (zero). This causes the default column and row heights to be recalculated when the DoAutoAdjustLayout method is called.

When csCustomPaint is included in ControlState, the Font is assigned to the Canvas for the control. @@ -12821,7 +12821,7 @@ Updates the grid after changes to the visual properties in the control.

- VisualChange is a procedure used to update the grid when visual aspects of the control have been changed. VisualChange calls UpdateSizes to refresh the size of cells in the grid, and calls Invalidate to force the control to be redrawn. + VisualChange is a procedure used to update the grid when visual aspects of the control have been changed. VisualChange calls UpdateSizes to refresh the size of cells in the grid, and calls Invalidate to cause the control to be redrawn.

No actions are performed in the method when BeginUpdate has already been called to buffer updates to the grid. VisualChange will resume updates when EndUpdate has been called to disable update buffering. @@ -13725,7 +13725,7 @@ Flat is a Boolean property which indicates if the cells on the control are drawn using a "flat" drawing style. This causes the cells, including fixed headers, to have a thinner single-line border without any 3D relief regardless of the setting in TitleStyle.

- The default value for the property is False. Changing the value in Flat causes the UpdateBorderStyle method to be called when BorderStyle is set to bsSingle. Invalidate is called to force the control to be redrawn. + The default value for the property is False. Changing the value in Flat causes the UpdateBorderStyle method to be called when BorderStyle is set to bsSingle. Invalidate is called and causes the control to be redrawn.

Flat is used in the DrawBorder method to determine the border drawing style and Canvas settings needed for the control. @@ -15395,7 +15395,7 @@

- Calls the InvalidateRect routine to force the cells to be re-drawn. No actions are performed in the method if a Handle has not been allocated for the control. + Calls the InvalidateRect routine which causes the cells to be re-drawn. No actions are performed in the method if a Handle has not been allocated for the control.

@@ -16692,7 +16692,7 @@ Sets the value for the Color property.

- Calls Invalidate to force the grid control to be redrawn. + Calls Invalidate to request the grid control to be redrawn.

@@ -16710,7 +16710,7 @@ SetCheckboxState is a method used to set the checked, unchecked, or grayed state for a check box in the cell specified by ACol and ARow. AState contains the state value applied to the cell.

- SetCheckboxState signals the OnSetCheckboxState event handler (when assigned) to perform the actions needed to change the value in the cell. If DefaultDrawing is enabled for the control, the InvalidateCell method is called to force the cell to be redrawn. + SetCheckboxState signals the OnSetCheckboxState event handler (when assigned) to perform the actions needed to change the value in the cell. If DefaultDrawing is enabled for the control, the InvalidateCell method is called and causes the cell to be redrawn.

No actions are performed in the method when OnSetCheckboxState has not been assigned. diff --git a/docs/xml/lcl/stdctrls.xml b/docs/xml/lcl/stdctrls.xml index bbaffebf4f..bdd756724d 100644 --- a/docs/xml/lcl/stdctrls.xml +++ b/docs/xml/lcl/stdctrls.xml @@ -5555,7 +5555,9 @@ - Enforces the setting in the ReadOnly property when editing is finished in the control. + + Enforces the setting in the ReadOnly property when editing is finished in the control. +

EditingDone is an overridden method in TCustomEdit. It ensures that the inherited method is NOT called when the value in ReadOnly is True. EditingDone is called from the KeyUpAfterInterface method when the VK_RETURN key code is handled. @@ -8378,7 +8380,7 @@ end; TextChanged is an overridden method used to performs actions needed when the CM_TEXTCHANGED message is handled in the control.

- TextChanged calls InvalidatePreferredSize to force the preferred height and width for the control to be recalculated. When Parent has been assigned and its AutoSize property is set to True, the AdjustSize method in Parent is called. The AdjustSize method for the control is called to resize the control or update control flags when delayed auto-sizing is in use. + TextChanged calls InvalidatePreferredSize and causes the preferred height and width for the control to be recalculated. When Parent has been assigned and its AutoSize property is set to True, the AdjustSize method in Parent is called. The AdjustSize method for the control is called to resize the control or update control flags when delayed auto-sizing is in use.

TextChanged calls the inherited method prior to exit. @@ -9840,19 +9842,24 @@ end; Message examined in the method. - + Performs actions when the CM_TEXTCHANGED message is handled for the control.

- TextChanged is an overridden method used to perform actions needed when the CM_TEXTCHANGED message is handled for the control. TextChanged calls Invalidate to force the control to be redrawn. UpdateSize is called to perform auto-sizing, and recalculate the dimensions for the control and its font. + TextChanged is an overridden method used to perform actions needed when the CM_TEXTCHANGED message is handled for the control. TextChanged calls Invalidate to request the control to be redrawn. UpdateSize is called to perform auto-sizing, and recalculate the dimensions for the control. The font may be re-sized when OptimalFill is enabled.

- TextChanged does not calls the inherited method. + TextChanged does not call the inherited method.

- + + + + TControl.Invalidate + TControl.TextChanged +