Andy De George
c0ba284473
* Merge winforms framework content to working branch (#14) * Breadcrumb / TOC / Move net5 to net folder (#15) * change path from net5 to net * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Add .net 5 winforms placeholder article (#16) * added some metadata and adjusted net5 placeholder * corrections * corrections * corrections * Test1 * Swapping landing page vs concept * fix links * Fix links * Fix desc
2.3 KiB
title, ms.date, dev_langs, helpviewer_keywords, ms.assetid
| title | ms.date | dev_langs | helpviewer_keywords | ms.assetid | |||||
|---|---|---|---|---|---|---|---|---|---|
| How to: Fill a Shape with an Image Texture | 03/30/2017 |
|
|
508da5a6-2433-4d2b-9680-eaeae4e96e3b |
How to: Fill a Shape with an Image Texture
You can fill a closed shape with a texture by using the xref:System.Drawing.Image class and the xref:System.Drawing.TextureBrush class.
Example
The following example fills an ellipse with an image. The code constructs an xref:System.Drawing.Image object, and then passes the address of that xref:System.Drawing.Image object as an argument to a xref:System.Drawing.TextureBrush.%23ctor%2A constructor. The third statement scales the image, and the fourth statement fills the ellipse with repeated copies of the scaled image.
In the following code, the xref:System.Drawing.TextureBrush.Transform%2A property contains the transformation that is applied to the image before it is drawn. Assume that the original image has a width of 640 pixels and a height of 480 pixels. The transform shrinks the image to 75×75 by setting the horizontal and vertical scaling values.
Note
In the following example, the image size is 75×75, and the ellipse size is 150×250. Because the image is smaller than the ellipse it is filling, the ellipse is tiled with the image. Tiling means that the image is repeated horizontally and vertically until the boundary of the shape is reached. For more information about tiling, see How to: Tile a Shape with an Image.
[!code-csharpSystem.Drawing.UsingABrush#21] [!code-vbSystem.Drawing.UsingABrush#21]
Compiling the Code
The preceding example is designed for use with Windows Forms, and it requires xref:System.Windows.Forms.PaintEventArgs e, which is a parameter of the xref:System.Windows.Forms.Control.Paint event handler.