Symbian学习笔记(10)：使用ListBox

symbian中的ListBox比较复杂也是比较常用的，我只能先从最简单的CAknSingleStyleListBox入手来尝试看看。太复杂的东西不是我这样的新手要立刻去明白的。

先声明一个列表组件： 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()->SetScrollBarVisibilityL(CEikScrollBarFrame::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主要的作用是处理上下方向键。

关于ListBox的使用，可以参考这个地址： http://pagesperso-orange.fr/klisa/3650/ListBox/page01.html