Graphics.BeginContainer 메서드

정의

네임스페이스:

System.Drawing

어셈블리:

System.Drawing.Common.dll

패키지:

System.Drawing.Common v9.0.0-rc.2.24474.1

이 Graphics 현재 상태로 그래픽 컨테이너를 저장하고 새 그래픽 컨테이너를 열고 사용합니다.

오버로드

BeginContainer()	이 Graphics 현재 상태로 그래픽 컨테이너를 저장하고 새 그래픽 컨테이너를 열고 사용합니다.
BeginContainer(Rectangle, Rectangle, GraphicsUnit)	이 Graphics 현재 상태로 그래픽 컨테이너를 저장하고 지정된 배율 변환과 함께 새 그래픽 컨테이너를 열고 사용합니다.
BeginContainer(RectangleF, RectangleF, GraphicsUnit)	이 Graphics 현재 상태로 그래픽 컨테이너를 저장하고 지정된 배율 변환과 함께 새 그래픽 컨테이너를 열고 사용합니다.

BeginContainer()

Source:

Graphics.cs

이 Graphics 현재 상태로 그래픽 컨테이너를 저장하고 새 그래픽 컨테이너를 열고 사용합니다.

public:
 System::Drawing::Drawing2D::GraphicsContainer ^ BeginContainer();

public System.Drawing.Drawing2D.GraphicsContainer BeginContainer ();

member this.BeginContainer : unit -> System.Drawing.Drawing2D.GraphicsContainer

Public Function BeginContainer () As GraphicsContainer

반환

GraphicsContainer

이 메서드는 메서드 호출 시 이 Graphics 상태를 나타내는 GraphicsContainer 반환합니다.

예제

다음 코드 예제는 Windows Forms에서 사용하도록 설계되었으며 Paint 이벤트 처리기의 매개 변수인 PaintEventArgse필요합니다. 코드는 다음 작업을 수행합니다.

• 새 그래픽 컨테이너를 열고 이전 컨테이너를 저장합니다.

• 컨테이너의 세계 좌표를 변환합니다.

• 새 컨테이너의 변환된 좌표에 빨간색 사각형을 채웁니다.

• 새 컨테이너를 닫고 저장된 컨테이너를 복원합니다.

• 저장된 컨테이너의 녹색 사각형(번역되지 않은 좌표)을 채웁니다.

그 결과 동일한 크기의 빨간색 사각형에 덮어지는 녹색 사각형이 생성됩니다.

private:
   void BeginContainerVoid( PaintEventArgs^ e )
   {
      // Begin graphics container.
      GraphicsContainer^ containerState = e->Graphics->BeginContainer();

      // Translate world transformation.
      e->Graphics->TranslateTransform( 100.0F, 100.0F );

      // Fill translated rectangle in container with red.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Red ), 0, 0, 200, 200 );

      // End graphics container.
      e->Graphics->EndContainer( containerState );

      // Fill untransformed rectangle with green.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Green ), 0, 0, 200, 200 );
   }

private void BeginContainerVoid(PaintEventArgs e)
{
    // Begin graphics container.
    GraphicsContainer containerState = e.Graphics.BeginContainer();
             
    // Translate world transformation.
    e.Graphics.TranslateTransform(100.0F, 100.0F);
             
    // Fill translated rectangle in container with red.
    e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0, 0, 200, 200);
             
    // End graphics container.
    e.Graphics.EndContainer(containerState);
             
    // Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(new SolidBrush(Color.Green), 0, 0, 200, 200);
}

Private Sub BeginContainerVoid(ByVal e As PaintEventArgs)

    ' Begin graphics container.
    Dim containerState As GraphicsContainer = _
    e.Graphics.BeginContainer()

    ' Translate world transformation.
    e.Graphics.TranslateTransform(100.0F, 100.0F)

    ' Fill translated rectangle in container with red.
    e.Graphics.FillRectangle(New SolidBrush(Color.Red), 0, 0, 200, 200)

    ' End graphics container.
    e.Graphics.EndContainer(containerState)

    ' Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(New SolidBrush(Color.Green), 0, 0, _
    200, 200)
End Sub

설명

EndContainer 메서드와 함께 이 메서드를 사용하여 중첩된 그래픽 컨테이너를 만듭니다. 그래픽 컨테이너는 변환, 클리핑 영역 및 렌더링 속성과 같은 그래픽 상태를 유지합니다.

Graphics BeginContainer 메서드를 호출하면 Graphics 상태를 보유하는 정보 블록이 스택에 배치됩니다. BeginContainer 메서드는 해당 정보 블록을 식별하는 GraphicsContainer 반환합니다. 식별 개체를 EndContainer 메서드에 전달하면 정보 블록이 스택에서 제거되고 GraphicsBeginContainer 메서드 호출 당시의 상태로 복원하는 데 사용됩니다.

컨테이너를 중첩할 수 있습니다. 즉, EndContainer 메서드를 호출하기 전에 BeginContainer 메서드를 여러 번 호출할 수 있습니다. BeginContainer 메서드를 호출할 때마다 정보 블록이 스택에 배치되고 정보 블록에 대한 GraphicsContainer 받습니다. 이러한 개체 중 하나를 EndContainer 메서드에 전달하면 Graphics 특정 GraphicsContainer반환한 BeginContainer 메서드 호출 당시의 상태로 반환됩니다. 해당 BeginContainer 메서드 호출에 의해 스택에 배치된 정보 블록은 스택에서 제거되고 해당 BeginContainer 메서드 호출 후에 해당 스택에 배치된 모든 정보 블록도 제거됩니다.

Save 메서드에 대한 호출은 BeginContainer 메서드에 대한 호출과 동일한 스택에 정보 블록을 배치합니다. EndContainer 메서드 호출이 BeginContainer 메서드 호출과 쌍을 이루는 것처럼 Restore 메서드 호출은 Save 메서드 호출과 쌍을 이릅니다.

EndContainer 메서드를 호출하면 BeginContainer 메서드에 대한 해당 호출 후 스택에 배치된 모든 정보 블록(Save 메서드 또는 BeginContainer 메서드)이 스택에서 제거됩니다. 마찬가지로 Restore 메서드를 호출하면 Save 메서드에 대한 해당 호출 후 스택에 배치된 모든 정보 블록(Save 메서드 또는 BeginContainer 메서드)이 스택에서 제거됩니다.

BeginContainer 메서드에 의해 설정된 그래픽 상태에는 기본 그래픽 상태의 렌더링 품질이 포함됩니다. 메서드를 호출할 때 기존 렌더링 품질 상태가 기본값으로 다시 설정됩니다.

BeginContainer(Rectangle, Rectangle, GraphicsUnit)

Source:

Graphics.cs

이 Graphics 현재 상태로 그래픽 컨테이너를 저장하고 지정된 배율 변환과 함께 새 그래픽 컨테이너를 열고 사용합니다.

public:
 System::Drawing::Drawing2D::GraphicsContainer ^ BeginContainer(System::Drawing::Rectangle dstrect, System::Drawing::Rectangle srcrect, System::Drawing::GraphicsUnit unit);

public System.Drawing.Drawing2D.GraphicsContainer BeginContainer (System.Drawing.Rectangle dstrect, System.Drawing.Rectangle srcrect, System.Drawing.GraphicsUnit unit);

member this.BeginContainer : System.Drawing.Rectangle * System.Drawing.Rectangle * System.Drawing.GraphicsUnit -> System.Drawing.Drawing2D.GraphicsContainer

Public Function BeginContainer (dstrect As Rectangle, srcrect As Rectangle, unit As GraphicsUnit) As GraphicsContainer

매개 변수

dstrect

Rectangle

srcrect 매개 변수와 함께 컨테이너에 대한 크기 조정 변환을 지정하는 Rectangle 구조체입니다.

srcrect

Rectangle

dstrect 매개 변수와 함께 컨테이너에 대한 크기 조정 변환을 지정하는 Rectangle 구조체입니다.

unit

GraphicsUnit

컨테이너의 측정 단위를 지정하는 GraphicsUnit 열거형의 멤버입니다.

반환

GraphicsContainer

이 메서드는 메서드 호출 시 이 Graphics 상태를 나타내는 GraphicsContainer 반환합니다.

예제

다음 코드 예제는 Windows Forms에서 사용하도록 설계되었으며 Paint 이벤트 처리기의 매개 변수인 PaintEventArgse필요합니다. 코드는 다음 작업을 수행합니다.

• 새 컨테이너에 대한 배율 변환을 지정하는 두 개의 사각형을 만듭니다.

• 새 그래픽 컨테이너를 열고 이전 컨테이너를 저장합니다.

