CDC::RestoreDC - Microsoft Foundation Classes

Microsoft Foundation Classes (mfc.hlp) (Table of Contents; Topic list)

Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

CDC::RestoreDC

◄CDC►                                         ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  BOOL RestoreDC( int nSavedDC );
 
  Parameter   Description
 
  <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►
 
 
                                     -♦-