CProgress类使用例程

//========================================================================
//TITLE:
//    CProgress类使用例程
//AUTHOR:
//    norains
//DATE:
//    Tuesday  17-April-2007
//Environment:
//        EVC4.0 + Standard SDK 4.2
//        EVC4.0 + Standard SDK 5.0
//========================================================================

        CProgress类是仿照微软的CProgress写的一个显示进度类.最大的区别在于,该类的状态显示的图片可以按自己意愿设置,这对于某些需要风格独特的程序来说,显得比较方便.
       
        该类的使用范例如下:
       
        //声明一个对象       

 CProgress prg;

       
        //设置显示的位置       

 prg.SetPosition(rcWnd);

        //设置有效和无效的图片

  prg.SetImgInfoInvalid(&imgInvalid);
  prg.SetImgInfoValid(&imgValid)

        //设置范围     

   prg.SetRange(0,6);

       
        //设置等级       

 prg.SetLevel(4);        

       
        //传入应用程序的实例句柄,令控件能读取图片       

 prg.SetHinstance(hInst);

       
        //绘制控件       

 prg.Draw(hdc);

/**///////////////////////////////////////////////////////////////////////
// Progress.h: interface for the CProgress class.
//
//Version: 
//    1.0.2
//Data:
//    2007.04.12   
/**///////////////////////////////////////////////////////////////////////

#ifndef PROGRESS_H
#define PROGRESS_H


#include "CtrlCommon.h"


//The image displayed information
typedef struct
...{
    LONG imgID;
    LONG left;
    LONG top;
    LONG right;
    LONG bottom;
}DISPIMAGEINFO,*PDISPIMAGEINFO;

class CProgress  
...{
public:
    BOOL SetBkMode(int iMode);
    void SetBkColor(COLORREF crColor);
    void SetHinstance(HINSTANCE hInst);
    BOOL Draw(HDC hdc);
    BOOL SetLevel(int m_iLevel);
    BOOL SetRange(int iMin,int iMax);
    void SetImgInfoInvalid(const DISPIMAGEINFO *pInfo);
    void SetImgInfoValid(const DISPIMAGEINFO *pInfo);
    void SetPosition(const RECT *prc);
    CProgress();
    virtual ~CProgress();
protected:
    RECT m_rcWndPos;
    DISPIMAGEINFO m_ImgValid;
    DISPIMAGEINFO m_ImgInvalid;
    int m_iMinLevel;
    int m_iMaxLevel;
    int m_iCurLevel;
    HINSTANCE m_hInst;
    COLORREF m_crBkColor;
    int m_iBkMode;
};

#endif //#ifndef PROGRESS_H

/**///////////////////////////////////////////////////////////////////////
// Progress.cpp: implementation of the CProgress class.
//
/**///////////////////////////////////////////////////////////////////////

#include "stdafx.h"
#include "Progress.h"


//--------------------------------------------------------------------
//Macro define
#define DEFAULT_MIN_LEVEL                0
#define DEFAULT_MAX_LEVEL                10
#define DEFAULT_CUR_LEVEL                0
#define DEFAULT_BKCOLOR                    RGB(128,128,128)
#define DEFAULT_BKMODE                    TRANSPARENT

//The interval between two level image
#define LEVEL_INTERVAL            4
//--------------------------------------------------------------------
/**///////////////////////////////////////////////////////////////////////
// Construction/Destruction
/**///////////////////////////////////////////////////////////////////////

CProgress::CProgress()
...{
    memset(&m_rcWndPos,0,sizeof(m_rcWndPos));
    memset(&m_ImgValid,0,sizeof(m_ImgValid));
    memset(&m_ImgInvalid,0,sizeof(m_ImgInvalid));
    m_iMaxLevel = DEFAULT_MAX_LEVEL;
    m_iMinLevel = DEFAULT_MIN_LEVEL;
    m_iCurLevel = DEFAULT_CUR_LEVEL;
    m_hInst = NULL;
    m_crBkColor = DEFAULT_BKCOLOR;
    m_iBkMode = DEFAULT_BKMODE;
}

CProgress::~CProgress()
...{
}


//-------------------------------------------------------------------
//Description:
//    Set the position
//-------------------------------------------------------------------
void CProgress::SetPosition(const RECT *prc)
...{
    m_rcWndPos = *prc;
}


//-------------------------------------------------------------------
//Description:
//    Set the image information for valid
//-------------------------------------------------------------------
void CProgress::SetImgInfoValid(const DISPIMAGEINFO *pInfo)
...{
    m_ImgValid = *pInfo;
}


//-------------------------------------------------------------------
//Description:
//    Set the image information for invalid
//-------------------------------------------------------------------
void CProgress::SetImgInfoInvalid(const DISPIMAGEINFO *pInfo)
...{
    m_ImgInvalid = *pInfo;
}


//-------------------------------------------------------------------
//Description:
//    Set the range
//-------------------------------------------------------------------
BOOL CProgress::SetRange(int iMin, int iMax)
...{
    if(iMin < 0 || iMax < 0 || iMin >= iMax)
    ...{
        return FALSE;
    }

    m_iMinLevel = iMin;
    m_iMaxLevel = iMax;

    return TRUE;
}



//-------------------------------------------------------------------
//Description:
//    Set the position
//-------------------------------------------------------------------
BOOL CProgress::SetLevel(int iLevel)
...{
    if(iLevel < m_iMinLevel || iLevel > m_iMaxLevel)
    ...{
        return FALSE;
    }
    m_iCurLevel = iLevel;
    return TRUE;
}


