RestoreDC-Funktion (wingdi.h)

Die RestoreDC-Funktion stellt einen Gerätekontext (DC) wieder in den angegebenen Zustand zurück. Der DC wird wiederhergestellt, indem Zustandsinformationen aus einem Stapel angezeigt werden, der durch frühere Aufrufe der SaveDC-Funktion erstellt wurde.

Syntax

BOOL RestoreDC(
  [in] HDC hdc,
  [in] int nSavedDC
);

Parameter

[in] hdc

Ein Handle für den DC.

[in] nSavedDC

Der wiederherzustellende gespeicherte Zustand. Wenn dieser Parameter positiv ist, stellt nSavedDC eine bestimmte instance des wiederherzustellenden Zustands dar. Wenn dieser Parameter negativ ist, stellt nSavedDC eine instance relativ zum aktuellen Zustand dar. Beispielsweise stellt -1 den zuletzt gespeicherten Zustand wieder her.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

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

Hinweise

Jeder DC verwaltet einen Stapel gespeicherter Zustände. Die SaveDC-Funktion pusht den aktuellen Zustand des DC auf den Stapel gespeicherter Zustände. Dieser Zustand kann nur auf demselben DC wiederhergestellt werden, aus dem er erstellt wurde. Nachdem ein Zustand wiederhergestellt wurde, wird der gespeicherte Zustand zerstört und kann nicht wiederverwendet werden. Darüber hinaus werden alle nach der Erstellung des wiederhergestellten Zustands gespeicherten Zustände ebenfalls zerstört und können nicht verwendet werden. Mit anderen Worten, die RestoreDC-Funktion füllt den wiederhergestellten Zustand (und alle nachfolgenden Zustände) aus dem Zustandsinformationsstapel auf.

Anforderungen

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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

Gerätekontextfunktionen

Übersicht über Gerätekontexte

SaveDC