Region Region Region Region Class

정의

사각형과 경로로 구성된 그래픽 모양의 내부를 설명합니다.Describes the interior of a graphics shape composed of rectangles and paths. 이 클래스는 상속될 수 없습니다.This class cannot be inherited.

public ref class Region sealed : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Region : MarshalByRefObject, IDisposable
type Region = class
    inherit MarshalByRefObject
    interface IDisposable
Public NotInheritable Class Region
Inherits MarshalByRefObject
Implements IDisposable
상속
특성
구현

예제

다음 코드 예제는 Windows Forms에서 사용 하도록 설계 되었으며 필요 PaintEventArgs e의 매개 변수는 Paint 이벤트 처리기입니다.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 코드 예제에 사용 하는 방법을 보여 줍니다.는 Data 간에 RegionData 설정 하는 개체를 Data 다른 RegionData.The code example demonstrates how to use the Data from one RegionData object to set the Data for another RegionData.

private:
   void DemonstrateRegionData2( PaintEventArgs^ e )
   {
      //Create a simple region.
      System::Drawing::Region^ region1 = gcnew System::Drawing::Region( Rectangle(10,10,100,100) );

      // Extract the region data.
      System::Drawing::Drawing2D::RegionData^ region1Data = region1->GetRegionData();
      array<Byte>^data1;
      data1 = region1Data->Data;

      // Create a second region.
      System::Drawing::Region^ region2 = gcnew System::Drawing::Region;

      // Get the region data for the second region.
      System::Drawing::Drawing2D::RegionData^ region2Data = region2->GetRegionData();

      // Set the Data property for the second region to the Data from the first region.
      region2Data->Data = data1;

      // Construct a third region using the modified RegionData of the second region.
      System::Drawing::Region^ region3 = gcnew System::Drawing::Region( region2Data );

      // Dispose of the first and second regions.
      delete region1;
      delete region2;

      // Call ExcludeClip passing in the third region.
      e->Graphics->ExcludeClip( region3 );

      // Fill in the client rectangle.
      e->Graphics->FillRectangle( Brushes::Red, this->ClientRectangle );
      delete region3;
   }
private void DemonstrateRegionData2(PaintEventArgs e)
{

    //Create a simple region.
    Region region1 = new Region(new Rectangle(10, 10, 100, 100));

    // Extract the region data.
    System.Drawing.Drawing2D.RegionData region1Data = region1.GetRegionData();
    byte[] data1;
    data1 = region1Data.Data;

    // Create a second region.
    Region region2 = new Region();

    // Get the region data for the second region.
    System.Drawing.Drawing2D.RegionData region2Data = region2.GetRegionData();

    // Set the Data property for the second region to the Data from the first region.
    region2Data.Data = data1;

    // Construct a third region using the modified RegionData of the second region.
    Region region3 = new Region(region2Data);

    // Dispose of the first and second regions.
    region1.Dispose();
    region2.Dispose();

    // Call ExcludeClip passing in the third region.
    e.Graphics.ExcludeClip(region3);

    // Fill in the client rectangle.
    e.Graphics.FillRectangle(Brushes.Red, this.ClientRectangle);

    region3.Dispose();

}
Private Sub DemonstrateRegionData2(ByVal e As PaintEventArgs)

    'Create a simple region.
    Dim region1 As New Region(New Rectangle(10, 10, 100, 100))

    ' Extract the region data.
    Dim region1Data As System.Drawing.Drawing2D.RegionData = region1.GetRegionData
    Dim data1() As Byte
    data1 = region1Data.Data

    ' Create a second region.
    Dim region2 As New Region

    ' Get the region data for the second region.
    Dim region2Data As System.Drawing.Drawing2D.RegionData = region2.GetRegionData()

    ' Set the Data property for the second region to the Data from the first region.
    region2Data.Data = data1

    ' Construct a third region using the modified RegionData of the second region.
    Dim region3 As New Region(region2Data)

    ' Dispose of the first and second regions.
    region1.Dispose()
    region2.Dispose()

    ' Call ExcludeClip passing in the third region.
    e.Graphics.ExcludeClip(region3)

    ' Fill in the client rectangle.
    e.Graphics.FillRectangle(Brushes.Red, Me.ClientRectangle)

    region3.Dispose()

End Sub

설명

좌표가 영역 좌표에서 지정 된 때문에 지역 확장성이 뛰어납니다.A region is scalable because its coordinates are specified in world coordinates. 그러나가 그리기 화면에서 해당 내부 크기 및 모양을 나타내는 픽셀의 종속 되어 있습니다.On a drawing surface, however, its interior is dependent on the size and shape of the pixels representing it. 애플리케이션에는 그리기 작업의 출력에 맞추는 지역을 사용할 수 있습니다.An application can use regions to clip the output of drawing operations. 이러한 지역 클리핑 영역 이라고 합니다.These regions are called clipping regions. 영역을 사용 하 여 클리핑에 대 한 자세한 내용은 참조 하세요. 방법: 사용 하 여 지역 클리핑합니다.For more information on using regions for clipping, see How to: Use Clipping with a Region.

애플리케이션의 점 또는 사각형 영역을 교차 하는지 여부를 확인 하는 등의 적중 테스트 작업 영역을 사용할 수도 있습니다.An application can also use regions in hit-testing operations, such as checking whether a point or a rectangle intersects a region. 영역을 사용 하 여 적중 테스트에 대 한 자세한 내용은 참조 하세요. 방법: 사용 하 여 적중 테스트 영역합니다.For more information on using regions for hit-testing, see How to: Use Hit Testing with a Region.

애플리케이션 사용 하 여 영역을 채울 수는 Graphics.FillRegion 메서드 및 Brush 개체입니다.An application can fill a region by using the Graphics.FillRegion method and a Brush object.

생성자

Region() Region() Region() Region()

Region를 초기화합니다.Initializes a new Region.

Region(GraphicsPath) Region(GraphicsPath) Region(GraphicsPath) Region(GraphicsPath)

지정된 GraphicsPath을 사용하여 새 Region를 초기화합니다.Initializes a new Region with the specified GraphicsPath.

Region(Rectangle) Region(Rectangle) Region(Rectangle) Region(Rectangle)

지정된 Region 구조체에서 새 Rectangle을 초기화합니다.Initializes a new Region from the specified Rectangle structure.

Region(RectangleF) Region(RectangleF) Region(RectangleF) Region(RectangleF)

지정된 Region 구조체에서 새 RectangleF을 초기화합니다.Initializes a new Region from the specified RectangleF structure.

Region(RegionData) Region(RegionData) Region(RegionData) Region(RegionData)

지정된 데이터에서 새 Region을 초기화합니다.Initializes a new Region from the specified data.

메서드

Clone() Clone() Clone() Clone()

Region의 정확한 복사본을 만듭니다.Creates an exact copy of this Region.

Complement(GraphicsPath) Complement(GraphicsPath) Complement(GraphicsPath) Complement(GraphicsPath)

Region과 교차하지 않는 지정된 GraphicsPath의 일부를 포함하도록 이 Region을 업데이트합니다.Updates this Region to contain the portion of the specified GraphicsPath that does not intersect with this Region.

Complement(Rectangle) Complement(Rectangle) Complement(Rectangle) Complement(Rectangle)

Region과 교차하지 않는 지정된 Rectangle 구조체의 일부가 들어 있는 이 Region을 업데이트합니다.Updates this Region to contain the portion of the specified Rectangle structure that does not intersect with this Region.

Complement(RectangleF) Complement(RectangleF) Complement(RectangleF) Complement(RectangleF)

Region과 교차하지 않는 지정된 RectangleF 구조체의 일부가 들어 있는 이 Region을 업데이트합니다.Updates this Region to contain the portion of the specified RectangleF structure that does not intersect with this Region.

Complement(Region) Complement(Region) Complement(Region) Complement(Region)

Region과 교차하지 않는 지정된 Region의 일부를 포함하도록 이 Region을 업데이트합니다.Updates this Region to contain the portion of the specified Region that does not intersect with this Region.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Region에서 사용하는 리소스를 모두 해제합니다.Releases all resources used by this Region.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Equals(Region, Graphics) Equals(Region, Graphics) Equals(Region, Graphics) Equals(Region, Graphics)

지정된 Region이 지정된 그리기 화면에 있는 이 Region과 같은지 여부를 테스트합니다.Tests whether the specified Region is identical to this Region on the specified drawing surface.

Exclude(GraphicsPath) Exclude(GraphicsPath) Exclude(GraphicsPath) Exclude(GraphicsPath)

