/*
* 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: Qt search document field APIs
*
*/
#ifndef _QCPIXDOCUMENTFIELD_H
#define _QCPIXDOCUMENTFIELD_H
#ifdef BUILD_DLL
#define DLL_EXPORT Q_DECL_EXPORT
#else
#define DLL_EXPORT Q_DECL_IMPORT
#endif
/**
* @file
* @ingroup Qt Search ClientAPI
* @brief Contains CCPixDocument field APIs
*/
#include <QObject>
//Forward decelaration
class QCPixDocumentFieldPrivate;
/**
* @brief Represents the fields of documents returned as a result of a search query.
* @ingroup ClientAPI
*
* Link against: QCPixSearchClient.lib
*/
class DLL_EXPORT QCPixDocumentField: public QObject
{
Q_OBJECT
public:
/**
* Constructor.
* Creates a QCPixDocumentField object and return a pointer to the created object.
* @param aName Name of the field
* @param aValue Value of the field
* @param aConfig Config for the field
* @return A pointer to the created instance of QCPixDocumentField.
*
* @note After using this constructor, the client has to mandatorily call
* SetDatabase() before invoking any search.
*/
static QCPixDocumentField* newInstance( const QString aName, const QString aValue, const int aConfig );
/**
* Destructor.
*/
virtual ~QCPixDocumentField();
/**
* Getter: Gets the name of the field.
* @return The name of the field
*/
QString name() const;
/**
* Getter: Gets the Value of the field.
* @return The value of the field
*/
QString value() const;
/**
* Getter: Gets the Config of the field.
* @return The config of the field
*/
int config() const;
/**
* Setter: Sets the Name of the field.
* @param aName The name of the field
*/
void setName(const QString aName);
/**
* Setter: Sets the Value of the field.
* @param aValue The value of the field
*/
void setValue(const QString aValue);
/**
* Setter: Sets the Name of the field.
* @param aConfig The config of the field
*/
void setConfig(const int aConfig);
private:
/**
* Constructor.
* Creates a QCPixDocumentField object and return a pointer to the created object.
* @param aName Name of the field
* @param aValue Value of the field
* @param aConfig Config for the field
* @return A pointer to the created instance of QCPixDocumentField.
*/
QCPixDocumentField(const QString aName, const QString aValue, const int aConfig);
private:
QCPixDocumentFieldPrivate* const iPvtImpl;
Q_DECLARE_PRIVATE_D( iPvtImpl, QCPixDocumentField )
};
#endif //_QCPIXDOCUMENTFIELD_H