/*

* Copyright (c) 2005 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:    LandmarksUi Content File -

*     See class description below

*

*/

#ifndef CLMKLANDMARK_H

#define CLMKLANDMARK_H

//  INCLUDES

#include <e32base.h>

#include <badesca.h>

#include <EPos_CPosLandmark.h>

#include <EPos_CPosLandmarkCategory.h>

// CLASS DECLARATION

/**

*  This is a container class for a landmark.

*

*  A landmark is principally a location with a name.

*

*  The landmark object can either be created by a client or retrieved from

*  @ref CPosLandmarkDatabase.

*

*  A landmark consists of a number of landmark attributes, e.g. landmark name,

*  landmark position, coverage area, etc.

*

*  A landmark may also contain generic position fields. These position fields

*  are defined in LbsFields.h. Only text fields are supported.

*

*  CLmkLandmark contains functions for setting and getting landmark attributes

*  and position fields.

*

*  Note that CLmkLandmark is only a local representation of the landmark. To

*  update the database, call @ref CPosLandmarkDatabase::UpdateLandmarkL (or

*  @ref CPosLandmarkDatabase::AddLandmarkL for a new landmark).

*

*  @lib eposlandmarks.lib

*  @since S60 3.0

*  @version $Revision: 1.15 $, $Date: 2005/07/07 13:40:48 $

*/

class CLmkLandmark : public CBase

    {

    public:  // Constructors and destructor

        /**

        * Two-phased copy constructor.

        *

        * @param aLandmark The landmark to copy.

        * @returns A copy of the specified landmark object.

        */

        IMPORT_C static CLmkLandmark* NewL(

        const CPosLandmark*  aLandmark,

        const RPointerArray<CPosLandmarkCategory>& aCategories

       );

       const CLmkLandmark&  aLandmark);

        /**

        * Destructor.

        */

        virtual ~CLmkLandmark();

    public://New Functions

        IMPORT_C CPosLandmark* PosLandmark();

        IMPORT_C RPointerArray<CPosLandmarkCategory>& Categories();

    private:

        /**

        * C++ default constructor.

        */

        CLmkLandmark();

        CLmkLandmark(const CPosLandmark* aLandmark,

                     const RPointerArray<CPosLandmarkCategory>& aCategories);

        // Prohibit copy constructor

        CLmkLandmark(const CLmkLandmark&);

        // Prohibit assigment operator

        CLmkLandmark& operator= (const CLmkLandmark&);

        void ConstructL(const CPosLandmark* aLandmark,

                     const RPointerArray<CPosLandmarkCategory>& aCategories);

    private:    // Data

    CPosLandmark*  iLandmark;

    RPointerArray<CPosLandmarkCategory> iCategories;

    };

#endif      // CLMKLANDMARK_H

// End of File