CGdiObject::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.

CGdiObject::FromHandle

◄CGdiObject►                                  ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  static CGdiObject* FromHandle( HANDLE hObject );
 
  Parameter   Description
 
  <hObject>   A HANDLE to a Windows GDI object.
 
  Remarks
 
  Returns a pointer to a CGdiObject object given a handle to a Windows GDI
  object. If a CGdiObject object is not already attached to the Windows
  GDI object, a temporary CGdiObject object is created and attached.
 
  This temporary CGdiObject object is only valid 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 CGdiObject that may be temporary or permanent.
 
  See Also
 
  ◄CGdiObject::DeleteTempMap►
 
 
                                     -♦-