[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
  LoadBitmap( hInst, cnBitmap )-> <hBitmap>
------------------------------------------------------------------------------


 PARAMETER:

  <hInst>     Is the InstanceHandle that identifies the module containing
              the bitmap to be loaded. This is normally the handle of a DLL
              or executable, if the resources are linked to the exe.
              

  <cnBitmap>  Is the name or the numeric identifier of the bitmap to load


 RETURNS:

  <hBitmap> is the handle of the loaded bitmap.


 DESCRIPTION:

  The LoadBitmap function loads the specified bitmap resource from the given
  module's executable file. If you want to load a bitmap from disk, use
  ReadBitmap().  The function fails, if the bitmap does not exist or there
  is insufficient memory to load it. 
  The application must call DeleteObject() to delete each bitmap handle
  returned by LoadBitmap(). This also applies to the following predefined
  bitmaps:
  An application can use LoadBitmap to access the predefined bitmaps used
  by Windows. To do so, the application must set <hInst> to zero, and 
  <cnBitMap> to one of the following values: 


     OBM_BTNCORNERS  OBM_BTSIZE       OBM_CHECK       OBM_CHECKBOXES 
     OBM_CLOSE       OBM_REDUCE       OBM_COMBO       OBM_REDUCED 
     OBM_DNARROW     OBM_RESTORE      OBM_DNARROWD    OBM_RESTORED 
     OBM_DNARROWI    OBM_RGARROW      OBM_LFARROW     OBM_RGARROWD 
     OBM_LFARROWD    OBM_RGARROWI     OBM_LFARROWI    OBM_SIZE 
     OBM_MNARROW     OBM_UPARROW      OBM_UPARROWD    OBM_UPARROWI
     OBM_ZOOM        OBM_ZOOMD 

  Note that for an application to use any of the OBM_ constants, the
  constant OEMRESOURCE must be defined before the WINDOWS.H header file
  is included. For a sample, please look into the SAMPLES\Install.prg or
  SAMPLES\TestRes.prg files

 SOURCE:

  SOURCE\WINAPI\LOADBMP.C



See Also: DeleteObject ReadBitmap
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson