/*

* Copyright (c) 2010 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:  CSifUiAppInfo for application details

*

*/

#ifndef C_SIFUIAPPINFO_H

#define C_SIFUIAPPINFO_H

#include <e32base.h>                            // CBase

class RWriteStream;

class CApaMaskedBitmap;

/**

 * CSifUiAppInfo transfers application details from a SIF plugin

 * to UI process in device dialog server. See also Swi::CAppInfo.

 *

 * @lib sifui.lib

 * @since 10.1

 */

class CSifUiAppInfo : public CBase

    {

    public:     // constructors and destructor

        /**

         * Creates new CSifUiAppInfo object and pushes it to cleanup stack.

         * Does not take the ownership of aAppIcon parameter.

         * @param aAppName - application name

         * @param aAppVendor - vendor name

         * @param aAppVersion - application version

         * @param aAppSize - application size in bytes

         * @param aAppIcon - application icon (or NULL if no icon)

         * @returns CSifUiAppInfo* -- new CSifUiAppInfo object

         */

        IMPORT_C static CSifUiAppInfo* NewLC( const TDesC& aAppName,

                const TDesC& aAppVendor, const TVersion& aAppVersion, TInt aAppSize,

                const CApaMaskedBitmap* aAppIcon );

        /**

         * Creates new CSifUiAppInfo object.

         * Does not take the ownership of aAppIcon parameter.

         * @param aAppName - application name

         * @param aAppVendor - vendor name

         * @param aAppVersion - application version

         * @param aAppSize - application size in bytes

         * @param aAppIcon - application icon (or NULL if no icon)

         * @returns CSifUiAppInfo* -- new CSifUiAppInfo object

         */

        IMPORT_C static CSifUiAppInfo* NewL( const TDesC& aAppName,

                const TDesC& aAppVendor, const TVersion& aAppVersion, TInt aAppSize,

                const CApaMaskedBitmap* aAppIcon );

        /**

         * Creates new CSifUiAppInfo object by copying existing object.

         * @param aAppInfo - application info to copy

         * @returns CSifUiAppInfo* -- new CSifUiAppInfo object

         */

        IMPORT_C static CSifUiAppInfo* NewL( const CSifUiAppInfo& aAppInfo );

        /**

         * Destructor.

         */

        ~CSifUiAppInfo();

    public:     // new functions

        /**

         * Application name.

         * @returns TDesC - application name

         */

        IMPORT_C const TDesC& Name() const;

        /**

         * Application vendor.

         * @returns TDesC - vendor name

         */

        IMPORT_C const TDesC& Vendor() const;

        /**

         * Application version.

         * @returns TVersion - application version

         */

        IMPORT_C const TVersion& Version() const;

        /**

         * Application size.

         * @returns TInt - application size

         */

        IMPORT_C TInt Size() const;

        /**

         * Application icon and mask bitmaps. Does not transfer ownership.

         * @returns CApaMaskedBitmap - icon and mask bitmaps, NULL if no bitmaps

         */

        IMPORT_C const CApaMaskedBitmap* Bitmaps() const;

        /**

         * Externalizes this object to the specified write stream.

         * @param aStream   Stream to which the contents is written.

         */

        IMPORT_C void ExternalizeL( RWriteStream& aStream ) const;

    private:    // new functions

        CSifUiAppInfo();

        void ConstructL( const TDesC& aAppName, const TDesC& aAppVendor,

                const TVersion& aAppVersion, TInt aAppSize,

                const CApaMaskedBitmap* aAppIcon );

        void ConstructL( const CSifUiAppInfo& aAppInfo );

    private:    // data

        HBufC* iAppName;

        HBufC* iAppVendor;

        TVersion iAppVersion;

        TInt iAppSize;

        CApaMaskedBitmap* iAppIcon;

    };

#endif  // C_SIFUIAPPINFO_H