korganizer Library API Documentation

KOAgendaView Class Reference

KOAgendaView is the agenda-like view used to display events in an one or multi-day view. More...

#include <koagendaview.h>

Inheritance diagram for KOAgendaView:

Inheritance graph
[legend]
Collaboration diagram for KOAgendaView:

Collaboration graph
[legend]
List of all members.

Public Slots

virtual void updateView ()
virtual void updateConfig ()
virtual void showDates (const QDate &start, const QDate &end)
virtual void showIncidences (const Incidence::List &)
void insertIncidence (Incidence *incidence, QDate curDate, int curCol=-1)
void changeIncidenceDisplayAdded (Incidence *incidence)
void changeIncidenceDisplay (Incidence *incidence, int mode)
void clearSelection ()
void newEvent (const QPoint &pos)
void newEvent (const QPoint &start, const QPoint &end)
void newEventAllDay (const QPoint &pos)
void startDrag (Incidence *)
void readSettings ()
void readSettings (KConfig *)
void writeSettings (KConfig *)
void setContentsPos (int y)
void setExpandedButton (bool expanded)
void finishTypeAhead ()
void slotTodoDropped (Todo *, const QPoint &, bool)
void enableAgendaUpdate (bool enable)

Signals

void toggleExpand ()

Public Member Functions

 KOAgendaView (Calendar *cal, QWidget *parent=0, const char *name=0)
virtual int maxDatesHint ()
virtual int currentDateCount ()
virtual Incidence::List selectedIncidences ()
virtual DateList selectedDates ()
virtual bool eventDurationHint (QDateTime &startDt, QDateTime &endDt, bool &allDay)
void clearView ()
virtual void printPreview (CalPrinter *calPrinter, const QDate &, const QDate &)
CalPrinter::PrintType printType ()
QDateTime selectionStart ()
QDateTime selectionEnd ()
bool selectedIsAllDay ()
void deleteSelectedDateTime ()
bool selectedIsSingleCell ()
void setTypeAheadReceiver (QObject *)

Protected Slots

void updateEventDates (KOAgendaItem *item)
void doUpdateItem ()
void updateEventIndicatorTop (int newY)
void updateEventIndicatorBottom (int newY)
void newTimeSpanSelected (const QPoint &start, const QPoint &end)
void newTimeSpanSelectedAllDay (const QPoint &start, const QPoint &end)

Protected Member Functions

void fillAgenda (const QDate &startDate)
void fillAgenda ()
void connectAgenda (KOAgenda *agenda, QPopupMenu *popup, KOAgenda *otherAgenda)
void createDayLabels ()
void setHolidayMasks ()
void removeIncidence (Incidence *)
void updateEventIndicators ()

Detailed Description

KOAgendaView is the agenda-like view used to display events in an one or multi-day view.

Definition at line 129 of file koagendaview.h.


Member Function Documentation

int KOAgendaView::maxDatesHint  )  [virtual]
 

Returns maximum number of days supported by the koagendaview.

Implements KOEventView.

Definition at line 625 of file koagendaview.cpp.

int KOAgendaView::currentDateCount  )  [virtual]
 

Returns number of currently shown dates.

Implements KOrg::BaseView.

Definition at line 631 of file koagendaview.cpp.

Incidence::List KOAgendaView::selectedIncidences  )  [virtual]
 

returns the currently selected events

Implements KOrg::BaseView.

Definition at line 636 of file koagendaview.cpp.

DateList KOAgendaView::selectedDates  )  [virtual]
 

returns the currently selected events

Implements KOrg::BaseView.

Definition at line 650 of file koagendaview.cpp.

bool KOAgendaView::eventDurationHint QDateTime startDt,
QDateTime endDt,
bool &  allDay
[virtual]
 

return the default start/end date/time for new events

Reimplemented from KOrg::BaseView.

Definition at line 664 of file koagendaview.cpp.

References selectedIsAllDay(), selectionEnd(), and selectionStart().

void KOAgendaView::clearView  ) 
 

Remove all events from view.

Definition at line 1278 of file koagendaview.cpp.

Referenced by fillAgenda().

void KOAgendaView::printPreview CalPrinter calPrinter,
const QDate fd,
const QDate td
[virtual]
 

Generate a print preview of this event view.

Parameters:
calPrinter Calendar printer object used for printing
fd from date
td to date

Reimplemented from KOrg::BaseView.

Definition at line 1285 of file koagendaview.cpp.

References CalPrinter::preview().

QDateTime KOAgendaView::selectionStart  )  [inline]
 

start-datetime of selection

Definition at line 160 of file koagendaview.h.

Referenced by CalendarView::edit_paste(), eventDurationHint(), and selectedIsSingleCell().

QDateTime KOAgendaView::selectionEnd  )  [inline]
 

end-datetime of selection

Definition at line 162 of file koagendaview.h.

Referenced by CalendarView::edit_paste(), eventDurationHint(), and selectedIsSingleCell().

bool KOAgendaView::selectedIsAllDay  )  [inline]
 

returns true if selection is for whole day

Definition at line 164 of file koagendaview.h.

Referenced by CalendarView::edit_paste(), eventDurationHint(), and selectedIsSingleCell().

