/*
* Copyright (c) 2010 Ixonos Plc.
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the "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:
* Ixonos Plc
*
* Description:  
*
*/


#ifndef SINGLEPARAMCONTROL_H
#define SINGLEPARAMCONTROL_H

//  INCLUDES
#include <eiklabel.h>
#include "PreviewControlBase.h"

//  FORWARD DECLARATIONS
class CCoeControl;
class CAknView;
class MSingleParControlObserver;
class CPluginInfo;
class CHorizontalSlider;

#ifdef RD_TACTILE_FEEDBACK 
class MTouchFeedback;
#endif /* RD_TACTILE_FEEDBACK  */

/*	CLASS: CSingleParamControl
 *
 *   CSingleParamControl represents a single parameter adjustment UI control,
 *   that can be used by any of the plug-ins just by defining a UI type to
 *   resource file.
 */
class CSingleParamControl : public CPreviewControlBase
	{
public:

	/** @name Methods:*/
	//@{

	/** NewL factory method, pops cleanupstack
	 *
	 *   @param aRect - control rectangle
	 *	 @param aParent - pointer to window owning control
	 *   @param aActionOnButtonRelease - To indicate if rendering should happen only when
	 *   the button1 is released, i.e. when dragging has stopped. Default value is false.
	 *   @return - pointer to the newly created CSingleParamControl instance
	 */
	IMPORT_C static CSingleParamControl * NewL (
			const TRect & aRect,
			CCoeControl * aParent,
			TBool aActionOnButtonRelease = EFalse
	);

	/** Default constructor
	 *
	 *	@param -
	 *	@return -
	 */
	IMPORT_C CSingleParamControl ();

	/** Second phase constructor
	 *
	 *   @see CImageEditorControlBase
	 */
	IMPORT_C virtual void ConstructL (
			const TRect & aRect,
			CCoeControl * aParent,
			TBool aActionOnButtonRelease
	);

	/** Destructor
	 *
	 *	@param -
	 *	@return -
	 */
	IMPORT_C virtual ~CSingleParamControl ();

	/*	SetView
	 *
	 *   @see CImageEditorControlBase
	 */
	IMPORT_C virtual void SetView (CAknView * aView);

	/*	SetSelectedUiItemL
	 *
	 *   @see CImageEditorControlBase
	 */
	IMPORT_C virtual void SetSelectedUiItemL (CPluginInfo * aItem);

	/*	OfferKeyEventL
	 *
	 *   @see CImageEditorControlBase
	 */
	IMPORT_C virtual TKeyResponse OfferKeyEventL (
			const TKeyEvent & aKeyEvent,
			TEventCode aType
	);

	/**	HandlePointerEventL	
	 *
	 *	@see CCoeControl
	 */
	IMPORT_C virtual void HandlePointerEventL( const TPointerEvent &aPointerEvent );

	/*	SetParObserver 
	 *
	 *   Sets the MSingleParControlObserver for the control.
	 *
	 *	@param aObserver - parameter observer
	 *	@return -
	 */
	IMPORT_C void SetParObserver (MSingleParControlObserver * aObserver);

	/*	HandlePluginCommandL
	 *
	 *   @see CImageEditorControlBase
	 */
	IMPORT_C virtual void HandlePluginCommandL (const TInt aCommand);

	/*	GetSoftkeyIndexL
	 *
	 *   @see CImageEditorControlBase
	 */
	IMPORT_C virtual TInt GetSoftkeyIndexL();

	/*	GetNaviPaneTextL
	 *
	 *	@see CImageEditorControlBase
	 */
	IMPORT_C virtual TPtrC GetNaviPaneTextL (
			TBool& aLeftNaviPaneScrollButtonVisibile,
			TBool& aRightNaviPaneScrollButtonVisible);

	// these functions are for adjusting the slider
	IMPORT_C void SetSliderMinimumAndMaximum(TInt aMin, TInt aMax);
	IMPORT_C void SetSliderPosition(TInt aPosition);
	IMPORT_C void SetSliderStep(TUint aStep);
	IMPORT_C void SetSliderStepAmount(TUint8 aAmount);
	IMPORT_C void SetIcon(CEikImage* aIcon);
	IMPORT_C void SetCaption(const TDesC& aText);
	IMPORT_C TInt Position() const;

	// from CCoeControl
	IMPORT_C TInt CountComponentControls() const;
	IMPORT_C CCoeControl* ComponentControl(TInt aIndex) const;
	IMPORT_C void SizeChanged();

	//@}

protected:

private:

	/** @name Methods:*/
	//@{

	/*	Draw
	 *
	 *   @see CImageEditorControlBase
	 */
	IMPORT_C virtual void Draw (const TRect & aRect) const;

	//@}
	/// Parameter adjustment observer
	MSingleParControlObserver * iParObserver;

	IMPORT_C void CountImageSizesAndPositions();
	IMPORT_C void MoveSlider(TInt aSteps);

protected:

	/// Plug-in info
	CPluginInfo* iItem;

	/// View reference
	CAknView* iEditorView;

	/// drag flag
	TBool iDragging;
	
	/// should rendering happen only when the button is released
	TBool iActionOnButtonRelease;

	/// touch area
	TRect iTouchRect;

	/// minimum value of the slider
	TInt iMinimumValue;

	/// maximum value of the slider
	TInt iMaximumValue;

	/// step value
	TUint iStep;
	TUint iStepInPixels;

	/// number of steps
	TUint8 iNumberOfSteps;

	/// current position
	TInt iPosition;

	/// popup graphics
	RPointerArray<CEikImage> iBorders;

	/// scrollbar graphics
	RPointerArray<CEikImage> iScrollBar;

	/// caption text
	CEikLabel* iText;

	/// icon graphic, owned
	CEikImage* iIcon;

	/// use selection graphic
	TBool iMarkerPressed;

	// Feedback for screen touch:
#ifdef RD_TACTILE_FEEDBACK 
	MTouchFeedback* iTouchFeedBack;
#endif /* RD_TACTILE_FEEDBACK  */

	};

#endif

// End of File