SaveDC

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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.

Syntax

int SaveDC( 
  HDC hdc
);

Parameters

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

Return Value

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.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

RestoreDC
GDI Functions