Graphics.GetHdc Yöntem

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

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

Kaynak:

Graphics.cs

Bu Graphicsile ilişkili cihaz bağlamı tutamacını alır.

public:
 virtual IntPtr GetHdc();

public IntPtr GetHdc ();

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

Public Function GetHdc () As IntPtr

Döndürülenler

IntPtr

nativeint

bu Graphicsile ilişkilendirilmiş cihaz bağlamını işle.

Uygulamalar

GetHdc()

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Örnekte, GDI+ Graphics yöntemiyle aynı görevi gerçekleştirmek için Bir Windows GDI işlevini çağırma gösterilmektedir. Kod aşağıdaki eylemleri gerçekleştirir:

• gdi32.dllWindows DLL dosyası için birlikte çalışabilirlik DllImportAttribute özniteliğini tanımlar. Bu DLL istenen GDI işlevini içerir.

• Bu DLL'deki Rectangle işlevini dış olarak tanımlar.

• Kırmızı kalem oluşturur.

• Kalemle, GDI+ DrawRectangle yöntemini kullanarak ekrana bir dikdörtgen çizer.

• hdc bir iç işaretçi türü değişkeni tanımlar ve değerini formun cihaz bağlamı için tanıtıcıya ayarlar.

• GDI Rectangle işlevini kullanarak ekrana bir dikdörtgen çizer.

• hdc parametresiyle temsil edilen cihaz bağlamını serbest bırakır.

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

Açıklamalar

Cihaz bağlamı, bir dizi grafik nesne ve bunların ilişkili özniteliklerinin yanı sıra çıkışı etkileyen grafik modlarını tanımlayan GDI'yi temel alan bir Windows yapısıdır. Bu yöntem, bir yazı tipi dışında bu cihaz bağlamını döndürür. Yazı tipi seçilmediğinden, GetHdc yönteminden döndürülen bir tanıtıcı kullanarak FromHdc yöntemine yapılan çağrılar başarısız olur.

GetHdc ve ReleaseHdc yöntemlerine yapılan çağrılar çiftler halinde görünmelidir. bir GetHdc ve ReleaseHdc yöntem çifti kapsamında genellikle yalnızca GDI işlevlerine çağrı yaparsınız. hdc parametresini oluşturan Graphics GDI+ yöntemlerine yapılan bu kapsamdaki çağrılar ObjectBusy hatasıyla başarısız olur. Ayrıca GDI+, sonraki işlemlerde hdc parametresinin Graphics yapılan durum değişikliklerini yoksayar.