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:

KOEventView KOrg::BaseView QWidget 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 eventDurationHint(), selectedIsAllDay(), selectionEnd(), and selectionStart().

Referenced by eventDurationHint().

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(), and printPreview().

Referenced by printPreview().

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(), and KOViewManager::showView().

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 988 of file koagendaview.cpp.

References fillAgenda(), and showDates().

Referenced by showDates().

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 1005 of file koagendaview.cpp.

References showIncidences().

Referenced by showIncidences().

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 1123 of file koagendaview.cpp.

References changeIncidenceDisplay(), updateEventIndicators(), and updateView().

Referenced by changeIncidenceDisplay(), and 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(), and slotTodoDropped().

Referenced by slotTodoDropped().

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

Fill agenda beginning with date startDate.

Definition at line 1155 of file koagendaview.cpp.

References fillAgenda().

void KOAgendaView::fillAgenda  )  [protected]
 

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

Definition at line 1160 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(), updateEventDates(), and updateView().

Referenced by updateEventDates().

void KOAgendaView::doUpdateItem  )  [protected, slot]
 

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

Definition at line 978 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.

References newTimeSpanSelected().

Referenced by newTimeSpanSelected(), and 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(), and newTimeSpanSelectedAllDay().

Referenced by newTimeSpanSelectedAllDay().


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.0.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Thu Oct 21 19:46:58 2004 by doxygen 1.3.7 written by Dimitri van Heesch, © 1997-2003