kaddressbook

KAddressBookTableView Class Reference

This class is the table view for kaddressbook. More...

#include <kaddressbooktableview.h>

Inheritance diagram for KAddressBookTableView:

KAddressBookView

List of all members.


Public Slots

virtual void reconstructListView ()

Public Member Functions

 KAddressBookTableView (KAB::Core *core, TQWidget *parent, const char *name=0)
virtual void refresh (const TQString &uid=TQString())
virtual TQStringList selectedUids ()
virtual void setSelected (const TQString &uid=TQString(), bool selected=false)
virtual void setFirstSelected (bool selected=true)
virtual KABC::Field * sortField () const
virtual void readConfig (KConfig *config)
virtual void writeConfig (KConfig *config)
virtual TQString type () const
void scrollUp ()
void scrollDown ()

Protected Slots

void addresseeSelected ()
void addresseeExecuted (TQListViewItem *)
void rmbClicked (KListView *, TQListViewItem *, const TQPoint &)
void updatePresence (const TQString &uid)

Friends

class ContactListView

Detailed Description

This class is the table view for kaddressbook.

This view is a KListView with multiple columns for the selected fields.

Table View

Author:
Don Sanders <dsanders@kde.org>
Version:
0.1

Definition at line 60 of file kaddressbooktableview.h.


Member Function Documentation

void KAddressBookTableView::refresh ( const TQString &  uid = TQString()  )  [virtual]

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 217 of file kaddressbooktableview.cpp.

TQStringList KAddressBookTableView::selectedUids (  )  [virtual]

Must be overloaded in subclasses.

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

Implements KAddressBookView.

Definition at line 269 of file kaddressbooktableview.cpp.

void KAddressBookTableView::setSelected ( const TQString &  uid = TQString(),
bool  selected = false 
) [virtual]

This method must be overloaded in subclasses.

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

Implements KAddressBookView.

Definition at line 286 of file kaddressbooktableview.cpp.

void KAddressBookTableView::setFirstSelected ( bool  selected = true  )  [virtual]

Selects the first contact in the view.

Implements KAddressBookView.

Definition at line 306 of file kaddressbooktableview.cpp.

KABC::Field * KAddressBookTableView::sortField (  )  const [virtual]

Returns:
The current sort field.

Implements KAddressBookView.

Definition at line 170 of file kaddressbooktableview.cpp.

void KAddressBookTableView::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 183 of file kaddressbooktableview.cpp.

void KAddressBookTableView::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.

Reimplemented from KAddressBookView.

Definition at line 176 of file kaddressbooktableview.cpp.

virtual TQString KAddressBookTableView::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 79 of file kaddressbooktableview.h.

void KAddressBookTableView::addresseeSelected (  )  [protected, slot]

Called whenever the user selects an addressee in the list view.

Definition at line 314 of file kaddressbooktableview.cpp.

void KAddressBookTableView::addresseeExecuted ( TQListViewItem *  item  )  [protected, slot]

Called whenever the user executes an addressee.

In terms of the list view, this is probably a double click

Definition at line 336 of file kaddressbooktableview.cpp.

void KAddressBookTableView::rmbClicked ( KListView *  ,
TQListViewItem *  ,
const TQPoint &  point 
) [protected, slot]

RBM menu called.

Definition at line 350 of file kaddressbooktableview.cpp.

void KAddressBookTableView::updatePresence ( const TQString &  uid  )  [protected, slot]

Called to update the presence of a single item.

Definition at line 355 of file kaddressbooktableview.cpp.


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