/*
* Copyright (c) 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: This class handles columns.
*
*/
#ifndef C_XMPPSETTINGSCOLUMN_H
#define C_XMPPSETTINGSCOLUMN_H
#include <e32base.h>
class CRepository;
/**
* This class handles columns.
*
* This class contains all methods needed to read and write columns table.
*
*
* @lib jabbersettings.lib
* @since S60 5.0
*/
class CXmppSettingsColumn: public CBase
{
public:
/**
* Two-phased constructor.
* @return Instance of this class
*/
static CXmppSettingsColumn* NewL( CRepository& aRepository );
static CXmppSettingsColumn* NewLC( CRepository& aRepository );
/**
* Destructor
*/
virtual ~CXmppSettingsColumn();
/**
* This method checks that does this column exist. If it does not, it
* creates it (if requested. Otherwise it leaves.
*
* @since S60 5.0
* @param aAttrName Column name.
* @param aCreateColumnIfNotExist Should new column be created if it is
* not found.
* @param aColKey onn return contains the key of the column.
*/
void GetColumnKeyL( const TDesC& aAttrName,
TBool aCreateColumnIfNotExist,
TUint32& aColKey );
/**
* Tries to find columns key by it is name (value).
*
* @since S60 5.0
* @param aColumnName Name of the column.
* @param aColumnKey on return contains the columns key.
*/
void FindByNameL( const TDesC& aColumnName,
TUint32& aColumnKey );
private:
/**
* Default Contructor
*/
CXmppSettingsColumn( CRepository& aRepository );
void ConstructL();
/**
* This method resolves next free key to be used as column key.
*
* @since S60 5.0
* @param aColKey On return contains next free column key.
*/
void NextFreeSlotL( TUint32& aColKey );
private: // data
/**
* Handle to the Central Repository. Doesnt Own.
*/
CRepository& iRepository;
};
#endif // C_XMPPSETTINGSCOLUMN_H