Graphics.GetHdc Methode

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

Gibt zurück

Behandeln Sie den diesem Zugeordneten GraphicsGerätekontext.

Implementiert

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des ereignishandlers Paint handelt. Das Beispiel veranschaulicht das Aufrufen einer Windows GDI-Funktion, um dieselbe Aufgabe wie eine GDI+ Graphics-Methode auszuführen. Der Code führt die folgenden Aktionen aus:

• Definiert das Interoperabilitäts-attribut DllImportAttribute für die Windows DLL-Datei gdi32.dll. Diese DLL enthält die gewünschte GDI-Funktion.

• Definiert die Funktion in dieser Rectangle DLL als extern.

• Erstellt einen roten Stift.

• Zeichnet mit dem Stift ein Rechteck mit der GDI+ DrawRectangle -Methode auf den Bildschirm.

• Definiert eine interne Zeigertypvariable hdc und legt seinen Wert auf das Handle auf den Gerätekontext des Formulars fest.

• Zeichnet ein Rechteck mithilfe der GDI-Funktion Rectangle auf dem Bildschirm.

• Gibt den durch den hdc Parameter dargestellten Gerätekontext frei.

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

Hinweise

Der Gerätekontext ist eine Windows Struktur basierend auf GDI, die einen Satz grafischer Objekte und der zugehörigen Attribute definiert, sowie die grafischen Modi, die sich auf die Ausgabe auswirken. Diese Methode gibt den Gerätekontext mit Ausnahme einer Schriftart zurück. Da keine Schriftart ausgewählt ist, schlagen Aufrufe der FromHdc Methode mit einem von der GetHdc Methode zurückgegebenen Handle fehl.

Aufrufe der GetHdc Und ReleaseHdc Methoden müssen in Paaren angezeigt werden. Während des Bereichs eines GetHdc Methodenpaars ReleaseHdc führen Sie in der Regel nur Aufrufe an GDI-Funktionen durch. Aufrufe in diesem Bereich an GDI+-Methoden der Graphics erzeugten hdc Parameter schlagen mit einem ObjectBusy Fehler fehl. Außerdem ignoriert GDI+ alle Zustandsänderungen, die an dem Graphicshdc Parameter in nachfolgenden Vorgängen vorgenommen wurden.