CRgn::FromHandle - 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.

CRgn::FromHandle

◄CRgn►                                        ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  static CRgn* FromHandle( HRGN hRgn );
 
  Parameter   Description
 
  <hRgn>      Specifies a handle to a Windows region.
 
  Remarks
 
  Returns a pointer to a CRgn object when given a handle to a Windows
  region. If a CRgn object is not already attached to the handle, a
  temporary CRgn object is created and attached. This temporary CRgn
  object is valid only until the next time the application has idle time
  in its event loop, at which time all temporary graphic objects are
  deleted. Another way of saying this is that the temporary object is only
  valid during the processing of one window message.
 
  Return Value
 
  A pointer to a CRgn object. If the function was not successful, the
  return value is NULL.
 
 
                                     -♦-