Akonadi::ContactDefaultActions Class Reference

#include <contactdefaultactions.h>

Inheritance diagram for Akonadi::ContactDefaultActions:

Public Slots
void	dialPhoneNumber (const KABC::PhoneNumber &number)
void	sendEmail (const QString &name, const QString &address)
void	sendSms (const KABC::PhoneNumber &number)
void	showAddress (const KABC::Address &address)
void	showUrl (const KUrl &url)

Public Member Functions
	ContactDefaultActions (QObject *parent=0)
virtual	~ContactDefaultActions ()
void	connectToView (QObject *view)
Public Member Functions inherited from QObject
	QObject (QObject *parent)
	QObject (QObject *parent, const char *name)
bool	blockSignals (bool block)
QObject *	child (const char *objName, const char *inheritsClass, bool recursiveSearch) const
const QObjectList &	children () const
const char *	className () const
bool	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const QObject *receiver, const char *method)
bool	disconnect (const char *signal, const QObject *receiver, const char *method)
void	dumpObjectInfo ()
void	dumpObjectTree ()
QList< QByteArray >	dynamicPropertyNames () const
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name) const
QList< T >	findChildren (const QRegExp &regExp) const
QList< T >	findChildren (const QString &name) const
bool	inherits (const char *className) const
void	insertChild (QObject *object)
void	installEventFilter (QObject *filterObj)
bool	isA (const char *className) const
bool	isWidgetType () const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const
void	moveToThread (QThread *targetThread)
const char *	name () const
const char *	name (const char *defaultName) const
QString	objectName () const
QObject *	parent () const
QVariant	property (const char *name) const
void	removeChild (QObject *object)
void	removeEventFilter (QObject *obj)
void	setName (const char *name)
void	setObjectName (const QString &name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	signalsBlocked () const
int	startTimer (int interval)
QThread *	thread () const

Additional Inherited Members
Static Public Member Functions inherited from QObject
bool	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
bool	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
bool	disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
bool	disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
QString	tr (const char *sourceText, const char *disambiguation, int n)
QString	trUtf8 (const char *sourceText, const char *disambiguation, int n)
Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char *signal, const QObject *object, const char *method)
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const char *signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const char *signal)
int	receivers (const char *signal) const
QObject *	sender () const
int	senderSignalIndex () const
virtual void	timerEvent (QTimerEvent *event)
Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)
Properties inherited from QObject
	objectName

Detailed Description

A convenience class that handles different contact related actions.

This class handles contact related actions like opening an email address, showing the address of a contact on a map etc.

Example:

using namespace Akonadi;

const Item contact = ...

ContactViewer *viewer = new ContactViewer( this );
viewer->setContact( contact );

ContactDefaultActions *actions = new ContactDefaultActions( this );
actions->connectToView( viewer );

If you want to use the full functionality of ContactDefaultActions but customize a single action (e.g. handling sending mail differently) the following can be done:

using namespace Akonadi;

ContactViewer *viewer = new ContactViewer( this );
ContactDefaultActions *actions = new ContactDefaultActions( this );

// first connect all actions
actions->connectToView( viewer );

// then remove the signle/slot connection you want to overwrite
disconnect( viewer, SIGNAL( emailClicked( const QString&, const QString& ) ),
            actions, SLOT( sendEmail( const QString&, const QString& ) ) );

// connect to your custom implementation
connect( viewer, SIGNAL( emailClicked( const QString&, const QString& ) ),
         this, SLOT( handleSpecial( const QString&, const QString& ) ) );

Author

Tobias Koenig tokoe.nosp@m.@kde.nosp@m..org

Since

4.4

Definition at line 86 of file contactdefaultactions.h.

Constructor & Destructor Documentation

ContactDefaultActions::ContactDefaultActions

(

QObject *

parent = 0

)

Creates a new contact default actions object.

Parameters

parent

The parent object.

Definition at line 38 of file contactdefaultactions.cpp.

ContactDefaultActions::~ContactDefaultActions ( )

virtual

Destroys the contact default actions object.

Definition at line 43 of file contactdefaultactions.cpp.

Member Function Documentation

void ContactDefaultActions::connectToView

(

QObject *

view

)

Tries to connect the well known signals of the view to the well known slots of this object.

Definition at line 47 of file contactdefaultactions.cpp.

void ContactDefaultActions::dialPhoneNumber ( const KABC::PhoneNumber &  number )

slot

Dials the given phone number with the application as configured by the user in the general settings dialog.

Definition at line 92 of file contactdefaultactions.cpp.

void ContactDefaultActions::sendEmail ( const QString &  name, const QString &  address  )

slot

Opens the users preferred mail composer and does the setup to send a mail to the contact with the given name and email address.

Definition at line 81 of file contactdefaultactions.cpp.

void ContactDefaultActions::sendSms ( const KABC::PhoneNumber &  number )

slot

Sends a sms to number with the application as configured by the user in the general settings dialog.

Definition at line 98 of file contactdefaultactions.cpp.

void ContactDefaultActions::showAddress ( const KABC::Address &  address )

slot

Shows the address of a contact in a webbrowser or application as configured by the user in the general settings dialog.

Definition at line 104 of file contactdefaultactions.cpp.

void ContactDefaultActions::showUrl ( const KUrl &  url )

slot

Shows the given url in the users preferred webbrowser.

Definition at line 76 of file contactdefaultactions.cpp.

---

The documentation for this class was generated from the following files:

• contactdefaultactions.h
• contactdefaultactions.cpp