bitmapga.cpp

Go to the documentation of this file.

//----------------------------------------------------------------------------
// ObjectWindows
// Copyright (c) 1993, 1996 by Borland International, All Rights Reserved
//
/// \file
/// Implementation of class TBitmapGadget
/// Implementation of class TDynamicBitmapGadget
//----------------------------------------------------------------------------
#include <owl/pch.h>
#include <owl/bitmapga.h>
#include <owl/gadgetwi.h>
#include <owl/celarray.h>
 
namespace owl {
 
OWL_DIAGINFO;
DIAG_DECLARE_GROUP(OwlGadget);  // diagnostic group for gadgets
 
//
/// Construct a bitmap gadget
//
/// Constructs a TBitmapGadget and sets the current image to the beginning image
/// (startImage) in the array of images. Then, sets the border style to the current
/// TGadget border style and numImages to the number of images in the array.
///
/// If sharedCels is false, imageResIdOrIndex specifies a single bitmap image that
/// can be evenly divided into numImages parts. If sharedCels is true,
/// imageResIdOrIndex specifies the starting image to use in the common
/// TGadgetWindow bitmap image.
//
TBitmapGadget::TBitmapGadget(TResId imageResIdOrIndex,
                             int    id,
                             TBorderStyle borderStyle,
                             int    numImages,
                             int    startImage,
                             bool   sharedCels)
:
  TGadget(id, borderStyle),
  ImageArray(nullptr),            // Created on first call to GetDesiredSize
  CurrentImage(startImage),
  NumImages(numImages),
  BitmapOrigin(0)
{
  if (sharedCels) {
    ResId = 0;
    ImageIndex = imageResIdOrIndex.GetInt();
  }
  else {
    ResId = imageResIdOrIndex;
    ImageIndex = 0;
  }
 
  TRACEX(OwlGadget, OWL_CDLEVEL, "TBitmapGadget constructed @" << this);
}
 
//
/// Destruct a bitmap gadget and free its resources
//
/// Deletes the array of images.
//
TBitmapGadget::~TBitmapGadget()
{
  delete ImageArray;
  TRACEX(OwlGadget, OWL_CDLEVEL, "TBitmapGadget destructed @" << this);
}
 
//
/// When the system colors have been changed, SysColorChange is called by the gadget
/// window's EvSysColorChange so that bitmap gadgets can be rebuilt and repainted.
//
/// Handle a system color change by cleaning up & reloading & processing the
/// bitmap. Is also called to create the initial bitmap.
//
void
TBitmapGadget::SysColorChange()
{
  TCelArray* a = ResId ? CreateCelArray(ResId, NumImages) : nullptr;
  delete ImageArray;
  ImageArray = a;
}
 
//virtual 
TCelArray* 
TBitmapGadget::CreateCelArray(TResId resId, int numImages) const
{
  TDib dib(*GetGadgetWindow()->GetModule(), resId);
  dib.MapUIColors(TDib::MapFace | TDib::MapText | TDib::MapShadow |
    TDib::MapHighlight);
  return new TCelArray(dib, numImages);
}
 
//
/// Set the bounding rect for this button gadget. Also takes care of
/// re-centering the image
//
/// Calls TGadget::SetBounds and passes the dimensions of the bitmap gadget.
/// SetBounds informs the control gadget of a change in its bounding rectangle.
//
void
TBitmapGadget::SetBounds(const TRect& boundRect)
{
  TRACEX(OwlGadget, 1, "TBitmapGadget::SetBounds() called @" << this);
  TGadget::SetBounds(boundRect);
 
  TRect innerRect;
  GetInnerRect(innerRect);
 
  TSize bitmapSize = ImageArray->CelSize();
 
  BitmapOrigin.x = innerRect.left + (innerRect.Width()-bitmapSize.cx)/2;
  BitmapOrigin.y = innerRect.top + (innerRect.Height()-bitmapSize.cy)/2;
}
 
//
/// Find out how big this bitmap gadget wants to be. Calculated using the base
/// size to get the borders, etc. plus the image size.
//
/// Calls TGadget::GetDesiredSize, which determines how big the bitmap gadget can
/// be. The gadget window sends this message to query the gadget's size. If
/// shrink-wrapping is requested, GetDesiredSize returns the size needed to
/// accommodate the borders and margins. If shrink-wrapping is not requested, it
/// returns the gadget's current width and height. TGadgetWindow needs this
/// information to determine how big the gadget needs to be, but it can adjust these
/// dimensions if necessary. If WideAsPossible is true, then the width parameter
/// (size.cx) is ignored.
//
void
TBitmapGadget::GetDesiredSize(TSize& size)
{
  TRACEX(OwlGadget, 1, "TBitmapGadget::GetDesiredSize() called @" << this);
  TGadget::GetDesiredSize(size);
 
  if (!ImageArray)
    SysColorChange();   // Get the initial bitmap
 
  size += (ImageArray ? ImageArray->CelSize() : GetGadgetWindow()->GetCelArray().CelSize());
}
 
//
/// Choose the relative image to display. If immediate is true, this gadget is
/// repainted immediately
//
int
TBitmapGadget::SelectImage(int imageNum, bool immediate)
{
  PRECONDITION(imageNum >=0 && imageNum < NumImages);
 
  uint oldImageNum = CurrentImage;
 
  if (imageNum != CurrentImage) {
    CurrentImage = imageNum;
    Invalidate(false);
  }
 
  if (immediate)
    Update();
  return oldImageNum;
}
 
//
/// Paint this bitmap gadget. Uses normal borders, plus draws the image centered
//
void
TBitmapGadget::Paint(TDC& dc)
{
  PaintBorder(dc);
 
  TRect destRect;
  GetInnerRect(destRect);
 
  TCelArray& imageArray = ImageArray ? *ImageArray : GetGadgetWindow()->GetCelArray();
 
  imageArray.BitBlt(ImageIndex+CurrentImage, dc, destRect.left, destRect.top);
}
 
//
/// \class TDynamicBitmapGadgetEnabler
// ~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
//
#  if defined(BI_COMP_BORLANDC)
#    pragma warn -inl
#  endif
class TDynamicBitmapGadgetEnabler : public TCommandEnabler {
  public:
    TDynamicBitmapGadgetEnabler(TWindow::THandle hReceiver,
                                TDynamicBitmapGadget* g)
    :
      TCommandEnabler(g->GetId(), hReceiver),
      Gadget(g)
    {
    }
 
