paweld/lazarus
1
0
Fork 0
mirror of https://gitlab.com/freepascal.org/lazarus/lazarus.git synced 2025-08-14 06:22:30 +02:00
Code Issues Packages Projects Releases Wiki Activity

Docs: LCL/graphics. Updates the TCanvas.Draw topic to clarify content.

Browse Source 
* Based on suggestions by @jamie in the forum discussion
* https://forum.lazarus.freepascal.org/index.php/topic,67389.0.html.
This commit is contained in:
dsiders 2024-05-28 18:07:11 +01:00
parent 9f017e0230
commit c52332fbb5
1 changed files with 22 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/xml/lcl/graphics.xml
View File

@ -8998,21 +8998,39 @@ Draws the image content in SrcGraphic on the canvas at the specified position.
<p> <p>
<var>Draw</var> is reintroduced method in TCanvas; it reimplements the <var>Draw</var> is reintroduced method in TCanvas; it reimplements the
inherited method to use the TGraphic instance in SrcGraphic as the container inherited method to use the TGraphic instance in SrcGraphic as the container
for the image content drawn in the method. with the image content drawn in the method.
</p> </p>
<p> <p>
No actions are performed in the method if SrcGraphic has not been assigned. No actions are performed in the method if SrcGraphic has not been assigned.
</p> </p>
<p> <p>
Draw calls the StretchDraw method to draw the content in SrcGraphic on the Draw calls the StretchDraw method to render the content in SrcGraphic on the
canvas at the position specified in X and Y. The Width and Height in canvas at the position specified in X and Y. The Width and Height in SrcGraphic
SrcGraphic are used to size the destination rectangle on the canvas. set the bounds for the image rectangle applied to the canvas using StretchDraw.
Since a stretch mode is not enabled when StretchDraw is called, the source
graphic is not enlarged or shrunk to the canvas size. The source graphic is
clipped if its bounds exceeds the canvas bounds. The Draw method in SrcGraphic
performs the actions needed to position and rendering the content to the Pixels
in the canvas.
</p>
<p>
CopyMode determines the raster operation performed for the Pixels affected on
the canvas.
</p>
<p>
Calling Draw causes the OnChanging and OnChange events to be signalled (when
assigned). OnChanging occurs prior to calling Draw in the TGraphic instance.
OnChange occurs after calling Draw in the TGraphic instance.
</p> </p>
</descr> </descr>
<seealso> <seealso>
<link id="TCanvas.StretchDraw"/> <link id="TCanvas.StretchDraw"/>
<link id="TCanvas.CopyMode"/>
<link id="TCanvas.OnChange"/>
<link id="TCanvas.OnChanging"/>
<link id="TGraphic.Width"/> <link id="TGraphic.Width"/>
<link id="TGraphic.Height"/> <link id="TGraphic.Height"/>
<link id="TGraphic.Draw"/>
<link id="#rtl.classes.TRect">TRect</link> <link id="#rtl.classes.TRect">TRect</link>
</seealso> </seealso>
</element> </element>