Graphics.ReleaseHdc Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Gibt ein Gerätekontexthandle frei, das durch einen vorherigen Aufruf der GetHdc()-Methode dieses Graphicsabgerufen wurde.

Überlädt

ReleaseHdc()	Gibt ein Gerätekontexthandle frei, das durch einen vorherigen Aufruf der GetHdc()-Methode dieses Graphicsabgerufen wurde.
ReleaseHdc(IntPtr)	Gibt ein Gerätekontexthandle frei, das durch einen vorherigen Aufruf der GetHdc()-Methode dieses Graphicsabgerufen wurde.

ReleaseHdc()

Gibt ein Gerätekontexthandle frei, das durch einen vorherigen Aufruf der GetHdc()-Methode dieses Graphicsabgerufen wurde.

public:
 virtual void ReleaseHdc();

public void ReleaseHdc ();

abstract member ReleaseHdc : unit -> unit
override this.ReleaseHdc : unit -> unit

Public Sub ReleaseHdc ()

Implementiert

ReleaseHdc()

Hinweise

GetHdc und ReleaseHdc sind zwei Methoden, mit denen Sie das Handle für ein Windows-Gerät abrufen und freigeben können. Wenn Sie mit dem Windows-Handle fertig sind, sollten Sie immer einem Aufruf von GetHdc folgen, um ReleaseHdc zu GetHdc.

Weitere Informationen

• IDeviceContext

ReleaseHdc(IntPtr)

Gibt ein Gerätekontexthandle frei, das durch einen vorherigen Aufruf der GetHdc()-Methode dieses Graphicsabgerufen wurde.

public:
 void ReleaseHdc(IntPtr hdc);

public void ReleaseHdc (IntPtr hdc);

member this.ReleaseHdc : nativeint -> unit

Public Sub ReleaseHdc (hdc As IntPtr)

Parameter

hdc

IntPtr

nativeint

Behandeln Sie einen Gerätekontext, der durch einen vorherigen Aufruf der GetHdc()-Methode dieses Graphicsabgerufen wurde.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers 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-DllImportAttribute-Attribut für die Windows-DLL-Datei gdi32.dll. Diese DLL enthält die gewünschte GDI-Funktion und definiert die Rectangle Funktion in dieser DLL als extern.

• Erstellt einen roten Stift.

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

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

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

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

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

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

Hinweise

Der Gerätekontext ist eine Windows-Struktur, die auf GDI basiert, die einen Satz grafischer Objekte und der zugehörigen Attribute definiert, sowie die grafischen Modi, die sich auf die Ausgabe auswirken.

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