Graphics.GetHdc Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

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

Source:

Graphics.cs

Obtient le handle du contexte d’appareil associé à cette Graphics.

public:
 virtual IntPtr GetHdc();

public IntPtr GetHdc ();

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

Public Function GetHdc () As IntPtr

Retours

IntPtr

nativeint

Gérez le contexte de l’appareil associé à cette Graphics.

Implémente

GetHdc()

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 gestionnaire d’événements Paint. L’exemple illustre l’appel d’une fonction GDI Windows pour effectuer la même tâche qu’une méthode Graphics GDI+. Le code effectue les actions suivantes :

• Définit l’attribut d’interopérabilité DllImportAttribute du fichier DLL Windows gdi32.dll. Cette DLL contient la fonction GDI souhaitée.

• Définit la fonction Rectangle dans cette DLL comme externe.

• Crée un stylet rouge.

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

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

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

• Libère le contexte de l’appareil représenté par le paramètre 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

Remarques

Le contexte de l’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. Cette méthode retourne ce contexte d’appareil à l’exception d’une police. Étant donné qu’une police n’est pas sélectionnée, les appels à la méthode FromHdc à l’aide d’un handle retourné par la méthode GetHdc échouent.

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