diff --git a/docs/xml/lcl/graphics.xml b/docs/xml/lcl/graphics.xml
index 24a841ecee..69440cfea3 100644
--- a/docs/xml/lcl/graphics.xml
+++ b/docs/xml/lcl/graphics.xml
@@ -4374,7 +4374,7 @@ Ensures that resources are allocated for the Reference property.
Performs actions needed to allocate (or reallocate) resources for the brush
-instance.
+instance.
@@ -5629,16 +5629,17 @@ representing a specific image format.
-Loads a resource with the specified name from the given handle.
+
+Loads a resource with the specified name from the given handle.
+
LoadFromResourceName is a procedure used to load a resource with
the name specified in ResName using the handle provided in
Instance. LoadFromResourceName calls GetResourceType to
get the Integer resource type used in the class instance. No
-actions are performed in the method when the TResourceType value
-is unassigned (contains
-Nil).
+actions are performed in the method when the TResourceType value is
+unassigned (contains Nil).
LoadFromResourceName creates a temporary TResourceStream that is
@@ -5653,7 +5654,17 @@ Use LoadFromLazarusResource to load a Lazarus resource from a
.lrs file with a give name.
-
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
+
+
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
+TResourceStream
+Handle where the content for the resource is stored.
@@ -5664,7 +5675,7 @@ Use LoadFromLazarusResource to load a Lazarus resource from a
-Load graphic data from a resource identified by the integer identifier
+Loads graphic data from a resource identified by the integer identifier
ResID.
@@ -5700,7 +5711,19 @@ Use LoadFromLazarusResource to load a Lazarus resource from a
Raises an EResNotFound exception when the TResourceStream is initialized if
the resource type or the resource handle is invalid.
-
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
+
+
+
+
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
+TResourceStream
+Handle where the content for the resource is stored.
@@ -6812,7 +6835,7 @@ Loads content from the specified resource into the Graphic property.
LoadFromResourceName is an overloaded method used to created a
TGraphic instance with the content from the specified resource
name.
-Instance is the Handle with the resources examined in the method.
+Instance is the handle with the resources examined in the method.
ResName is the name of the resource loaded in the method.
@@ -6826,8 +6849,8 @@ instance.
An overloaded variant includes an AClass argument with the class
type for the TGraphic descendant needed for a supported image format. The
-LoadFromStream in the class instance is called to load the named
-resource.
+LoadFromResourceName method in the class instance is called to load
+the named resource.
The existing TGraphic instance in Graphic is freed and the new TGraphic
@@ -6835,7 +6858,18 @@ instance is used as the member variable. The Changed method is called to
signal the OnChange event handler (when assigned).
-
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
+
+
+
+
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
+Handle with the resources examine in the method.
@@ -6855,13 +6889,30 @@ signal the OnChange event handler (when assigned).
File name with resource retrieved in the method.
+
-Loads a supported image format from the specified stream.
+
+Loads picture data in a supported image format from the specified stream.
+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+Stream instance with the graphics format and data loaded in the method.
+
@@ -10871,6 +10922,7 @@ controls.
+
Frees the handle for the shared image.
@@ -10896,14 +10948,13 @@ No actions are performed in the method when the handle is already set to
-ReleaseHandle - returns the identity of the handle that has just
-been released.
+Returns the handle that has just been released.
-ReleaseHandle is a THandle function used to release a reference for the
-handle in the class instance. The return value contains the value for the
-handle on entry.
+ReleaseHandle is a TLCLHandle function used to release a
+reference for the handle in the class instance. The return value contains the
+value for the handle on entry.
ReleaseHandle sets the handle value to 0 to indicate that it is no longer
@@ -10916,10 +10967,19 @@ like TCustomBitmap and TIcon, when their ReleaseHandle method is called to
free the handle for its shared image.
-
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the return value.
+
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
+
-
+
+Value for the internal handle on entry to the method.
+
@@ -10956,7 +11016,8 @@ constructor on entry.
-Not implemented in the current LCL version.
+
+Abstract virtual method not implemented in the class instance.
@@ -10983,15 +11044,20 @@ Calls the inherited destructor prior to exiting from the method.
-Determines whether the Handle for the class has been allocated.
+
+Determines whether the Handle for the class has been allocated.
+
Implements the abstract virtual method defined in TSharedImage.
-The return value is True when the Handle contains a non-zero value.
+The return value is True when the internal handle contains a non-zero
+value.
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
@@ -11403,21 +11469,31 @@ for the class instance.
-Gets the value for the Handle property.
+
+Gets the value for the handle used in the image.
+
-Calls HandleNeeded to ensure that valid handles exist for the image. Requires
-a valid handle in the shared raster image for the class instance.
+Calls HandleNeeded to ensure that valid handle(s) exist for the image. The
+return value is the handle in the shared raster image for the class instance.
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the return value.
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
-Value for the property.
+
+Handle for the raster image.
+
@@ -11902,10 +11978,12 @@ image data for a specific image format.
-Sets the Handle used for the image.
+
+Sets the handle used for the image.
+
-SetHandle stores the specified THandle value as the
+SetHandle stores the specified TLCLHandle value as the
handle used for the image. The handle is actually the one used by the internal
TSharedRasterImage instance for the class. No actions are
performed in the method when the value in AHandle is the same as the handle
@@ -11918,6 +11996,10 @@ assigned to the internal shared image. When no other active update processes
are pending, the Changed method is called.
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the AValue parameter.
+
@@ -11925,6 +12007,8 @@ are pending, the Changed method is called.
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
@@ -13712,18 +13796,26 @@ before the value in RawImage is accessed. For example:
-Re-implements the method from the ancestor class.
+
+Re-implements the method from the ancestor class.
+
SetHandle is an overridden method in TCustomBitmap, and
re-implements the method from the TRasterImage ancestor class.
-AValue contains the new handle assigned to the
+AValue contains the new handle instance assigned to the
BitmapHandle property.
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Value parameter.
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
@@ -15236,15 +15328,24 @@ Frees the existing icon image and reloads it from the specified handle.
Calls FreeHandle to free the existing handle for the Icon in the widgetset
-class, and sets the Handle to the value specified in NewHandle. Gets icon
+class, and sets the handle to the value specified in NewHandle. Gets icon
information from the widgetset class and adds a new icon image to the list of
Images.
-
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the NewHandle parameter.
+
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
+
-
+
+TLCLHandle instance assigned as the handle for the shared icon.
+
@@ -16285,24 +16386,32 @@ Unshares an existing shared image handle and set the new value.
-SetHandle is a method used to set set the value for the shared image handle
-in the icon instance. It ensures that an existing shared image handle frees
-both its canvas context and the data in its TSharedImage instance.
+SetHandle is a method used to set set the value for the shared
+image handle in the icon instance. It ensures that an existing shared image
+handle frees both its canvas context and the data in its TSharedImage instance.
It calls UpdateHandle to set the new shared handle for the icon instance to
AValue. Values in Current and Count are reset when the handle is changed.
Current is set 0 when multiple images are used in the icon. It is set to -1
when a single image is present. Changed is called to update the value in
-Modified and signal the OnCHange event handler (when assigned).
+Modified and signal the OnChange event handler (when assigned).
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the AValue parameter.
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
-New value for the shared image handle in the icon.
+
+New value for the shared image handle in the icon.
+
@@ -16808,9 +16917,8 @@ Loads the icon with the specified resource name from the instance handle.
LoadFromResourceName is an overridden procedure used to load a
resource with the name specified in ResName using the handle
-provided in
-Instance. LoadFromResourceName re-implements the method defined in
-the ancestor class, and does not call the inherited method.
+provided in Instance. LoadFromResourceName re-implements the method
+defined in the ancestor class, and does not call the inherited method.
LoadFromResourceName calls GetResourceType to get the
@@ -16835,7 +16943,17 @@ Use LoadFromLazarusResource to load a Lazarus resource from a
.lrs file with a give name.
-
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
+
+
+
+TResourceType
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
+Handle where the content for the resource is stored.
@@ -16856,7 +16974,7 @@ LoadFromResourceID re-implements the method defined in the ancestor class,
and does not call the inherited method.
-Instance contains the Handle used to read the resource.
+Instance contains the handle used to read the resource.
ResID contains an Integer pointer to the resource identifier
loaded in the method.
@@ -16888,7 +17006,14 @@ Use LoadFromLazarusResource to load a Lazarus resource from a
Raises an EResNotFound exception if the resource handle for the specified ID
and type is not valid.
-
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
+Handle where the content for the resource is stored.
@@ -16907,8 +17032,14 @@ LoadFromResourceHandle has an empty implementation in TCustomIcon. It is
re-implemented in TIcon descendant.
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
@@ -17215,13 +17346,20 @@ image has already been assigned.
+
Loads icon data from the specified instance and resource handles.
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
@@ -17231,13 +17369,14 @@ Loads icon data from the specified instance and resource handles.
Resource handle with the icon data loaded in the method.
+
Frees the Handle used for the Icon.
-HICON value removed from the Handle in the class instance.
+HICON value removed from the handle in the class instance.
@@ -17267,8 +17406,8 @@ Handle used to access the image data for the icon.
Handle is a HICON property which contains the handle
-for the icon used to access image data for the icon. The property value is
-provided by the inherited GetHandle method, and contains the Handle for its
+for the icon used to access its image data. The property value is provided by
+the inherited GetHandle method, and contains the handle for its
TSharedRasterImage instance.
@@ -17737,18 +17876,29 @@ Returns RT_GROUP_CURSOR in TCursorImage.
-
+
+
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
-
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
-
+
+Handle for the resource instance with the cursor image.
+
-
+
+Handle for the resource entry with the cursor image.
+
@@ -19965,13 +20115,21 @@ the Lazarus Resource (.LRS).
+
-Creates and loads a TGraphic instance using the specified instance handle and
-resource name.
+Creates and loads a TGraphic instance using the specified resource instance
+handle and resource name.
-
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
+
@@ -19995,7 +20153,14 @@ stored in a Lazarus resource. Typically used to load button glyphs and icons
displayed on the component palette in the Lazarus IDE.
-
+
+Modified in LCL version 4.0 to use the TLCLHandle type instead of the
+deprecated THandle type in the Instance parameter.
+
+
+LCLType.TLCLHandle
+WSReferences.TLCLHandle
+Bitmap instance created and loaded in the routine.
@@ -20008,6 +20173,8 @@ Handle for the Lazarus resource with the content for the bitmap.
Name for the RT_BITMAP resource loaded in the routine.
+
+
Creates and loads a Bitmap from a Lazarus Resource (.lrs) file.