Symbian中大段文本显示控件，使用系统滚动条，可自动换行

有些时候我们想显示一个大段的文本内容，但是我们去找不到合适的控件。或者觉得系统控件太单调，无法满足需求是，我们需要自定义控件，来实现我们自己想要的效果。我这个自定义控件实现了，文本的自动换行，添加了系统的滚动条和一些简单的文本显示，

 

废话不多说了，直接贴出代码吧！！

 

.h文件

/*
============================================================================
 Name        : TextDisplay.h
 Author      : Barrett
 Version     :
 Copyright   : Your copyright notice
 Description : CTextDisplay declaration
============================================================================
*/

#ifndef TEXTDISPLAY_H
#define TEXTDISPLAY_H

// INCLUDES
#include <COECNTRL.H> //Link against:cone.lib
#include <fbs.h>//Link against:fbscli.lib
#include <gulicon.h>
#include <aknutils.h>
#include <avkon.hrh>
// CLASS DECLARATION

/**
*  CTextDisplay
*
*/
class CTextDisplay : public CCoeControl
{
public: // Constructors and destructor

 /**
        * Destructor.
        */
 ~CTextDisplay();

        /**
        * Two-phased constructor.
        */
 static CTextDisplay* NewL(const TRect &aRect,CCoeControl* aParent);

        /**
        * Two-phased constructor.
        */
 static CTextDisplay* NewLC(const TRect &aRect,CCoeControl* aParent);
 TKeyResponse OfferKeyEventL(const TKeyEvent &aKeyEvent, TEventCode aType);

private:

 /**
        * Constructor for performing 1st stage construction
        */
 CTextDisplay();

 void Draw( const TRect& aRect ) const;

 /**
        * EPOC default constructor for performing 2nd stage construction
        */
 void ConstructL(const TRect &aRect,CCoeControl* aParent);
private:
 // display content
 RPointerArray<HBufC> *iDisplayContent;
 // 起始位置为第几行
 TInt iStartLine;
 //字体颜色
 TRgb iFontColour;
 //文字总行数
 TInt iTotalLine;
 //文字显示区域
 TRect iRect;
 //文字字体
 CFont *iFont;
 //滚动条宽度
 TInt iScrollBarWidth;
 //控件背景色
 TRgb iBackGround;
 //文字显示开始位置
 TPoint iStartPoit;
 //每行文字间的间距
 TInt iLineToLineSpace;
 //一屏幕显示的最大行数
 TInt iMaxDisplayLine;

 CCoeControl *iParent;

 //系统滚动条
 CEikScrollBarFrame* iSBFrame;
 TEikScrollBarModel iModel;

 //创建系统滚动条
 void CreateScrollBars(TInt aCunt);
public:
 //计算文字中行数
 void AccountTotalLine();
 //计算一屏幕显示的最大行数
 TInt GetMaxDisplay();
 void SetScrollBarWidth(TInt aWidth);
 //设置背景颜色
 void SetBackground(TRgb aRgb);
 //设置显示的文字
 void SetDisplayContent(const TDesC& aContent,TBool aUseFlag = EFalse);
 //设置文字显示字体
 void SetFont(CFont *aFont);
 //设置文字显示颜色
 void SetFontColour(TRgb aRgb);
 
};

#endif // TEXTDISPLAY_H

 

 

.cpp文件

/*
============================================================================
 Name        : TextDisplay.cpp
 Author      : Barrett
 Version     :
 Copyright   : Your copyright notice
 Description : CTextDisplay implementation
============================================================================
*/

#include "TextDisplay.h"
//#include "AuditionContainer.h"

_LIT(KLineStart,"<Line>");
_LIT(KLineEnd,"</Line>");
#define MAXDISPLAYLINE 10
#define LINESPACE 3
#define LASTSPACE 25

CTextDisplay::CTextDisplay()
{
 // No implementation required
// iBackGroundBitmap = NULL;
 iStartLine = 0;
 iTotalLine = 0;
 iFontColour = KRgbBlack; // default
 iStartPoit = TPoint(3,5);
 iLineToLineSpace = LINESPACE;
 iScrollBarWidth = 10;
}

CTextDisplay::~CTextDisplay()
{

 if (iDisplayContent)
 {
  iDisplayContent->ResetAndDestroy();
  delete iDisplayContent;
  iDisplayContent = NULL;
 }
 if(iSBFrame)
 {
  delete iSBFrame;
  iSBFrame = NULL;
 }
}

CTextDisplay* CTextDisplay::NewLC(const TRect &aRect,CCoeControl* aParent)
{
 CTextDisplay* self = new (ELeave)CTextDisplay();
 CleanupStack::PushL(self);
 self->ConstructL(aRect,aParent);
 return self;
}

CTextDisplay* CTextDisplay::NewL(const TRect &aRect,CCoeControl* aParent)
{
 CTextDisplay* self=CTextDisplay::NewLC(aRect,aParent);
 CleanupStack::Pop(); // self;
 return self;
}

void CTextDisplay::ConstructL(const TRect &aRect,CCoeControl* aParent)
{
// SetRect(aRect);
 iRect = aRect;

 TFontSpec fontSpec = iEikonEnv->DenseFont()->FontSpecInTwips();
 fontSpec.iHeight *= 1;
 iCoeEnv->ScreenDevice()->GetNearestFontInTwips(iFont,fontSpec);
 iMaxDisplayLine = GetMaxDisplay();
 iParent = aParent;
 
}

TKeyResponse CTextDisplay::OfferKeyEventL(const TKeyEvent &aKeyEvent, TEventCode aType)
{
 if((aType == EEventKeyDown) && (aKeyEvent.iScanCode == EStdKeyDownArrow))
 {
  if(iTotalLine >= iStartLine+iMaxDisplayLine)
  {
   ++iStartLine;
  }
 }
 else if((aType == EEventKeyDown) && (aKeyEvent.iScanCode == EStdKeyUpArrow))
 {
  if(iStartLine > 0)
  {
   --iStartLine;
  }
 }
 iSBFrame->MoveVertThumbTo(iStartLine);//绝对坐标
 iSBFrame->DrawScrollBarsNow();
 DrawNow();
 return EKeyWasConsumed;
}

void CTextDisplay::SetDisplayContent(const TDesC& aContent,TBool aUseFlag)
{
 if(aContent.Length() == 0)
 {
  return ;
 }
 if (iDisplayContent)
 {
  iDisplayContent->ResetAndDestroy();
  delete iDisplayContent;
  iDisplayContent = NULL;
 }

 iDisplayContent = new RPointerArray<HBufC>;

 HBufC *CopyText = aContent.Alloc();
 
 if(aUseFlag)
 {
  TBuf<6> bufBeginTag(KLineStart);
  TBuf<7> bufEndTag(KLineEnd);
  
  while(CopyText->Length())
  {
   TInt posBegin = CopyText->Find(bufBeginTag)+bufBeginTag.Length();
   TInt posEnd = CopyText->Find(bufEndTag);
   if(posBegin!=KErrNotFound&&posEnd!=KErrNotFound)
   {
    TPtrC ptrPerson = CopyText->Mid(posBegin,posEnd-posBegin);
    HBufC *HText = ptrPerson.Alloc();
    iDisplayContent->Append(HText);
    if(CopyText->Length() > posEnd+bufEndTag.Length()+1)
    {
     CopyText->Des().Copy(CopyText->Des().Right(CopyText->Length()-posEnd-bufEndTag.Length()));
    }
    else
    {
     break;
    }
   }
  }
  delete CopyText;
 }
 else
 {
  iDisplayContent->Append(CopyText);
 }
 //获取一屏幕显示的行数
 //计算文字显示总行数
 AccountTotalLine();
 CreateScrollBars(iTotalLine-iMaxDisplayLine+2);
}