void KOAgendaView::deleteSelectedDateTime  ) 
 

make selected start/end invalid

Definition at line 1499 of file koagendaview.cpp.

Referenced by fillAgenda().

bool KOAgendaView::selectedIsSingleCell  ) 
 

returns if only a single cell is selected, or a range of cells

Definition at line 677 of file koagendaview.cpp.

References selectedIsAllDay(), selectionEnd(), and selectionStart().

Referenced by CalendarView::edit_paste().

void KOAgendaView::updateView  )  [virtual, slot]
 

Updates the current display to reflect changes that may have happened in the calendar since the last display refresh.

Implements KOrg::BaseView.

Definition at line 691 of file koagendaview.cpp.

References fillAgenda().

Referenced by changeIncidenceDisplay(), updateConfig(), and updateEventDates().

void KOAgendaView::updateConfig  )  [virtual, slot]
 

Re-reads the KOrganizer configuration and picks up relevant changes which are applicable to the view.

Reimplemented from KOrg::BaseView.

Definition at line 702 of file koagendaview.cpp.

References createDayLabels(), setHolidayMasks(), and updateView().

void KOAgendaView::showDates const QDate start,
const QDate end
[virtual, slot]
 

Show incidences for the given date range.

The date range actually shown may be different from the requested range, depending on the particular requirements of the view.

Parameters:
start Start of date range.
end End of date range.

Implements KOrg::BaseView.

Definition at line 990 of file koagendaview.cpp.

References fillAgenda().

void KOAgendaView::showIncidences const Incidence::List &   )  [virtual, slot]
 

Show given incidences.

Depending on the actual view it might not be possible to show all given events.

Parameters:
eventList a list of events to show.

Implements KOrg::BaseView.

Definition at line 1007 of file koagendaview.cpp.

void KOAgendaView::changeIncidenceDisplay Incidence *  incidence,
int  mode
[virtual, slot]
 

Updates the current display to reflect the changes to one particular incidence.

Implements KOrg::BaseView.

Definition at line 1125 of file koagendaview.cpp.

References updateEventIndicators(), and updateView().

Referenced by doUpdateItem().

void KOAgendaView::clearSelection  )  [virtual, slot]
 

Clear selection.

The incidenceSelected signal is not emitted.

Reimplemented from KOrg::BaseView.

Definition at line 1468 of file koagendaview.cpp.

void KOAgendaView::slotTodoDropped Todo *  ,
const QPoint ,
bool 
[slot]
 

reschedule the todo to the given x- and y- coordinates.

Third parameter determines all-day (no time specified)

Definition at line 1361 of file koagendaview.cpp.

References KOrg::BaseView::calendar().

void KOAgendaView::fillAgenda const QDate startDate  )  [protected]
 

Fill agenda beginning with date startDate.

Definition at line 1157 of file koagendaview.cpp.

References fillAgenda().

void KOAgendaView::fillAgenda  )  [protected]
 

Fill agenda using the current set value for the start date.

Definition at line 1162 of file koagendaview.cpp.

References KOrg::BaseView::calendar(), clearView(), createDayLabels(), deleteSelectedDateTime(), and setHolidayMasks().

Referenced by fillAgenda(), showDates(), and updateView().

void KOAgendaView::createDayLabels  )  [protected]
 

Create labels for the selected dates.

Definition at line 552 of file koagendaview.cpp.

References QBoxLayout::addWidget(), KOrg::CalendarDecoration::shortText(), and KOrg::CalendarDecoration::smallWidget().

Referenced by fillAgenda(), and updateConfig().

void KOAgendaView::setHolidayMasks  )  [protected]
 

Set the masks on the agenda widgets indicating, which days are holidays.

Definition at line 1437 of file koagendaview.cpp.

Referenced by fillAgenda(), and updateConfig().

void KOAgendaView::updateEventIndicators  )  [protected]
 

Updates the event indicators after a certain incidence was modified or removed.

Definition at line 1524 of file koagendaview.cpp.

Referenced by changeIncidenceDisplay().

void KOAgendaView::updateEventDates KOAgendaItem *  item  )  [protected, slot]
 

Update event belonging to agenda item.

Definition at line 732 of file koagendaview.cpp.

References doUpdateItem(), and updateView().

void KOAgendaView::doUpdateItem  )  [protected, slot]
 

update just the display of the given incidence, called by a single-shot timer

Definition at line 980 of file koagendaview.cpp.

References changeIncidenceDisplay().

Referenced by updateEventDates().

void KOAgendaView::newTimeSpanSelected const QPoint start,
const QPoint end
[protected, slot]
 

Updates data for selected timespan.

Definition at line 1480 of file koagendaview.cpp.

Referenced by newTimeSpanSelectedAllDay().

void KOAgendaView::newTimeSpanSelectedAllDay const QPoint start,
const QPoint end
[protected, slot]
 

Updates data for selected timespan for all day event.

Definition at line 1474 of file koagendaview.cpp.

References newTimeSpanSelected().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for korganizer Library Version 3.3.2.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Wed Jan 31 15:55:58 2007 by doxygen 1.4.2 written by Dimitri van Heesch, © 1997-2003