Graphics.ReleaseHdc Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Uvolní popisovač kontextu zařízení získaný předchozím voláním GetHdc() metody tohoto Graphics.

Přetížení

ReleaseHdc()	Uvolní popisovač kontextu zařízení získaný předchozím voláním GetHdc() metody tohoto Graphics.
ReleaseHdc(IntPtr)	Uvolní popisovač kontextu zařízení získaný předchozím voláním GetHdc() metody tohoto Graphics.

ReleaseHdc()

Uvolní popisovač kontextu zařízení získaný předchozím voláním GetHdc() metody tohoto Graphics.

public:
 virtual void ReleaseHdc();

public void ReleaseHdc ();

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

Public Sub ReleaseHdc ()

Implementuje

ReleaseHdc()

Poznámky

GetHdc a ReleaseHdc jsou dvě metody, které umožňují získat a uvolnit popisovač zařízení s Windows. Vždy byste měli volat GetHdc s voláním ReleaseHdc až skončíte s popisovačem Windows.

Viz také

• IDeviceContext

ReleaseHdc(IntPtr)

Uvolní popisovač kontextu zařízení získaný předchozím voláním GetHdc() metody tohoto Graphics.

public:
 void ReleaseHdc(IntPtr hdc);

public void ReleaseHdc (IntPtr hdc);

member this.ReleaseHdc : nativeint -> unit

Public Sub ReleaseHdc (hdc As IntPtr)

Parametry

hdc

IntPtr

nativeint

Zpracování kontextu zařízení získaného předchozím voláním GetHdc() metody tohoto Graphics.

Příklady

Následující příklad kódu je určený pro použití s Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny události Paint. Příklad znázorňuje volání funkce GDI systému Windows k provedení stejné úlohy jako GDI+ Graphics metoda. Kód provede následující akce:

• Definuje atribut interoperability DllImportAttribute pro soubor knihovny WINDOWS DLL gdi32.dll. Tato knihovna DLL obsahuje požadovanou funkci GDI a definuje Rectangle funkci v této knihovně DLL jako externí.

• Vytvoří červené pero.

• Pomocí pera nakreslí na obrazovku obdélník pomocí GDI+ DrawRectangle metody.

• Definuje proměnnou interního typu ukazatele hdc a nastaví její hodnotu na popisovač na kontext zařízení formuláře.

• Nakreslí na obrazovku obdélník pomocí funkce Rectangle GDI.

• Uvolní kontext zařízení reprezentovaný parametrem hdc.

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

Poznámky

Kontext zařízení je struktura Systému Windows založená na GDI, která definuje sadu grafických objektů a jejich přidružených atributů a také grafické režimy, které ovlivňují výstup.

Volání GetHdc a metod ReleaseHdc se musí objevit ve dvojicích. Během rozsahu dvojice metod GetHdc a ReleaseHdc obvykle voláte pouze funkce GDI. Volání v daném oboru metod GDI+ Graphics, které vytvořily parametr hdc, selžou s chybou ObjectBusy. GDI+ také ignoruje všechny změny stavu provedené v Graphics parametru hdc v následných operacích.