• 새 컨테이너의 크기 조정된 좌표에 빨간색 사각형을 채웁니다.

• 새 컨테이너를 닫고 저장된 컨테이너를 복원합니다.

• 저장된 컨테이너의 녹색 사각형(크기가 조정되지 않은 좌표)을 채웁니다.

그 결과 작은 빨간색 사각형의 기초가 되는 녹색 사각형이 생성됩니다.

private:
   void BeginContainerRectangle( PaintEventArgs^ e )
   {
      // Define transformation for container.
      Rectangle srcRect = Rectangle(0,0,200,200);
      Rectangle destRect = Rectangle(100,100,150,150);

      // Begin graphics container.
      GraphicsContainer^ containerState = e->Graphics->BeginContainer( destRect, srcRect, GraphicsUnit::Pixel );

      // Fill red rectangle in container.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Red ), 0, 0, 200, 200 );

      // End graphics container.
      e->Graphics->EndContainer( containerState );

      // Fill untransformed rectangle with green.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Green ), 0, 0, 200, 200 );
   }

private void BeginContainerRectangle(PaintEventArgs e)
{
    // Define transformation for container.
    Rectangle srcRect = new Rectangle(0, 0, 200, 200);
    Rectangle destRect = new Rectangle(100, 100, 150, 150);
             
    // Begin graphics container.
    GraphicsContainer containerState = e.Graphics.BeginContainer(
        destRect, srcRect,
        GraphicsUnit.Pixel);
             
    // Fill red rectangle in container.
    e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0, 0, 200, 200);
             
    // End graphics container.
    e.Graphics.EndContainer(containerState);
             
    // Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(new SolidBrush(Color.Green), 0, 0, 200, 200);
}

Private Sub BeginContainerRectangle(ByVal e As PaintEventArgs)

    ' Define transformation for container.
    Dim srcRect As New Rectangle(0, 0, 200, 200)
    Dim destRect As New Rectangle(100, 100, 150, 150)

    ' Begin graphics container.
    Dim containerState As GraphicsContainer = _
    e.Graphics.BeginContainer(destRect, srcRect, GraphicsUnit.Pixel)

    ' Fill red rectangle in container.
    e.Graphics.FillRectangle(New SolidBrush(Color.Red), 0, 0, 200, 200)

    ' End graphics container.
    e.Graphics.EndContainer(containerState)

    ' Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(New SolidBrush(Color.Green), 0, 0, _
    200, 200)
End Sub

설명

EndContainer 메서드와 함께 이 메서드를 사용하여 중첩된 그래픽 컨테이너를 만듭니다. 그래픽 컨테이너는 변환, 클리핑 영역 및 렌더링 속성과 같은 그래픽 상태를 유지합니다.

Graphics BeginContainer 메서드를 호출하면 Graphics 상태를 보유하는 정보 블록이 스택에 배치됩니다. BeginContainer 메서드는 해당 정보 블록을 식별하는 GraphicsContainer 반환합니다. 식별 개체를 EndContainer 메서드에 전달하면 정보 블록이 스택에서 제거되고 GraphicsBeginContainer 메서드 호출 당시의 상태로 복원하는 데 사용됩니다.

컨테이너를 중첩할 수 있습니다. 즉, EndContainer 메서드를 호출하기 전에 BeginContainer 메서드를 여러 번 호출할 수 있습니다. BeginContainer 메서드를 호출할 때마다 정보 블록이 스택에 배치되고 정보 블록에 대한 GraphicsContainer 받습니다. 이러한 개체 중 하나를 EndContainer 메서드에 전달하면 Graphics 특정 GraphicsContainer반환한 BeginContainer 메서드 호출 당시의 상태로 반환됩니다. 해당 BeginContainer 메서드 호출에 의해 스택에 배치된 정보 블록은 스택에서 제거되고 해당 BeginContainer 메서드 호출 후에 해당 스택에 배치된 모든 정보 블록도 제거됩니다.

Save 메서드에 대한 호출은 BeginContainer 메서드에 대한 호출과 동일한 스택에 정보 블록을 배치합니다. EndContainer 메서드 호출이 BeginContainer 메서드 호출과 쌍을 이루는 것처럼 Restore 메서드 호출은 Save 메서드 호출과 쌍을 이릅니다.

