문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문
이 설명서는 보관되지만 유지 되지 않습니다.

Region 클래스

사각형과 경로로 구성된 그래픽 모양의 내부를 설명합니다. 이 클래스는 상속될 수 없습니다.

네임스페이스:  System.Drawing
어셈블리:  System.Drawing(System.Drawing.dll)

public sealed class Region : MarshalByRefObject, 
	IDisposable

Region 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드Region()Region을 초기화합니다.
Public 메서드Region(GraphicsPath)지정된 GraphicsPath가 있는 새 Region을 초기화합니다.
Public 메서드Region(Rectangle)지정된 Rectangle 구조체에서 새 Region을 초기화합니다.
Public 메서드Region(RectangleF)지정된 RectangleF 구조체에서 새 Region을 초기화합니다.
Public 메서드Region(RegionData)지정된 데이터에서 새 Region을 초기화합니다.
위쪽

  이름설명
Public 메서드CloneRegion과 정확하게 일치하는 복사본을 만듭니다.
Public 메서드Complement(GraphicsPath) Region 과 교차하지 않는 지정된 GraphicsPath의 일부가 들어 있는 이 Region을 업데이트합니다.
Public 메서드Complement(Rectangle) Region 과 교차하지 않는 지정된 Rectangle 구조체의 일부가 들어 있는 이 Region을 업데이트합니다.
Public 메서드Complement(RectangleF) Region 과 교차하지 않는 지정된 RectangleF 구조체의 일부가 들어 있는 이 Region을 업데이트합니다.
Public 메서드Complement(Region) Region 과 교차하지 않는 지정된 Region의 일부가 들어 있는 이 Region을 업데이트합니다.
Public 메서드CreateObjRef원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (MarshalByRefObject에서 상속됨)
Public 메서드Dispose Region 에서 사용하는 모든 리소스를 해제합니다.
Public 메서드Equals(Object)지정한 Object가 현재 Object와 같은지 여부를 확인합니다. (Object에서 상속됨)
Public 메서드Equals(Region, Graphics)지정된 Region이 지정된 그리기 화면에 있는 이 Region과 같은지 여부를 테스트합니다.
Public 메서드Exclude(GraphicsPath)지정된 GraphicsPath와 교차하지 않는 이 개체 내부의 일부만 들어 있는 이 Region을 업데이트합니다.
Public 메서드Exclude(Rectangle)지정된 Rectangle 구조체와 교차하지 않는 이 개체 내부의 일부만 들어 있는 이 Region을 업데이트합니다.
Public 메서드Exclude(RectangleF)지정된 RectangleF 구조체와 교차하지 않는 이 개체 내부의 일부만 들어 있는 이 Region을 업데이트합니다.
Public 메서드Exclude(Region)지정된 Region와 교차하지 않는 이 개체 내부의 일부만 들어 있는 이 Region을 업데이트합니다.
Protected 메서드Finalize 개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드정적 멤버FromHrgn핸들에서 지정된 기존 GDI 영역으로 새 Region을 초기화합니다.
Public 메서드GetBounds Graphics 개체의 그리기 화면에서 이 Region의 경계가 되는 사각형을 나타내는 RectangleF 구조체를 가져옵니다.
Public 메서드GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드GetHrgn지정된 그래픽 컨텍스트에서 Region에 대한 창 핸들을 반환합니다.
Public 메서드GetLifetimeService이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (MarshalByRefObject에서 상속됨)
Public 메서드GetRegionData Region 을 설명하는 정보를 나타내는 RegionData를 반환합니다.
Public 메서드GetRegionScans지정된 매트릭스 변환을 적용한 후 이 Region과 유사한 RectangleF 구조체 배열을 반환합니다.
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드InitializeLifetimeService이 인스턴스의 수명 정책을 제어하기 위한 수명 서비스 개체를 가져옵니다. (MarshalByRefObject에서 상속됨)
Public 메서드Intersect(GraphicsPath)지정된 GraphicsPath와 교차되게 이 Region을 업데이트합니다.
Public 메서드Intersect(Rectangle)지정된 Rectangle 구조체와 교차되게 이 Region을 업데이트합니다.
Public 메서드Intersect(RectangleF)지정된 RectangleF 구조체와 교차되게 이 Region을 업데이트합니다.
Public 메서드Intersect(Region)지정된 Region와 교차되게 이 Region을 업데이트합니다.
Public 메서드IsEmpty지정된 그리기 화면에서 이 Region의 내부가 비었는지 여부를 테스트합니다.
Public 메서드IsInfinite지정된 그리기 화면에서 이 Region의 내부 제한이 없는지 여부를 테스트합니다.
Public 메서드IsVisible(Point)지정된 Point 구조체가 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(PointF)지정된 PointF 구조체가 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(Rectangle)지정된 Rectangle 구조체의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(RectangleF)지정된 RectangleF 구조체의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(Point, Graphics)지정된 Graphics를 사용하여 그릴 때 지정된 Point 구조체가 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(PointF, Graphics)지정된 Graphics를 사용하여 그릴 때 지정된 PointF 구조체가 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(Rectangle, Graphics)지정된 Graphics를 사용하여 그릴 때 지정된 Rectangle 구조체의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(RectangleF, Graphics)지정된 Graphics를 사용하여 그릴 때 지정된 RectangleF 구조체의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(Single, Single)지정된 점이 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(Int32, Int32, Graphics)지정된 Graphics 개체를 사용하여 그릴 때 지정된 점이 이 Region 개체에 들어 있는지 여부를 검사합니다.
Public 메서드IsVisible(Single, Single, Graphics)지정된 Graphics를 사용하여 그릴 때 지정된 점이 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(Int32, Int32, Int32, Int32)지정된 사각형의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(Single, Single, Single, Single)지정된 사각형의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(Int32, Int32, Int32, Int32, Graphics)지정된 Graphics를 사용하여 그릴 때 지정된 사각형의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드IsVisible(Single, Single, Single, Single, Graphics)지정된 Graphics를 사용하여 그릴 때 지정된 사각형의 일부라도 이 Region에 들어 있는지 여부를 테스트합니다.
Public 메서드MakeEmpty Region 을 빈 내부로 초기화합니다.
Public 메서드MakeInfiniteRegion 개체를 제한이 없는 내부로 초기화합니다.
Protected 메서드MemberwiseClone()현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Protected 메서드MemberwiseClone(Boolean)현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (MarshalByRefObject에서 상속됨)
Public 메서드ReleaseHrgn Region 의 핸들을 해제합니다.
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
Public 메서드Transform지정된 Matrix로 이 Region을 변환합니다.
Public 메서드Translate(Int32, Int32)지정된 크기로 이 Region의 좌표를 오프셋합니다.
Public 메서드Translate(Single, Single)지정된 크기로 이 Region의 좌표를 오프셋합니다.
Public 메서드Union(GraphicsPath)지정된 GraphicsPath와 통합되게 이 Region을 업데이트합니다.
Public 메서드Union(Rectangle)지정된 Rectangle 구조체와 통합되게 이 Region을 업데이트합니다.
Public 메서드Union(RectangleF)지정된 RectangleF 구조체와 통합되게 이 Region을 업데이트합니다.
Public 메서드Union(Region)지정된 Region과 통합되게 이 Region을 업데이트합니다.
Public 메서드Xor(GraphicsPath)교차 부분을 제외하고 지정된 GraphicsPath와 통합되게 이 Region을 업데이트합니다.
Public 메서드Xor(Rectangle)교차 부분을 제외하고 지정된 Rectangle 구조체와 통합되게 이 Region을 업데이트합니다.
Public 메서드Xor(RectangleF)교차 부분을 제외하고 지정된 RectangleF 구조체와 통합되게 이 Region을 업데이트합니다.
Public 메서드Xor(Region)교차 부분을 제외하고 지정된 Region과 통합되게 이 Region을 업데이트합니다.
위쪽

영역의 좌표가 영역 좌표로 지정되어 있기 때문에 스케일이 가능합니다. 그러나 그리기 화면에서 내부는 그림을 나타내는 픽셀의 크기와 모양에 따라 달라집니다. 응용 프로그램은 영역을 사용하여 그리기 작업의 출력을 클리핑할 수 있습니다. 이 영역을 클리핑 영역이라고 합니다. 클리핑에 대해 영역을 사용하는 방법에 대한 자세한 내용은 방법: 영역을 사용하여 클리핑을 참조하십시오.

또한 응용 프로그램은 점이나 사각형이 영역을 교차하는지 여부의 확인과 같은 적중 테스트 작업에서 영역을 사용합니다. 적중 횟수 테스트에 대해 영역을 사용하는 방법에 대한 자세한 내용은 방법: 영역을 사용하여 적중 테스트을 참조하십시오.

응용 프로그램은 Graphics.FillRegion 메서드와 Brush 개체를 사용하여 영역을 채울 수 있습니다.

다음 코드 예제는 Windows Forms에서 사용해야 하며, 여기에는 Paint 이벤트 처리기의 매개 변수인 PaintEventArgse가 필요합니다. 코드 예제에서는 한 RegionData 개체에서 Data를 사용하여 다른 RegionDataData를 설정하는 방법을 보여 줍니다.


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();

}


.NET Framework

4, 3.5, 3.0, 2.0, 1.1, 1.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

Windows 7, Windows Vista SP1 이상, Windows XP SP3, Windows XP SP2 x64 버전, Windows Server 2008(Server Core는 지원되지 않음), Windows Server 2008 R2(Server Core는 SP1 이상에서 지원됨), Windows Server 2003 SP2

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.
표시: