Graphics.ReleaseHdc Método

Definición

Libera un identificador de contexto de dispositivo obtenido mediante una llamada anterior al método GetHdc() de este Graphics.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

Sobrecargas

ReleaseHdc()

Libera un identificador de contexto de dispositivo obtenido mediante una llamada anterior al método GetHdc() de este Graphics.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

ReleaseHdc(IntPtr)

Libera un identificador de contexto de dispositivo obtenido mediante una llamada anterior al método GetHdc() de este Graphics.Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

ReleaseHdc()

Libera un identificador de contexto de dispositivo obtenido mediante una llamada anterior al método GetHdc() de este 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 ()

Implementaciones

Comentarios

GetHdcy ReleaseHdc son dos métodos que permiten obtener y liberar el identificador de un dispositivo Windows.GetHdc and ReleaseHdc are two methods that allow you to get and release the handle for a Windows device. Siempre debe seguir una llamada a GetHdc con una llamada a ReleaseHdc cuando haya terminado con el identificador de Windows.You should always follow a call to GetHdc with a call to ReleaseHdc when you are finished with the Windows handle.

Seguridad

SecurityPermission
para el acceso a código no administrado.for access to unmanaged code. Enumeración relacionada: UnmanagedCode.Related enumeration: UnmanagedCode.

Consulte también:

ReleaseHdc(IntPtr)

Libera un identificador de contexto de dispositivo obtenido mediante una llamada anterior al método GetHdc() de este 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)

Parámetros

hdc
IntPtr

Identificador de un contexto de dispositivo obtenido mediante una llamada anterior al método GetHdc() de este Graphics.Handle to a device context obtained by a previous call to the GetHdc() method of this Graphics.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. En el ejemplo se muestra cómo llamar GDIGDI a una función de Windows para realizar la GDI+GDI+ misma tarea que un Graphics método.The example illustrates calling a Windows GDIGDI function to perform the same task as a GDI+GDI+ Graphics method. El código realiza las siguientes acciones:The code performs the following actions:

  • Define el atributo de DllImportAttribute interoperabilidad para el archivo dll de Windows gdi32. dll.Defines the interoperability DllImportAttribute attribute for the Windows DLL file gdi32.dll. Este archivo dll contiene la GDIGDI función deseada y define la Rectangle función en esa dll como externa.This DLL contains the desired GDIGDI function, and it defines the Rectangle function in that DLL as external.

  • Crea un lápiz rojo.Creates a red pen.

  • Con el lápiz, dibuja un rectángulo en la pantalla mediante el GDI+GDI+ DrawRectangle método.With the pen, draws a rectangle to the screen using the GDI+GDI+ DrawRectangle method.

  • Define una variable hdc de tipo de puntero interna y establece su valor en el identificador del contexto de dispositivo del formulario.Defines an internal pointer type variable hdc and sets its value to the handle to the device context of the form.

  • Dibuja un rectángulo en la pantalla mediante la GDIGDI Rectangle función.Draws a rectangle to the screen using the GDIGDI Rectangle function.

  • Libera el contexto de dispositivo representado por hdc el parámetro.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

Comentarios

El contexto de dispositivo es una estructura de Windows GDIGDI basada en que define un conjunto de objetos gráficos y sus atributos asociados, así como los modos gráficos que afectan a la salida.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.

Las llamadas a GetHdc los ReleaseHdc métodos y deben aparecer en pares.Calls to the GetHdc and ReleaseHdc methods must appear in pairs. Durante el ámbito de un GetHdc par ReleaseHdc de métodos y, normalmente solo realiza llamadas a GDIGDI funciones.During the scope of a GetHdc and ReleaseHdc method pair, you usually make calls only to GDIGDI functions. Las llamadas en ese ámbito a GDI+GDI+ los métodos Graphics de que generaron hdc el parámetro generan un ObjectBusy error.Calls in that scope made to GDI+GDI+ methods of the Graphics that produced the hdc parameter fail with an ObjectBusy error. Además, GDI+GDI+ omite cualquier cambio de estado realizado en el Graphics del hdc parámetro en operaciones posteriores.Also, GDI+GDI+ ignores any state changes made to the Graphics of the hdc parameter in subsequent operations.

Seguridad

SecurityPermission
para el acceso a código no administrado.for access to unmanaged code. Enumeración relacionada: UnmanagedCode.Related enumeration: UnmanagedCode.

Se aplica a