/*

* Copyright (c) 2006, 2007 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:  Single style implementation for the abstract tree node class.

*

*/

#ifndef C_AKNSINGLESTYLETREENODE_H

#define C_AKNSINGLESTYLETREENODE_H

#include "akntreenode.h"

/**

 *  Single style implementation for the abstract tree node class.

 *

 *  Single style tree nodes can contain single row of text, separate icon

 *  for expaneded and collapsed state, and two optional icons. Each of these

 *  icons can also have an alternate representation, which is used when the

 *  item is highlighted.

 *

 *  @lib aknhlist.lib

 *  @since S60 v3.2

 */

NONSHARABLE_CLASS( CAknSingleStyleTreeNode ) : public CAknTreeNode

    {

public:

    /** Icon types for single style tree node. */

    enum TIconType

        {

        /** Icon for node's expanded state. */

        EExpandedIcon,

        /** Icon for node's collapsed state. */

        ECollapsedIcon,

        /** First optional icon. */

        EOptIcon1,

        /** Second optional icon. */

        EOptIcon2,

        /** Highlighted icon for node's expanded state. */

        EHighlightedExpandedIcon,

        /** Highlighted icon for node's collapsed state. */

        EHighlightedCollapsedIcon,

        /** Highlighted first optional icon. */

        EHighlightedOptIcon1,

        /** Highlighted second optional icon. */

        EHighlightedOptIcon2

        };

    /**

     * Two-phased constructor. Creates a single style tree node instance.

     *

     * @param aText Text for the node.

     *

     * @param aFlags Flags.

     *

     * @return Pointer to the newly created object.

     *

     * @leave KErrNoMemory Not enough memory.

     */

    static CAknSingleStyleTreeNode* NewL( const TDesC& aText, TUint32 aFlags );

    /**

     * Otherwise identical to @c NewL, but leaves the newly created object in

     * the cleanup stack.

     *

     * @copydoc CAknSingleStyleTreeNode::NewL( const TDesC&, TUint32 )

     *

     * @post Pointer to the newly created object is left in cleanup stack.

     */

    static CAknSingleStyleTreeNode* NewLC( const TDesC& aText, TUint32 aFlags );

    /**

     * Destructor.

     */

    virtual ~CAknSingleStyleTreeNode();

    /**

     * Text of the node.

     *

     * @return Text.

     */

    const TDesC& Text() const;

    /**

     * Sets the text for the node. Does not change the position of the node

     * in the tree.

     *

     * @param aText Text.

     *

     * @param aDrawNow @c ETrue to redraw the item after the text is changed.

     *

     * @leave KErrNoMemory Not enough memory.

     */

    void SetTextL( const TDesC& aText, TBool aDrawNow );

    /**

     * Returns the icon ID set for the specified icon type.

     *

     * @param aType Type of the icon. 

     *

     * @return The icon ID for the icon of specified type.The value

     *      @c AknTreeListIconID::KDefault is returned, if no icon for the

     *      specified type is set.

     */

    TInt Icon( TIconType aType ) const;

    /**

     * Sets an icon ID for a specified tree node icon type. The icon ID

     * indicates which icon from the tree is used when the icon of specified

     * type is drawn by the node.

     *

     * @param aType The icon type for which the icon ID is changed. The type

     *      has to be one of the types defined in @c TIconType enumeration.

     *

     * @param aIconId The new icon ID for the specified icon type. The value

     *      @c AknTreeListIconID::KDefault indicates that the default icon

     *      for the type is to be used.

     *

     * @param aDrawNow @c ETrue to redraw the item after the icon is changed.

     */

    void SetIcon( TIconType aType, TInt aIconId, TBool aDrawNow );

    /**

     * Determines which icon ID is to be used when drawing the node. The used

     * icon depends on the value of @c aFocused parameter, which icon IDs have

     * been set, and whether the node is expanded or collapsed.

     *

     * @param aFocused @c ETrue, if icon ID for focused item is required.

     *

     * @return Icon ID.

     */

    TInt IconId( TBool aFocused ) const;

    /**

     * Determines which icon ID is to be used for the specified optional icon.

     *

     * @param aIndex Index specifying the optional icon.

     *

     * @param aFocused @c ETrue, if icon ID for focused item is required.

     *

     * @return Icon ID for specified optional icon.

     */

    TInt OptionalIconId( TInt aIndex, TBool aFocused ) const;

    /**

     * Text variety depending on given optional icon IDs.

     *

     * @param aOptIconId1 Icon ID for first optional icon.

     *

     * @param aOptIconId2 Icon ID for second optional icon.

     *

     * @return Text layout variety.

     */

    TInt TextVariety( TInt aOptIconId1, TInt aOptIconId2 ) const;

// from base class CAknTreeItem

    /**

     * From CAknTreeItem.

     * Returns the type of the item.

     *

     * @return Item type.

     */

    TInt Type() const;

    /**

     * From CAknTreeItem.

     * Draws the node.

     *

     * @param aGc Graphic context.

     *

     * @param aItemRect Item rectangle.

     *

     * @param aRect Rectangle that needs to be redrawn.

     *

     * @param aFocused @c ETrue, when the item is focused.

     */

    void Draw( CWindowGc& aGc, const TRect& aItemRect,

        const TRect& aRect, TBool aFocused ) const;

    /**

     * From CAknTreeItem.

     * Handles pointer events.

     *

     * @param aPointerEvent Pointer event.

     *

     * @param aItemRect Item rectangle.

     */

    void HandlePointerEventL( const TPointerEvent& aPointerEvent,

        const TRect& aItemRect );

private:

    /**

     * C++ constructor.

     *

     * @param aFlags Flags.

     */

    CAknSingleStyleTreeNode( TUint32 aFlags );

    /**

     * Second phase constructor.

     *

     * @param aText Text.

     */

    void ConstructL( const TDesC& aText );

private: // data

    /**

     * Text.

     * Own.

     */

    HBufC* iText;

    /**

     * Icon ID for expanded node icon.

     */

    TInt iExpandedIcon;

    /**

     * Icon ID for collapsed node icon.

     */

    TInt iCollapsedIcon;

    /**

     * Icon ID for first optional node icon.

     */

    TInt iOptIcon1;

    /**

     * Icon ID for second optional node icon.

     */

    TInt iOptIcon2;

    /**

     * Icon ID for highlighted expanded node icon.

     */

    TInt iHighlightedExpandedIcon;

    /**

     * Icon ID for highlighted collapsed node icon.

     */

    TInt iHighlightedCollapsedIcon;

    /**

     * Icon ID for first highlighted optional node icon.

     */

    TInt iHighlightedOptIcon1;

    /**

     * Icon ID for second highlighted optional node icon.

     */

    TInt iHighlightedOptIcon2;

    };

#endif // C_AKNSINGLESTYLETREENODE_H