EndContainer 메서드를 호출하면 BeginContainer 메서드에 대한 해당 호출 후 스택에 배치된 모든 정보 블록(Save 메서드 또는 BeginContainer 메서드)이 스택에서 제거됩니다. 마찬가지로 Restore 메서드를 호출하면 Save 메서드에 대한 해당 호출 후 스택에 배치된 모든 정보 블록(Save 메서드 또는 BeginContainer 메서드)이 스택에서 제거됩니다.

이 메서드는 dstrect 및 srcrect 매개 변수를 사용하여 새 그래픽 컨테이너에 대한 크기 조정 변환을 지정합니다. 소수 자릿수는 srcrect적용할 때 dstrect발생시키는 변환과 같습니다.

BeginContainer 메서드에 의해 설정된 그래픽 상태에는 기본 그래픽 상태의 렌더링 품질이 포함됩니다. 메서드를 호출할 때 기존 렌더링 품질 상태가 기본값으로 다시 설정됩니다.

BeginContainer(RectangleF, RectangleF, GraphicsUnit)

Source:

Graphics.cs

이 Graphics 현재 상태로 그래픽 컨테이너를 저장하고 지정된 배율 변환과 함께 새 그래픽 컨테이너를 열고 사용합니다.

public:
 System::Drawing::Drawing2D::GraphicsContainer ^ BeginContainer(System::Drawing::RectangleF dstrect, System::Drawing::RectangleF srcrect, System::Drawing::GraphicsUnit unit);

public System.Drawing.Drawing2D.GraphicsContainer BeginContainer (System.Drawing.RectangleF dstrect, System.Drawing.RectangleF srcrect, System.Drawing.GraphicsUnit unit);

member this.BeginContainer : System.Drawing.RectangleF * System.Drawing.RectangleF * System.Drawing.GraphicsUnit -> System.Drawing.Drawing2D.GraphicsContainer

Public Function BeginContainer (dstrect As RectangleF, srcrect As RectangleF, unit As GraphicsUnit) As GraphicsContainer

매개 변수

dstrect

RectangleF

srcrect 매개 변수와 함께 새 그래픽 컨테이너에 대한 크기 조정 변환을 지정하는 RectangleF 구조체입니다.

srcrect

RectangleF

dstrect 매개 변수와 함께 새 그래픽 컨테이너에 대한 크기 조정 변환을 지정하는 RectangleF 구조체입니다.

unit

GraphicsUnit

컨테이너의 측정 단위를 지정하는 GraphicsUnit 열거형의 멤버입니다.

반환

GraphicsContainer

이 메서드는 메서드 호출 시 이 Graphics 상태를 나타내는 GraphicsContainer 반환합니다.

예제

다음 코드 예제는 Windows Forms에서 사용하도록 설계되었으며 Paint 이벤트 처리기의 매개 변수인 PaintEventArgse필요합니다. 코드는 다음 작업을 수행합니다.

• 새 컨테이너에 대한 배율 변환을 지정하는 두 개의 사각형을 만듭니다.

• 새 그래픽 컨테이너를 열고 이전 컨테이너를 저장합니다.

• 새 컨테이너의 크기 조정된 좌표에 빨간색 사각형을 채웁니다.

• 새 컨테이너를 닫고 저장된 컨테이너를 복원합니다.

• 저장된 컨테이너의 녹색 사각형(크기가 조정되지 않은 좌표)을 채웁니다.

그 결과 작은 빨간색 사각형의 기초가 되는 녹색 사각형이 생성됩니다.

private:
   void BeginContainerRectangleF( PaintEventArgs^ e )
   {
      // Define transformation for container.
      RectangleF srcRect = RectangleF(0.0F,0.0F,200.0F,200.0F);
      RectangleF destRect = RectangleF(100.0F,100.0F,150.0F,150.0F);

      // Begin graphics container.
      GraphicsContainer^ containerState = e->Graphics->BeginContainer( destRect, srcRect, GraphicsUnit::Pixel );

      // Fill red rectangle in container.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Red ), 0.0F, 0.0F, 200.0F, 200.0F );

      // End graphics container.
      e->Graphics->EndContainer( containerState );

      // Fill untransformed rectangle with green.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Green ), 0.0F, 0.0F, 200.0F, 200.0F );
   }

private void BeginContainerRectangleF(PaintEventArgs e)
{
    // Define transformation for container.
    RectangleF srcRect = new RectangleF(0.0F, 0.0F, 200.0F, 200.0F);
    RectangleF destRect = new RectangleF(100.0F, 100.0F, 150.0F, 150.0F);
             
    // Begin graphics container.
    GraphicsContainer containerState = e.Graphics.BeginContainer(
        destRect, srcRect,
        GraphicsUnit.Pixel);
             
    // Fill red rectangle in container.
    e.Graphics.FillRectangle(new SolidBrush(Color.Red), 0.0F, 0.0F, 200.0F, 200.0F);
             
    // End graphics container.
    e.Graphics.EndContainer(containerState);
             
    // Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(new SolidBrush(Color.Green), 0.0F, 0.0F, 200.0F, 200.0F);
}

Private Sub BeginContainerRectangleF(ByVal e As PaintEventArgs)

    ' Define transformation for container.
    Dim srcRect As New RectangleF(0.0F, 0.0F, 200.0F, 200.0F)
    Dim destRect As New RectangleF(100.0F, 100.0F, 150.0F, 150.0F)

    ' Begin graphics container.
    Dim containerState As GraphicsContainer = _
    e.Graphics.BeginContainer(destRect, srcRect, GraphicsUnit.Pixel)

    ' Fill red rectangle in container.
    e.Graphics.FillRectangle(New SolidBrush(Color.Red), 0.0F, 0.0F, _
    200.0F, 200.0F)

    ' End graphics container.
    e.Graphics.EndContainer(containerState)

    ' Fill untransformed rectangle with green.
    e.Graphics.FillRectangle(New SolidBrush(Color.Green), 0.0F, 0.0F, _
    200.0F, 200.0F)
End Sub

설명

EndContainer 메서드와 함께 이 메서드를 사용하여 중첩된 그래픽 컨테이너를 만듭니다. 그래픽 컨테이너는 변환, 클리핑 영역 및 렌더링 속성과 같은 그래픽 상태를 유지합니다.

Graphics BeginContainer 메서드를 호출하면 Graphics 상태를 보유하는 정보 블록이 스택에 배치됩니다. BeginContainer 메서드는 해당 정보 블록을 식별하는 GraphicsContainer 반환합니다. 식별 개체를 EndContainer 메서드에 전달하면 정보 블록이 스택에서 제거되고 GraphicsBeginContainer 메서드 호출 당시의 상태로 복원하는 데 사용됩니다.

컨테이너를 중첩할 수 있습니다. 즉, EndContainer 메서드를 호출하기 전에 BeginContainer 메서드를 여러 번 호출할 수 있습니다. BeginContainer 메서드를 호출할 때마다 정보 블록이 스택에 배치되고 정보 블록에 대한 GraphicsContainer 받습니다. 이러한 개체 중 하나를 EndContainer 메서드에 전달하면 Graphics 특정 GraphicsContainer반환한 BeginContainer 메서드 호출 당시의 상태로 반환됩니다. 해당 BeginContainer 메서드 호출에 의해 스택에 배치된 정보 블록은 스택에서 제거되고 해당 BeginContainer 메서드 호출 후에 해당 스택에 배치된 모든 정보 블록도 제거됩니다.

Save 메서드에 대한 호출은 BeginContainer 메서드에 대한 호출과 동일한 스택에 정보 블록을 배치합니다. EndContainer 메서드 호출이 BeginContainer 메서드 호출과 쌍을 이루는 것처럼 Restore 메서드 호출은 Save 메서드 호출과 쌍을 이릅니다.

EndContainer 메서드를 호출하면 BeginContainer 메서드에 대한 해당 호출 후 스택에 배치된 모든 정보 블록(Save 메서드 또는 BeginContainer 메서드)이 스택에서 제거됩니다. 마찬가지로 Restore 메서드를 호출하면 Save 메서드에 대한 해당 호출 후 스택에 배치된 모든 정보 블록(Save 메서드 또는 BeginContainer 메서드)이 스택에서 제거됩니다.

이 메서드는 dstrect 및 srcrect 매개 변수를 사용하여 새 그래픽 컨테이너에 대한 크기 조정 변환을 지정합니다. 소수 자릿수는 srcrect적용할 때 dstrect발생시키는 변환과 같습니다.

BeginContainer 메서드에 의해 설정된 그래픽 상태에는 기본 그래픽 상태의 렌더링 품질이 포함됩니다. 메서드를 호출할 때 기존 렌더링 품질 상태가 기본값으로 다시 설정됩니다.