Graphics.GetHdc 메서드

정의

Graphics와 관련된 디바이스 컨텍스트에 대한 핸들을 가져옵니다.Gets the handle to the device context associated with this Graphics.

public:
 virtual IntPtr GetHdc();
public:
 IntPtr GetHdc();
public IntPtr GetHdc ();
abstract member GetHdc : unit -> nativeint
override this.GetHdc : unit -> nativeint
member this.GetHdc : unit -> nativeint
Public Function GetHdc () As IntPtr

반환

IntPtr

Graphics와 관련된 디바이스 컨텍스트에 대한 핸들입니다.Handle to the device context associated with 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 GDI 함수를 호출 하 여 GDI + 메서드와 동일한 작업을 수행 하는 방법을 보여 줍니다 Graphics .The example illustrates calling a Windows GDI function to perform the same task as a GDI+ Graphics method. 코드는 다음 작업을 수행합니다.The code performs the following actions:

  • DllImportAttributegdi32.dll WINDOWS DLL 파일에 대 한 상호 운용성 특성을 정의 합니다.Defines the interoperability DllImportAttribute attribute for the Windows DLL file gdi32.dll. 이 DLL에는 원하는 GDI 함수가 포함 되어 있습니다.This DLL contains the desired GDI function.

  • Rectangle해당 DLL의 함수를 외부로 정의 합니다.Defines the Rectangle function in that DLL as external.

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

  • 펜을 사용 하 여 GDI + 메서드를 사용 하 여 화면에 사각형을 그립니다 DrawRectangle .With the pen, draws a rectangle to the screen using the 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.

  • GDI 함수를 사용 하 여 화면에 사각형을 그립니다 Rectangle .Draws a rectangle to the screen using the GDI Rectangle function.

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

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

public:
   void GetHdcForGDI1( 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.
      Rectangle( hdc, 10, 70, 110, 120 );

      // Release handle to device context.
      e->Graphics->ReleaseHdc( hdc );
   }
public class GDI
{
    [System.Runtime.InteropServices.DllImport("gdi32.dll")]
    internal static extern bool Rectangle(
       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 GetHdcForGDI1(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.
    GDI.Rectangle(hdc, 10, 70, 110, 120);

    // Release handle to device context.
    e.Graphics.ReleaseHdc(hdc);
}
Public Class GDI
    <System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")> _
    Friend Shared Function Rectangle(ByVal hdc As IntPtr, _
    ByVal ulCornerX As Integer, ByVal ulCornerY As Integer, ByVal lrCornerX As Integer, _
    ByVal lrCornerY As Integer) As Boolean
    End Function
End Class

<System.Security.Permissions.SecurityPermission( _
System.Security.Permissions.SecurityAction.LinkDemand, Flags:= _
System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Private Sub GetHdcForGDI1(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.
    GDI.Rectangle(hdc, 10, 70, 110, 120)

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

설명

장치 컨텍스트는 그래픽 개체 및 관련 특성 집합을 정의 하는 GDI 기반 Windows 구조와 출력에 영향을 주는 그래픽 모드입니다.The device context is a Windows structure based on GDI that defines a set of graphical objects and their associated attributes, as well as the graphical modes that affect output. 이 메서드는 글꼴을 제외 하 고 해당 디바이스 컨텍스트를 반환합니다.This method returns that device context with the exception of a font. 글꼴을 선택 하지 않았기 때문에 FromHdc 메서드에서 반환 된 핸들을 사용 하 여 메서드를 호출 하면 GetHdc 오류가 발생 합니다.Because a font is not selected, calls to the FromHdc method using a handle returned from the GetHdc method will fail.

GetHdc및 메서드에 대 한 호출은 ReleaseHdc 쌍으로 표시 되어야 합니다.Calls to the GetHdc and ReleaseHdc methods must appear in pairs. 및 메서드 쌍의 범위 중에는 GetHdc ReleaseHdc 일반적으로 GDI 함수를 호출 하기만 하면 됩니다.During the scope of a GetHdc and ReleaseHdc method pair, you usually make only calls to GDI functions. 매개 변수를 생성 한의 GDI + 메서드에 적용 된 해당 범위의 호출은 Graphics hdc 오류로 인해 실패 ObjectBusy 합니다.Calls in that scope made to GDI+ methods of the Graphics that produced the hdc parameter fail with an ObjectBusy error. 또한 GDI +는 Graphics hdc 후속 작업에서 매개 변수의에 적용 된 모든 상태 변경을 무시 합니다.Also, GDI+ ignores any state changes made to the Graphics of the hdc parameter in subsequent operations.

적용 대상