diff -r ff572dfe6d86 -r 9674c1a575e9 menufw/menufwui/mmwidgets/inc/mmlistboxitemdrawer.h --- a/menufw/menufwui/mmwidgets/inc/mmlistboxitemdrawer.h Fri Mar 12 15:41:49 2010 +0200 +++ b/menufw/menufwui/mmwidgets/inc/mmlistboxitemdrawer.h Mon Mar 15 12:39:47 2010 +0200 @@ -12,7 +12,7 @@ * Contributors: * * Description: CMmListBoxItemDrawer -* Version : %version: MM_38.1.15 % << Don't touch! Updated by Synergy at check-out. +* Version : %version: MM_38.1.16 % << Don't touch! Updated by Synergy at check-out. * */ @@ -94,42 +94,42 @@ * @since S60 v3.0 */ ~CMmListBoxItemDrawer(); - + /** * Enables/disables cached data use. - * + * * When aEnable is true: * Enables the use of cached data when drawing items. * This significantly improves performance. * Do not ever try to use this feature in edit mode. - * + * * When aEnable is false: * Restores the normal mode where data needed for drawing * items is retrieved from the model and the cached data * is updated with the information retrieved from the model - * + * * @param aEnable Self-explanatory. */ void EnableCachedDataUse( TBool aEnable ); - + /** * Returns ETrue if item drawer is using cached data. * To start/stop using cached data, use the @c EnableCachedDataUse * method. - * + * * @return ETrue if cached data is used, EFalse otherwise. */ TBool CachedDataUseIsEnabled() const; - + /** * This method should be called whenever items(s) are removed * in order to remove corresponding entries in the local * items data cache. - * + * * @param aItemCount current item count */ void TrimCacheSize( TInt aItemCount ); - + /** * Invalidates the cached data for all items. */ @@ -154,7 +154,7 @@ * @return Size of item. */ TSize GetItemSize( TInt aItemIndex, TBool aItemIsCurrent ) const; - + /** * Gets rect of indicator. * @@ -372,14 +372,14 @@ * @param aPosition Floating item index to be removed. */ void RemoveFloatingItem( TInt aPosition ); - + /** * Removes all floating items. * * @since S60 5.0 */ void RemoveFloatingItems(); - + /** * Gets floating item at particular index in the * floating item array. @@ -469,6 +469,14 @@ */ void SetHighlightShown( TBool aDrawn ); + /** + * Draws background and separator lines. + * + * @since S60 v3.0 + * @param aItemTextRect Item rectangle. + */ + void DrawBackgroundAndSeparatorLines( const TRect& aItemTextRect ) const; + protected: /** * From CListItemDrawer. Draws an item. @@ -499,26 +507,19 @@ TBool aItemIsCurrent, TBool aViewIsEmphasized, TBool aItemIsSelected ) const; /** - * Draws the actual item contents for the specified item in the specified + * Draws the actual item contents for the specified item in the specified * rectangle. * - * @param aItemIndex Index of the item to draw. - * @param aActualItemRect Area to draw into. - * @param aItemIsCurrent @c ETrue if the item is current. - * @param aViewIsEmphasized @c ETrue if the view is emphasised. + * @param aItemIndex Index of the item to draw. + * @param aActualItemRect Area to draw into. + * @param aItemIsCurrent @c ETrue if the item is current. + * @param aViewIsEmphasized @c ETrue if the view is emphasised. * @param aViewIsDimmed Ignored * @param aItemIsSelected @c ETrue if the item is selected. */ void DrawActualItem(TInt aItemIndex, const TRect& aActualItemRect, TBool aItemIsCurrent, TBool aViewIsEmphasized, TBool aViewIsDimmed, TBool aItemIsSelected) const; - /** - * Draws background and separator lines. - * - * @since S60 v3.0 - * @param aItemTextRect Item rectangle. - */ - void DrawBackgroundAndSeparatorLines( const TRect& aItemTextRect ) const; /** * Sets up item currently drawn item subcells. @@ -667,11 +668,11 @@ void SetupIconSubcellL( RArray& aTemplateChildArray, TInt aChildIndex, TInt aItemIndex, RBuf& aItemText, TInt& aSubcellIncrement ) const; - + /** * Determines whether a bitmap of given size needs scaling to be displayed * in a rectangular area of some given target size. - * + * * This method assumes that the bitmap will always be scaled with aspect * ratio preserved. A bitmap does not need scaling if its size meets either * of the two conditions: @@ -683,8 +684,8 @@ * 1 pixel. * Please note that a bitmap which is too small (i.e. neither its width or its * height is close to the target width/height) will be regarded as one that - * needs scaling. - * + * needs scaling. + * * @param aBmpSize size of the bitmap * @param aTargetSize size of the area where bitmap will be displayed * @return ETrue if bitmap does not need scaling @@ -728,13 +729,13 @@ * * @param aItemIndex An index of a currently drawn item. * @param aItemIsCurrent Is aItemIndex the current item index. - * @param aAllowHighlightForNonDraggedItem Should highlight be shown + * @param aAllowHighlightForNonDraggedItem Should highlight be shown * (set in case when effects are used). * @return ETrue if highlight is drawn for the actually drawn item. */ - TBool GetHighlightVisibility( TInt aItemIndex, + TBool GetHighlightVisibility( TInt aItemIndex, TBool aItemIsCurrent, TBool aAllowHighlightForNonDraggedItem ) const; - + /** * Returns backdrop visibility. * @@ -886,7 +887,7 @@ * Not own. */ CMmTemplateLibrary* iTemplateLibrary; - + /** * Storage for cached items data. The data is updated during normal operation * and used when iUseCache is ETrue. @@ -905,7 +906,7 @@ * Stores information on the last used subcells configuration. * Such information is needed to determine whether it is necessary to * setup subcells before drawing a particular item or is it possible - * to skip this step because the subcells are already set properly. + * to skip this step because the subcells are already set properly. */ mutable TMmSubcellsSetupCode iLastSubcellsSetupCode; @@ -913,17 +914,17 @@ * Set to ETrue if item has backdrop. */ mutable TBool iItemHasBackdrop; - + /** * Number of subcells in iData. */ mutable TInt iCurrentNumberOfSubcellsSet; - + /** * A structure that stores color information needed to draw an item. */ mutable CFormattedCellListBoxData::TColors iColors; - + /** * ETrue if the item that was last drawn was a floating item. */