Akonadi::ContactDefaultActions Class Reference

#include <contactdefaultactions.h>

Inheritance diagram for Akonadi::ContactDefaultActions:

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

Public Member Functions
	ContactDefaultActions (QObject *parent=nullptr)
	~ContactDefaultActions () override
void	connectToView (QObject *view)
Public Member Functions inherited from QObject
	QObject (QObject *parent)
bool	blockSignals (bool block)
const QObjectList &	children () const const
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const char *signal, const QObject *receiver, const char *method) const const
bool	disconnect (const QObject *receiver, const char *method) const const
void	dumpObjectInfo ()
void	dumpObjectInfo () const const
void	dumpObjectTree ()
void	dumpObjectTree () const const
QList< QByteArray >	dynamicPropertyNames () const const
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QRegExp &regExp, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QString &name, Qt::FindChildOptions options) const const
bool	inherits (const char *className) const const
void	installEventFilter (QObject *filterObj)
bool	isWidgetType () const const
bool	isWindowType () const const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const const
void	moveToThread (QThread *targetThread)
QString	objectName () const const
void	objectNameChanged (const QString &objectName)
QObject *	parent () const const
QVariant	property (const char *name) const const
	Q_CLASSINFO (Name, Value)
	Q_DISABLE_COPY (Class)
	Q_DISABLE_COPY_MOVE (Class)
	Q_DISABLE_MOVE (Class)
	Q_EMIT Q_EMIT
	Q_ENUM (...)
	Q_ENUM_NS (...)
	Q_ENUMS (...)
	Q_FLAG (...)
	Q_FLAG_NS (...)
	Q_FLAGS (...)
	Q_GADGET Q_GADGET
	Q_INTERFACES (...)
	Q_INVOKABLE Q_INVOKABLE
	Q_NAMESPACE Q_NAMESPACE
	Q_NAMESPACE_EXPORT (EXPORT_MACRO)
	Q_OBJECT Q_OBJECT
	Q_PROPERTY (...)
	Q_REVISION Q_REVISION
	Q_SET_OBJECT_NAME (Object)
	Q_SIGNAL Q_SIGNAL
	Q_SIGNALS Q_SIGNALS
	Q_SLOT Q_SLOT
	Q_SLOTS Q_SLOTS
T	qFindChild (const QObject *obj, const QString &name)
QList< T >	qFindChildren (const QObject *obj, const QRegExp &regExp)
QList< T >	qFindChildren (const QObject *obj, const QString &name)
T	qobject_cast (const QObject *object)
T	qobject_cast (QObject *object)
	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
void	removeEventFilter (QObject *obj)
void	setObjectName (const QString &name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	signalsBlocked () const const
int	startTimer (int interval, Qt::TimerType timerType)
int	startTimer (std::chrono::milliseconds time, Qt::TimerType timerType)
QThread *	thread () const const

Additional Inherited Members
Properties inherited from QObject
	objectName
Static Public Member Functions inherited from QObject
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
bool	disconnect (const QMetaObject::Connection &connection)
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)
bool	disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
QString	tr (const char *sourceText, const char *disambiguation, int n)
QString	trUtf8 (const char *sourceText, const char *disambiguation, int n)
Public Attributes inherited from QObject
typedef	QObjectList
Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const QMetaMethod &signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const QMetaMethod &signal)
bool	isSignalConnected (const QMetaMethod &signal) const const
int	receivers (const char *signal) const const
QObject *	sender () const const
int	senderSignalIndex () const const
virtual void	timerEvent (QTimerEvent *event)

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 signal/slot connection you want to overwrite
disconnect( viewer, SIGNAL(emailClicked(QString,QString)),
            actions, SLOT(sendEmail(QString,QString)) );
 
// connect to your custom implementation
connect( viewer, SIGNAL(emailClicked(QString,QString)),
         this, SLOT(handleSpecial(QString,QString)) );

Author

Tobias Koenig tokoe[email protected]@kde[email protected].org

Since

4.4

Definition at line 77 of file contactdefaultactions.h.

Constructor & Destructor Documentation

ContactDefaultActions()

ContactDefaultActions::ContactDefaultActions ( QObject *  parent = nullptr )

explicit

Creates a new contact default actions object.

Parameters

parent

The parent object.

Definition at line 30 of file contactdefaultactions.cpp.

~ContactDefaultActions()

ContactDefaultActions::~ContactDefaultActions ( )

overridedefault

Destroys the contact default actions object.

Member Function Documentation

connectToView()

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 38 of file contactdefaultactions.cpp.

dialPhoneNumber

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

slot

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

Definition at line 81 of file contactdefaultactions.cpp.

sendEmail

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 70 of file contactdefaultactions.cpp.

sendSms

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

slot

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

Definition at line 87 of file contactdefaultactions.cpp.

showAddress

void ContactDefaultActions::showAddress ( const KContacts::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 93 of file contactdefaultactions.cpp.

showUrl

void ContactDefaultActions::showUrl ( const QUrl &  url )

slot

Shows the given url in the users preferred webbrowser.

Definition at line 65 of file contactdefaultactions.cpp.

---

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

• contactdefaultactions.h
• contactdefaultactions.cpp