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

CPalette::FromHandle

◄CPalette►                                    ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  static CPalette* FromHandle( HPALETTE hPalette );
 
  Parameter   Description
 
  <hPalette>  A handle to a Windows GDI color palette.
 
  Remarks
 
  Returns a pointer to a CPalette object when given a handle to a Windows
  palette object. If a CPalette object is not already attached to the
  Windows palette, a temporary CPalette object is created and attached.
  This temporary CPalette 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 CPalette object if successful; otherwise NULL.
 
 
                                     -♦-