KAddressBookIconView Class Reference
This is an example kaddressbook view that is implemented using KIconView. More...
#include <kaddressbookiconview.h>
Inheritance diagram for KAddressBookIconView:

Public Slots | |
void | refresh (QString uid=QString::null) |
Must be overloaded in subclasses to refresh the view. | |
void | setSelected (QString uid=QString::null, bool selected=true) |
This method must be overloaded in subclasses. | |
Public Member Functions | |
KAddressBookIconView (KABC::AddressBook *doc, QWidget *parent, const char *name) | |
virtual QStringList | selectedUids () |
Must be overloaded in subclasses. | |
virtual QString | type () const |
Return the type of the view: Icon, Table, etc. | |
virtual void | readConfig (KConfig *config) |
Called whenever this view should read the config. | |
virtual void | incrementalSearch (const QString &value, KABC::Field *field) |
This method can be overloaded in the subclass to implement incremental searching. | |
Protected Slots | |
void | addresseeExecuted (QIconViewItem *item) |
void | addresseeSelected () |
Detailed Description
This is an example kaddressbook view that is implemented using KIconView.This view is not the most useful view, but it displays how simple implementing a new view can be.
Definition at line 42 of file kaddressbookiconview.h.
Member Function Documentation
|
Must be overloaded in subclasses. Should return a list of all the uids of selected contacts. Implements KAddressBookView. Definition at line 150 of file kaddressbookiconview.cpp. References QIconViewItem::isSelected(), and QIconViewItem::nextItem(). |
|
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 52 of file kaddressbookiconview.h. |
|
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.
Reimplemented from KAddressBookView. Definition at line 135 of file kaddressbookiconview.cpp. References KAddressBookView::executed(), and KAddressBookView::readConfig(). |
|
This method can be overloaded in the subclass to implement incremental searching. Incremental searching is where the user types in characters and after each character the selection is updated to select the item (addressee) that matches the search. For example, if this method is called with value being 'p', the selection should be moved to the first item with the field matching 'p'. If the user then typed 'r', making the value 'pr', the selection should be updated to the first item with the field matching 'pr'. If there is no item matching 'pr', the selection should remain on the last valid match. If the value is empty, select the first item.
Reimplemented from KAddressBookView. Definition at line 260 of file kaddressbookiconview.cpp. References QPtrList< AddresseeIconViewItem >::first(), QString::isEmpty(), and QPtrList< AddresseeIconViewItem >::next(). |
|
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 169 of file kaddressbookiconview.cpp. References KAddressBookView::addressBook(), KAddressBookView::addressees(), QPtrList< AddresseeIconViewItem >::append(), QPtrList< AddresseeIconViewItem >::clear(), KAddressBookView::fields(), QWidget::icon(), and QIconViewItem::nextItem(). |
|
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 205 of file kaddressbookiconview.cpp. References QIconViewItem::nextItem(). |
The documentation for this class was generated from the following files: