RestoreDC
The RestoreDC
function restores a device context (DC) to the specified state. The device
context is restored by popping state information off a stack created by earlier
calls to the SaveDC
function.
BOOL RestoreDC(
|
HDC hdc, |
// handle of device
context |
|
int nSavedDC |
// specifies state
to be restored |
|
); |
|
Parameters
hdc
Identifies
the device context.
nSavedDC
Specifies the
instance of the device context to be restored. If this parameter is positive, nSavedDC
represents a specific instance of the device context to be restored. If this
parameter is negative, nSavedDC represents an instance relative to the
current device context. For example, -1 restores the most recently saved state.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero.
Remarks
The stack can
contain the state information for several instances of the device context. If
the state specified by the given parameter is not at the top of the stack, RestoreDC
deletes all state information between the top of the stack and the specified
instance.
See Also