Export (0) Print
Expand All

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 class WrapMode

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

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.

   void Button2_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
         Bitmap^ image1 = dynamic_cast<Bitmap^>(Image::FromFile( "C:\\Documents and Settings\\" 
         "All Users\\Documents\\My Music\\music.bmp", true ));
         TextureBrush^ texture = gcnew TextureBrush( image1 );
         texture->WrapMode = System::Drawing::Drawing2D::WrapMode::Tile;
         Graphics^ formGraphics = this->CreateGraphics();
         formGraphics->FillEllipse( texture, RectangleF(90.0F,110.0F,100,100) );
         delete formGraphics;
      catch ( System::IO::FileNotFoundException^ ) 
         MessageBox::Show( "There was an error opening the bitmap." 
         "Please check the path." );

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

© 2014 Microsoft