Graphics.GetHdc Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v9.0.0-rc.2.24474.1

Origine:

Graphics.cs

Ottiene l'handle per il contesto di dispositivo associato a questo Graphics.

public:
 virtual IntPtr GetHdc();

public IntPtr GetHdc ();

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

Public Function GetHdc () As IntPtr

Restituisce

IntPtr

nativeint

Handle per il contesto di dispositivo associato a questo Graphics.

Implementazioni

GetHdc()

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. L'esempio illustra la chiamata di una funzione GDI di Windows per eseguire la stessa attività di un metodo GDI+ Graphics. Il codice esegue le azioni seguenti:

• Definisce l'attributo di interoperabilità DllImportAttribute per il file DLL di Windows gdi32.dll. Questa DLL contiene la funzione GDI desiderata.

• Definisce la funzione Rectangle in tale DLL come esterna.

• Crea una penna rossa.

• Con la penna, disegna un rettangolo sullo schermo usando il metodo GDI+ DrawRectangle.

• Definisce una variabile di tipo puntatore interno hdc e ne imposta il valore sull'handle sul contesto di dispositivo del modulo.

• Disegna un rettangolo sullo schermo usando la funzione di Rectangle GDI.

• Rilascia il contesto di dispositivo rappresentato dal parametro 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

Commenti

Il contesto del dispositivo è una struttura di Windows basata su GDI che definisce un set di oggetti grafici e i relativi attributi associati, nonché le modalità grafiche che influiscono sull'output. Questo metodo restituisce il contesto del dispositivo ad eccezione di un tipo di carattere. Poiché un tipo di carattere non è selezionato, le chiamate al metodo FromHdc utilizzando un handle restituito dal metodo GetHdc avranno esito negativo.

Le chiamate ai metodi GetHdc e ReleaseHdc devono essere visualizzate in coppie. Durante l'ambito di una coppia di metodi GetHdc e ReleaseHdc, in genere si effettuano solo chiamate alle funzioni GDI. Le chiamate nell'ambito effettuate ai metodi GDI+ del Graphics che ha generato il parametro hdc hanno esito negativo con un errore di ObjectBusy. GDI+ ignora inoltre qualsiasi modifica dello stato apportata al Graphics del parametro hdc nelle operazioni successive.