Graphics.GetHdc Metode

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.5.24306.5

Sumber:

Graphics.cs

Mendapatkan handel ke konteks perangkat yang terkait dengan Graphicsini.

public:
 virtual IntPtr GetHdc();

public IntPtr GetHdc ();

abstract member GetHdc : unit -> nativeint
override this.GetHdc : unit -> nativeint

Public Function GetHdc () As IntPtr

Mengembalikan

IntPtr

nativeint

Tangani ke konteks perangkat yang terkait dengan Graphicsini .

Penerapan

GetHdc()

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Windows Forms, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan aktivitas Paint. Contoh ini mengilustrasikan panggilan fungsi GDI Windows untuk melakukan tugas yang sama dengan metode Graphics GDI+. Kode melakukan tindakan berikut:

• Menentukan atribut DllImportAttribute interoperabilitas untuk file Dll Windows gdi32.dll. DLL ini berisi fungsi GDI yang diinginkan.

• Menentukan fungsi Rectangle di DLL tersebut sebagai eksternal.

• Membuat pena merah.

• Dengan pena, menggambar persegi panjang ke layar menggunakan metode DrawRectangle GDI+.

• Menentukan variabel jenis pointer internal hdc dan mengatur nilainya ke handel ke konteks perangkat formulir.

• Menggambar persegi panjang ke layar menggunakan fungsi Rectangle GDI.

• Merilis konteks perangkat yang diwakili oleh parameter hdc.

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

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

Keterangan

Konteks perangkat adalah struktur Windows berdasarkan GDI yang mendefinisikan sekumpulan objek grafis dan atribut terkaitnya, serta mode grafis yang memengaruhi output. Metode ini mengembalikan konteks perangkat tersebut dengan pengecualian font. Karena font tidak dipilih, panggilan ke metode FromHdc menggunakan handel yang dikembalikan dari metode GetHdc akan gagal.

Panggilan ke metode GetHdc dan ReleaseHdc harus muncul berpasangan. Selama cakupan pasangan metode GetHdc dan ReleaseHdc, Anda biasanya hanya melakukan panggilan ke fungsi GDI. Panggilan dalam cakupan yang dilakukan ke metode GDI+ dari Graphics yang menghasilkan parameter hdc gagal dengan kesalahan ObjectBusy. Selain itu, GDI+ mengabaikan perubahan status apa pun yang dilakukan pada Graphics parameter hdc dalam operasi berikutnya.