SaveDC-Funktion (wingdi.h)

Die SaveDC-Funktion speichert den aktuellen Zustand des angegebenen Gerätekontexts (DC), indem Daten, die ausgewählte Objekte und Grafikmodi (z. B. Bitmap, Pinsel, Palette, Schriftart, Stift, Region, Zeichnungsmodus und Zuordnungsmodus) beschreiben, in einen Kontextstapel kopiert werden.

Syntax

int SaveDC(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für den DC, dessen Zustand gespeichert werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, identifiziert der Rückgabewert den gespeicherten Zustand.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die SaveDC-Funktion kann beliebig oft verwendet werden, um eine beliebige Anzahl von Instanzen des DC-Zustands zu speichern.

Ein gespeicherter Zustand kann mithilfe der RestoreDC-Funktion wiederhergestellt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

Gerätekontextfunktionen

Übersicht über Gerätekontexte

RestoreDC