지정된 Region와 교차하지 않는 이 개체 내부의 일부만 들어 있는 이 GraphicsPath을 업데이트합니다.Updates this Region to contain only the portion of its interior that does not intersect with the specified GraphicsPath.

Exclude(Rectangle) Exclude(Rectangle) Exclude(Rectangle) Exclude(Rectangle)

지정된 Region 구조체와 교차하지 않는 이 개체 내부의 일부만 들어 있는 이 Rectangle을 업데이트합니다.Updates this Region to contain only the portion of its interior that does not intersect with the specified Rectangle structure.

Exclude(RectangleF) Exclude(RectangleF) Exclude(RectangleF) Exclude(RectangleF)

지정된 Region 구조체와 교차하지 않는 이 개체 내부의 일부만 들어 있는 이 RectangleF을 업데이트합니다.Updates this Region to contain only the portion of its interior that does not intersect with the specified RectangleF structure.

Exclude(Region) Exclude(Region) Exclude(Region) Exclude(Region)

지정된 Region와 교차하지 않는 이 개체 내부의 일부만 들어 있는 이 Region을 업데이트합니다.Updates this Region to contain only the portion of its interior that does not intersect with the specified Region.

Finalize() Finalize() Finalize() Finalize()

가비지 컬렉션이 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

FromHrgn(IntPtr) FromHrgn(IntPtr) FromHrgn(IntPtr) FromHrgn(IntPtr)

핸들에서 지정된 기존 GDIGDI 영역으로 새 Region을 초기화합니다.Initializes a new Region from a handle to the specified existing GDIGDI region.

GetBounds(Graphics) GetBounds(Graphics) GetBounds(Graphics) GetBounds(Graphics)

RectangleF 개체의 그리기 화면에서 이 Region의 경계가 되는 사각형을 나타내는 Graphics 구조체를 가져옵니다.Gets a RectangleF structure that represents a rectangle that bounds this Region on the drawing surface of a Graphics object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetHrgn(Graphics) GetHrgn(Graphics) GetHrgn(Graphics) GetHrgn(Graphics)

지정된 그래픽 컨텍스트에서 Region에 대한 창 핸들을 반환합니다.Returns a Windows handle to this Region in the specified graphics context.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetRegionData() GetRegionData() GetRegionData() GetRegionData()

RegionData을 설명하는 정보를 나타내는 Region를 반환합니다.Returns a RegionData that represents the information that describes this Region.

GetRegionScans(Matrix) GetRegionScans(Matrix) GetRegionScans(Matrix) GetRegionScans(Matrix)

지정된 매트릭스 변환을 적용한 후 이 RectangleF과 유사한 Region 구조체 배열을 반환합니다.Returns an array of RectangleF structures that approximate this Region after the specified matrix transformation is applied.

GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Intersect(GraphicsPath) Intersect(GraphicsPath) Intersect(GraphicsPath) Intersect(GraphicsPath)

Region을 지정된 GraphicsPath의 교차 부분으로 업데이트합니다.Updates this Region to the intersection of itself with the specified GraphicsPath.

Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle) Intersect(Rectangle)

Region을 지정된 Rectangle 구조의 교차 부분으로 업데이트합니다.Updates this Region to the intersection of itself with the specified Rectangle structure.

Intersect(RectangleF) Intersect(RectangleF) Intersect(RectangleF) Intersect(RectangleF)

Region을 지정된 RectangleF 구조의 교차 부분으로 업데이트합니다.Updates this Region to the intersection of itself with the specified RectangleF structure.

Intersect(Region) Intersect(Region) Intersect(Region) Intersect(Region)

Region을 지정된 Region의 교차 부분으로 업데이트합니다.Updates this Region to the intersection of itself with the specified Region.

IsEmpty(Graphics) IsEmpty(Graphics) IsEmpty(Graphics) IsEmpty(Graphics)

지정된 그리기 화면에서 이 Region의 내부가 비었는지 여부를 테스트합니다.Tests whether this Region has an empty interior on the specified drawing surface.

IsInfinite(Graphics) IsInfinite(Graphics) IsInfinite(Graphics) IsInfinite(Graphics)

지정된 그리기 화면에서 이 Region의 내부 제한이 없는지 여부를 테스트합니다.Tests whether this Region has an infinite interior on the specified drawing surface.

