Framework / Presentation Layer / Graphics / Appearance Styles / Fill Styles / Image Fill Style

Image Fill Style

The image fill style is used to fill an object interior with a raster image. It is represented by an instance of the NImageFillStyle class. The following code applies the myimage.png file as filling:

C#
Copy Code
someObject.FillStyle = new NImageFillStyle("c:\\images\\myimage.png");
Visual Basic
Copy Code
someObject.FillStyle = new NImageFillStyle("c:\\images\\myimage.png");
 Creating Images Dynamically

You may also create the image dynamically using the functionality provided by the Graphics.FromImage function. In the following example the image is created on the fly and passed to the NImageFillStyle constructor:

C#
Copy Code
// create objects
Bitmap bitmap = new Bitmap(256, 256, PixelFormat.Format32bppArgb);
Graphics graphics = Graphics.FromImage(bitmap);
Pen pen = new Pen(Color.Black, 1);

graphics.Clear(Color.White);
graphics.DrawRectangle(pen, 10, 10, 236, 236);

// dispose objects
pen.Dispose();
graphics.Dispose();

someObject.FillStyle = new NImageFillStyle(bitmap);
Visual Basic
Copy Code
' create objects
Dim bitmap As New Bitmap(256, 256, PixelFormat.Format32bppArgb)
Dim graphics As Graphics = graphics.FromImage(bitmap)
Dim pen As New Pen(Color.Black, 1)

Graphics.Clear(Color.White)
graphics.DrawRectangle(pen, 10, 10, 236, 236)

' dispose objects
pen.Dispose()
graphics.Dispose()

someObject.FillStyle = New NImageFillStyle(bitmap)
 Modifying the Alpha Channel

Another useful feature of the image fill style is that it can also modify the alpha channel of the image:

C#
Copy Code
someObject.FillStyle = new NImageFillStyle("c:\\images\\myimage.png", 125);
Visual Basic
Copy Code
someObject.FillStyle = new NImageFillStyle("c:\\images\\myimage.png", 125);

The above code will apply a semi transparent raster filling on the object based on the raster image contained in the myimage.png.

See Also