SetBlackPen( hDC )-> <hPrevPen>
------------------------------------------------------------------------------


 PARAMETER:


  <hDC>        handle that identifies a device context in which the pen 
               is to be selected


 RETURNS:

  <hPrevPen> is the handle of the previously selected pen



 DESCRIPTION:

  This function retrieves a predefined black Pen and selects it into
  the given context. The Pen can than be used to write to that window.


 EXAMPLE:


    +--------------------------------------------------------------+
    |  /* Get a black pen and draw a rectangle */                  |
    |   hPen := SetBlackPen( hDC )                                 |
    |   Rectangle( hDC, 10, 10, 100, 120 )                         |
    |   SelectObject( hPen )                                       |
    +--------------------------------------------------------------+


 SOURCE:

  SOURCE\WINAPI\GETSTKOB.C