Graphics.ReleaseHdc Graphics.ReleaseHdc Graphics.ReleaseHdc Graphics.ReleaseHdc Method

정의

GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

오버로드

ReleaseHdc() ReleaseHdc() ReleaseHdc() ReleaseHdc()

GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

ReleaseHdc(IntPtr) ReleaseHdc(IntPtr) ReleaseHdc(IntPtr) ReleaseHdc(IntPtr)

GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

ReleaseHdc() ReleaseHdc() ReleaseHdc() ReleaseHdc()

GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

public:
 virtual void ReleaseHdc();
public void ReleaseHdc ();
abstract member ReleaseHdc : unit -> unit
override this.ReleaseHdc : unit -> unit
Public Sub ReleaseHdc ()

구현

설명

GetHdcReleaseHdc 가져오고 Windows 디바이스에 대 한 핸들을 해제할 수 있도록 하는 두 가지가 있습니다.GetHdc and ReleaseHdc are two methods that allow you to get and release the handle for a Windows device. 에 대 한 호출을 항상 따라야 GetHdc 에 대 한 호출을 사용 하 여 ReleaseHdc Windows 핸들을 사용 하 여 완료 될 때입니다.You should always follow a call to GetHdc with a call to ReleaseHdc when you are finished with the Windows handle.

보안

SecurityPermission
비관리 코드에 액세스 합니다.for access to unmanaged code. 열거형 관련: UnmanagedCode합니다.Related enumeration: UnmanagedCode.

추가 정보

ReleaseHdc(IntPtr) ReleaseHdc(IntPtr) ReleaseHdc(IntPtr) ReleaseHdc(IntPtr)

GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트 핸들을 해제합니다.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

public:
 void ReleaseHdc(IntPtr hdc);
public void ReleaseHdc (IntPtr hdc);
member this.ReleaseHdc : nativeint -> unit
Public Sub ReleaseHdc (hdc As IntPtr)

매개 변수

hdc
IntPtr IntPtr IntPtr IntPtr

GraphicsGetHdc() 메서드에 대한 이전 호출에서 얻은 디바이스 컨텍스트에 대한 핸들입니다.Handle to a device context obtained by a previous call to the GetHdc() method of this Graphics.

예제

다음 코드 예제는 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. 예제는 Windows를 호출 하는 방법을 보여 줍니다 GDIGDI 와 동일한 작업을 수행 하는 함수를 GDI+GDI+ Graphics 메서드.The example illustrates calling a Windows GDIGDI function to perform the same task as a GDI+GDI+ Graphics method. 이 코드에서는 다음 작업을 수행합니다.The code performs the following actions:

  • 상호 운용성 정의 DllImportAttribute Windows DLL 파일 gdi32.dll에 대 한 특성입니다.Defines the interoperability DllImportAttribute attribute for the Windows DLL file gdi32.dll. 이 DLL에 원하는 GDIGDI 기능을 정의 합니다 Rectangle 외부와 해당 DLL에는 함수입니다.This DLL contains the desired GDIGDI function, and it defines the Rectangle function in that DLL as external.

  • 빨간색 펜을 만듭니다.Creates a red pen.

  • 펜으로 사각형을 사용 하 여 화면을 GDI+GDI+ DrawRectangle 메서드.With the pen, draws a rectangle to the screen using the GDI+GDI+ DrawRectangle method.

  • 내부 포인터 형식 변수를 정의 hdc 형식의 디바이스 컨텍스트에 대 한 핸들을 해당 값을 가져오거나 설정 합니다.Defines an internal pointer type variable hdc and sets its value to the handle to the device context of the form.

  • 사각형을 사용 하 여 화면을 GDIGDI Rectangle 함수입니다.Draws a rectangle to the screen using the GDIGDI Rectangle function.

  • 나타내는 디바이스 컨텍스트를 해제 합니다 hdc 매개 변수입니다.Releases the device context represented by the hdc parameter.

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

[System.Security.Permissions.SecurityPermission(
System.Security.Permissions.SecurityAction.LinkDemand, Flags = 
System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)]            
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

설명

디바이스 컨텍스트는 기준으로 Windows 구조를 GDIGDI 출력에 영향을 주는 그래픽 모드 뿐만 아니라 그래픽 개체 및 해당 관련된 특성의 집합을 정의 하는 합니다.The device context is a Windows structure based on GDIGDI that defines a set of graphical objects and their associated attributes, as well as the graphical modes that affect output.

에 대 한 호출을 GetHdcReleaseHdc 메서드 쌍으로 나타나야 합니다.Calls to the GetHdc and ReleaseHdc methods must appear in pairs. 범위에 있는 동안을 GetHdc 하 고 ReleaseHdc 메서드 쌍을 일반적으로 수행한 호출에만 GDIGDI 함수입니다.During the scope of a GetHdc and ReleaseHdc method pair, you usually make calls only to GDIGDI functions. 호출에 대 한 범위에 GDI+GDI+ 의 메서드를 Graphics 시킨를 hdc 매개 변수 실패는 ObjectBusy 오류.Calls in that scope made to GDI+GDI+ methods of the Graphics that produced the hdc parameter fail with an ObjectBusy error. 또한 GDI+GDI+ 상태 변경 내용이 무시 합니다 Graphicshdc 후속 작업에서 매개 변수입니다.Also, GDI+GDI+ ignores any state changes made to the Graphics of the hdc parameter in subsequent operations.

보안

SecurityPermission
비관리 코드에 액세스 합니다.for access to unmanaged code. 열거형 관련: UnmanagedCode합니다.Related enumeration: UnmanagedCode.

적용 대상