From b194126ecaea448af045c604e3677fecb04a0929 Mon Sep 17 00:00:00 2001
From: dsiders <dsiders@lazarus-ide.org>
Date: Wed, 13 Dec 2023 20:26:38 +0000
Subject: [PATCH] Docs: LCL/controls. Updates
 TDragImageListResolution.ShowDragImage topic for changes in 85aa06c1. Issue
 #40640.

---
 docs/xml/lcl/controls.xml | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/docs/xml/lcl/controls.xml b/docs/xml/lcl/controls.xml
index 18e2fa09be..d685e37109 100644
--- a/docs/xml/lcl/controls.xml
+++ b/docs/xml/lcl/controls.xml
@@ -2810,19 +2810,28 @@ HideDragImage is called from the HideDragImage method in TDragImageList.
 </element>
 
 <element name="TDragImageListResolution.ShowDragImage">
-<short>Notifies the widgetset class to display the drag image.</short>
+<short>
+Notifies the widgetset class to display the drag image for the resolution.
+</short>
 <descr>
 <p>
-Displays the drag image from the image resolution. No actions are performed 
-in the method if Dragging is set to <b>False</b>.
+Calls the ShowDragImage method in the widgetset class to display the drag image 
+for the image resolution if its Dragging property is set to <b>True</b>. The 
+previous position for the drag image, stored in an internal member, is used to 
+send the image position to the widgetset class.
 </p>
 <p>
-ShowDragImage is called from the ShowDragImage method in TDragImageList.
+No actions are performed in the method if Dragging is set to <b>False</b>.
+</p>
+<p>
+ShowDragImage is called from the ShowDragImage method in TDragImageList, and 
+occurs after the active image resolution in the image list has been determined.
 </p>
 </descr>
 <seealso>
 <link id="TDragImageListResolution.Dragging"/>
 <link id="TDragImageList.ShowDragImage"/>
+<link id="#lcl.imglist.TCustomImageList.Resolutions">TCustomImageList.Resolutions</link>
 </seealso>
 </element>