CDC::RestoreDC

Syntax

BOOL RestoreDC( int nSavedDC );

Parameters

nSavedDC

Specifies the device context to be restored. It must be a value returned by a previous SaveDC function call. If nSavedDC is -1, the most recent device context saved is restored.

Remarks

Restores the Windows device context to the previous state identified by nSavedDC. RestoreDC restores the device context by copying state information saved on the Windows internal context stack by earlier calls to the SaveDC member function.

The Windows internal context stack can contain the state information for several device contexts. If the context specified by nSavedDC is not at the top of the stack, RestoreDC deletes any state information between the device context specified by nSavedDC and the top of the stack. The deleted information is lost.

Return Value

TRUE if the specified context was restored; otherwise FALSE.

See Also

CDC::SaveDC, ::RestoreDC