Graphics.ReleaseHdc Metodo

Definizione

Rilascia un handle per contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

Overload

ReleaseHdc()

Rilascia un handle per contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

ReleaseHdc(IntPtr)

Rilascia un handle per contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

ReleaseHdc()

Rilascia un handle per contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

public:
 virtual void ReleaseHdc();
public void ReleaseHdc ();
abstract member ReleaseHdc : unit -> unit
override this.ReleaseHdc : unit -> unit
Public Sub ReleaseHdc ()

Implementazioni

Commenti

GetHdce ReleaseHdc sono due metodi che consentono di ottenere e rilasciare l'handle per un dispositivo Windows.GetHdc and ReleaseHdc are two methods that allow you to get and release the handle for a Windows device. È sempre necessario seguire una chiamata a GetHdc con una chiamata a ReleaseHdc al termine dell'handle di Windows.You should always follow a call to GetHdc with a call to ReleaseHdc when you are finished with the Windows handle.

Sicurezza

SecurityPermission
per l'accesso al codice non gestito.for access to unmanaged code. Enumerazione correlata UnmanagedCode:.Related enumeration: UnmanagedCode.

Vedi anche

ReleaseHdc(IntPtr)

Rilascia un handle per contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.Releases a device context handle obtained by a previous call to the GetHdc() method of this 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

Handle per un contesto di dispositivo ottenuto da una precedente chiamata al metodo GetHdc() di questo oggetto Graphics.Handle to a device context obtained by a previous call to the GetHdc() method of this Graphics.

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nell'esempio viene illustrata la chiamata GDIGDI di una funzione di Windows per eseguire la GDI+GDI+ stessa attività di un Graphics metodo.The example illustrates calling a Windows GDIGDI function to perform the same task as a GDI+GDI+ Graphics method. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Definisce l'attributo di DllImportAttribute interoperabilità per il file dll di Windows gdi32. dll.Defines the interoperability DllImportAttribute attribute for the Windows DLL file gdi32.dll. Questa dll contiene la funzione GDIGDI desiderata e definisce la Rectangle funzione nella dll come esterna.This DLL contains the desired GDIGDI function, and it defines the Rectangle function in that DLL as external.

  • Crea una penna rossa.Creates a red pen.

  • Con la penna, disegna un rettangolo sullo schermo usando il GDI+GDI+ DrawRectangle metodo.With the pen, draws a rectangle to the screen using the GDI+GDI+ DrawRectangle method.

  • Definisce una variabile hdc di tipo puntatore interna e imposta il relativo valore sull'handle per il contesto di dispositivo del modulo.Defines an internal pointer type variable hdc and sets its value to the handle to the device context of the form.

  • Disegna un rettangolo sullo schermo utilizzando la GDIGDI Rectangle funzione.Draws a rectangle to the screen using the GDIGDI Rectangle function.

  • Rilascia il contesto di dispositivo rappresentato dal hdc parametro.Releases the device context represented by the hdc parameter.

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

[System.Security.Permissions.SecurityPermission(
System.Security.Permissions.SecurityAction.LinkDemand, Flags = 
System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)]            
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 GDIGDI basata su che definisce un set di oggetti grafici e i relativi attributi associati, oltre alle modalità grafiche che influiscono sull'output.The device context is a Windows structure based on GDIGDI that defines a set of graphical objects and their associated attributes, as well as the graphical modes that affect output.

Le GetHdc chiamate ai metodi ReleaseHdc e devono essere visualizzate in coppie.Calls to the GetHdc and ReleaseHdc methods must appear in pairs. Durante l'ambito di una GetHdc coppia ReleaseHdc di metodi e, in genere si effettuano GDIGDI chiamate solo alle funzioni.During the scope of a GetHdc and ReleaseHdc method pair, you usually make calls only to GDIGDI functions. Le chiamate in tale ambito apportate GDI+GDI+ ai Graphics metodi dell'oggetto hdc che ha generato il ObjectBusy parametro hanno esito negativo e generano un errore.Calls in that scope made to GDI+GDI+ methods of the Graphics that produced the hdc parameter fail with an ObjectBusy error. Ignora inoltre eventuali modifiche di stato apportate all' Graphics oggetto del hdc parametro nelle operazioni successive. GDI+GDI+Also, GDI+GDI+ ignores any state changes made to the Graphics of the hdc parameter in subsequent operations.

Sicurezza

SecurityPermission
per l'accesso al codice non gestito.for access to unmanaged code. Enumerazione correlata UnmanagedCode:.Related enumeration: UnmanagedCode.

Si applica a