Graphics.GetHdc Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft das Handle für den Gerätekontext ab, der diesem Graphics zugeordnet ist.
public:
virtual IntPtr GetHdc();
public:
IntPtr GetHdc();
public IntPtr GetHdc ();
abstract member GetHdc : unit -> nativeint
override this.GetHdc : unit -> nativeint
member this.GetHdc : unit -> nativeint
Public Function GetHdc () As IntPtr
Gibt zurück
nativeint
Handle für den Gerätekontext, der diesem Graphics zugeordnet ist.
Implementiert
Beispiele
Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse
, was ein Parameter des Paint Ereignishandlers ist. Das Beispiel veranschaulicht das Aufrufen einer Windows GDI-Funktion, um dieselbe Aufgabe wie eine GDI+ Graphics -Methode auszuführen. Der Code führt die folgenden Aktionen aus:
Definiert das Interoperabilitätsattribut DllImportAttribute für die Windows DLL-Datei gdi32.dll. Diese DLL enthält die gewünschte GDI-Funktion.
Definiert die Rectangle Funktion in dieser DLL als extern.
Erstellt einen roten Stift.
Zeichnet mit dem Stift ein Rechteck mit der GDI+ DrawRectangle -Methode auf den Bildschirm.
Definiert eine interne Zeigertypvariable
hdc
und legt ihren Wert auf das Handle auf den Gerätekontext des Formulars fest.Zeichnet mithilfe der GDI-Funktion Rectangle ein Rechteck auf den Bildschirm.
Gibt den durch den Parameter dargestellten Gerätekontext frei
hdc
.
private:
[System::Runtime::InteropServices::DllImportAttribute("gdi32.dll")]
static bool Rectangle( IntPtr hdc, int ulCornerX, int ulCornerY, int lrCornerX, int lrCornerY );
public:
void GetHdcForGDI1( 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.
Rectangle( hdc, 10, 70, 110, 120 );
// Release handle to device context.
e->Graphics->ReleaseHdc( hdc );
}
public class GDI
{
[System.Runtime.InteropServices.DllImport("gdi32.dll")]
internal static extern bool Rectangle(
IntPtr hdc,
int ulCornerX, int ulCornerY,
int lrCornerX, int lrCornerY);
}
private void GetHdcForGDI1(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.
GDI.Rectangle(hdc, 10, 70, 110, 120);
// Release handle to device context.
e.Graphics.ReleaseHdc(hdc);
}
Public Class GDI
<System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")> _
Friend Shared Function Rectangle(ByVal hdc As IntPtr, _
ByVal ulCornerX As Integer, ByVal ulCornerY As Integer, ByVal lrCornerX As Integer, _
ByVal lrCornerY As Integer) As Boolean
End Function
End Class
<System.Security.Permissions.SecurityPermission( _
System.Security.Permissions.SecurityAction.LinkDemand, Flags:= _
System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Private Sub GetHdcForGDI1(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.
GDI.Rectangle(hdc, 10, 70, 110, 120)
' Release handle to device context.
e.Graphics.ReleaseHdc(hdc)
End Sub
Hinweise
Der Gerätekontext ist eine Windows-Struktur, die auf GDI basiert und eine Reihe von grafischen Objekten und den zugehörigen Attributen sowie die grafischen Modi definiert, die sich auf die Ausgabe auswirken. Diese Methode gibt den Gerätekontext mit Ausnahme einer Schriftart zurück. Da eine Schriftart nicht ausgewählt ist, schlagen Aufrufe der FromHdc -Methode mit einem von der GetHdc -Methode zurückgegebenen Handle fehl.
Aufrufe der GetHdc Methoden und ReleaseHdc müssen paarweise angezeigt werden. Während des Bereichs eines GetHdc Methodenpaars führen ReleaseHdc Sie normalerweise nur Aufrufe von GDI-Funktionen durch. Aufrufe in diesem Bereich, die Graphics an GDI+-Methoden der GDI+-Methode der ausgeführt wurden, hdc
schlagen mit einem Fehler fehl ObjectBusy
. Außerdem ignoriert GDI+ alle Zustandsänderungen, die an der Graphics des hdc
Parameters in nachfolgenden Vorgängen vorgenommen wurden.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für