//-------------------------------------------------------------------
//Description:
//    Draw the control
//-------------------------------------------------------------------
BOOL CProgress::Draw(HDC hdc)
...{
    if(m_hInst == NULL)
    ...{
        return FALSE;
    }

    int iImgTotalWidth = (m_ImgValid.right - m_ImgValid.left) * (m_iMaxLevel - m_iMinLevel) + LEVEL_INTERVAL * (m_iMaxLevel - m_iMinLevel - 1);
    int iImgTotalHeight = m_ImgValid.bottom - m_ImgValid.top;

    //Create a DC that matches the device
    HBITMAP hBitmap = CreateCompatibleBitmap(hdc,iImgTotalWidth,iImgTotalHeight);
    HDC hdcMem = CreateCompatibleDC(hdc);
    //Select the bitmap into to the compatible device context
    HGDIOBJ hOldSel = SelectObject(hdcMem,hBitmap);



    //Draw the background
    //The frame color
    HPEN hPen=CreatePen(PS_SOLID,1,m_crBkColor);
    HPEN hOldPen=NULL;
    hOldPen=(HPEN)SelectObject(hdcMem,hPen);
    //the rect color
    HBRUSH hBrush = CreateSolidBrush(m_crBkColor);
    HGDIOBJ hOldBrush = SelectObject(hdcMem,hBrush);
    //Draw
    Rectangle(hdcMem,0,0,iImgTotalWidth + 1, iImgTotalHeight + 1);
    //Realse the resource
    SelectObject(hdcMem,hOldBrush);
    DeleteObject(hBrush);
    SelectObject(hdcMem,hOldPen);
    DeleteObject(hPen);




    //Draw the valid image
    //Create a DC that matches the device to draw the background bitmap
    HDC hdcBmp = CreateCompatibleDC(hdc);
    //Load the  bitmap
    HANDLE    hBmp = LoadImage(m_hInst,MAKEINTRESOURCE(m_ImgValid.imgID),IMAGE_BITMAP,0,0,0);
    //Select the bitmap into to the compatible device context
    HGDIOBJ hOldBmpSel = SelectObject(hdcBmp,hBmp);
    int i = 0, iPos_x = 0;
    for(i = m_iMinLevel + 1; i <= m_iCurLevel; i ++)
    ...{
        //Copy the bitmap image to the memory DC
        BitBlt(hdcMem,iPos_x,0,(m_ImgValid.right - m_ImgValid.left),(m_ImgValid.bottom - m_ImgValid.top),hdcBmp,m_ImgValid.left,m_ImgValid.top,SRCCOPY);
        iPos_x += (m_ImgValid.right - m_ImgValid.left) + LEVEL_INTERVAL;
    }
    //Delete the bmp
    DeleteObject(hBmp);


    //Draw the invalid image
    hBmp = LoadImage(m_hInst,MAKEINTRESOURCE(m_ImgInvalid.imgID),IMAGE_BITMAP,0,0,0);
    //Select the bitmap into to the compatible device context
    SelectObject(hdcBmp,hBmp);
    for(i = m_iCurLevel + 1; i <= m_iMaxLevel; i ++)
    ...{
        //Copy the bitmap image to the memory DC
        BitBlt(hdcMem,iPos_x,0,(m_ImgValid.right - m_ImgValid.left),(m_ImgValid.bottom - m_ImgValid.top),hdcBmp,m_ImgInvalid.left,m_ImgInvalid.top,SRCCOPY);
        iPos_x += (m_ImgValid.right - m_ImgValid.left) + LEVEL_INTERVAL;
    }
    //Delete the bmp
    DeleteObject(hBmp);



    if(m_iBkMode == TRANSPARENT)
    ...{
        TransparentImage(hdc,m_rcWndPos.left,m_rcWndPos.top,(m_rcWndPos.right - m_rcWndPos.left),(m_rcWndPos.bottom - m_rcWndPos.top),
            hdcMem,0,0,iImgTotalWidth,iImgTotalHeight,m_crBkColor);
    }
    else
    ...{
        StretchBlt(hdc,m_rcWndPos.left,m_rcWndPos.top,(m_rcWndPos.right - m_rcWndPos.left),(m_rcWndPos.bottom - m_rcWndPos.top),
            hdcMem,0,0,iImgTotalWidth,iImgTotalHeight,SRCCOPY);
    }
    //Restore original bitmap selection and destroy the memory DC
    SelectObject(hdcBmp,hOldBmpSel);
    SelectObject(hdcMem,hOldSel);
    DeleteObject(hBitmap);    
    DeleteDC(hdcBmp);
    DeleteDC(hdcMem);



    return TRUE;
}


//-------------------------------------------------------------------
//Description:
//    Set the hinstance
//-------------------------------------------------------------------
void CProgress::SetHinstance(HINSTANCE hInst)
...{
    m_hInst = hInst;
}


//-------------------------------------------------------------------
//Description:
//    Set the background color
//-------------------------------------------------------------------
void CProgress::SetBkColor(COLORREF crColor)
...{
    m_crBkColor = crColor;
}


//--------------------------------------------------------------------
//Description:
//    Set the background mode.If you choose the TRANSPARENT, the transparent
//color is the background color
//
//Parameters:
//    iMode: [in] The value is just like as follow:
//        OPAQUE      -- Background is filled with the current background color before the text, 
//                        hatched brush, or pen is drawn. 
//        TRANSPARENT -- Background remains untouched. 

//--------------------------------------------------------------------
BOOL CProgress::SetBkMode(int iMode)
...{
    if(iMode == OPAQUE || iMode == TRANSPARENT)
    ...{
        m_iBkMode = iMode;
        return TRUE;
    }
    else
    ...{
        return FALSE;
    }
}