IsVisible(Int32, Int32, Graphics) IsVisible(Int32, Int32, Graphics) IsVisible(Int32, Int32, Graphics) IsVisible(Int32, Int32, Graphics)

지정된 Region 개체를 사용하여 그릴 때 지정된 점이 이 Graphics 개체에 들어 있는지 여부를 검사합니다.Tests whether the specified point is contained within this Region object when drawn using the specified Graphics object.

IsVisible(Int32, Int32, Int32, Int32) IsVisible(Int32, Int32, Int32, Int32) IsVisible(Int32, Int32, Int32, Int32) IsVisible(Int32, Int32, Int32, Int32)

지정된 사각형의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.Tests whether any portion of the specified rectangle is contained within this Region.

IsVisible(Int32, Int32, Int32, Int32, Graphics) IsVisible(Int32, Int32, Int32, Int32, Graphics) IsVisible(Int32, Int32, Int32, Int32, Graphics) IsVisible(Int32, Int32, Int32, Int32, Graphics)

지정된 Region를 사용하여 그릴 때 지정된 사각형의 일부라도 이 Graphics에 들어 있는지 여부를 테스트합니다.Tests whether any portion of the specified rectangle is contained within this Region when drawn using the specified Graphics.

IsVisible(Point) IsVisible(Point) IsVisible(Point) IsVisible(Point)

지정된 Point 구조체가 이 Region에 들어 있는지 여부를 테스트합니다.Tests whether the specified Point structure is contained within this Region.

IsVisible(Point, Graphics) IsVisible(Point, Graphics) IsVisible(Point, Graphics) IsVisible(Point, Graphics)

지정된 Point를 사용하여 그릴 때 지정된 Region 구조체가 이 Graphics에 들어 있는지 여부를 테스트합니다.Tests whether the specified Point structure is contained within this Region when drawn using the specified Graphics.

IsVisible(PointF) IsVisible(PointF) IsVisible(PointF) IsVisible(PointF)

지정된 PointF 구조체가 이 Region에 들어 있는지 여부를 테스트합니다.Tests whether the specified PointF structure is contained within this Region.

IsVisible(PointF, Graphics) IsVisible(PointF, Graphics) IsVisible(PointF, Graphics) IsVisible(PointF, Graphics)

지정된 PointF를 사용하여 그릴 때 지정된 Region 구조체가 이 Graphics에 들어 있는지 여부를 테스트합니다.Tests whether the specified PointF structure is contained within this Region when drawn using the specified Graphics.

IsVisible(Rectangle) IsVisible(Rectangle) IsVisible(Rectangle) IsVisible(Rectangle)

지정된 Rectangle 구조체의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.Tests whether any portion of the specified Rectangle structure is contained within this Region.

IsVisible(Rectangle, Graphics) IsVisible(Rectangle, Graphics) IsVisible(Rectangle, Graphics) IsVisible(Rectangle, Graphics)

지정된 Rectangle를 사용하여 그릴 때 지정된 Region 구조체의 일부라도 이 Graphics에 들어 있는지 여부를 테스트합니다.Tests whether any portion of the specified Rectangle structure is contained within this Region when drawn using the specified Graphics.

IsVisible(RectangleF) IsVisible(RectangleF) IsVisible(RectangleF) IsVisible(RectangleF)

지정된 RectangleF 구조체의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.Tests whether any portion of the specified RectangleF structure is contained within this Region.

IsVisible(RectangleF, Graphics) IsVisible(RectangleF, Graphics) IsVisible(RectangleF, Graphics) IsVisible(RectangleF, Graphics)

지정된 RectangleF를 사용하여 그릴 때 지정된 Region 구조체의 일부라도 이 Graphics에 들어 있는지 여부를 테스트합니다.Tests whether any portion of the specified RectangleF structure is contained within this Region when drawn using the specified Graphics.

IsVisible(Single, Single) IsVisible(Single, Single) IsVisible(Single, Single) IsVisible(Single, Single)

지정된 점이 이 Region에 들어 있는지 여부를 테스트합니다.Tests whether the specified point is contained within this Region.

IsVisible(Single, Single, Graphics) IsVisible(Single, Single, Graphics) IsVisible(Single, Single, Graphics) IsVisible(Single, Single, Graphics)

지정된 Region를 사용하여 그릴 때 지정된 점이 이 Graphics에 들어 있는지 여부를 테스트합니다.Tests whether the specified point is contained within this Region when drawn using the specified Graphics.

IsVisible(Single, Single, Single, Single) IsVisible(Single, Single, Single, Single) IsVisible(Single, Single, Single, Single) IsVisible(Single, Single, Single, Single)

지정된 사각형의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.Tests whether any portion of the specified rectangle is contained within this Region.

IsVisible(Single, Single, Single, Single, Graphics) IsVisible(Single, Single, Single, Single, Graphics) IsVisible(Single, Single, Single, Single, Graphics) IsVisible(Single, Single, Single, Single, Graphics)

지정된 Region를 사용하여 그릴 때 지정된 사각형의 일부라도 이 Graphics에 들어 있는지 여부를 테스트합니다.Tests whether any portion of the specified rectangle is contained within this Region when drawn using the specified Graphics.

MakeEmpty() MakeEmpty() MakeEmpty() MakeEmpty()

Region을 빈 내부로 초기화합니다.Initializes this Region to an empty interior.

MakeInfinite() MakeInfinite() MakeInfinite() MakeInfinite()

Region 개체를 제한이 없는 내부로 초기화합니다.Initializes this Region object to an infinite interior.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ReleaseHrgn(IntPtr) ReleaseHrgn(IntPtr) ReleaseHrgn(IntPtr) ReleaseHrgn(IntPtr)

Region의 핸들을 해제합니다.Releases the handle of the Region.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)
Transform(Matrix) Transform(Matrix) Transform(Matrix) Transform(Matrix)

지정된 Region로 이 Matrix을 변환합니다.Transforms this Region by the specified Matrix.

Translate(Int32, Int32) Translate(Int32, Int32) Translate(Int32, Int32) Translate(Int32, Int32)

지정된 크기로 이 Region의 좌표를 오프셋합니다.Offsets the coordinates of this Region by the specified amount.

Translate(Single, Single) Translate(Single, Single) Translate(Single, Single) Translate(Single, Single)

지정된 크기로 이 Region의 좌표를 오프셋합니다.Offsets the coordinates of this Region by the specified amount.

Union(GraphicsPath) Union(GraphicsPath) Union(GraphicsPath) Union(GraphicsPath)

지정된 Region와 통합되게 이 GraphicsPath을 업데이트합니다.Updates this Region to the union of itself and the specified GraphicsPath.

Union(Rectangle) Union(Rectangle) Union(Rectangle) Union(Rectangle)

지정된 Region 구조체와 통합되게 이 Rectangle을 업데이트합니다.Updates this Region to the union of itself and the specified Rectangle structure.

Union(RectangleF) Union(RectangleF) Union(RectangleF) Union(RectangleF)

지정된 Region 구조체와 통합되게 이 RectangleF을 업데이트합니다.Updates this Region to the union of itself and the specified RectangleF structure.

Union(Region) Union(Region) Union(Region) Union(Region)

지정된 Region와 통합되게 이 Region을 업데이트합니다.Updates this Region to the union of itself and the specified Region.

Xor(GraphicsPath) Xor(GraphicsPath) Xor(GraphicsPath) Xor(GraphicsPath)

교차 부분을 제외하고 지정된 Region와 통합되게 이 GraphicsPath을 업데이트합니다.Updates this Region to the union minus the intersection of itself with the specified GraphicsPath.

Xor(Rectangle) Xor(Rectangle) Xor(Rectangle) Xor(Rectangle)

교차 부분을 제외하고 지정된 Region 구조체와 통합되게 이 Rectangle을 업데이트합니다.Updates this Region to the union minus the intersection of itself with the specified Rectangle structure.

Xor(RectangleF) Xor(RectangleF) Xor(RectangleF) Xor(RectangleF)

교차 부분을 제외하고 지정된 Region 구조체와 통합되게 이 RectangleF을 업데이트합니다.Updates this Region to the union minus the intersection of itself with the specified RectangleF structure.

Xor(Region) Xor(Region) Xor(Region) Xor(Region)

교차 부분을 제외하고 지정된 Region와 통합되게 이 Region을 업데이트합니다.Updates this Region to the union minus the intersection of itself with the specified Region.

적용 대상

추가 정보