CText类使用例程

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

        CText是为了方便在屏幕中输出文本而封装的类.该类将复杂的设置操作封装成简单的函数,便于代码书写的简便性.

        该类使用简单,示例如下:

           //设置显示范围

 txtInfo.SetPosition( & rcWnd);

    //设置字体颜色  

 txtInfo.SetTextColor(RGB( 255 , 0 , 0 ));

   
    //设置字体磅值,0为默认的字体大小   

 txtInfo.SetTextHeight( 0 );

   
    //设置显示的文本

 txtInfo.SetText(TEXT( " 测试 " ));

      
    //设置格式,该参数和DrawText()相同

 txtInfo.SetFormat(DT_RIGHT);

    //绘制文本

 txtInfo.Draw(hdc);

   
    默认的是透明显示,如果需要显示背景颜色,可以如下操作:
       
    //设置背景色

 txtInfo.SetBkColor(RGB( 0 , 0 , 233 ));

    //OPAQUE为绘制背景色

 txtInfo.SetBkMode(OPAQUE);

   
    然后再调用Draw进行绘制即可.

    
/**/ ///
//  Text.h: interface for the CText class.
//
// Version: 
//     1.0
// Data:
//     2007.03.27   
/**/ //

#ifndef TEXT_H
#define  TEXT_H


// ------------------------------------------------------------------
class  CText  
... {
public:
    void GetPosition(RECT * prcOut);
    void SetTextHeight(int iHeight);
    void SetFormat(UINT uFormat);
    void SetBkColor(COLORREF crColor);
    void SetTextColor(COLORREF crColor);
    BOOL SetBkMode(int iMode);
    void Draw(HDC hdc);
    BOOL SetText(const TCHAR *pszText);
    void SetPosition(const RECT *prc);
    CText();
    virtual ~CText();
protected:
    RECT m_rcWndPos;    
    TCHAR *m_pszText;
    ULONG m_ulSizeText;
    UINT m_uFormat;
    int m_iTextHeight;
    int m_iBkMode;
    COLORREF m_crTextColor;
    COLORREF m_crBkColor;

} ;

#endif   //  #ifndef TEXT_H

/**/ //
//  Text.cpp: implementation of the CText class.
//
/**/ //

#include  " stdafx.h "
#include  " Text.h "


// --------------------------------------------------------------------
// Macro define
#define  DEFAULT_BKMODE            TRANSPARENT
#define  DEFAULT_TEXT_COLOR        RGB(0,0,0)
#define  DEFAULT_BK_COLOR        RGB(255,255,255)
#define  DEFAULT_FORMAT            (DT_LEFT | DT_SINGLELINE)
#define  DEFAULT_TEXT_HEIGHT        0


// --------------------------------------------------------------------
/**/ //
//  Construction/Destruction
/**/ //

CText::CText()
... {
    memset(&m_rcWndPos,0,sizeof(m_rcWndPos));
    m_pszText = NULL;
    m_ulSizeText = 0;
    m_iBkMode = DEFAULT_BKMODE;
    m_crTextColor = DEFAULT_TEXT_COLOR;
    m_crBkColor = DEFAULT_BK_COLOR;
    m_uFormat = DEFAULT_FORMAT;
    m_iTextHeight = DEFAULT_TEXT_HEIGHT;
}

CText:: ~ CText()
... {
    if(m_pszText != NULL)
    ...{
        delete [] m_pszText;
        m_pszText = NULL;
    }
}

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


// --------------------------------------------------------------------
// Description:
//     Set the text. If you want to display the text ,you should call the Display()
//
// --------------------------------------------------------------------
BOOL CText::SetText( const  TCHAR  * pszText)
... {
    ULONG ulLen = _tcslen(pszText);

    if(m_pszText == NULL)
    ...{        
        m_pszText = new TCHAR [ulLen + 1];
        
        if(m_pszText == NULL)
        ...{
            return FALSE;
        }

        m_ulSizeText = ulLen + 1;
    }
    else if(ulLen + 1 > m_ulSizeText)
    ...{
        delete [] m_pszText;

        m_pszText = new TCHAR [ulLen + 1];
        
        if(m_pszText == NULL)
        ...{
            return FALSE;
        }

        m_ulSizeText = ulLen + 1;
    }

    _tcscpy(m_pszText,pszText);

    return TRUE;
}


// --------------------------------------------------------------------
// Description:
//     Display the text stored.
//
// --------------------------------------------------------------------
void  CText::Draw(HDC hdc)
... {
    COLORREF crOldTextColor = ::SetTextColor(hdc,m_crTextColor);
    COLORREF crOldBkColor = ::SetBkColor(hdc,m_crBkColor);
    int iOldMode = ::SetBkMode(hdc,m_iBkMode);

    LOGFONT lf = ...{0};
    HFONT hFontNew, hFontOld;
    lf.lfQuality = CLEARTYPE_QUALITY;
    lf.lfHeight = -1 * (m_iTextHeight * GetDeviceCaps(hdc,LOGPIXELSY) / 72); //pound
    hFontNew = CreateFontIndirect(&lf);
    hFontOld = (HFONT) SelectObject(hdc, hFontNew);

    DrawText(hdc,m_pszText,-1,&m_rcWndPos,m_uFormat);

    SelectObject(hdc, hFontOld);
    DeleteObject(hFontNew);

    ::SetTextColor(hdc,crOldTextColor);
    ::SetBkColor(hdc,crOldBkColor);
    ::SetBkMode(hdc,iOldMode);
}


// --------------------------------------------------------------------
// Description:
//     Set the background mode.
//
// 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 CText::SetBkMode( int  iMode)
... {
    if(iMode == OPAQUE || iMode == TRANSPARENT)
    ...{
        m_iBkMode = iMode;
        return TRUE;
    }
    else
    ...{
        return FALSE;
    }
}


// --------------------------------------------------------------------
// Description:
//     Set the text color
//
// --------------------------------------------------------------------
void  CText::SetTextColor(COLORREF crColor)
... {
    m_crTextColor = crColor;
}


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

// --------------------------------------------------------------------
// Description:
//     Set Format.
//
// Parameters:
//     The value you should see the uFormat of DrawText()
// --------------------------------------------------------------------
void  CText::SetFormat(UINT uFormat)
... {
    m_uFormat = uFormat;
}


// --------------------------------------------------------------------
// Description:
//     Set the height of text as pound
//
// ---------------------------------------------------------------------
void  CText::SetTextHeight( int  iHeight)
... {
    m_iTextHeight = iHeight;
}


// --------------------------------------------------------------------
// Description:
//     Get the position as rect
//
// ---------------------------------------------------------------------
void  CText::GetPosition(RECT  * prcOut)
... {
    *prcOut = m_rcWndPos;
}