idlehomescreen/widgetmanager/inc/wmportalbutton.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Wed, 09 Jun 2010 09:29:04 +0300
branchRCL_3
changeset 26 1b758917cafc
parent 19 79311d856354
permissions -rw-r--r--
Revision: 201021 Kit: 2010123

/*
* 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:
* Declares portal button for WidgetManager
*
*/

#ifndef ___WMPORTALBUTTON_H__
#define ___WMPORTALBUTTON_H__

#include <aknbutton.h>	// CAknButton
#include <AknServerApp.h> //MAknServerAppExitObserver

#include "wmcommon.h"

// FORWARD DECLARATIONS
class CWmMainContainer;
class CFbsBitmap;
class CWmConfiguration;
class CWmProcessMonitor;
class CBrowserLauncher;
class CWmImageConverter;

/**
 * Portal button ( ovi, operator ) class for Wm
 * 
 * @class   CWmPortalButton wmportalbutton.h
 */
NONSHARABLE_CLASS( CWmPortalButton ) : public CAknButton,
                                       public MCoeControlObserver,
                                       public MAknServerAppExitObserver
    {
public:
    /*
     * Two-phased constructor.
     * 
     * @param aParent button title text
     * @param aPortalButtonIndex index of this button (0 or 1)
     */
    static CWmPortalButton* NewL(
            const CCoeControl* aParent,
            TInt aPortalButtonIndex = 0 );
    
    /** Destructor */
    virtual ~CWmPortalButton();
                                      
public: // Functions from base class

    /*
     * Draws the control.
     * 
     * @see CCoeControl::Draw
     */
    void Draw( const TRect& /*aRect*/ ) const;
    
    /**
     * Sets the control's extent, specifying a rectangle.
     * 
     * @see CCoeControl::SizeChanged
     */
    void SizeChanged();
    
    /**
     * Executes action for button pressed
     */
    void ExecuteL();
    
protected: // from MCoeControlObserver

    /** Observes the button's own activity  */
    void HandleControlEventL( CCoeControl* aControl, TCoeEvent aEventType );
    
protected: // from MAknServerAppExitObserver

    /** Observes when browser is exited  */
    void HandleServerAppExit( TInt aReason );
    
protected: // from CCoeControl

    /** Handles pointer events.  */
    void HandlePointerEventL( const TPointerEvent& aPointerEvent );
    
protected: // Constructors
    
    /** Constructor for performing 1st stage construction */
    CWmPortalButton( const TInt aFlags,
            TInt aPortalButtonIndex );
    
    /** 2nd phase constructor */
    void ConstructL( 
            CWmMainContainer* aParent,
            const TDesC& aText = KNullDesC,
            const TDesC& aIcon = KNullDesC );
    
private:

    /** size of button icon, defined in the layout */
    TSize LayoutIconSize() const;
    
    /** Draws text over button */
    void DrawText( CWindowGc& aGc,
                   const TDesC& aText, 
                   TAknTextComponentLayout& aLayout,
                   TInt aMargin ) const;
    
    /** Runs ovi store launcher */
    void RunOviL( CWmConfiguration& aConf );
    
    /**  Starts browser */ 
    void StartBrowserL( const TDesC& aUrl );
    
	/** Starts operator application */
    void RunOperatorApplicationL( CWmConfiguration& aConf );
    
	/** Starts rprocess by given values */
    void StartProcessL( TUid aUid, const TDesC& aParam );
    	
    /**
     * Opens cwrt/wrt widget to fullscreen. 
     * @param aAppUid Uid of the widget
     * @param aParams Optional parameters
     * */
    void StartWidgetL( TUid aAppUid, const TDesC& aParams );
    
private: //data members

    /**
     * the image converter utility
     */    
    CWmImageConverter*  iImageConverter;

    /**
     * Parent control
     */ 
    CWmMainContainer* iWmMainContainer;

    /** 
     * Button index
     */ 
    TInt iPortalButtonIndex;

    /** icon */
    CFbsBitmap* iButtonIcon;
    
    /** icon mask */
    CFbsBitmap* iButtonIconMask;
	
    /**
     * Monitors process 
     */
    CWmProcessMonitor* iProcessMonitor;

    /** 
     * Broswer launcher. 
     */
    CBrowserLauncher* iBrowserLauncher;

 	};

#endif //___WMPORTALBUTTON_H__

// End of File