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

◄CGdiObject►                                  ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  BOOL UnrealizeObject();
 
  Remarks
 
  Resets the origin of a brush or resets a logical palette. While
  UnrealizeObject is a member function of the CGdiObject class, it should
  be invoked only on CBrush or CPalette objects.
 
  For CBrush objects, UnrealizeObject directs the system to reset the
  origin of the given brush the next time it is selected into a device
  context. If the object is a CPalette object, UnrealizeObject directs the
  system to realize the palette as though it had not previously been
  realized. The next time the application calls the ◄CDC::RealizePalette►
  function for the specified palette, the system completely remaps the
  logical palette to the system palette.
 
  The UnrealizeObject function should not be used with stock objects. The
  UnrealizeObject function must be called whenever a new brush origin is
  set (by means of the ◄CDC::SetBrushOrg► function). The UnrealizeObject
  function must not be called for the currently selected brush or
  currently selected palette of any display context.
 
  Return Value
 
  TRUE if successful; otherwise FALSE.
 
  See Also
 
  ◄CDC::RealizePalette►, ◄CDC::SetBrushOrg►
 
 
                                     -♦-