Graphics.ReleaseHdc 메서드

정의

네임스페이스:

System.Drawing

어셈블리:

System.Drawing.Common.dll

패키지:

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

이 GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.

오버로드

ReleaseHdc()	이 GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.
ReleaseHdc(IntPtr)	이 GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.

ReleaseHdc()

Source:

Graphics.cs

이 GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.

public:
 virtual void ReleaseHdc();

public void ReleaseHdc ();

abstract member ReleaseHdc : unit -> unit
override this.ReleaseHdc : unit -> unit

Public Sub ReleaseHdc ()

구현

ReleaseHdc()

설명

GetHdc 및 ReleaseHdc Windows 디바이스에 대한 핸들을 가져오고 해제할 수 있는 두 가지 방법입니다. Windows 핸들을 마쳤으면 항상 ReleaseHdc 호출로 GetHdc 호출을 따라야 합니다.

추가 정보

• IDeviceContext

ReleaseHdc(IntPtr)

Source:

Graphics.cs

이 GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.

public:
 void ReleaseHdc(IntPtr hdc);

public void ReleaseHdc (IntPtr hdc);

member this.ReleaseHdc : nativeint -> unit

Public Sub ReleaseHdc (hdc As IntPtr)

매개 변수

hdc

IntPtr

nativeint

이 GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트에 대한 핸들입니다.

예제

다음 코드 예제는 Windows Forms에서 사용하도록 설계되었으며 Paint 이벤트 처리기의 매개 변수인 PaintEventArgse필요합니다. 이 예제에서는 GDI+ Graphics 메서드와 동일한 작업을 수행하기 위해 Windows GDI 함수를 호출하는 방법을 보여 줍니다. 코드는 다음 작업을 수행합니다.

• Windows DLL 파일 gdi32.dll대한 상호 운용성 DllImportAttribute 특성을 정의합니다. 이 DLL은 원하는 GDI 함수를 포함하며 해당 DLL의 Rectangle 함수를 외부로 정의합니다.

• 빨간색 펜을 만듭니다.

• 펜을 사용하여 GDI+ DrawRectangle 메서드를 사용하여 화면에 사각형을 그립니다.

• 내부 포인터 형식 변수 hdc 정의하고 해당 값을 폼의 디바이스 컨텍스트에 대한 핸들로 설정합니다.

• GDI Rectangle 함수를 사용하여 화면에 사각형을 그립니다.

• hdc 매개 변수가 나타내는 디바이스 컨텍스트를 해제합니다.

private:
   [System::Runtime::InteropServices::DllImportAttribute("gdi32.dll")]
   static bool Rectangle2( IntPtr hdc, int ulCornerX, int ulCornerY, int lrCornerX, int lrCornerY );

public:
   void GetHdcForGDI2( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ redPen = gcnew Pen( Color::Red,1.0f );

      // Draw rectangle with GDI+.
      e->Graphics->DrawRectangle( redPen, 10, 10, 100, 50 );

      // Get handle to device context.
      IntPtr hdc = e->Graphics->GetHdc();

      // Draw rectangle with GDI using default pen.
      Rectangle2( hdc, 10, 70, 110, 120 );

      // Release handle to device context.
      e->Graphics->ReleaseHdc( hdc );
   }

[System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")]
private static extern bool Rectangle2(
    IntPtr hdc,
    int ulCornerX, int ulCornerY,
    int lrCornerX, int lrCornerY);

private void GetHdcForGDI2(PaintEventArgs e)
{
    // Create pen.
    Pen redPen = new Pen(Color.Red, 1);

    // Draw rectangle with GDI+.
    e.Graphics.DrawRectangle(redPen, 10, 10, 100, 50);

    // Get handle to device context.
    IntPtr hdc = e.Graphics.GetHdc();

    // Draw rectangle with GDI using default pen.
    Rectangle2(hdc, 10, 70, 110, 120);

    // Release handle to device context.
    e.Graphics.ReleaseHdc(hdc);
}

<System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")> _
Private Shared Function Rectangle2(ByVal hdc As IntPtr, _
ByVal ulCornerX As Integer, ByVal ulCornerY As Integer, ByVal lrCornerX As Integer, _
ByVal lrCornerY As Integer) As Boolean
End Function

<System.Security.Permissions.SecurityPermission( _
System.Security.Permissions.SecurityAction.LinkDemand, Flags:= _
System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Private Sub GetHdcForGDI2(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim redPen As New Pen(Color.Red, 1)

    ' Draw rectangle with GDI+.
    e.Graphics.DrawRectangle(redPen, 10, 10, 100, 50)

    ' Get handle to device context.
    Dim hdc As IntPtr = e.Graphics.GetHdc()

    ' Draw rectangle with GDI using default pen.
    Rectangle2(hdc, 10, 70, 110, 120)

    ' Release handle to device context.
    e.Graphics.ReleaseHdc(hdc)
End Sub

설명

디바이스 컨텍스트는 출력에 영향을 주는 그래픽 모드뿐만 아니라 그래픽 개체 및 관련 특성 집합을 정의하는 GDI를 기반으로 하는 Windows 구조입니다.

GetHdc 및 ReleaseHdc 메서드에 대한 호출은 쌍으로 표시되어야 합니다. GetHdc 및 ReleaseHdc 메서드 쌍의 범위 동안 일반적으로 GDI 함수만 호출합니다. hdc 매개 변수를 생성한 Graphics GDI+ 메서드에 대한 해당 범위의 호출은 ObjectBusy 오류와 함께 실패합니다. 또한 GDI+는 후속 작업에서 hdc 매개 변수의 Graphics 대한 상태 변경을 무시합니다.