/*
* Copyright (c) 2005-2006 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: Java Registy API header file
*
*/


#ifndef JAVAREGISTRYAPPLICATIONENTRY_H
#define JAVAREGISTRYAPPLICATIONENTRY_H

#include <e32base.h>
#include <e32cmn.h>
#include <f32file.h>
#include "javaregistryentry.h"
#include "javaregistryentrytype.h"

namespace Java
{
namespace Manager
{
namespace Registry
{

// FORWARD DECLARATION
class CWriteableJavaRegistryApplicationEntry;

}// namespace Registry
}// namespace Manager

// FORWARD DECLARATION
class CJavaRegistryPackageEntry;

/**
 * This subclass of CJavaRegistryEntry supports attributes
 * for single application, that can't contain embedded entries.
 *
 * @lib javaregistryclient.lib
 * @since S60 v3.2
 */
class CJavaRegistryApplicationEntry : public CJavaRegistryEntry
{
public:


    /**
     * CJavaRegistryApplicationEntry::CJavaRegistryApplicationEntry
     * constructor
     *
     * @since S60 v3.2
     * @param aWritableEntry Pointer to a writable entry, to delegate
     *          getter methods. Pointer ownership taken.
     */
    CJavaRegistryApplicationEntry(Java::Manager::Registry::
                                  CWriteableJavaRegistryApplicationEntry* aWritableEntry);

    /**
     * Tells if this application is startable.
     *
     * @since S60 v3.2
     * @return ETrue if the application is startable, EFalse otherwise.
     *         Default value if not set: ETrue.
     */
    IMPORT_C TBool IsStartable() const;

    /**
     * Tells if this application must be shown in Application Shell or
     * it must rather be hidden.
     *
     * @since S60 v3.2
     * @return ETrue if the application is shown in Application Shell,
     *         EFalse otherwise.
     *         Default value if not set: ETrue.
     */
    IMPORT_C TBool IsVisible() const;

    /**
     * Tells if the end user can not uninstall this application.
     *
     * @since S60 v3.2
     * @return ETrue if the application is resident, EFalse otherwise.
     *         Default value if not set: EFalse.
     */
    IMPORT_C TBool IsResident() const;

    /**
     * Gets the group name of this application. This property tells in
     * which folder the application icon shall appear. It can be a
     * null-string: in that case the Installed folder will be hosting
     * midlet icons.
     *
     * @since S60 v3.2
     * @return Group name of this application.
     *         Default value if not set:
     */
    IMPORT_C const TDesC& GroupName() const;

    /**
     * Gets a reference to the install package entry, which is the parent
     * of this application. E.g. if this entry represents a MIDlet this
     * method returns a reference to the corresponding MIDlet Suite entry.
     * The function may leave with one of the system-wide error codes.
     *
     * @since S60 v3.2
     * @return a CJavaRegistryEntry object. Caller takes over the
     *         ownership of the object being transferred.
     */
    IMPORT_C CJavaRegistryPackageEntry* PackageEntryL() const;

protected:

    /**
     * CJavaRegistryApplicationEntry::WritableEntry method returns the member
     * of the parent class, but first casts it to
     * CWriteableJavaRegistryApplicationEntry.
     *
     * @since S60 v3.2
     * @return Returns the member of this class.
     */
    Java::Manager::Registry::
    CWriteableJavaRegistryApplicationEntry* WritableEntry() const;

};

} // namespace Java

#endif // JAVAREGISTRYAPPLICATIONENTRY_H