    // Override TCommandEnabler virtuals
    //
    void  Enable(bool enable);
    void  SetText(LPCTSTR){}
    void  SetCheck(int state);
 
  protected:
    TDynamicBitmapGadget* Gadget;
};
#  if defined(BI_COMP_BORLANDC)
#    pragma warn .inl
#  endif
 
//
void TDynamicBitmapGadgetEnabler::Enable(bool enable)
{
  TCommandEnabler::Enable(enable);
  if(Gadget->GetEnabled() != enable)
    Gadget->SetEnabled(enable);
}
//
void  TDynamicBitmapGadgetEnabler::SetCheck(int state)
{
  Gadget->SelectImage(state, false);
}
//
 
//--------------------------------------------------------
/// TDynamicBitmapGadget Constructor
//
TDynamicBitmapGadget::TDynamicBitmapGadget(TResId imageResIdOrIndex,
      int id, TBorderStyle borderStyle, int numImages,
      int startImage, bool sharedCels)
:
  TBitmapGadget(imageResIdOrIndex,id,borderStyle,numImages,startImage,
                sharedCels)
{
}
 
//
void TDynamicBitmapGadget::CommandEnable()
{
  PRECONDITION(Window);
 
  // Must send, not post here, since a ptr to a temp is passed
  //
  // This might be called during idle processing before the
  // HWND has created.  Therefore, confirm handle exists.
  //
  if (GetGadgetWindow()->GetHandle()){
    TDynamicBitmapGadgetEnabler ge(*GetGadgetWindow(), this);
    GetGadgetWindow()->HandleMessage(WM_COMMAND_ENABLE, 0, TParam2(&ge));
  }
}
//
 
} // OWL namespace
//==================================================================================