This article has been excerpted from book "Graphics Programming with GDI+".

A region describes the interior of a closed graphics shape, or form. A form has two areas: a nonclient area and a client area. The nonclient area (which does not allow for user-drawn graphics objects) includes the title bar- and depending on the application, horizontal and vertical scroll bars. This area cannot be used to draw graphics objects. The client area is used to draw controls and graphics objects.

In the .NET Framework library, the Region class object represents a region. If you have ever developed a complex .NET graphics application that requires a lot of rendering, you may have used this object a lot.

Constructing a Region Object

The Region class provides five overloaded forms. Using these forms, you can construct a Region object from a Rectangle, RectangleF, GraphicsPath, or RegionData object, or will no parameters. The following code snippet creates Region objects in different ways using different arguments.

            //Create two rectangles
            Rectangle rect1 = new Rectangle(20, 20, 60, 80);
            RectangleF rect2 = new RectangleF(100, 20, 60, 100);

            //Create a graphics path
            GraphicsPath path = new GraphicsPath();

            //Add a rectangle to the graphics path
            path.AddRectangle(rect1);

            //Create a region from rect1
            Region rectRgn1 = new Region(rect1);

            //Create a region from rect2
            Region rectRgn2 = new Region(rect2);

            //Create a region from GraphicsPath
            Region pathRgn = new Region(path);

The Region class has no properties. After constructing a region, an application can use the Graphics class's FillRegion method to fill the region.

Table 6.1 describes the methods of the Region class briefly.

Table 6.1: Region method

Conclusion

Hope the article would have helped you in understanding the Region Class in GDI+. Read other articles on GDI+ on the website.

This book teaches .NET developers how to work with GDI+ as they develop applications that include graphics, or that interact with monitors or printers. It begins by explaining the difference between GDI and GDI+, and covering the basic concepts of graphics programming in Windows.