Lists API: Changes

Lists API: Changes

The following header file(s) have changed between 3.0 and 3.1

aknlistboxsettingpage.h
eikclb.h
eikclbd.h
eikfrlb.h
eikfrlbd.h
eiklbx.h

**Table 2:** aknlistboxsettingpage.h
Type	Class	Change
New public method	`CAknListBoxSettingPage`	`static void CreateIconAndAddToArrayL( CArrayPtr<CGulIcon>*& aIconArray, const TAknsItemID& aId, const TInt aColorIndex, const TDesC& aBmpFile, const TInt32 aBmp, const TInt32 aBmpM );`

**Table 3:** eikclb.h
Type	Class	Change
New public method	`CEikColumnListBox`	`void EnableStretching( const TBool aEnabled );`
New public method	`CEikColumnListBox`	`void GetColorUseListL(CArrayFix<TCoeColorUse>& aColorUseList) const;`

**Table 4:** eikclbd.h
Type	Class	Change
New public method	`CColumnListBoxData`	`void DrawSimple(const TListItemProperties& aItemProperties, CWindowGc& aGc,const TDesC* aText,const TRect& aRect,TBool aHighlight,const TColors& aColors) const;`
New public method	`CColumnListBoxData`	`TBool HasHighlightAnim() const;`
New public method	`CColumnListBoxData`	`TBool DrawHighlightAnim( CBitmapContext& aGc, const TRect& aRect ) const;`
New public method	`CColumnListBoxData`	`void SetGraphicSubCellL(TInt aSubCell,const TAknWindowLineLayout& aGraphicLayout;);`
New public method	`CColumnListBoxData`	`void SetTextSubCellL(TInt aSubCell,const TAknTextLineLayout& aTextLayout;);`
New public method	`CColumnListBoxData`	`void SetConditionalSubCellL(TInt aSubCell, const TAknTextLineLayout& aTextLayout;,TInt aAffectedSubCell);`
New public method	`CColumnListBoxData`	`void SubCellsMightIntersect( const TBool aMightIntersect );`
New public method	`CColumnListBoxData`	`void SetStretchableGraphicSubCellL(TInt aSubCell, const TAknWindowComponentLayout& aNormalLayout, const TAknWindowComponentLayout& aStretchedLayout);`
New public method	`CColumnListBoxData`	`void SetStretchableTextSubCellL(TInt aSubCell, const TAknTextComponentLayout& aNormalLayout, const TAknTextComponentLayout& aStretchedLayout);`
New public method	`CColumnListBoxData`	`void SetStretchableConditionalSubCellL(TInt aSubCell, const TAknTextComponentLayout& aNormalLayout, const TAknTextComponentLayout& aStretchedLayout, TInt aNormalSubCell, TInt aStretchedSubCell );`
New public method	`CColumnListBoxData`	`void ResetSLSubCellArray();`
New public method	`CColumnListBoxData`	`TBool UsesScalableLayoutData() const;`
New public method	`CColumnListBoxData`	`void EnableStretching(const TBool aEnabled);`
New public method	`CColumnListBoxData`	`TBool StretchingEnabled() const;`

**Table 5:** eikfrlb.h
Type	Class	Change
New public method	`CFormattedCellListBoxItemDrawer`	`void WordWrapListItem( TPtr& aTarget, const TDesC& aItemString, TInt aFirstIndex, TInt aSecondIndex, TInt aItemIndex ) const;`
New public method	`CFormattedCellListBoxItemDrawer`	`void DrawBackgroundAndSeparatorLines( const TRect& aItemTextRect ) const;`
New public method	`CFormattedCellListBoxItemDrawer`	`void EnableStretching( const TBool aEnabled );`
New public method	`CFormattedCellListBoxItemDrawer`	`void HideSecondRow( const TBool aHide );`

**Table 6:** eikfrlbd.h
Type	Class	Change
New public method	`CFormattedCellListBoxData`	`void SetSubCellBaselinePosL(TInt aSubCellIndex, TInt aPos);`
New public method	`CFormattedCellListBoxData`	`void SetSubCellTextClipGapL(TInt aSubCellIndex, TInt aGap);`
New public method	`CFormattedCellListBoxData`	`TBool HasHighlightAnim() const;`
New public method	`CFormattedCellListBoxData`	`TBool DrawHighlightAnim( CBitmapContext& aGc, const TRect& aRect ) const;`
New public method	`CFormattedCellListBoxData`	`void SetCurrentlyDrawnItemIndex( TInt aIndex );`
New public method	`CFormattedCellListBoxData`	`void UseHighlightIconSwapping( TBool aUse );`
New public method	`CFormattedCellListBoxData`	`TBool UseHighlightIconSwapping() const;`
New public method	`CFormattedCellListBoxData`	`TSize SubCellRealSize(TInt aSubCellIndex) const;`
New public method	`CFormattedCellListBoxData`	`void SetSubCellRealSize(TInt aSubCellIndex, TSize aRealSize) const;`
New public method	`CFormattedCellListBoxData`	`TSize SubCellRealTextSize(TInt aSubCellIndex) const;`
New public method	`CFormattedCellListBoxData`	`void SetSubCellRealTextSize(TInt aSubCellIndex, TSize aRealSize) const;`
New struct	`CFormattedCellListBoxData`	`SSubCell`
New public method	`CFormattedCellListBoxData`	`void SetStretchableGraphicSubCellL(TInt aSubCell, const TAknWindowComponentLayout& aNormalLayout, const TAknWindowComponentLayout& aStretchedLayout);`
New public method	`CFormattedCellListBoxData`	`void SetStretchableTextSubCellL(TInt aSubCell, const TAknTextComponentLayout& aNormalLayout, const TAknTextComponentLayout& aStretchedLayout);`
New public method	`CFormattedCellListBoxData`	`void SetStretchableConditionalSubCellL(TInt aSubCell, const TAknTextComponentLayout& aNormalLayout, const TAknTextComponentLayout& aStretchedLayout, TInt aNormalSubCell, TInt aStretchedSubCell );`
New public method	`CFormattedCellListBoxData`	`void ResetSLSubCellArray();`
New public method	`CFormattedCellListBoxData`	`void EnableStretching(const TBool aEnabled);`
New public method	`CFormattedCellListBoxData`	`TBool StretchingEnabled() const;`
New public method	`CFormattedCellListBoxData`	`void HideSecondRow(const TBool aHide);`
New public method	`CFormattedCellListBoxData`	`TBool SecondRowHidden() const;`
New public method	`CFormattedCellListBoxData`	`void SubCellsMightIntersect( const TBool aMightIntersect );`
New public method	`CFormattedCellListBoxData`	`void ToggleDropShadows( const TBool aEnable );`

**Table 7:** eiklbx.h
Type	Class	Change
New public method	`CEikListBox`	`CEikScrollBarFrame* CreateScrollBarFrameL(TBool aPreAlloc, TBool aRemote);`
New public method	`CEikListBox`	`CEikScrollBarFrame* CreateScrollBarFrameL(TBool aPreAlloc, TBool aRemote, TBool aWindowOwning);`

The following header file(s) have changed between 3.1 and 3.2

eikclb.h
eikclbd.h
eikfrlbd.h
eiklbx.h

**Table 8:** eikclb.h
Type	Class	Change
New constructor	`CColumnListBoxItemDrawer`	`IMPORT_C CColumnListBoxItemDrawer();`

**Table 9:** eikclbd.h
Type	Class	Change
New public method	`CColumnListBoxData`	`IMPORT_C TUint32 CurrentItemTextWasClipped() const;`

**Table 10:** eikfrlbd.h
Type	Class	Change
New public method	`CFormattedCellListBoxData`	`void SetClippedByWrap( TUint32 aClippedCells, TBool aUseClippedByWrap );`
New public method	`CFormattedCellListBoxData`	`IMPORT_C TUint32 CurrentItemTextWasClipped() const;`
New public method	`CFormattedCellListBoxData`	`void UseScalableLayoutData( TBool aUse );`

**Table 11:** eiklbx.h
Type	Class	Change
New class	`MListBoxSelectionObserver`
New protected method	`CEikListBox`	`IMPORT_C void RedrawItem( TInt aItemIndex );`
New protected method	`CEikListBox`	`void UpdateMarkUnmarkMSKL() const;`
New public method	`CEikListBox`	`IMPORT_C void EnableMSKObserver(TBool aEnable);`
New public method	`CEikListBox`	`void DoShiftMSKMarkingL();`
New public method	`CEikListBox`	`void InformMSKButtonGroupDeletion();`
New public method	`CEikListBox`	`IMPORT_C void AddSelectionObserverL( MListBoxSelectionObserver* aObserver );`
New public method	`CEikListBox`	`IMPORT_C void RemoveSelectionObserver( MListBoxSelectionObserver* aObserver );`
New public method	`CEikListBox`	`void ChangeSelectionMode(TBool aEnable);`