Region Constructors

Reference

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Package:: System.Drawing.Common v10.0.0-preview.1.25080.3

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Initializes a new Region.

Overloads

Region()	Initializes a new Region.
Region(GraphicsPath)	Initializes a new Region with the specified GraphicsPath.
Region(RegionData)	Initializes a new Region from the specified data.
Region(Rectangle)	Initializes a new Region from the specified Rectangle structure.
Region(RectangleF)	Initializes a new Region from the specified RectangleF structure.

Region()

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Initializes a new Region.

public:
 Region();

public Region();

Public Sub New ()

Remarks

This constructor initializes a new Region with an infinite interior.

Applies to

.NET 10 (package-provided) и други версии

Продукт	Версии
.NET	8 (package-provided), 9 (package-provided), 10 (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, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Region(GraphicsPath)

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Initializes a new Region with the specified GraphicsPath.

public:
 Region(System::Drawing::Drawing2D::GraphicsPath ^ path);

public Region(System.Drawing.Drawing2D.GraphicsPath path);

new System.Drawing.Region : System.Drawing.Drawing2D.GraphicsPath -> System.Drawing.Region

Public Sub New (path As GraphicsPath)

Parameters

path: GraphicsPath

A GraphicsPath that defines the new Region.

Exceptions

ArgumentNullException

path is null.

Remarks

This method creates a new Region with a GraphicsPath. The new region is defined as the interior of the GraphicsPath specified by the path parameter.

Applies to

.NET 10 (package-provided) и други версии

Продукт	Версии
.NET	8 (package-provided), 9 (package-provided), 10 (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, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Region(RegionData)

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Initializes a new Region from the specified data.

public:
 Region(System::Drawing::Drawing2D::RegionData ^ rgnData);

public Region(System.Drawing.Drawing2D.RegionData rgnData);

new System.Drawing.Region : System.Drawing.Drawing2D.RegionData -> System.Drawing.Region

Public Sub New (rgnData As RegionData)

Parameters

rgnData: RegionData

A RegionData that defines the interior of the new Region.

Exceptions

ArgumentNullException

rgnData is null.

Remarks

This method creates a new Region with an interior defined by an existing Region. The rgnData parameter is an array that contains the definition of an existing Region.

Applies to

.NET 10 (package-provided) и други версии

Продукт	Версии
.NET	8 (package-provided), 9 (package-provided), 10 (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, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Region(Rectangle)

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Initializes a new Region from the specified Rectangle structure.

public:
 Region(System::Drawing::Rectangle rect);

public Region(System.Drawing.Rectangle rect);

new System.Drawing.Region : System.Drawing.Rectangle -> System.Drawing.Region

Public Sub New (rect As Rectangle)

Parameters

rect: Rectangle

A Rectangle structure that defines the interior of the new Region.

Examples

The following code example demonstrates how to use the Region constructor and MakeEmpty method. This example is designed to be used with Windows Forms. Create a form and paste the following code into it. Call the FillEmptyRegion method in the form's Paint event-handling method, passing e as PaintEventArgs.

private:
   void FillEmptyRegion( PaintEventArgs^ e )
   {
      // Create a region from a rectangle.
      Rectangle originalRectangle = Rectangle(40,40,40,50);
      System::Drawing::Region^ smallRegion = gcnew System::Drawing::Region( originalRectangle );

      // Call MakeEmpty.
      smallRegion->MakeEmpty();

      // Fill the region in red and draw the original rectangle
      // in black. Note there is nothing filled in.
      e->Graphics->FillRegion( Brushes::Red, smallRegion );
      e->Graphics->DrawRectangle( Pens::Black, originalRectangle );
   }

private void FillEmptyRegion(PaintEventArgs e)
{

    // Create a region from a rectangle.
    Rectangle originalRectangle = new Rectangle(40, 40, 40, 50);
    Region smallRegion = new Region(originalRectangle);

    // Call MakeEmpty.
    smallRegion.MakeEmpty();

    // Fill the region in red and draw the original rectangle
    // in black. Note there is nothing filled in.
    e.Graphics.FillRegion(Brushes.Red, smallRegion);
    e.Graphics.DrawRectangle(Pens.Black, originalRectangle);
}

Private Sub FillEmptyRegion(ByVal e As PaintEventArgs)

    ' Create a region from a rectangle.
    Dim originalRectangle As New Rectangle(40, 40, 40, 50)
    Dim smallRegion As New Region(originalRectangle)

    ' Call MakeEmpty.
    smallRegion.MakeEmpty()

    ' Fill the region in red and draw the original rectangle
    ' in black. Note there is nothing filled in.
    e.Graphics.FillRegion(Brushes.Red, smallRegion)
    e.Graphics.DrawRectangle(Pens.Black, originalRectangle)

End Sub

Remarks

This method creates a new Region with a rectangular interior. The interior is defined by the rect parameter.

Applies to

.NET 10 (package-provided) и други версии

Продукт	Версии
.NET	8 (package-provided), 9 (package-provided), 10 (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, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Region(RectangleF)

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Source:: Region.cs

Initializes a new Region from the specified RectangleF structure.

public:
 Region(System::Drawing::RectangleF rect);

public Region(System.Drawing.RectangleF rect);

new System.Drawing.Region : System.Drawing.RectangleF -> System.Drawing.Region

Public Sub New (rect As RectangleF)

Parameters

rect: RectangleF

A RectangleF structure that defines the interior of the new Region.

Remarks

This method creates a new Region with a rectangular interior. The interior is defined by the rect parameter.

Applies to

.NET 10 (package-provided) и други версии

Продукт	Версии
.NET	8 (package-provided), 9 (package-provided), 10 (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, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Споделяне чрез

Region Constructors

Definition

Overloads

Region()

Remarks

Applies to

Region(GraphicsPath)

Parameters

Exceptions

Remarks

Applies to

Region(RegionData)

Parameters

Exceptions

Remarks

Applies to

Region(Rectangle)

Parameters

Examples

Remarks

Applies to

Region(RectangleF)

Parameters

Remarks

Applies to

Допълнителни ресурси