/*

* Copyright (c) 2004-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:  An interface for objects that can be expanded to a view

*

*/

#ifndef MVPBKEXPANDABLE_H

#define MVPBKEXPANDABLE_H

// INCLUDES

#include <e32std.h>

// FORWARD DECLARATIONS

class MVPbkContactViewBase;

class MVPbkContactViewObserver;

class MVPbkFieldTypeList;

// CLASS DECLARATIONS

/**

 * An interface for objects that can be expanded to a view

 *

 * E.g. a view contact that represents a group can be expanded

 * to the group members view.

 * @see MVPbkViewContact

 */

class MVPbkExpandable

    {

    protected: // destructor

        /**

         * Destructor.

         */

        virtual ~MVPbkExpandable() { }

    public: // interface

        /**

         * Returns an expanded view that is constructed asynchronously.

         *

         * A client must wait the expanded view to become ready before

         * usage.

         *

         * @param aObserver A contact view observer

         * @param aSortOrder A contact view sort order.

         * @return the expanded view.

         * @return The child view.

         */

        virtual MVPbkContactViewBase* ExpandLC(

            MVPbkContactViewObserver& aObserver,

            const MVPbkFieldTypeList& aSortOrder ) const =0;

        /**

         * Returns an extension point for this interface or NULL.

         *

         * @param aExtensionUid no extensions defined currently.

         * @return an extension point for this interface or NULL.

         */

        virtual TAny* ExpandableExtension( TUid /*aExtensionUid*/ ) 

                { return NULL; }

    };

#endif // MVPBKEXPANDABLE_H

//End of file