/*
* Copyright (c) 2002-2004 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:           
*       Provides the CAknFepUICtrlCandidateCharacter definition.
*
*/












#ifndef __AKN_FEP_CANDIDATE_CHARACTER_PANE_H__
#define __AKN_FEP_CANDIDATE_CHARACTER_PANE_H__

#include <e32std.h>
#include <coecntrl.h>

#include "AknFepUICtrlCandidatePane.h"

class CEikLabel;
class MAknFepUIEventObserver;

/**
 * Control representing the selected candidate. Is a window owning control,
 * that appears over the candidate pane such that it obscures the labels
 * beneath. Can be hidden, for example if there is no visible selection, 
 * or if highlighting is disabled.
 */
NONSHARABLE_CLASS(CAknFepUICtrlCandidateCharacter) : public CCoeControl
    {
public:
    enum
        {
		EOneCandidate = 1,
        EMaxSelectedCandidateLength = 10 // extend buffer for phrase input
        };
public:

    /**
     * first phase construction
     */
    static CAknFepUICtrlCandidateCharacter* NewL( RWindowTreeNode& aParent, 
    		                                      MAknFepUIEventObserver* aObserver );

    /**
     * destructor
     */
    ~CAknFepUICtrlCandidateCharacter();

    /**
     * Set the text buffer of the character.
     *
     * @param aCharacter, the label will be filled with the characters from aCharacter
     */
    void SetText( const TDesC& aCharacter );

    /**
     * Get the text of the character
     *
     */
	const TDesC* Text() const;

public: // from CCoeControl
    /**
     * size changed
     */
    virtual void SizeChanged();

    /**
     * count component controls
     *
     * @return number of contained controls
     */
    TInt CountComponentControls() const;

    /**
     * Component control
     *
     * @param aIndex the control to return, must be between 0 and the number of controls
     * @return pointer to contained control, ownership is not passed
     */
    CCoeControl* ComponentControl(TInt aIndex) const;

    /**
     * draw
     *
     * @param aRect rectangle
     */
    virtual void Draw( const TRect& aRect ) const;
    
    /**
     * Set character highlight state
     *
     * @param bHighlight highlight or not
     */
    void SetHighlight( TBool bHightlight );

protected:
    /**
     * second phase construction
     */
    void ConstructL( RWindowTreeNode& aParent, MAknFepUIEventObserver* aObserver );

     /**
      * constructor
      */
    CAknFepUICtrlCandidateCharacter();

    /**
     * layout the rectangles
     */
    void LayoutRects();

    /**
     * layout contained controls
     */
    void LayoutContainedControls();

    /**
     * layout the background frames
     *
     * @param aOuterRect filled with outer rect coords
     * @param aInnerRect filled with inner rect coords
     *
     */
    void CalculateFrameRects(TRect& aOuterRect, TRect& aInnerRect) const;
    
private:
    TAknLayoutRect iRectShadow;
    TAknLayoutRect iRectHighlight;
	TBufC<EMaxSelectedCandidateLength> iBuffer;
	
private: // the following are owned
    CEikLabel* iCandidateLabel;
	TBool iIsHighligt;
    };

#endif //__AKN_FEP_CANDIDATE_CHARACTER_PANE_H__

// End of file