QContactActionFactory Class

The QContactActionFactory class provides an interface for clients to retrieve instances of action implementations More...

Header: #include <QContactActionFactory>
Inherits:

Public Functions

QContactActionFactory(QObject * parent = 0)
virtual ~QContactActionFactory()
virtual QList<QContactActionDescriptor> actionDescriptors() const = 0
virtual QContactFilter contactFilter(const QContactActionDescriptor & which) const = 0
virtual QContactAction * create(const QContactActionDescriptor & which) const = 0
virtual QVariant metaData(const QString & key, const QList<QContactActionTarget> & targets, const QVariantMap & parameters, const QContactActionDescriptor & which) const = 0
virtual QSet<QContactActionTarget> supportedTargets(const QContact & contact, const QContactActionDescriptor & which) const = 0
virtual bool supportsContact(const QContact & contact, const QContactActionDescriptor & which) const

Static Public Members

const QString InterfaceName()

Protected Functions

QContactActionDescriptor createDescriptor(const QString & actionName, const QString & serviceName, const QString & actionIdentifier, int implementationVersion) const

Detailed Description

The QContactActionFactory class provides an interface for clients to retrieve instances of action implementations

Member Function Documentation

QContactActionFactory::QContactActionFactory(QObject * parent = 0)

Default constructor for this interface. Passes parent to the QObject constructor.

[virtual] QContactActionFactory::~QContactActionFactory()

Clears any memory in use by this factory

[static] const QString QContactActionFactory::InterfaceName()

The name of the interface that action plugins should implement.

[pure virtual] QList<QContactActionDescriptor> QContactActionFactory::actionDescriptors() const

Return a list of action descriptors for the actions that this factory supports.

[pure virtual] QContactFilter QContactActionFactory::contactFilter(const QContactActionDescriptor & which) const

Returns a filter to select contacts that are supported by the action specified by which.

[pure virtual] QContactAction * QContactActionFactory::create(const QContactActionDescriptor & which) const

Returns a new QContactAction instance for the supplied action descriptor which.

The caller will own this object.

[protected] QContactActionDescriptor QContactActionFactory::createDescriptor(const QString & actionName, const QString & serviceName, const QString & actionIdentifier, int implementationVersion) const

Creates an action descriptor based on the supplied action name actionName, service name serviceName, action identifier actionIdentifier, and version implementationVersion.

[pure virtual] QVariant QContactActionFactory::metaData(const QString & key, const QList<QContactActionTarget> & targets, const QVariantMap & parameters, const QContactActionDescriptor & which) const

Returns the meta-data associated with the action described by which for the given key (such as icon, label or sound cues). The meta-data may vary depending on the targets of the action and any parameters to invocation which the client may specify.

[pure virtual] QSet<QContactActionTarget> QContactActionFactory::supportedTargets(const QContact & contact, const QContactActionDescriptor & which) const

Returns the targets which are supported by the action described by which that may be instantiated by this factory for the given contact. If there are no supported targets for the contact, then that contact is not supported by the action.

See also supportsContact().

[virtual] bool QContactActionFactory::supportsContact(const QContact & contact, const QContactActionDescriptor & which) const

Returns true if there are any targets for the given contact supported by the action described by which.