[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 SetBkColor()      Set the current background color to the specified
 --------------------------------------------------------------------------------

      SetBkColor( <hDC>, <nRGBColor> )  -->  <nRGBColorOld>


  Changes the Back color of a specified handle to device context and returns
  the previous Back color of the device context.

  <hDC>             A handle -numeric value- of a Device Context.

  <nRGBColor>       A Color in RGB format. If the system can not use that
                    color, Windows automatically will use the nearest
                    color available.

  <nRGBColorOld>    The previous color in RGB format.


  Device contexts are used in Windows to use 'virtual screens'. Think
  about them in a similar way as when we do DispBegin() and DispEnd()
  In Clipper.

  All the work on a device has to be done on its 'device context' and
  later that Device context is dumped onto its device.

  In a similar way as we do in MsDos Clipper DispBegin() ...actions...
  and DispEnd(), in device contexts we create them and later we
  release them.

  Windows device contexts don't 'keep' the colors from one painting
  operation to the next. So, each time we are going to use a certain
  color we have to Set it to the device context doing SetTextColor(...)
  and SetBkColor(...).

  FiveWin does that automatically so you don't have to worry about this
  process. Every you paint on the Window, FiveWin will set the
  correct colors calling internally to SetTextColor(), SetBkColor() API
  functions and some others functions needed.

  Warning: If you incorrectly manipulate Device contexts -not releasing
  them properly, or doing it without balance- you may corrupt all the
  Windows environment, and you will have to go out of Windows and load
  it again to recover control.

This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson