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.
CDumpContext::SetDepth
CDumpContext                                Up Contents Index Back
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  void SetDepth( int nNewDepth );
 
  Parameter   Description
 
  <nNewDepth> The new depth value.
 
  Remarks
 
  Sets the depth for the dump. If you are dumping primitive types or
  simple CObjects that contain no pointers to other objects, then a value
  of 0 is sufficient. A value greater than 0 specifies a deep dump where
  all objects are dumped recursively. For example, a deep dump of a
  collection will dump all elements of the collection. You may use other
  specific depth values in your derived classes.
 
  NOTE: Circular references are not detected in deep dumps and can result
        in infinite loops.
 
  Example
 
  afxDump.SetDepth( 1 );  // specifies deep dump
  ASSERT( afxDump.GetDepth() == 1 );
 
 
  See Also
 
  CObject::Dump
 
 
                                     -♦-