/*
 * 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:
 *
 */

//
//  W A R N I N G
//  -------------
//
// FOR INTERNAL USE ONLY!
//
// This file is not the final version. These interfaces may and will
// change without any notice until they are final. Please do not use them.
//

#ifndef CNTUIEXTENSIONFACTORY_H
#define CNTUIEXTENSIONFACTORY_H

#include <QtPlugin>
#include <qcontact.h>

class CntContactCardActionSupplier;
class CntUiGroupSupplier;
class CntUiSocialExtension;
class CntEditViewItemSupplier;
class CntViewSupplier;

QTM_BEGIN_NAMESPACE
class QContact;
QTM_END_NAMESPACE

QTM_USE_NAMESPACE

/**
 * A factory which gives access to UI extension interfaces.
 * The plugin can extend the needed extensions and return null for the
 * unsupported extension types.
 *
 * Plugins must be exported to /resource/qt/plugins/contacts/extensions
 */
class CntUiExtensionFactory
{
 public:
    virtual ~CntUiExtensionFactory() {}

    /**
     * Gives access to an interface for extending UI with new groups.
     * @return Returns null if not supported. Ownership is not given.
     */
    virtual CntUiGroupSupplier* groupSupplier() = 0;

    /**
     * Gives access to an interface for extending edit view list with new items for a given contact.
     * @return Returns null if not supported. Ownership is not given.
     */
    virtual CntEditViewItemSupplier* editViewItemSupplier(QContact &contact) = 0;

    /**
     * Gives access to an interface for creating new views.
     * @return Returns null if not supported. Ownership is not given.
     */
    virtual CntViewSupplier* viewSupplier() = 0;

    virtual CntUiSocialExtension* socialExtension() = 0;

    virtual bool hasService(int serviceId) = 0;
    
    virtual void* ExtensionFactoryExt(
            int /*aExtensionId*/ )
    {
        return NULL;
    }

};

Q_DECLARE_INTERFACE(CntUiExtensionFactory, "com.nokia.contacts.uiextensionfactory/1.0")

#endif // CNTUIEXTENSIONFACTORY_H