Akonadi::ContactDefaultActions Class Reference

A convenience class that handles different contact related actions. More...

#include <contactdefaultactions.h>

Inherits QObject.

List of all members.

Public Slots
void	dialPhoneNumber (const KABC::PhoneNumber &number)
void	sendEmail (const QString &name, const QString &address)
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@kde.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 37 of file contactdefaultactions.cpp.

ContactDefaultActions::~ContactDefaultActions

(

)

[virtual]

Destroys the contact default actions object.

Definition at line 42 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 46 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 79 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 71 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 85 of file contactdefaultactions.cpp.

void ContactDefaultActions::showUrl

(

const KUrl &

url

)

[slot]

Shows the given url in the users preferred webbrowser.

Definition at line 66 of file contactdefaultactions.cpp.

---

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

• contactdefaultactions.h
• contactdefaultactions.cpp