Share via

Gdi::RestoreDC_I (Windows Embedded CE 6.0)

  • Article

1/6/2010

This method restores a device context to the specified state. The device context is restored by popping state information off a stack created by earlier calls to the Gdi::SaveDC_I method.

Syntax

static WINGDIAPI BOOL WINAPI RestoreDC_I(
  HDC hdc, 
  int nSavedDC
);

Parameters

  • hdc
    [in] Handle to the device context.

  • nSavedDC
    [in] Integer that 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 Value

Nonzero indicates success.

Zero indicates failure.

To get extended error information, call GetLastError.

Remarks

This method is an internal version of the RestoreDC function.

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, Gdi::RestoreDC_I deletes all state information between the top of the stack and the specified instance.

Requirements

Header gdi.hpp
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Gdi
RestoreDC
Gdi::CreateDCW_I
Gdi::SaveDC_I