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 |