Region class (gdiplusheaders.h)

The Region class describes an area of the display surface. The area can be any shape. In other words, the boundary of the area can be a combination of curved and straight lines. Regions can also be created from the interiors of rectangles, paths, or a combination of these. Regions are used in clipping and hit-testing operations.

Inheritance

The Region class implements GdiplusBase.

Methods

The Region class has these methods.

 
Region::Clone

The Region::Clone method makes a copy of this Regionobject and returns the address of the new Regionobject.
Region::Complement

The Region::Complement method updates this region to the portion of the specified path's interior that does not intersect this region.
Region::Complement

The Region::Complement method updates a region that does not intersect this region.
Region::Complement

The Region::Complement method updates this region to the portion of the specified rectangle's interior that does not intersect this region.
Region::Complement

The Region::Complement method updates this region to the portion of another region that does not intersect this region.
Region::Equals

The Region::Equals method determines whether this region is equal to a specified region.
Region::Exclude

The Region::Exclude method updates this region to the portion of itself that does not intersect the specified path's interior.
Region::Exclude

The Region::Exclude method updates a region that does not intersect the specified rectangle's interior.
Region::Exclude

The Region::Exclude method updates this region to the portion of itself that does not intersect the specified rectangle's interior.
Region::Exclude

The Region::Exclude method updates this region to the portion of itself that does not intersect another region.
Region::FromHRGN

The Region::FromHRGN method creates a Windows GDI+Region object from a Windows Graphics Device Interface (GDI)  region.
Region::GetBounds

The Region::GetBounds method gets a rectangle that encloses this region. (overload 2/2)
Region::GetBounds

The Region::GetBounds method gets a rectangle that encloses this region. (overload 1/2)
Region::GetData

The Region::GetData method gets data that describes this region.
Region::GetDataSize

The Region::GetDataSize method gets the number of bytes of data that describes this region.
Region::GetHRGN

The Region::GetHRGN method creates a Windows Graphics Device Interface (GDI) region from this region.
Region::GetLastStatus

The Region::GetLastStatus method returns a value that indicates the nature of this Regionobject's most recent method failure.
Region::GetRegionScans

The Region::GetRegionScans method gets an array of rectangles that approximate this region. The region is transformed by a specified matrix before the rectangles are calculated.
Region::GetRegionScans

The Region::GetRegionScans method gets an array of rectangles that approximate this region.
Region::GetRegionScansCount

The Region::GetRegionScansCount method gets the number of rectangles that approximate this region. The region is transformed by a specified matrix before the rectangles are calculated.
Region::Intersect

The Region::Intersect method updates this region to the portion of itself that intersects the specified path's interior.
Region::Intersect

The Region::Intersect method updates a region intersects the specified rectangle's interior.
Region::Intersect

The Region::Intersect method updates this region to the portion of itself that intersects the specified rectangle's interior.
Region::Intersect

The Region::Intersect method updates this region to the portion of itself that intersects another region.
Region::IsEmpty

The Region::IsEmpty method determines whether this region is empty.
Region::IsInfinite

The Region::IsInfinite method determines whether this region is infinite.
Region::IsVisible

The Region::IsVisible method determines whether a point is inside this region. (overload 1/4)
Region::IsVisible

The Region::IsVisible method determines whether a point is inside this region. (overload 4/4)
Region::IsVisible

The Region::IsVisible method determines whether a rectangle intersects this region. (overload 2/4)
Region::IsVisible

The Region::IsVisible method determines whether a rectangle intersects this region. (overload 4/4)
Region::IsVisible

The Region::IsVisible method determines whether a point is inside this region. (overload 2/4)
Region::IsVisible

The Region::IsVisible method determines whether a rectangle intersects this region. (overload 3/4)
Region::IsVisible

The Region::IsVisible method determines whether a point is inside this region. (overload 3/4)
Region::IsVisible

The Region::IsVisible method determines whether a rectangle intersects this region. (overload 1/4)
Region::MakeEmpty

The Region::MakeEmpty method updates this region to an empty region. In other words, the region occupies no space on the display device.
Region::MakeInfinite

The Region::MakeInfinite method updates this region to an infinite region.
Region::Region

Creates a region that is infinite. This is the default constructor. (Region.Region)
Region::Region

Creates a region that is defined by data obtained from another region.
Region::Region

Creates a region that is defined by a path (a GraphicsPath object) and has a fill mode that is contained in the GraphicsPath object.
Region::Region

Creates a region that is defined by a rectangle. (overload 1/2)
Region::Region

Creates a region that is defined by a rectangle. (overload 2/2)
Region::Region

Creates a region that is infinite. This is the default constructor. (overload 2/3)
Region::Region

Creates a region that is infinite. This is the default constructor. (overload 1/3)
Region::Region

Creates a region that is identical to the region that is specified by a handle to a Windows Graphics Device Interface (GDI) region.
Region::Transform

The Region::Transform method transforms this region by multiplying each of its data points by a specified matrix.
Region::Translate

The Region::Translate method offsets this region by specified amounts in the horizontal and vertical directions. (overload 1/2)
Region::Translate

The Region::Translate method offsets this region by specified amounts in the horizontal and vertical directions. (overload 2/2)
Region::Union

The Region::Union method updates this region to all portions (intersecting and nonintersecting) of itself and all portions of the specified path's interior.
Region::Union

The Region::Union method updates this region.
Region::Union

The Region::Union method updates this region to all portions (intersecting and nonintersecting) of itself and all portions of the specified rectangle's interior.
Region::Union

The Region::Union method updates this region to all portions (intersecting and nonintersecting) of itself and all portions of another region.
Region::Xor

The Region::Xor method updates this region to the nonintersecting portions of itself and the specified path's interior.
Region::Xor

The Region::Xor method updates a region to the nonintersecting portions with a rectangle's interior.
Region::Xor

The Region::Xor method updates this region to the nonintersecting portions of itself and the specified rectangle's interior.
Region::Xor

The Region::Xor method updates this region to the nonintersecting portions of itself and another region.

Remarks

A GDI+ region is stored in world coordinates whereas a GDI region is stored in device coordinates. Therefore, a GDI+ region is scalable and a GDI region is not. For more information, see the Scalable Regions section in New Features.

An application can use regions to clip the output of drawing operations. The Window Manager uses regions to define the drawing area of windows. These regions are called clipping regions. An application can also use regions in hit-testing operations, such as checking whether a point is in a region or whether a rectangle intersects a region. For more information, see Regions, Clipping, and Using Regions.

Requirements

   
Target Platform Windows
Header gdiplusheaders.h