Region.Union Method

Definition

Updates this Region to the union of itself and the specified GraphicsPath.

Overloads

Union(GraphicsPath)

Updates this Region to the union of itself and the specified GraphicsPath.

Union(Rectangle)

Updates this Region to the union of itself and the specified Rectangle structure.

Union(RectangleF)

Updates this Region to the union of itself and the specified RectangleF structure.

Union(Region)

Updates this Region to the union of itself and the specified Region.

Union(GraphicsPath)

Source:
Region.cs
Source:
Region.cs
Source:
Region.cs

Updates this Region to the union of itself and the specified GraphicsPath.

public void Union (System.Drawing.Drawing2D.GraphicsPath path);

Parameters

path
GraphicsPath

The GraphicsPath to unite with this Region.

Exceptions

path is null.

Examples

For a code example, see the Union(RectangleF) and Complement(GraphicsPath) methods.

Applies to

.NET 9 (package-provided) og andre versioner
Produkt Versions
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Union(Rectangle)

Source:
Region.cs
Source:
Region.cs
Source:
Region.cs

Updates this Region to the union of itself and the specified Rectangle structure.

public void Union (System.Drawing.Rectangle rect);

Parameters

rect
Rectangle

The Rectangle structure to unite with this Region.

Examples

For a code example, see the Union(RectangleF) method.

Applies to

.NET 9 (package-provided) og andre versioner
Produkt Versions
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Union(RectangleF)

Source:
Region.cs
Source:
Region.cs
Source:
Region.cs

Updates this Region to the union of itself and the specified RectangleF structure.

public void Union (System.Drawing.RectangleF rect);

Parameters

rect
RectangleF

The RectangleF structure to unite with this Region.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e. The code performs the following actions:

  • Creates the first rectangle and draws it to the screen in black.

  • Creates a second rectangle and draws it to the screen in red.

  • Creates a region using the first rectangle.

  • Gets the area of union for myRegion when combined with complementRect.

  • Fills the fills the area of union with blue and draws it to the screen.

Notice that both rectangles are filled with blue, including the area of overlap.

public void Union_RectF_Example(PaintEventArgs e)
{
             
    // Create the first rectangle and draw it to the screen in black.
    Rectangle regionRect = new Rectangle(20, 20, 100, 100);
    e.Graphics.DrawRectangle(Pens.Black, regionRect);
             
    // create the second rectangle and draw it to the screen in red.
    RectangleF unionRect = new RectangleF(90, 30, 100, 100);
    e.Graphics.DrawRectangle(Pens.Red,
        Rectangle.Round(unionRect));
             
    // Create a region using the first rectangle.
    Region myRegion = new Region(regionRect);
             
    // Get the area of union for myRegion when combined with
             
    // complementRect.
    myRegion.Union(unionRect);
             
    // Fill the union area of myRegion with blue.
    SolidBrush myBrush = new SolidBrush(Color.Blue);
    e.Graphics.FillRegion(myBrush, myRegion);
}

Applies to

.NET 9 (package-provided) og andre versioner
Produkt Versions
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Union(Region)

Source:
Region.cs
Source:
Region.cs
Source:
Region.cs

Updates this Region to the union of itself and the specified Region.

public void Union (System.Drawing.Region region);

Parameters

region
Region

The Region to unite with this Region.

Exceptions

region is null.

Examples

For a code example, see the Union(RectangleF) and Complement(GraphicsPath) method.

Applies to

.NET 9 (package-provided) og andre versioner
Produkt Versions
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9