diff --git a/docs/xml/lcl/graphics.xml b/docs/xml/lcl/graphics.xml index 69440cfea3..ed94844a49 100644 --- a/docs/xml/lcl/graphics.xml +++ b/docs/xml/lcl/graphics.xml @@ -17346,18 +17346,36 @@ image has already been assigned. - Loads icon data from the specified instance and resource handles. - + +

+LoadFromResourceHandle is an overridden method in TIcon +used to load image data from an icon resource identified by the handles in +Instance and ResHandle. The handles are passed as +arguments to the RTL LoadResource routine which provides the global handle for +the group resource on the platform. +

+

+LoadFromResourceHandle reads the icon headers and data for the entries from +the resource. The ReadData method is called to read and store the values in +the stream to the shared raster image for the icon. +

+

+LoadFromResourceHandle reimplements the empty implementation introduced in the +TCustomIcon ancestor. +

+
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 @@ -17369,10 +17387,16 @@ deprecated THandle type in the Instance parameter. Resource handle with the icon data loaded in the method.
- -Frees the Handle used for the Icon. - +Frees the Handle used for the shared image in the Icon. + +

+Calls HandleNeeded to ensure that a handle is assigned if it does not already +exist. Calls the ReleaseHandle method in the shared raster image used for the +icon. The return value is the handle for the shared raster image before it is +set to the unassigned value (0). +

+
@@ -17873,19 +17897,42 @@ Returns RT_GROUP_CURSOR in TCursorImage. - + +Returns RT_GROUP_CURSOR for TCusrsorImage. + - - - + +Loads cursor images from the specified instance and resource handles. + + +

+LoadFromResourceHandle is an overridden method in +TCursorImage used to load cursor image(s) from the group cursor +resource identified in the Instance and ResHandle arguments. It calls the RTL +LoadResource routine to get the global handle used for the resource(s) on the +platform. No actions are performed in the method if the handle is unassigned +(0). +

+

+LoadFromResourceHandle creates a temporary resource stream which is used to +store the group cursor resources, including hot spot and image offset data. +ReadData is called to load the values from the stream to the shared raster +image used for the group cursor resources. +

+

+LoadFromResourceHandle reimplements the empty implementation introduced in the +TCustomIcon ancestor. +

+
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 @@ -17901,27 +17948,21 @@ Handle for the resource entry with the cursor image.
- - - - - - - - - - - + + + -ReleaseHandle - free the handle used for the cursor Image. +Frees the handle in the shared raster image used for the cursor. - + +HICON value for the handle freed in the method. +