Graphics.ReleaseHdc Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Libère un handle vers le contexte de périphérique obtenu lors d’un précédent appel à la méthode GetHdc() de ce Graphics.

Surcharges

ReleaseHdc()	Libère un handle vers le contexte de périphérique obtenu lors d’un précédent appel à la méthode GetHdc() de ce Graphics.
ReleaseHdc(IntPtr)	Libère un handle vers le contexte de périphérique obtenu lors d’un précédent appel à la méthode GetHdc() de ce Graphics.

ReleaseHdc()

Source:

Graphics.cs

Libère un handle vers le contexte de périphérique obtenu lors d’un précédent appel à la méthode GetHdc() de ce Graphics.

public:
 virtual void ReleaseHdc();

public void ReleaseHdc ();

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

Public Sub ReleaseHdc ()

Implémente

ReleaseHdc()

Remarques

GetHdc et ReleaseHdc sont deux méthodes qui vous permettent d’obtenir et de libérer le handle pour un appareil Windows. Vous devez toujours suivre un appel à GetHdc avec un appel à ReleaseHdc lorsque vous avez terminé avec le handle Windows.

Voir aussi

• IDeviceContext

ReleaseHdc(IntPtr)

Source:

Graphics.cs

Libère un handle vers le contexte de périphérique obtenu lors d’un précédent appel à la méthode GetHdc() de ce Graphics.

public:
 void ReleaseHdc(IntPtr hdc);

public void ReleaseHdc (IntPtr hdc);

member this.ReleaseHdc : nativeint -> unit

Public Sub ReleaseHdc (hdc As IntPtr)

Paramètres

hdc

IntPtr

nativeint

Handle vers un contexte de périphérique obtenu lors d'un précédent appel à la méthode GetHdc() de ce Graphics.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du Paint gestionnaire d’événements. L’exemple illustre l’appel d’une fonction GDI Windows pour effectuer la même tâche qu’une méthode GDI+ Graphics . Le code effectue les actions suivantes :

• Définit l’attribut d’interopérabilité DllImportAttribute pour le fichier DLL Windows gdi32.dll. Cette DLL contient la fonction GDI souhaitée et définit la Rectangle fonction dans cette DLL comme externe.

• Crée un stylet rouge.

• Avec le stylet, dessine un rectangle vers l’écran à l’aide de la méthode GDI+ DrawRectangle .

• Définit une variable hdc de type pointeur interne et définit sa valeur sur le handle dans le contexte d’appareil du formulaire.

• Dessine un rectangle vers l’écran à l’aide de la fonction GDI Rectangle .

• Libère le contexte de l’appareil représenté par le hdc paramètre.

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

Remarques

Le contexte d’appareil est une structure Windows basée sur GDI qui définit un ensemble d’objets graphiques et leurs attributs associés, ainsi que les modes graphiques qui affectent la sortie.

Les appels aux GetHdc méthodes et ReleaseHdc doivent apparaître par paires. Pendant l’étendue d’une GetHdc paire de méthodes et ReleaseHdc , vous effectuez généralement des appels uniquement aux fonctions GDI. Les appels dans cette étendue effectués aux méthodes GDI+ du Graphics qui ont produit le hdc paramètre échouent avec une ObjectBusy erreur. En outre, GDI+ ignore les modifications d’état apportées au Graphics du paramètre dans les hdc opérations suivantes.