Akonadi::ContactDefaultActions Class Reference

#include <contactdefaultactions.h>

Inherits QObject.

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)

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