Graphics.ReleaseHdc Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Rilascia un handle per un contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.

Overload

ReleaseHdc()	Rilascia un handle per un contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.
ReleaseHdc(IntPtr)	Rilascia un handle per un contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.

ReleaseHdc()

Origine:

Graphics.cs

Rilascia un handle per un contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.

public:
 virtual void ReleaseHdc();

public void ReleaseHdc ();

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

Public Sub ReleaseHdc ()

Implementazioni

ReleaseHdc()

Commenti

GetHdc e ReleaseHdc sono due metodi che consentono di ottenere e rilasciare l'handle per un dispositivo Windows. Devi sempre seguire una chiamata a GetHdc con una chiamata a ReleaseHdc quando sei finito con l'handle di Windows.

Vedi anche

• IDeviceContext

ReleaseHdc(IntPtr)

Origine:

Graphics.cs

Rilascia un handle per un contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.

public:
 void ReleaseHdc(IntPtr hdc);

public void ReleaseHdc (IntPtr hdc);

member this.ReleaseHdc : nativeint -> unit

Public Sub ReleaseHdc (hdc As IntPtr)

Parametri

hdc

IntPtr

nativeint

Handle per un contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. 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 e definisce la Rectangle funzione 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 hdc interno e ne imposta il valore sull'handle sul contesto di dispositivo del modulo.

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

• Rilascia il contesto di dispositivo rappresentato dal hdc parametro .

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

Commenti

Il contesto di 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.

Le chiamate ai GetHdc metodi e ReleaseHdc devono essere visualizzate in coppie. Durante l'ambito di una GetHdc coppia di metodi e ReleaseHdc , in genere, si effettuano chiamate solo alle funzioni GDI. Le chiamate in tale ambito effettuate ai metodi GDI+ dell'oggetto Graphics che ha generato il hdc parametro hanno esito negativo con un ObjectBusy errore. GDI+ ignora inoltre tutte le modifiche apportate allo Graphics stato del hdc parametro nelle operazioni successive.