kaddressbook Library API Documentation

KAddressBookCardView Class Reference

This view uses the CardView class to create a card view. More...

#include <kaddressbookcardview.h>

Inheritance diagram for KAddressBookCardView:

KAddressBookView QWidget List of all members.

Public Slots

void refresh (QString uid=QString::null)
void setSelected (QString uid=QString::null, bool selected=true)

Public Methods

 KAddressBookCardView (KAB::Core *core, QWidget *parent, const char *name=0)
virtual ~KAddressBookCardView ()
virtual QStringList selectedUids ()
virtual QString type () const
virtual KABC::Field * sortField () const
virtual void readConfig (KConfig *config)
virtual void writeConfig (KConfig *)

Protected Slots

void addresseeExecuted (CardViewItem *item)
void addresseeSelected ()
void rmbClicked (CardViewItem *, const QPoint &)

Detailed Description

This view uses the CardView class to create a card view.

At some point in the future I think this will be the default view of KAddressBook.

Definition at line 43 of file kaddressbookcardview.h.


Member Function Documentation

QStringList KAddressBookCardView::selectedUids   [virtual]
 

Must be overloaded in subclasses.

Should return a list of all the uids of selected contacts.

Implements KAddressBookView.

Definition at line 266 of file kaddressbookcardview.cpp.

References CardView::firstItem(), CardViewItem::isSelected(), and CardViewItem::nextItem().

virtual QString KAddressBookCardView::type   const [inline, virtual]
 

Return the type of the view: Icon, Table, etc.

Please make sure that this is the same value that ViewWrapper::type() will return for your view.

Implements KAddressBookView.

Definition at line 53 of file kaddressbookcardview.h.

KABC::Field * KAddressBookCardView::sortField   const [virtual]
 

Returns:
The current sort field.

Implements KAddressBookView.

Definition at line 186 of file kaddressbookcardview.cpp.

void KAddressBookCardView::readConfig KConfig *    config [virtual]
 

Called whenever this view should read the config.

This can be used as a sign that the config has changed, therefore the view should assume the worst and rebuild itself if necessary. For example, in a table view this method may be called when the user adds or removes columns from the view.

If overloaded in the subclass, do not forget to call super class's method.

Parameters:
config  The KConfig object to read from. The group will already be set, so do not change the group.

Reimplemented from KAddressBookView.

Definition at line 192 of file kaddressbookcardview.cpp.

References QPalette::color(), KAddressBookView::executed(), QWidget::font(), KAddressBookView::readConfig(), QFont::setBold(), QPalette::setColor(), CardView::setDrawCardBorder(), CardView::setDrawColSeparators(), CardView::setDrawFieldLabels(), CardView::setFont(), CardView::setHeaderFont(), CardView::setItemMargin(), CardView::setItemSpacing(), CardView::setItemWidth(), CardView::setSeparatorWidth(), CardView::setShowEmptyFields(), and QScrollView::viewport().

void KAddressBookCardView::writeConfig KConfig *    [virtual]
 

Called whenever this view should write the config.

The view should not write out information handled by the application, such as which fields are visible. The view should only write out information specific to itself (i.e.: All information in the ViewConfigWidget)

If overloaded in the subclass, do not forget to call the super class's method.

Parameters:
config  The KConfig object to read from. The group will already be set, so do not change the group.

Reimplemented from KAddressBookView.

Definition at line 260 of file kaddressbookcardview.cpp.

References CardView::itemWidth(), and KAddressBookView::writeConfig().

void KAddressBookCardView::refresh QString    uid = QString::null [virtual, slot]
 

Must be overloaded in subclasses to refresh the view.

Refreshing includes updating the view to ensure that only items in the document are visible. If uid is valid, only the addressee with uid needs to be refreshed. This is an optimization only.

Implements KAddressBookView.

Definition at line 285 of file kaddressbookcardview.cpp.

References KAddressBookView::addressees(), CardView::clear(), KAddressBookView::core(), KAddressBookView::fields(), CardView::firstItem(), QString::isNull(), CardViewItem::nextItem(), KAddressBookView::selected(), and QScrollView::viewport().

void KAddressBookCardView::setSelected QString    uid = QString::null,
bool    selected = true
[virtual, slot]
 

This method must be overloaded in subclasses.

Select (highlight) the addressee matching uid. If uid is equal to QString::null, then all addressees should be selected.

Implements KAddressBookView.

Definition at line 326 of file kaddressbookcardview.cpp.

References CardView::ensureItemVisible(), CardView::firstItem(), QString::isNull(), CardViewItem::nextItem(), CardView::selectAll(), KAddressBookView::selected(), and CardView::setSelected().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kaddressbook Library Version 3.2.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Sat May 1 11:38:54 2004 by doxygen 1.2.15 written by Dimitri van Heesch, © 1997-2003