Tp::ContactFactory Class Reference [Utililty classes]

The ContactFactory class is responsible for constructing Contact objects according to application-defined settings. More...

#include <TelepathyQt4/ContactFactory>

Inherits Tp::RefCounted.

List of all members.

Public Member Functions

• virtual ~ContactFactory ()
• Features features () const
• void addFeature (const Feature &feature)
• void addFeatures (const Features &features)

Static Public Member Functions

• static ContactFactoryPtr create (const Features &features=Features())

Protected Member Functions

• ContactFactory (const Features &features)
• virtual ContactPtr construct (ContactManager *manager, const ReferencedHandles &handle, const Features &features, const QVariantMap &attributes) const
• virtual PendingOperation * prepare (const ContactPtr &contact) const

---

Detailed Description

The ContactFactory class is responsible for constructing Contact objects according to application-defined settings.

---

Constructor & Destructor Documentation

Tp::ContactFactory::~ContactFactory

(

)

[virtual]

Class destructor.

Tp::ContactFactory::ContactFactory

(

const Features &

features

)

[protected]

Class constructor.

Parameters:

features

The features to make ready on constructed contacts.

---

Member Function Documentation

ContactFactoryPtr Tp::ContactFactory::create

(

const Features &

features = Features()

)

[static]

Creates a new ContactFactory.

Parameters:

features

The features to make ready on constructed contacts.

Returns:

A pointer to the created factory.

Features Tp::ContactFactory::features

(

)

const

Gets the features this factory will make ready on constructed contacts.

Returns:

The set of features.

void Tp::ContactFactory::addFeature

(

const Feature &

feature

)

Adds a single feature this factory will make ready on further constructed contacts.

No feature removal is provided, to guard against uncooperative modules removing features other modules have set and depend on.

Parameters:

feature

The feature to add.

void Tp::ContactFactory::addFeatures

(

const Features &

features

)

Adds a set of features this factory will make ready on further constructed contacts.

No feature removal is provided, to guard against uncooperative modules removing features other modules have set and depend on.

Parameters:

features

The features to add.

ContactPtr Tp::ContactFactory::construct	(	Tp::ContactManager *	manager,
		const ReferencedHandles &	handle,
		const Features &	features,
		const QVariantMap &	attributes
	)			const [protected, virtual]

Can be used by subclasses to override the Contact subclass constructed by the factory.

The default implementation constructs Tp::Contact objects.

Parameters:

	manager	The contact manager this contact belongs.
	handle	The contact handle.
	features	The desired contact features.
	attributes	The desired contact attributes.

Returns:

A pointer to the constructed contact.

PendingOperation * Tp::ContactFactory::prepare

(

const ContactPtr &

contact

)

const [protected, virtual]

Can be used by subclasses to do arbitrary manipulation on constructed Contact objects.

The default implementation does nothing.

Parameters:

contact

The contact to be prepared.

Returns:

A PendingOperation used to prepare the contact or NULL if there is nothing to prepare.