diff --git a/docs/xml/lcl/buttons.xml b/docs/xml/lcl/buttons.xml
index 0925886539..3e83c56bd8 100644
--- a/docs/xml/lcl/buttons.xml
+++ b/docs/xml/lcl/buttons.xml
@@ -352,7 +352,7 @@
- Draw is a method used to draw the glyph for the button using the target and configuration specified in the arguments. Draw is overloaded to provide a variant which uses a scalilng factor for the glyph image.
+ Draw is a method used to draw the glyph for the button using the target and configuration specified in the arguments. Draw is overloaded to provide a variant which uses a scaling factor for the glyph image.
Canvas is the TCanvas instance where the glyph is rendered.
diff --git a/docs/xml/lcl/comboex.xml b/docs/xml/lcl/comboex.xml
index 4b73ce2cb5..5a18b6f0bf 100644
--- a/docs/xml/lcl/comboex.xml
+++ b/docs/xml/lcl/comboex.xml
@@ -43,10 +43,12 @@
- TAutoCompleteOption is an enumerated type with values representing the autocomplete options used in TCustomComboBoxEx and TComboBoxEx. Values from the enumeration are stored in the TAutoCompleteOptions set type used to implement the AutoCompleteOptions property in TCustomComboBoxEx and TComboBoxEx. Including a value from the enumeration in the TAutoCompleteOptions set enables the corresponding feature.
+ TAutoCompleteOption is an enumerated type with values representing the autocomplete options used in TCustomComboBoxEx and TComboBoxEx. Values from the enumeration are stored in the TAutoCompleteOptions set type used to implement the AutoCompleteOptions property in TCustomComboBoxEx and TComboBoxEx. Including a value from the enumeration in the TAutoCompleteOptions set enables the corresponding feature.
- Not implemented in the current LCL version. Updates to scrll bar visibility, position, or range are handled in the widgetset class.
+ Not implemented in the current LCL version. Updates to scroll bar visibility, position, or range are handled in the widgetset class.
- LargeImagesWidth is an Integer property with the width for large images in the list view. The value indicates the image resolution requested from the LargeImages image list. If a resoution using the requested width does not already exist, it is created by scaling a candidate resolution for the image list.
+ LargeImagesWidth is an Integer property with the width for large images in the list view. The value indicates the image resolution requested from the LargeImages image list. If a resolution using the requested width does not already exist, it is created by scaling a candidate resolution for the image list.
The default value for the property is zero (0), and causes the width stored in LargeImages to be used for the large images.
@@ -11073,7 +11073,7 @@ end;
- SmallImagesWidth is an Integer property that indicates the width for the small images displayed in the list view. The value indicates the image resolution requested from the SmallImages image list. If a resoution using the requested width does not already exist, it is created by scaling a candidate resolution for the image list.
+ SmallImagesWidth is an Integer property that indicates the width for the small images displayed in the list view. The value indicates the image resolution requested from the SmallImages image list. If a resolution using the requested width does not already exist, it is created by scaling a candidate resolution for the image list.
The default value for the property is zero (0), and causes the width stored in the image list to be used for its images.
@@ -22843,7 +22843,7 @@ AToolbar.ButtonHeight := 30;
No actions are performed in the method for any of the following conditions:
- GetChildAccessibleObjectAtPos returns the accesibility object at the position expressed in client coordinates. This method is provided for controls which wish to override this behavior without sub-classing TLazAccessibleObject.
+ GetChildAccessibleObjectAtPos returns the accessibility object at the position expressed in client coordinates. This method is provided for controls which wish to override this behavior without sub-classing TLazAccessibleObject.
- GetDefaultColor is a virtual method and can be overridden in descedent classes to use the colors needed for a specific control.
+ GetDefaultColor is a virtual method and can be overridden in descendent classes to use the colors needed for a specific control.
GetDefaultColor is used in the implementation of the GetColorResolvingParent and GetRGBColorResolvingParent methods. It is also called from the SetColor and CreateBrush methods in the TWinControl descendant.
@@ -11110,7 +11110,7 @@
The return value is True when the Visible property is set to True. The value is False at design-time if the ControlStyle property includes the value csNoDesignVisible. IsControlVisible does not check the visibility for parent controls in the control hierarchy.
- Use IsVisible to consider the visiblity for any Parent controls.
+ Use IsVisible to consider the visibility for any Parent controls.
- OnChangeBounds is signalled from the DoOnChangeBounds method (when assigned). It occurs after the internal control flags have been updated to excelude cfOnChangeBoundsNeeded, and before DoCallNotifyHandler is called to notify handlers for the chtOnChangeBounds type.
+ OnChangeBounds is signalled from the DoOnChangeBounds method (when assigned). It occurs after the internal control flags have been updated to exclude cfOnChangeBoundsNeeded, and before DoCallNotifyHandler is called to notify handlers for the chtOnChangeBounds type.
- Enlarge children equally. Children are resized to their normal/adviced size. If there is some space left in the client area of the parent, then the remaining space is distributed equally to each child.
+ Enlarge children equally. Children are resized to their normal/advised size. If there is space left in the client area of the parent, the remaining space is distributed equally to each child.
For example: 3 child controls A, B, C with A.Width=10, B.Width=20 and C.Width=30 (total=60). If the Parent's client area has a ClientWidth of 120, then 60/3=20 is added to each Child.
diff --git a/docs/xml/lcl/dialogs.xml b/docs/xml/lcl/dialogs.xml
index 394f4ef89d..dc5a4a94b7 100644
--- a/docs/xml/lcl/dialogs.xml
+++ b/docs/xml/lcl/dialogs.xml
@@ -876,7 +876,7 @@
- The default value for the property is an empty String (''), and cause the values "See details" or "Hide details" to be used on the Task dialog (when the lanuguage is English). Setting a value for the property causes the same caption to be displayed for both the expanded and collapsed states; only the button indicator changes.
+ The default value for the property is an empty String (''), and cause the values "See details" or "Hide details" to be used on the Task dialog (when the language is English). Setting a value for the property causes the same caption to be displayed for both the expanded and collapsed states; only the button indicator changes.
Use the Flags property to control the position (tfExpandFooterArea) or the expanded / collapsed state (tfExpandedByDefault) for the ExpandedText on the Task dialog.
diff --git a/docs/xml/lcl/extctrls.xml b/docs/xml/lcl/extctrls.xml
index 0d38bf4483..ba529aa6fd 100644
--- a/docs/xml/lcl/extctrls.xml
+++ b/docs/xml/lcl/extctrls.xml
@@ -2050,7 +2050,7 @@
- OnCanResize is a TCanResizeEvent proprety with the event handler signalled to determine if the splitter control can be resized. OnCanResise is signalled (when assigned) from the CheckNewSize method using the splitter control and the new size for the anchored control as arguments. The Accept argument can be updated in the event handler to indicate whether the new size is acceptable (True) or rejected (False).
+ OnCanResize is a TCanResizeEvent property with the event handler signalled to determine if the splitter control can be resized. OnCanResise is signalled (when assigned) from the CheckNewSize method using the splitter control and the new size for the anchored control as arguments. The Accept argument can be updated in the event handler to indicate whether the new size is acceptable (True) or rejected (False).
OnMoved is a TNotifyEvent property with the event handler signalled when the splitter control has been dragged / moved. It is signalled (when assigned) from the StopSplitterMove method when the mouse button is released to end the drag operation. It occurs after the splitter has been moved using the MoveSplitter method.
@@ -7156,7 +7158,9 @@
- If the file is not successully loaded (due to permissions or image format), the ClearPreview method is called.
+ If the file is not successfully loaded (due to permissions or image format), the ClearPreview method is called.
UpdatePreview is called from the DoSelectionChange method when the selected file name for the preview dialog has changed.
@@ -442,7 +442,7 @@
- DoShow is an overridden procedure used to display the Picture FIle Open preview dialog. DoShow calls ClearPreview to set the dialog to the state needed prior to selecting an image file name in the preview dialog.
+ DoShow is an overridden procedure used to display the Picture File Open preview dialog. DoShow calls ClearPreview to set the dialog to the state needed prior to selecting an image file name in the preview dialog.
DoShow calls the inherited method to signal the OnShow event handler (when assigned).
@@ -1208,7 +1208,7 @@
- DialogScale is an Integer property which indicates the scaling percentage applied to the height and width for the calculator dialog. When the value for the property is changed, it its validated and adjusted to ensure that it is in the range 80...400 (the minuimum and maximum allowed for the property).
+ DialogScale is an Integer property which indicates the scaling percentage applied to the height and width for the calculator dialog. When the value for the property is changed, it its validated and adjusted to ensure that it is in the range 80...400 (the minimum and maximum allowed for the property).
DialogScale is passed as the multiplier argument to the ScaleBy method in TCalculatorForm; the divisor is always set to 100.
@@ -1431,7 +1431,7 @@
- Cascade is a method used to arrange MDI Chid forms so that they overlap in a cascading fashion.
+ Cascade is a method used to arrange MDI Child forms so that they overlap in a cascading fashion.
No actions are performed in the method when FormStyle has a value other than fsMDIForm. At run-time, the Cascade method in the widgetset class is called when its Handle has been allocated.
@@ -13384,7 +13384,7 @@ HintWindow.ActivateHint(Rect, 'This is the hint');
- OnUserInput is a TOnUserInputEvent property with the event handler signalled when an input message is available in the processing loop for the widgetset class. It is signalled (when assigned) from the NotifyUserInputHandler method, and occurs before other application handlers using the ahtUserInput type are notififed.
+ OnUserInput is a TOnUserInputEvent property with the event handler signalled when an input message is available in the processing loop for the widgetset class. It is signalled (when assigned) from the NotifyUserInputHandler method, and occurs before other application handlers using the ahtUserInput type are notified.
- Orientation is an
- Integer property which contains the rotation angle used for text in 1/10ths of a degree. The rotation angle is determined by the relationship between the X Axis for the Canvas and the baseline for the font, and uses the following directionality:
+ Orientation is an Integer property which contains the rotation angle used for text in 1/10ths of a degree. The rotation angle is determined by the relationship between the X Axis for the Canvas and the baseline for the font, and uses the following directions:
Setting a new value for the property causes the font Reference to be re-created, and calls Changes to signal the OnChange event handler (when assigned).
+
+ Setting a new value for the property causes the font Reference to be re-created, and calls Changes to signal the OnChange event handler (when assigned).
The default value for the property is 0 (zero).
+
+ The default value for the property is 0 (zero).
- IsEmpy is a
- Boolean function which indicates if image content has been assigned for the shared image. The return value is True when both the Handle and the SaveStream for the shared image are unassigned. Specifically, Handle contains 0 and SaveStream is Nil.
+ IsEmpty is a Boolean function which indicates if image content has been assigned for the shared image. The return value is True when both the Handle and the SaveStream for the shared image are unassigned. Specifically, Handle contains 0 and SaveStream is Nil.
Create is the constructor for the class instance, and calls the inherited constructor on entry.
+
+ Create is the constructor for the class instance, and calls the inherited constructor on entry.
Calls CreateMask to create and appy the mask handle required for the fixed color transparency.
+
+ Calls CreateMask to create and apply the mask handle required for the fixed color transparency.
- TransparentColor is a
- TColor property which indicates the color used for transparent pixels in the raw image data. The default value for the property is
+ TransparentColor is a TColor property which indicates the color used for transparent pixels in the raw image data. The default value for the property is
clDefault.
TransparentColor is used along with TransparentMode to determine whether a fixed color is used for transparency, or if the tranparent color is read from a specified pixel in the raw image data.
+
+ TransparentColor is used along with TransparentMode to determine whether a fixed color is used for transparency, or if the transparent color is read from a specified pixel in the raw image data.
When TransparentColor contains clDefault, the RequestTransparentColor method is used to get the transparency color value from the bottom-left pixel in the raw image data.
+
+ When TransparentColor contains clDefault, the RequestTransparentColor method is used to get the transparency color value from the bottom-left pixel in the raw image data.
When setting a new value for the property, the TransparentMode property is updated as well. When clDefault is assigned to the property, TransparentMode is set to tmAuto. For other color values, TransparentMode is set to tmFixed.
+
+ When setting a new value for the property, the TransparentMode property is updated as well. When clDefault is assigned to the property, TransparentMode is set to tmAuto. For other color values, TransparentMode is set to tmFixed.
MaskHandleAllocated is called to determine if a HBITMAP handle has been allocated for the MaskHandle property. When True, the MaskHandle is reset to 0 to indicate the handle is no longer in use or is invalid.
@@ -9940,7 +9946,7 @@
- Destroy is theoverridden destructor for
+ Destroy is the overridden destructor for
TSharedCustomBitmap.
Destroy frees the internal save stream for the class instance. It also calls FreeHandle and FreeImage to free the handle and the raw image data for the shared bitmap. Calls the inherited destructor prior to exiting from the method.
@@ -10272,7 +10278,7 @@
Calls RawimageNeeded to ensure that the image desriptor is valid.
+ Calls RawimageNeeded to ensure that the image descriptor is valid.
ReadStream verifies that AStream contains an icon image by checking for header value(s) that are valid for .ICO data. If the header values are nopt found, an EInvalidGraphic exception is raised.
+ ReadStream verifies that AStream contains an icon image by checking for header value(s) that are valid for .ICO data. If the header values are not found, an EInvalidGraphic exception is raised.
For icon data, the icon directory must be read from the stream. The header contains the number of icon directory entries included in the stream. The icon directory entries are read from AStream, and include values for each icon image that includes:
ReadStream positions the stream, and reads image data for the each of the icon directory entries. It handles both DIB Bitmap and PNG (used in WIndows Vista) image data for the icon images. An FCL-compatible image reader is created as required for the image type, and a TLazIntfImage instance is used to capture the raw image data from the stream. Images read from the stream are added to the internal list of images in the TSharedIcon member for the class instance.
+ ReadStream positions the stream, and reads image data for the each of the icon directory entries. It handles both DIB Bitmap and PNG (used in Windows Vista) image data for the icon images. An FCL-compatible image reader is created as required for the image type, and a TLazIntfImage instance is used to capture the raw image data from the stream. Images read from the stream are added to the internal list of images in the TSharedIcon member for the class instance.
ReadStream calls CheckRequestedSize to use the Width and/or Height specified in the class instance. GetBestIndexForSize is called to determine the value in Current with the requested image size.
- Orginal author: Chris Rorden
+ Original author: Chris Rorden
- IsDefault is when the coloumns for the parent grid are streamed using the LCL component streaming mechanism. Columns which contain default values (including the title) are not written during component streaming.
+ IsDefault is when the columns for the parent grid are streamed using the LCL component streaming mechanism. Columns which contain default values (including the title) are not written during component streaming.
- GetDefaultColumnTitle provides the text used for the specified column number when Columns have not been enabled for the grid control. GetDefaultColumnTitle always returns an empty strng ('') in TCustomGrid.
+ GetDefaultColumnTitle provides the text used for the specified column number when Columns have not been enabled for the grid control. GetDefaultColumnTitle always returns an empty string ('') in TCustomGrid.
GetDefaultColumnTitle is called from the GetColumnTitle method.
@@ -8959,7 +8959,7 @@
- MouseMove sets the Hint displayed for the cell under the mouse pointer when ShowHint is enabled. Values in Hint, CellHintPriority, Options, and the OnGetCellHint event hander are used for the purpose. If the mouse pointer is not over a cell, the Hint for the application is reset to a previous hint or an empty string ('') when saved hint text is not available.
+ MouseMove sets the Hint displayed for the cell under the mouse pointer when ShowHint is enabled. Values in Hint, CellHintPriority, Options, and the OnGetCellHint event handler are used for the purpose. If the mouse pointer is not over a cell, the Hint for the application is reset to a previous hint or an empty string ('') when saved hint text is not available.
Called from WMMouseMove when a LM_MOUSEMOVE window message is handled for the grid control.
@@ -11335,7 +11335,7 @@
EditorMode is a Boolean property which indicates whether the cell Editor has been enabled for the grid control. Set EditorMode to True to display the cell Editor for the control. Set it to False to hide the cell Editor.
- The value in EditorMode is updated when handling key presses and mouse clicks, scrolling the visible area for the control, or changing the configration of the grid.
+ The value in EditorMode is updated when handling key presses and mouse clicks, scrolling the visible area for the control, or changing the configuration of the grid.
- IsColumn indicates whether a column or a row is affected in the method. When set to True, a column is removed. Othewise, a row is removed.
+ IsColumn indicates whether a column or a row is affected in the method. When set to True, a column is removed. Otherwise, a row is removed.
Index contains the column or row number removed in the method.
@@ -13873,7 +13873,7 @@
WasInsert determines the event handler signalled in the method. When WasInsert is set to True, the OnColRowInserted event handler is signalled (when assigned). When set to False, the OnColRowDeleted event handler is signalled (when assigned).
- FromIndex and ToIndex indicate the column(s) or row(s) affected by the change. FromIndex has the column or row number where the action was performed. When a column or row was inserted, ToIndex has the same value as FromIndex. For changes to ColCout or RowCount, FromIndex and ToIndex contain the column or row count prior to and following the change.
+ FromIndex and ToIndex indicate the column(s) or row(s) affected by the change. FromIndex has the column or row number where the action was performed. When a column or row was inserted, ToIndex has the same value as FromIndex. For changes to ColCount or RowCount, FromIndex and ToIndex contain the column or row count prior to and following the change.
NotifyColRowChange is called from methods like ColRowInserted, ColRowDeleted, and SizeChanged.
@@ -15765,7 +15765,7 @@
While values in Cells and Objects are related, they are handled independently. The value in Objects is not changed when a new value is assigned to Cells.
- Values stored in Objects are set to Nil when the Clean method is callled to remove content in the grid. The application is responsible for allocating and freeing resources in Objects.
+ Values stored in Objects are set to Nil when the Clean method is called to remove content in the grid. The application is responsible for allocating and freeing resources in Objects.
Values for the Objects property are not included in the grid data read and written during LCL component streaming. They are not handled by the LoadContent and SaveContent either. The property values are available at run-time only.
@@ -16177,7 +16177,7 @@
goVertLine, goHorzLine
- ACollection is the TCollection instance which owns the new dialog button. It is assigned to the Collection property in the colleciton item.
+ ACollection is the TCollection instance which owns the new dialog button. It is assigned to the Collection property in the collection item.
Create sets the default values for the Caption and ModalResult properties.
@@ -612,7 +612,7 @@
AModalResult contains the modal result value to locate in the collection Items.
- AOrder allows an array of modal resuilt values to be located in the method. It specifies the search order for the modal result values.
+ AOrder allows an array of modal result values to be located in the method. It specifies the search order for the modal result values.
FindButton iterates over the Items in the collection to find the first button which uses the modal result value(s). The return value is the first TDialogButton instance in Items which matches the requested value(s).
@@ -722,10 +722,10 @@
- PassCmdLineOptions is a procedure used to pass commandline arguments used for the platform-specific widgetset implementation. PassCmdLineOptions has an empty implementation in TWidgetSet, and must be overridden in a descendent class. It allows commandline arguments to be preprocessed or modified prior to starting an application.
+ PassCmdLineOptions is a procedure used to pass command line arguments used for the platform-specific widgetset implementation. PassCmdLineOptions has an empty implementation in TWidgetSet, and must be overridden in a descendent class. It allows command line arguments to be preprocessed or modified prior to starting an application.
- The return value is either LCL_CAPABILITY_NO or LCL_CAPABILITY_YES. LCL_CAPABILITY_YES indicates that the capabiity is implemented for the platform.
+ The return value is either LCL_CAPABILITY_NO or LCL_CAPABILITY_YES. LCL_CAPABILITY_YES indicates that the capability is implemented for the platform.
GetLCLCapability is overridden in descendent classes to return a value valid for the platform-specific implementation. The implementation in TWidgetSet handles the capabilities common to all widgetsets supported in the LCL. It is called when the descendent class does not handle the value in ACapability.
@@ -1764,7 +1764,7 @@
- The available features depend on the window manager for the platform, and the capabiities for the widgetset.
+ The available features depend on the window manager for the platform, and the capabilities for the widgetset.
-
- Text is drawn vertically from top to bottom.
- There are 16 raster operations usig the possible combinations of two (boolean) values: + There are 16 raster operations using the possible combinations of two (boolean) values:
- The Points member contains the TPoint values that define the vertices for the polygon. FillMode defines how the interior of the polygon is fillled, as uses values like those defined for the Windows GDI API. An overridden IsPointInPart is provided to determine if a point is within the bounds for the polygonal area. + The Points member contains the TPoint values that define the vertices for the polygon. FillMode defines how the interior of the polygon is filled, and uses values like those defined for the Windows GDI API. An overridden IsPointInPart is provided to determine if a point is within the bounds for the polygonal area.
Instances of TLazRegionPolygon are created when the AddPolygon method in TLazRegion is called. diff --git a/docs/xml/lcl/lclintf.xml b/docs/xml/lcl/lclintf.xml index 2ef5985ebe..e04580e3fb 100644 --- a/docs/xml/lcl/lclintf.xml +++ b/docs/xml/lcl/lclintf.xml @@ -694,10 +694,10 @@
- Returns information about any DC (Device Context), which might be the screen DC representing the monitor, a control canvas or a offscreen bitmap canvas. The following constants can be utilized in the index argument: + Returns information about any DC (Device Context), which might be the screen DC representing the monitor, a control canvas or a off-screen bitmap canvas. The following constants can be utilized in the index argument:
The bytes are shifted into place, following the format $00bbggrr, which is the format of the - Windows API type COLORREF. Their actual physical order depends on the endianness of the machine. + Windows API type COLORREF. Their actual physical order depends on the endian-ness of the machine.
- StoredValues is a TStoredValues property with the collection of names and values for properties handled by the storage container. StoredValues is used in the Save and Restore methods when the collection items are read or written using the underlying storage mechamism for the container. It is also used to read or write the value for the indexed StoreValue property. + StoredValues is a TStoredValues property with the collection of names and values for properties handled by the storage container. StoredValues is used in the Save and Restore methods when the collection items are read or written using the underlying storage mechanism for the container. It is also used to read or write the value for the indexed StoreValue property.
- The write access specifier is overridden in TCustomGroupBox. It calls the inherited method on enty. + The write access specifier is overridden in TCustomGroupBox. It calls the inherited method on entry.
If AParentBackground is True and ParentColor is True, the Color from the Parent control is assigned to the Color property. Otherwise, the value clDefault is stored in the Color property. @@ -2197,7 +2197,7 @@
- Style is quite Windows centric, reflecting the evolution of combo-box styles. The basic styles are: + Style is quite Windows-centric, reflecting the evolution of combo-box styles. The basic styles are:
- The property value (along with Shortcut) is passed to the widgetst class when the WSSetText method is called. + The property value (along with Shortcut) is passed to the widgetset class when the WSSetText method is called.
Use the ShortCut and ShortCutToKey routines in the
-Calls InitThemes to detrmine if theme data is available. Sets the value in the ThemesAvailable property. Calls UpdateThemes to load theme data. +Calls InitThemes to determine if theme data is available. Sets the value in the ThemesAvailable property. Calls UpdateThemes to load theme data.
-Overloaded to provide WIndows and non-Windows variants. Overridden in the TWin32ThemeServices descendant for compatability with Delphi. +Overloaded to provide Windows and non-Windows variants. Overridden in the TWin32ThemeServices descendant for compatibility with Delphi.
- Use InsertRow to insert a new row using seperate key and item value parameters. + Use InsertRow to insert a new row using separate key and item value parameters.
In this unit you can find an implementation of a name/value pair storage container in XML format.
-This container will get the Form's Session Properties that you setup in TForm.SessionProperties and read/write them on the file you specify on TXMLPropStorage.FileName.
++ In this unit you can find an implementation of a name/value pair storage container in XML format. +
++ This container will get the Form's Session Properties that you setup in TForm.SessionProperties and read/write them on the file you specify on TXMLPropStorage.FileName. +
@@ -384,7 +406,9 @@
Calls the GetValue method for the internal TXMLConfig instance.
@@ -401,7 +425,9 @@
- Use WriteToDisk or SaveToStream to speciy where the XML content is stored . + Use WriteToDisk or SaveToStream to specify where the XML content is stored .