/*

* Copyright (c) 2002 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:  Definition of CEntryLangDetails class.

*

*/

#ifndef ENTRYLANGDETAILS_H

#define ENTRYLANGDETAILS_H

// INCLUDE FILES

#include <e32base.h>

// FORWARD DECLARATIONS

class RReadStream;

class RWriteStream;

// CLASS DECLARATION

/**

 * Class used by CInstalledAppsRegistryEntry. This class is not exposed

 * outside of the entry. It contains a single Language/Package/Vendor

 * triplet. Each entry contains a collection of these language details.

 */

class CEntryLangDetails : public CBase

{

public:

    /**

    * Two-phase constructors.

    */

    static CEntryLangDetails* NewLC(TLanguage aLang,

                                    const TDesC& aPackageName,

                                    const TDesC& aVendor);

    static CEntryLangDetails* NewLC(RReadStream& aStream);

    static CEntryLangDetails* NewLC(const CEntryLangDetails& aOther);

    /**

    * Destructor.

    */

    virtual ~CEntryLangDetails();

    // attribute getters

    /**

    * Returns language assigned to this entry.

    */

    TLanguage Language() const;

    /**

    * Returns name of this package.

    */

    const TDesC& PackageName() const;

    /**

    * Returns name of the vendor of this package.

    */

    const TDesC& VendorName() const;

    // Streaming

    /**

    * Method used for serializing this object to a stream.

    * @param aStream Stream object used for serilazation.

    */

    void ExternalizeL(RWriteStream& aStream) const;

    /**

    * Returns the number of bytes a buffer, used for streaming, must

    * at least consist of.

    * @return Number of bytes required by a buffer used for storing.

    */

    TInt SizeForStreamingL() const;

private:

    // 1st and 2nd phase constructors

    /**

    * Constructor. Sets language.

    */

    CEntryLangDetails(TLanguage aLang = ELangEnglish);

    /**

    * Second-phase constructors.

    */

    void ConstructL(const TDesC& aPackage, const TDesC& aVendor);

    void ConstructL(RReadStream& aStream);

private:    // data member

    TLanguage iLanguage;

    HBufC* iPackageName;    // Owned.

    HBufC* iVendorName;     // Owned.

};

#endif // ENTRYLANGDETAILS_H