/*
* Copyright (c) 2004-2007 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: Maps a Contact Model field to a Virtual Phonebook field.
*
*/
#ifndef VPBKCNTMODEL_TCONTACTFIELD_H
#define VPBKCNTMODEL_TCONTACTFIELD_H
// INCLUDES
#include <MVPbkStoreContactField.h>
#include <MVPbkStoreContactField2.h>
#include "TContactFieldData.h"
// FORWARD DECLARATIONS
class CContactItemField;
namespace VPbkCntModel {
// FORWARD DECLARATIONS
class CFieldTypeMap;
class CContact;
// CLASS DECLARATIONS
/**
* Maps a Contact Model field to a Virtual Phonebook field.
*/
NONSHARABLE_CLASS( TContactField ) :
public MVPbkStoreContactField,
public MVPbkStoreContactField2
{
public: // Constructors
/**
* Constructor. Sets the parent contact and resets other data to null
* values.
*/
TContactField(CContact& aParentContact);
/**
* Destructor.
*/
~TContactField();
public: // New functions
/**
* Sets the Contact Model field to map.
*
* @param aCntModelField Contact Model field to map to
* MVPbkContactField.
*/
void SetField
(CContactItemField& aCntModelField);
/**
* Sets a new parent contact for this field. Resets the Contact Model
* field mapping to null.
*/
void SetParentContact(CContact& aParentContact);
/**
* Creates a new field instance that points to the same native
* contact item
* @return a new field
*/
MVPbkStoreContactField* CloneLC() const;
CContactItemField* NativeField() const;
TInt NativeFieldIndex() const;
public: // from MVPbkStoreContactField
virtual MVPbkBaseContact& ParentContact() const;
const MVPbkFieldType* MatchFieldType(TInt aMatchPriority) const;
const MVPbkFieldType* BestMatchingFieldType() const;
TBool SupportsLabel() const;
/// @precond SetField has been called
TPtrC FieldLabel() const;
/// @precond SetField has been called
void SetFieldLabelL(const TDesC& aText);
TInt MaxLabelLength() const;
/// @precond SetField has been called
const MVPbkContactFieldData& FieldData() const;
/// @precond SetField has been called
MVPbkContactFieldData& FieldData();
/// @precond SetField has been called
TBool IsSame(const MVPbkBaseContactField& aOther) const;
MVPbkContactLink* CreateLinkLC() const;
TAny* StoreContactFieldExtension(TUid aExtensionUid);
public: // from MVPbkStoreContactField2
CArrayFix<TInt>* SpeedDialIndexesL();
public: // from MVPbkObjectHierarchy
MVPbkObjectHierarchy& ParentObject() const;
protected: // Access for TNewContactField
/// Used by TNewContactField
void ResetNativeField();
private: // Data
/// Ref: Parent contact
CContact* iParentContact;
/// Ref: Contact model field
CContactItemField* iCntModelField;
/// Ref: field data
TContactFieldData iFieldData;
};
// INLINE FUNCTIONS
inline CContactItemField* TContactField::NativeField() const
{
return iCntModelField;
}
} // namespace VPbkCntModel
#endif // VPBKCNTMODEL_TCONTACTFIELD_H
//End of file