SaveDC Function

The SaveDC function saves the current state of the specified device context (DC) and selects the specified number of graphic objects into it.

Syntax

int SaveDC(
      HDC hdc
    );
            

Parameters

Return Value

If the function succeeds, the return value is the integer value of the saved DC state. This value can be used to restore the DC. If the function fails, the return value is 0.

Remarks

The SaveDC function creates a copy of the device context (DC) specified by the hdc parameter. The saved DC state includes the following attributes:

• The clipping region.
• The selected graphics objects (pens, brushes, fonts, regions, bitmaps).
• The mapping mode.
• The background color.
• The text color.
• The drawing mode.
• Other DC attributes.

The saved DC state is stored on a stack. You can use the RestoreDC function to restore the DC to a previous state by specifying the integer value returned by SaveDC. If you save the DC multiple times, you must restore it the same number of times to return it to its original state.

It is important to note that SaveDC does not create a new device context. It simply saves the current state of an existing one.

Requirements

See Also

• GDI Functions
• Device Contexts
• RestoreDC