Region.Xor Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Updates this Region object to the union minus the intersection of itself with the specified GraphicsPath object.

Overloads

Xor(GraphicsPath)	Updates this Region to the union minus the intersection of itself with the specified GraphicsPath.
Xor(Rectangle)	Updates this Region to the union minus the intersection of itself with the specified Rectangle structure.
Xor(RectangleF)	Updates this Region to the union minus the intersection of itself with the specified RectangleF structure.
Xor(Region)	Updates this Region to the union minus the intersection of itself with the specified Region.

Xor(GraphicsPath)

Source:

Region.cs

Updates this Region to the union minus the intersection of itself with the specified GraphicsPath.

C#

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

Parameters

path

GraphicsPath

The GraphicsPath to Xor with this Region.

Exceptions

ArgumentNullException

path is null.

Examples

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

Xor(Rectangle)

Source:

Region.cs

Updates this Region to the union minus the intersection of itself with the specified Rectangle structure.

C#

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

Parameters

rect

Rectangle

The Rectangle structure to Xor with this Region.

Examples

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

Xor(RectangleF)

Source:

Region.cs

Updates this Region to the union minus the intersection of itself with the specified RectangleF structure.

C#

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

Parameters

rect

RectangleF

The RectangleF structure to Xor(GraphicsPath) with this Region.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. 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 Xor area for myRegion when combined with complementRect.

• Fills the Xor area with blue and draws it to the screen.

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

C#

public void XorExample(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 xorRect = new RectangleF(90, 30, 100, 100);
    e.Graphics.DrawRectangle(Pens.Red,
        Rectangle.Round(xorRect));
             
    // Create a region using the first rectangle.
    Region myRegion = new Region(regionRect);
             
    // Get the area of overlap for myRegion when combined with
             
    // complementRect.
    myRegion.Xor(xorRect);
             
    // Fill the Xor area of myRegion with blue.
    SolidBrush myBrush = new SolidBrush(Color.Blue);
    e.Graphics.FillRegion(myBrush, myRegion);
}

Xor(Region)

Source:

Region.cs

Updates this Region to the union minus the intersection of itself with the specified Region.

C#

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

Parameters

region

Region

The Region to Xor with this Region.

Exceptions

ArgumentNullException

region is null.

Examples

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