SaveDC

This function saves the current state of the specified device context by copying data describing selected objects and graphic modes (such as the bitmap, brush, palette, font, pen, region, and drawing mode) to a context stack.

At a Glance

Header file: Wingdi.h
Windows CE versions: 1.0 and later

Syntax

int SaveDC( HDC hdc);

Parameters

hdc

[in] Handle to the device context to be saved.

Return Values

If the function succeeds, the return value identifies the saved device context.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The SaveDC function can be used any number of times to save any number of instances of the device context's state.

A saved state can later be restored by using the RestoreDC function.

See Also

RestoreDC