#include <specialmailcollectionsrequestjob.h>

Inherits SpecialCollectionsRequestJob.

Public Member Functions
	SpecialMailCollectionsRequestJob (QObject *parent=0)

	~SpecialMailCollectionsRequestJob ()

void	requestCollection (SpecialMailCollections::Type type, const AgentInstance &instance)

void	requestDefaultCollection (SpecialMailCollections::Type type)

Detailed Description

A job to request SpecialMailCollections.

Use this job to request the SpecialMailCollections you need. You can request both default SpecialMailCollections and SpecialMailCollections in a given resource. The default SpecialMailCollections resource is created when the first default SpecialCollection is requested, but if a SpecialCollection in a custom resource is requested, this job expects that resource to exist already.

If the folders you requested already exist, this job simply succeeds. Otherwise, it creates the required collections and registers them with SpecialMailCollections.

Example:

SpecialMailCollectionsRequestJob *job = new SpecialMailCollectionsRequestJob( this );
job->requestDefaultCollection( SpecialMailCollections::Outbox );
connect( job, SIGNAL(result(KJob*)),
         this, SLOT(requestDone(KJob*)) );
...
MyClass::requestDone( KJob *job )
{
  if ( job->error() )
    return;
  SpecialMailCollectionsRequestJob *requestJob = qobject_cast<SpecialMailCollectionsRequestJob*>( job );
  const Collection collection = requestJob->collection();
  ...
}