diff -r 64e38f08e49c -r 47d84de1c893 emailservices/nmclientapi/src/nmapimessagesearch.cpp --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/emailservices/nmclientapi/src/nmapimessagesearch.cpp Mon Oct 04 00:05:37 2010 +0300 @@ -0,0 +1,91 @@ +/* + * 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: + * Email messages search implementation. + */ + +#include "nmapiheaders.h" + +namespace EmailClientApi +{ + +NmApiMessageSearch::NmApiMessageSearch(QObject *parent, quint64 mailboxId) : + NmApiMessageTask(parent) +{ + NM_FUNCTION; + d = new NmApiMessageSearchPrivate(mailboxId, this); + qRegisterMetaType ("EmailClientApi::NmApiMessage"); + connect(d, SIGNAL(messageFound(EmailClientApi::NmApiMessage&)), this, SIGNAL(messageFound(EmailClientApi::NmApiMessage&))); + connect(d, SIGNAL(searchComplete(int)), this, SIGNAL(searchComplete(int))); + connect(d, SIGNAL(canceled()), this, SIGNAL(canceled())); +} + +NmApiMessageSearch::~NmApiMessageSearch() +{ + NM_FUNCTION; +} + +/*! + \fn start + \return true if operation was started otherwise returns false. + + Starts search operation for given criterias if operation is not running. Only one search can be performed at a time. + Each found message signaled with messageFound(NmApiMessage &message). + Search completed signaled with searchComplete(int result). + Cancellation signalled with canceled(). + */ +bool NmApiMessageSearch::start() +{ + NM_FUNCTION; + return d->start(); +} + +/*! + \fn cancel + + Cancels current search operation and reset criterias. If operation is not running, nothing happens except criterias are reset. + Cancellation signalled with canceled(). + */ +void NmApiMessageSearch::cancel() +{ + NM_FUNCTION; + d->cancel(); +} + +/*! + \fn initialise + \param searchStrings List of search criteria strings. + \param sortCriteria Sort criteria for search. + \return true if initializing is successfully competed otherwise returns false. + + Initialize search criterias. + */ +bool NmApiMessageSearch::initialise(const QList &searchStrings, NmApiMailSortCriteria sortCriteria) +{ + NM_FUNCTION; + return d->initialise(searchStrings, sortCriteria); +} + +/*! + \fn isRunning + \return true if search operation is running otherwise returns false. + + Returns information about search operation running. + */ +bool NmApiMessageSearch::isRunning() const +{ + NM_FUNCTION; + return d->isRunning(); +} +}