void CTextDisplay::Draw( const TRect& aRect ) const
{
 CWindowGc& gc = SystemGc();

 gc.SetBrushColor(iBackGround);
 gc.Clear(aRect);
 
 gc.UseFont(iFont);
 gc.SetPenColor(iFontColour);
 //起点
 TPoint point = iStartPoit;
 //记录上一段的位置
 TPoint Mark = TPoint(0,-(iStartLine*iFont->HeightInPixels()+iLineToLineSpace));
 TPoint point2;
 if(iDisplayContent == NULL)
 {
  gc.DrawText(_L("No content!"),TPoint(aRect.Width()/3,aRect.Height()/3));
  return ;
 }
 for(TInt i=0;i<iDisplayContent->Count();i++)
 {
  TInt nStringMaxDisplayLine = iFont->TextWidthInPixels((*iDisplayContent)[i]->Des())/(iRect.Width() - iScrollBarWidth) + iMaxDisplayLine;

  TBidiText* bidi = TBidiText::NewL((*iDisplayContent)[i]->Des(), nStringMaxDisplayLine);
  bidi->WrapText(iRect.Width()-iScrollBarWidth, *iFont, NULL);
  TInt lines = bidi->NumberOfLinesInDisplayText();
  for(TInt i=0; i<lines; i++)
  {
   point2 = TPoint (point.iX,point.iY+Mark.iY + iFont->HeightInPixels()*(i+1)+iLineToLineSpace*i);
   TInt width = 0;
   TPtrC text = bidi->LineOfDisplayText(i, width);
   gc.DrawText(text, point2);
  }
  Mark = point2;
  delete bidi;
 }
 //画个小三角
 if(Mark.iY > iRect.Height() - LASTSPACE || iStartLine > 0)
 {
  gc.SetBrushStyle(CGraphicsContext::ESolidBrush);
  gc.SetPenStyle(CGraphicsContext::ENullPen);
  gc.SetBrushColor(KRgbBlue);
  gc.DrawRect(TRect(TPoint(0,iRect.Height()-LASTSPACE),TSize(iRect.Width(),LASTSPACE)));
  gc.SetBrushColor(KRgbBlack);
  TInt nTrigonWidth = 12;         //默认三角宽12个像素
  TInt nTrigonHeight = 12;         //默认三角高12个像素
  //三角形第一的点的横纵坐标
  TInt PointX = aRect.Width()/2;
  TInt PointY = aRect.Height()  - LASTSPACE + (LASTSPACE- 2*nTrigonHeight - 1)/2;
  if(iTotalLine >= iStartLine + iMaxDisplayLine && iTotalLine > iMaxDisplayLine)
  {
   CArrayFixFlat<TPoint>* ArrPoint = new (ELeave) CArrayFixFlat<TPoint>(10);
   ArrPoint->AppendL(TPoint(PointX-nTrigonWidth/2,PointY + 1 + nTrigonHeight)); // +1表示 两个三角的间距
   ArrPoint->AppendL(TPoint(PointX+nTrigonWidth/2,PointY + 1 + nTrigonHeight)); // +1表示 两个三角的间距
   ArrPoint->AppendL(TPoint(PointX,PointY+2*nTrigonHeight));
   gc.DrawPolygon(ArrPoint);
   delete ArrPoint;
  }
  if(iStartLine > 0)
  {
   CArrayFixFlat<TPoint>* ArrPoint = new (ELeave) CArrayFixFlat<TPoint>(10);
   ArrPoint->AppendL(TPoint(PointX,PointY));
   ArrPoint->AppendL(TPoint(PointX-nTrigonWidth/2,PointY+nTrigonHeight));
   ArrPoint->AppendL(TPoint(PointX+nTrigonWidth/2,PointY+nTrigonHeight));
   gc.DrawPolygon(ArrPoint);
   delete ArrPoint;
  }
  gc.SetBrushStyle(CGraphicsContext::ENullBrush);
 }

}
void CTextDisplay::SetFontColour(TRgb aRgb)
{
 iFontColour = aRgb;
}

void CTextDisplay::SetFont(CFont *aFont)
{
 iFont = aFont;
 iMaxDisplayLine = GetMaxDisplay();
}

void CTextDisplay::SetBackground(TRgb aRgb)
{
 iBackGround = aRgb;
}

void CTextDisplay::AccountTotalLine()
{
 for(TInt i=0;i<iDisplayContent->Count();i++)
 {
  TInt nStringMaxDisplayLine = iFont->TextWidthInPixels((*iDisplayContent)[i]->Des())/(iRect.Width() - iScrollBarWidth) + iMaxDisplayLine;
  TBidiText* bidi = TBidiText::NewL((*iDisplayContent)[i]->Des(), nStringMaxDisplayLine);
  bidi->WrapText(iRect.Width()-iScrollBarWidth, *iFont, NULL);
  TInt lines = bidi->NumberOfLinesInDisplayText();
  iTotalLine += lines;
  delete bidi;
 }
}

TInt CTextDisplay::GetMaxDisplay()
{
 return (iRect.Height() - LASTSPACE - iStartPoit.iY)/(iFont->HeightInPixels() + iLineToLineSpace);
}

void CTextDisplay::SetScrollBarWidth(TInt aWidth)
{
 iScrollBarWidth = aWidth;
}

//创建系统滚动条
void CTextDisplay::CreateScrollBars(TInt aCunt)
{
 //构造
 iSBFrame=new(ELeave) CEikScrollBarFrame(iParent, NULL,ETrue);
 iSBFrame->CreateDoubleSpanScrollBarsL(ETrue, EFalse,ETrue,ETrue);
 iSBFrame->SetTypeOfVScrollBar(CEikScrollBarFrame::EDoubleSpan);
 iSBFrame->SetScrollBarVisibilityL(CEikScrollBarFrame::EOff,
  CEikScrollBarFrame::EAuto);
 

 iModel = TEikScrollBarModel(aCunt, 1, 0);
 //设置区域
 TRect aRect;
 aRect = TRect(TPoint(iRect.Width()-iScrollBarWidth,iRect.iTl.iY),TSize(iScrollBarWidth,iRect.Height()-LASTSPACE));
 iSBFrame->Tile(&iModel,aRect);
 //设置初始位置-绝对坐标
 iSBFrame->MoveVertThumbTo(0);
 iSBFrame->DrawScrollBarsNow();
}
// End of File 

 

在container中的使用

第一步：在container中定义一个成员

 CTextDisplay *iTextDisplay;

第二步：在constructl中初始化

代码如下： //这里是为了方便直接从文件中读出一段文本

_LIT(KAbout,"C://about.ini");
 
 RFs fs = CEikonEnv::Static()->FsSession();
 RFile fp;
 TInt err = fp.Open(fs,KAbout,EFileRead);
 if(err == 0)
 {
  TInt nFileSize = 0;
  fp.Size(nFileSize);
  HBufC8* fileInfo = HBufC8::NewLC(nFileSize);
  TPtr8 file = fileInfo->Des();
  fp.Read(file, nFileSize);
  HBufC* fileInfo16 = HBufC::NewLC(file.Length());
  TPtr16 ptr = fileInfo16->Des();

  /*ptr.Copy(file);*/
  ConvGbk2Uni(file, ptr);
 
  iTextDisplay = CTextDisplay::NewL(aRect,this);
  iTextDisplay->SetDisplayContent(fileInfo16->Des());
  iTextDisplay->SetContainerWindowL(*this);
  iTextDisplay->SetExtent(TPoint(0,0), TSize(240, 320));
  CleanupStack::PopAndDestroy(2);
 }
 fp.Close();

 

在一段代码写在ActivateL函数之前，原因我就不说了。ConvGbk2Uni函数的代码我也贴出来。如下：

 

void ConvGbk2Uni(TDesC8& original, TDes& res)       //这个函数不是我写的，从网上搜的
{
 //RFs aFileServerSession = CEikonEnv::Static()->FsSession();
 RFs aFileServerSession;
 aFileServerSession.Connect();
 // CleanupStack::Pop();
 CCnvCharacterSetConverter* converter=CCnvCharacterSetConverter::NewLC();

 if(converter->PrepareToConvertToOrFromL(KCharacterSetIdentifierGbk,aFileServerSession)!=CCnvCharacterSetConverter::EAvailable)
  User::Leave(KErrNotSupported);

 TInt state=CCnvCharacterSetConverter::KStateDefault;

 TPtrC8 str( original );
 HBufC* iInfoText = HBufC::NewL( str.Length() );

 TPtr16 ptr = iInfoText->Des();

 if(CCnvCharacterSetConverter::EErrorIllFormedInput == converter->ConvertToUnicode(ptr, str, state))
  User::Leave(KErrArgument);

 res.Zero() ;
 res.Copy(ptr) ;
 aFileServerSession.Close();
 CleanupStack::PopAndDestroy();
 delete iInfoText;
}

 

第二步：CountComponentControls函数加1，ComponentControl函数返回控件指针。

第三步：在OfferKeyEventL函数中添加。

    return iTextDisplay->OfferKeyEventL(aKeyEvent,aType);

第四步：在析构函数中写好析构。

第五步：编译运行。

 

 

实现过程和使用过程还是比较简单的，使用过程和使用系统控件类似。在我这个控件中我提供了显示文本的两者方法。

第一种就是这里的这种，还有一种就是使用_LIT(KLineStart,"<Line>");
_LIT(KLineEnd,"</Line>");这对标签的。使用时把

iTextDisplay->SetDisplayContent(fileInfo16->Des());改成

iTextDisplay->SetDisplayContent(fileInfo16->Des()，ETrue);就可以了，这种显示的内容是<Line>你好吗</Line><Line>你好吗</Line>这种文本的。

 

在最后需要注意一个问题，在使用系统滚动条时，它需要窗口，这个窗口可以是共享父类的，也可以是控件自己定义的。如本文中的

//构造
 iSBFrame=new(ELeave) CEikScrollBarFrame(iParent, NULL,ETrue); iParent就是共享的父类窗口，如果这里不使用这个而是直接使用this的话，在下一句iSBFrame->CreateDoubleSpanScrollBarsL(ETrue, EFalse,ETrue,ETrue);中会有KERN-EXEC 3的panic，这个是我自己的理解也不知道对不对。希望知道的大婶，指点下~~