Graphics.ReleaseHdc Metoda

Definicja

Zwalnia uchwyt kontekstu urządzenia uzyskany przez poprzednie wywołanie GetHdc() metody tego Graphicselementu .

Przeciążenia

ReleaseHdc()

Zwalnia uchwyt kontekstu urządzenia uzyskany przez poprzednie wywołanie GetHdc() metody tego Graphicselementu .

ReleaseHdc(IntPtr)

Zwalnia uchwyt kontekstu urządzenia uzyskany przez poprzednie wywołanie GetHdc() metody tego Graphicselementu .

ReleaseHdc()

Zwalnia uchwyt kontekstu urządzenia uzyskany przez poprzednie wywołanie GetHdc() metody tego Graphicselementu .

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

Implementuje

Uwagi

GetHdci ReleaseHdc to dwie metody, które umożliwiają uzyskanie i zwolnienie uchwytu dla urządzenia Windows. Zawsze należy postępować zgodnie z wywołaniem wywołania, aby GetHdc ReleaseHdc po zakończeniu pracy z uchwytem Windows.

Zobacz też

Dotyczy

ReleaseHdc(IntPtr)

Zwalnia uchwyt kontekstu urządzenia uzyskany przez poprzednie wywołanie GetHdc() metody tego Graphicselementu .

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

Dojmij do kontekstu urządzenia uzyskanego przez poprzednie wywołanie GetHdc() metody tego Graphicselementu .

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z Windows Forms i wymaga PaintEventArgs eparametru Paint programu obsługi zdarzeń. W przykładzie pokazano wywołanie funkcji Windows GDI w celu wykonania tego samego zadania co metoda GDI+Graphics. Kod wykonuje następujące akcje:

  • Definiuje atrybut współdziałania DllImportAttribute dla gdi32.dll pliku dll Windows. Ta biblioteka DLL zawiera żądaną funkcję GDI i definiuje Rectangle funkcję w tej bibliotece DLL jako zewnętrzną.

  • Tworzy czerwone pióro.

  • Za pomocą pióra rysuje prostokąt na ekran przy użyciu metody GDI+DrawRectangle.

  • Definiuje wewnętrzną zmienną hdc typu wskaźnika i ustawia jej wartość na uchwyt w kontekście urządzenia formularza.

  • Rysuje prostokąt na ekranie przy użyciu funkcji GDI Rectangle .

  • Zwalnia kontekst urządzenia reprezentowany hdc przez parametr .

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

Uwagi

Kontekst urządzenia jest strukturą Windows opartą na GDI, która definiuje zestaw obiektów graficznych i skojarzonych z nimi atrybutów, a także tryby graficzne wpływające na dane wyjściowe.

Wywołania metod GetHdc i ReleaseHdc muszą być wyświetlane w parach. W zakresie GetHdc pary metod i ReleaseHdc zwykle wykonuje się wywołania tylko do funkcji GDI. Wywołania w tym zakresie wykonane w celu GDI+ metodGraphics, które wygenerowały hdc parametr, kończą się niepowodzeniem z powodu błęduObjectBusy. Ponadto GDI+ ignoruje wszelkie zmiany stanu wprowadzone w Graphics parametrze hdc w kolejnych operacjach.

Dotyczy