This documentation is archived and is not being maintained.

WrapMode Enumeration

Specifies how a texture or gradient is tiled when it is smaller than the area being filled.

Namespace:  System.Drawing.Drawing2D
Assembly:  System.Drawing (in System.Drawing.dll)

public enum WrapMode

Member nameDescription
TileTiles the gradient or texture.
TileFlipXReverses the texture or gradient horizontally and then tiles the texture or gradient.
TileFlipYReverses the texture or gradient vertically and then tiles the texture or gradient.
TileFlipXYReverses the texture or gradient horizontally and vertically and then tiles the texture or gradient.
ClampThe texture or gradient is not tiled.

Brushes use this enumeration to determine how shapes are filled. To see examples of the effects the WrapMode enumeration values have on a tiled image, see How to: Tile a Shape with an Image.

The following code example demonstrates how to obtain a new bitmap using the FromFile method. It also demonstrates a TextureBrush and the WrapMode enumeration. This example is designed to be used with Windows Forms. Create a form containing a button named Button2. Paste the code into the form and associate the Button2_Click method with the button's Click event.

private void Button2_Click(System.Object sender, System.EventArgs e)
        Bitmap image1 = (Bitmap) Image.FromFile(@"C:\Documents and Settings\" +
            @"All Users\Documents\My Music\music.bmp", true);

        TextureBrush texture = new TextureBrush(image1);
        texture.WrapMode = System.Drawing.Drawing2D.WrapMode.Tile;
        Graphics formGraphics = this.CreateGraphics();
            new RectangleF(90.0F, 110.0F, 100, 100));

        MessageBox.Show("There was an error opening the bitmap." +
            "Please check the path.");


Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0