/*
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: Taskswitcher Fast Swap area UI
*
*/
#ifndef TSFASTSWAPGRID_H_
#define TSFASTSWAPGRID_H_
#include <AknGrid.h>
#include <aknconsts.h>
#include "tsdevicestate.h"
class CAknsFrameBackgroundControlContext;
class CTsFastSwapTimer;
/**
* Observer for handling fast swap grid events
*/
class MTsFastSwapGridObserver
{
public:
/**
* Called when close icon is tapped on the grid item.
*
* @param aItemIdx index of the the item for which close icon
* has been tapped
*/
virtual void HandleCloseEventL( TInt aItemIdx ) = 0;
};
class MTsFastSwapTimerObserver
{
public:
/**
* Called when timer is completed
*/
virtual void TimerCompletedL( CTsFastSwapTimer* aSource ) = 0;
};
/**
* Avkon grid implementing custom item drawer
*/
class CTsFastSwapGrid:
public CAknGrid,
public MTsDeviceStateObserver,
public MTsFastSwapTimerObserver
{
public: // enums
enum TFastSwapGridBehaviour
{
// Highlight always visible
EHybrid,
// Touch only highlight handling
ETouchOnly
};
public: // Constructor and destructor
CTsFastSwapGrid();
~CTsFastSwapGrid();
void ConstructL( const CCoeControl* aParent );
public: // From CCoeControl
void HandlePointerEventL( const TPointerEvent &aPointerEvent );
void HandleResourceChange( TInt aType );
void SizeChanged();
void Draw( const TRect& aRect ) const;
public: //From MTsDeviceStateObserver
/**
* Called when a change, to which the observer is registered,
* has happened.
*/
virtual void HandleDeviceStateChanged( TChangeType aChangeType );
public: // New functions
/**
* Sets fast swap grid observer
*/
void SetFastSwapGridObserver( MTsFastSwapGridObserver* aObserver );
/**
* Set indexes of items which can be closed.
* Copies item index array.
*/
void SetCloseItemsL( RArray<TInt>& aItemIndex );
/**
* Checks if the item of given index is closable
*/
TBool CanCloseItem( TInt aItemIndex );
/**
* Checks if the given item's close icon has been tapped.
*/
TBool IsItemCloseHit( TInt aItemIndex );
/**
* Resets index of the item that has been close icon hit
*/
void ResetCloseHit();
/**
* Sets color for the screenshot stroke.
*
* @param aColor color for the thumbnail
* @param aHighlightedColor color for thumbnail when item is highlighted
*/
void SetStrokeColors( TRgb aColor,
TRgb aHighlightedColor );
/**
* Sets items for which stroke will be drawn
*
* @param aItemIndex array of item indexes for which stroke
* is drawn
*/
void SetStrokeItemsL( RArray<TInt>& aItemIndex );
/**
* Sets grid behaviour
*
* @param aBehaviour behaviour to be set
*/
void SetGridBehaviour( TFastSwapGridBehaviour aBehaviour );
/**
* Getter for grid behaviour
*
* @return girds behaviour
*/
TFastSwapGridBehaviour GridBehaviour();
/**
* Shows highlight. In touch only behaviour highlight
* will be shown only for ammount of time.
*/
void ShowHighlight();
/**
* Hides highlight.
*/
void HideHighlight();
/**
* Checks if the highlight is currently visible.
*
* @return ETrue if highlight is visible
* EFalse if highlight is not visible
*/
TBool IsHighlightVisible();
/**
* Sets visible view, items outside of view will not be drawn
*/
void SetVisibleViewRect( const TRect aRect );
/**
* Returns visible view. Items outside of visible rectangle are not drawn.
*/
TRect VisibleViewRect();
/**
* Updates layout data for item drawer. Should be called when
* layout maybe out of date
*/
void UpdateItemDrawerLayoutDataL();
/**
* Enables/disables avkon event handling.
*
* @param aEnable if set to ETrue, pointer events will be forwarded
* to CAknGrid base class if necessary. If set to EFalse,
* no pointer events will be forwarded.
*/
void EnableAknEventHandling( TBool aEnable );
private: // From CAknGrid
virtual void CreateItemDrawerL();
private: // From MTsFastSwapTimerObserver
void TimerCompletedL( CTsFastSwapTimer* aSource );
private: // New functions
/**
* Loads close icon bitmap and mask
*/
void LoadCloseIconAndStrokeParams();
/**
* Redraws grid and parent controls
*/
void Redraw();
private: // Data
// Grid's parent
const CCoeControl* iParent;
// Close icon handling
RArray<TInt> iCloseItems;
TInt iCloseIconHitIdx;
MTsFastSwapGridObserver* iFastSwapGridObserver;
CTsFastSwapTimer* iCloseIconRedrawTimer;
// Highlight handling
TFastSwapGridBehaviour iBehaviour;
TBool iHighlightVisible;
// Visible view rectangle (horizontal scrolling support)
TRect iVisibleViewRect;
// Flag controlling input handling by grid
TBool iAknEventHandlingEnabled;
};
/**
* Custom item drawer for drawing grid items
*/
class CTsGridItemDrawer: public CFormattedCellListBoxItemDrawer
{
public: // Constructor and destructor
CTsGridItemDrawer( CTsFastSwapGrid* aGrid,
CFormattedCellListBoxData* aData );
~CTsGridItemDrawer();
public: // New functions
/**
* Sets close icon drawn for items that can be closed.
* Ownership transferred.
*/
void SetCloseIcon( CFbsBitmap* aBmp, CFbsBitmap* aBmpMask,
CFbsBitmap* aBmpPressed, CFbsBitmap* aBmpPressedMask );
/**
* Initializes close icon rectangles.
*
* @param aButtonRect rectangle for the button, coordinates must be relative to the grid item
* @param aIconRect rectangle for the icon, coordinates must be relative to the grid item
*/
void SetCloseIconRect( const TRect& aButtonRect, const TRect& aIconRect );
/**
* Returns current close icon coordinates for the given item rectangle
*
* @param aItemRect rectangle of the item for which close button coordinates
* are to be returned
*/
TRect GetCloseButtonRect( const TRect& aItemRect ) const;
/**
* Sets screen offset for the item drawer to not draw items on the
* grid edges
*/
void SetEdgeOffset( TInt aLeftOffset, TInt aRightOffset );
/**
* Enables/Disables item drawer background redrawing
*
* @param aEnable if set to ETrue, background will be redrawn by item drawer
* if set to EFalse, background will not be redrawn
*/
void SetRedrawBackground( TBool aEnable );
/**
* Sets color for the screenshot stroke.
*
* @param aColor color for the thumbnail
* @param aHighlightedColor color for thumbnail when item is highlighted
*/
void SetStrokeColors( TRgb aNormalColor,
TRgb aHighlightedColor );
/**
* Sets items for which stroke will be drawn
*
* @param aItemIndex array of item indexes for which stroke
* is drawn.
*/
void SetStrokeItemsL( RArray<TInt>& aItemIndex );
/**
* Sets stroke offset and size: values must be relative
* to item rectangle.
*
* @param aStrokeOffset offset of the stroke rectangle relative
* to item rectangle
* @param aStrokeSize size of the stroke rectangle
*/
void SetStrokeOffset( TPoint aStrokeOffset, TSize aStrokeSize );
/**
* Set screen rectangle, used by the item drawer to determine
* drawn area.
*
* @param aRect screen rectangle
*/
void SetScreenRect( TRect aRect );
private: // From CFormattedCellListBoxItemDrawer
void DrawActualItem( TInt aItemIndex, const TRect& aActualItemRect,
TBool aItemIsCurrent, TBool aViewIsEmphasized,
TBool aViewIsDimmed, TBool aItemIsSelected ) const;
private: // New functions
/**
* Checks if the item rectangle is visible in the view.
*
* @param aItemRect rectangle of the item to be checked
* @return ETrue if rectangle is fully or partially visible
* EFalse if rectangle is not visible
*/
TBool IsItemRectVisible( const TRect& aItemRect ) const;
/**
* Checks if the aRectContained rectancle is contained by aRectContainig
*
* @param aRectContained rectangle that is suppose to be contained
* @param aRectContainig rectangle that is suppose to be containing
* @return ETrue if rectangle is fully contained
* EFalse if rectangle is not fully contained
*/
TBool IsRectContained(const TRect& aRectContained,
const TRect& aRectContainig) const;
/**
* Calculates current inner button rectangle for close icon
*/
TRect CalculateInnerButtonRect( const TRect& aOuterRect ) const;
private: // Data
// Not owned
CTsFastSwapGrid* iGrid;
// Owned
CFbsBitmap* iCloseIcon;
CFbsBitmap* iCloseIconMask;
CFbsBitmap* iCloseIconPressed;
CFbsBitmap* iCloseIconPressedMask;
TRect iScreenRect;
TInt iLeftOffset;
TInt iRightOffset;
// Close button data
TRect iCloseIconRect;
TRect iCloseButtonRect;
TBool iRedrawBackground;
// Stroke data
TRgb iStrokeColor;
TRgb iHighlightStrokeColor;
RArray<TInt> iStrokeItems;
TRect iStrokeRect;
};
/**
* Timer class for handling highlight bevaiour
*/
class CTsFastSwapTimer : public CTimer
{
public:
// Constructor
CTsFastSwapTimer( MTsFastSwapTimerObserver& aObserver );
// Destructor
~CTsFastSwapTimer();
// 2nd phase constructor
void ConstructL();
private: // From CTimer
void RunL();
private: // Data
MTsFastSwapTimerObserver* iObserver; // not own
};
#endif /* TSFASTSWAPGRID_H_ */