在Symbian系统中,ListBox的使用是比较复杂的,也是比较常用的,应该先从最简单的CAknSingleStyleListBox入手来尝试。基本实现步骤就是:先声明一个列表组件CAknSingleStyleListBox* iListBox,然后在Container的ConstructL中去创建它,接着在合适的地方需要去给ListBox增加内容。具体编程如下:
先声明一个列表组件:CAknSingleStyleListBox* iListBox;
然后在Container的ConstructL中去创建它:
void CUniNewsAppContainer::ConstructL(const TRect& aRect)
{
CreateWindowL();
//add your code here ...
//construct a listbox
iListBox = new(ELeave) CAknSingleStyleListBox;
iListBox->SetContainerWindowL( *this);
iListBox->SetListBoxObserver(this);
iListBox->ConstructL(this,EAknListBoxSelectionList|EAknListBoxLoopScrolling);
iListBox->CreateScrollBarFrameL(ETrue);
iListBox->ScrollBarFrame()->SetScrollBarVisibilityLCEikScrollBarFrame::EOn,CEikScrollBarFrame::EOn);
iListBox->ItemDrawer()->ColumnData()->EnableMarqueeL(ETrue);
iListBox->SetRect(aRect);
SetRect(aRect);
ActivateL();
}
这里有几句话:
一是SetScrollBarVisibilityL设置使用滚动条;
二是ItemDrawer()->ColumData()->EnableMarqueeL()让选中的文本超长后可以左右滚动。
有一点比较奇怪,我得先设置ListBox的Rect才能设置整个Container的Rect?否则ListBox会不占整个主面板的位置。
接着在合适的地方需要去给ListBox增加内容:
void CUniNewsAppContainer::InitListBox(TInt tabId)
{
if(iListBox==NULL) return;
CDesCArray* list = static_cast<CDesCArray*>( iListBox->Model()->ItemTextArray() );
TBuf<256> str;
list->Reset();
CUniNewsAppView * appView = STATIC_CAST(CUniNewsAppUi*,iCoeEnv->AppUi())->iAppView;
RArray<TNewsContent>* rc = appView->iChannelHandler->GetContents();
for(TInt i=0;i<rc->Count();i++)
{
if((*rc)[i].pid==tabId)
{
str.FillZ(str.MaxLength());
str.Format(KITEMFORMAT,(*rc)[i].title);
list->AppendL(str);
}
}
iListBox->HandleItemAdditionL();
iListBox->SetFocus( ETrue );
iListBox->SetCurrentItemIndexAndDraw(appView->iListIndex);
iListBox->ActivateL();
iListBox->DrawNow();
}
这里的HandleItemAdditionL()通知一下ListBox模型作了增加操作,同样还有一个HandleItemRemovalL()则是通知ListBox作了一个删除操作。
这里的KITEMFORMAT定义是"/t%S"。这里的格式似乎挺重要的,一般是:图标ID/t题头字串/t主要字串/t图标ID/t图标ID。
因为没有用到图标所以是一个/t%S,这个/t不可省略。如果用图标,则变成%d/t%S了,同时还要增加iconArray在创建iListBox的时候。
CAknIconArray* icons =new(ELeave) CAknIconArray(2);
CleanupStack::PushL(icons);
icons->ConstructFromResourceL(R_ICON_LISTICONS);
iListBox->ItemDrawer()->ColumnData()->SetIconArray(icons);
CleanupStack::Pop();
在ListBox中有一个叫Model()的还有一个叫View()的,从名字上就可以看出它们的含义了。前面我们从Model中操作列表内容,而我们可以从View中获取ItemDrawer去操作列表显示的一些参数:
iListBox->ItemDrawer()->SetFont(ApacPlain12());
但是我觉得有一点不爽的是,缺省生成的列表框字体比较大,不是太喜欢,在网上搜了一下,似乎那个设置字体的方法对我的机器不管用?
不过有一种方法是可行的,只是比较麻烦,那就是自己去实现ListBox,以及它的ItemDrawer。在网上看到的代码我试了一下,还行。方法如下。
第一步作一个自己的ItemDrawer:
class CCustomListItemDrawer: public CListItemDrawer
{
public:
CCustomListItemDrawer(const CEikTextListBox& aListBox);
~CCustomListItemDrawer();
private:
virtual void DrawActualItem(TInt aItemIndex, const TRect& aActualItemRect, TBool aItemIsCurrent, TBool aViewIsEmphasized, TBool aViewIsDimmed, TBool aItemIsSelected) const;
public:
void SetIconArray(CArrayPtr<CGulIcon>* aIconArray);
TSize MaxIconSize() const;
private:
void DeleteIconArray();
void CalculateMaxIconSize();
private:
const CEikTextListBox& iListBox;
CArrayPtr<CGulIcon>* iIconArray;
TSize iMaxIconSize;
};
实现的代码中最重要的就是那个DrawActualItem方法负责具体的绘制工作,从它的参数表中足够得到绘制所需的信息,剩下的事情就是用SystemGc去绘制。
第二步是作一个自己的ListBox控件:
class CCustomListBox: public CEikTextListBox
{
public: // constructors
CCustomListBox();
void ConstructL(const CCoeControl* aParent, TInt aFlags = 0);
public: // from CEikTextListBox
virtual TKeyResponse OfferKeyEventL(const TKeyEvent& aKeyEvent, TEventCode aType);
private: // from CEikTextListBox
virtual void CreateItemDrawerL();
};
在它的CreateItemDrawerL()中创建成员iItemDrawer = new (ELeave) CCustomListItemDrawer(*this)。而OfferKeyEvent主要的作用是处理上下方向键。