idlehomescreen/sapiwrapper/hspswrapper/inc/plugininfo.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 26 Jan 2010 11:48:23 +0200
changeset 4 4d54b72983ae
parent 0 f72a12da539e
permissions -rw-r--r--
Revision: 201001 Kit: 201004

/*
* 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:  Presents plugin info using states uid, interface, type and name
*
*/



#ifndef C_CPLUGININFO_H
#define C_CPLUGININFO_H

#include <e32base.h>

namespace hspswrapper{

/**
 *  Presents plugin info using states uid, interface, type and name
 *
 *  @code
 *  @endcode
 *
 *  @lib xnlayoutengine.lib
 *  @since S60 v5.0
 */
class CPluginInfo : public CBase
    {
public:    
    /**
     * Two-phased constructor.
     */
    IMPORT_C static CPluginInfo* NewL();
    IMPORT_C static CPluginInfo* NewLC();


    /**
    * Destructor.
    */
    IMPORT_C virtual ~CPluginInfo();

    /**
     * Set configuration uid
     *
     * @param aUid configuration uid
     */
    IMPORT_C CPluginInfo& SetUidL(const TDesC8& aUid);
        
    /**
     * Get configuration uid
     *
     * @return configuration uid or KNullDesC8
     */
    IMPORT_C const TDesC8& Uid()const;
        
    /**
     * Set configuration type
     *
     * @param aType configuration type
     */
    IMPORT_C CPluginInfo& SetTypeL(const TDesC8& aType);
        
    /**
     * Get configuration type
     *
     * @return configuration type or KNullDesC8
     */
    IMPORT_C const TDesC8& Type()const;
        
    /**
     * Set configuration interface
     *
     * @param aInterface configuration interface
     */
    IMPORT_C CPluginInfo& SetInterfaceL(const TDesC8& aInterface);
        
    /**
     * Get configuration interface
     *
     * @return configuration interface or KNullDesC8
     */
    IMPORT_C const TDesC8& Interface()const;
        
    /**
     * Set configuration name
     *
     * @param aName configuration name
     */
    IMPORT_C CPluginInfo& SetNameL(const TDesC8& aName);
        
    /**
     * Get configuration name
     *
     * @return configuration name or KNullDesC8
     */
    IMPORT_C const TDesC8& Name()const;

    /**
     * Set configuration state
     *
     * @param aConfigurationState configuration state
     */    
    IMPORT_C CPluginInfo& SetConfigurationStateL(
        const TDesC8& aConfigurationState);

    /**
     * Get configuration state
     *
     * @return configuration state or KNullDesC8
     */
    IMPORT_C const TDesC8& ConfigurationState()const;

    /**
     * Set widget multiinstance
     *
     * @param aMultiInstance widget multiinstance
     */
    IMPORT_C CPluginInfo& SetMultiInstanceL( const TInt32 aMultiInstance );

    /**
     * Get widget multiinstance
     *
     * @return widget multiinstance or KNullDesC8
     */
    IMPORT_C const TInt32& MultiInstance()const;

    
    /**
     * Get max children for the plugin
     *
     * @return max children
     */
    IMPORT_C const TInt32& MaxChild() const;

    /**
     * Set maximum of children allowed
     *
     * @param aMaxChild max. number of children
     */
    IMPORT_C CPluginInfo& SetMaxChild( const TInt32 aMaxChild );    
    
    /**
     * Set widget description (TDesC8)
     *
     * @param aDescription widget description
     */
    IMPORT_C CPluginInfo& SetDescriptionL( const TDesC8& aDescription );
    
    /**
     * Get widget description
     *
     * @return Description widget description or KNullDesC
     */
    IMPORT_C const TDesC8& Description() const;
    
    /**
     * Set Logo icon
     *
     * @param aLogoIcon logo icon
     */
    IMPORT_C CPluginInfo& SetLogoIconL( const TDesC& aLogoIcon );

    /**
     * Set Logo icon (TDesC8)
     *
     * @param aLogoIcon logo icon
     */
    IMPORT_C CPluginInfo& SetLogoIconL( const TDesC8& aLogoIcon );
    
    /**
     * Get Logo icon
     *
     * @return LogoIcon logo icon or KNullDesC
     */
    IMPORT_C const TDesC& LogoIcon() const;
    
private:

    CPluginInfo();

    void ConstructL();


private: // data

    /**
     * Own. Plugin uid
     */
    HBufC8* iUid;
    
    /**
     * Own. Plugin interface
     */
    HBufC8* iInterface;
    
    /**
     * Own. Plugin type
     */
    HBufC8* iType;
    
    /**
     * Own. Plugin name
     */
    HBufC8* iName;

    /**
     * Own. Plugin configuration state
     */    
    HBufC8* iConfigurationState;    
    
    /**
     * Number of children allowed
     */
    TInt32 iMaxChilds;
   
    /**
     * Own. Plugin description
     */
    HBufC8* iDescription;
    
    /**
     * Own. Plugin logo icon
     */
    HBufC* iLogoIcon;

    /**
     * Own. Plugin instances
     */
    TInt32 iMultiInstance;
    };
}

#endif // C_CPLUGININFO_H