/*

* Copyright (c) 2008 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:  Focus appearance drawer

*

*/

#ifndef _XNFOCUSCONTROL_H

#define _XNFOCUSCONTROL_H

// System includes

#include <e32base.h>

// Forward declarations

class CXnAppUiAdapter;

class CWindowGc;

/**

 * Focus appearance drawer

 * 

 * @ingroup group_xnlayoutengine

 * @lib xn3layoutengine.lib

 * @since S60 5.0

 */

    {

public:    

    // Constructors and destructor

    /**

     * Two-phased constructor.

     */

    static CXnFocusControl* NewL( CXnAppUiAdapter& aAppUiAdapter );

    /**

     * Two-phased constructor. Leaving on stack

     */

    static CXnFocusControl* NewLC( CXnAppUiAdapter& aAppUiAdapter );

    /**

     * Destructor

     */

    ~CXnFocusControl();

private:

    // private constructors

    /**

     * Leaving constructor

     */

    void ConstructL();

    /**

     * C++ default constructor

     */

    CXnFocusControl( CXnAppUiAdapter& aAppUiAdapter );

public: 

    // new functions

    /**

     * Makes focus viisble

     * 

     * @since S60 5.0     

     * @param aVisible, ETrue visible, EFalse invisible

     */

    void MakeVisible( TBool aVisible );

    /**

     * Queries whether focus is visible

     * 

     * @since S60 5.0     

     * @return ETrue if focus visible, EFalse otherwise

     */    

    TBool IsVisible() const;

    /**

     * Draws the 1st state and 2nd state focus appearenace

     * 

     * @since S60 5.0

     * @param aRect Rect where to draw

     * @param aGc Context

     */

    void Draw( const TRect& aRect, CWindowGc& aGc ) const;

private:

    // new functions

    void DoMakeVisibleL( TBool aVisible );

private:

    // data

    /** AppUiAdapter, Not owned */

    CXnAppUiAdapter& iAppUiAdapter;

    /** Flag to indicate whether it is allowed to show focus */

    TBool iVisible;

    /** Flag to indicate refusal */

    TBool iRefused;

    };

#endif // _XNFOCUSCONTROL_H