korganizer

CalendarView Class Reference

#include <calendarview.h>

Inheritance diagram for CalendarView:

Detailed Description

This is the main calendar widget.main calendar view widget.

It provides the different views on the calendar data as well as the date navigator. It also handles synchronization of the different views and controls the different dialogs like preferences, event editor, search dialog etc.

Author:: Cornelius Schumacher

Definition at line 80 of file calendarview.h.


Public Slots
void	updateConfig (const QCString &)
void	updateCategories ()
bool	openCalendar (const QString &filename, bool merge=false)
bool	saveCalendar (const QString &filename)
void	closeCalendar ()
void	archiveCalendar ()
void	showIncidence ()
void	editIncidence ()
bool	editIncidence (const QString &uid)
void	deleteIncidence ()
bool	addIncidence (const QString &ical)
void	connectIncidenceEditor (KOIncidenceEditor *)
void	newEvent (const QDateTime &, const QDateTime &, bool allDay=false)
void	newEvent (const QDateTime &fh)
void	newEvent (const QDate &dt)
void	newEvent ()
void	newEvent (const QString &)
void	newEvent (const QString &summary, const QString &description, const QString &attachment)
void	newEvent (const QString &summary, const QString &description, const QString &attachment, const QStringList &attendees)
void	newFloatingEvent ()
void	showIncidence (Incidence *)
bool	editIncidence (Incidence *)
void	deleteIncidence (Incidence *, bool force=false)
void	cutIncidence (Incidence *)
void	copyIncidence (Incidence *)
void	deleteSubTodosIncidence (Todo *todo)
void	deleteTodoIncidence (Todo *todo, bool force=false)
bool	deleteEvent (Event *)
bool	deleteTodo (Todo *)
bool	deleteJournal (Journal *)
bool	deleteIncidence (const QString &uid, bool force=false)
void	newTodo ()
void	newTodo (const QDate &date)
void	newSubTodo ()
void	newSubTodo (Todo *)
void	newTodo (const QString &)
void	newTodo (const QString &summary, const QString &description, const QString &attachment)
void	newTodo (const QString &summary, const QString &description, const QString &attachment, const QStringList &attendees)
void	newJournal ()
void	newJournal (const QDate &date)
void	newJournal (const QString &text, const QDate &date)
void	newJournal (const QString &text)
void	toggleAlarm (Incidence *)
void	dissociateOccurrence (Incidence *, const QDate &)
void	dissociateFutureOccurrence (Incidence *, const QDate &)
void	checkClipboard ()
void	readSettings ()
void	writeSettings ()
void	readFilterSettings (KConfig *config)
void	writeFilterSettings (KConfig *config)
void	changeIncidenceDisplay (Incidence *, int)
void	incidenceAdded (Incidence *)
void	incidenceChanged (Incidence oldEvent, Incidence newEvent)
void	incidenceChanged (Incidence oldEvent, Incidence newEvent, int what)
void	incidenceToBeDeleted (Incidence *incidence)
void	incidenceDeleted (Incidence *)
void	startMultiModify (const QString &text)
void	endMultiModify ()
void	editCanceled (Incidence *)
void	updateView (const QDate &start, const QDate &end)
void	updateView ()
void	updateUnmanagedViews ()
void	edit_cut ()
void	edit_copy ()
void	edit_paste ()
void	edit_options ()
void	print ()
void	exportWeb ()
void	exportICalendar ()
void	exportVCalendar ()
void	appointment_show ()
void	appointment_edit ()
void	appointment_delete ()
void	todo_unsub ()
bool	todo_unsub (Todo *todo)
bool	makeSubTodosIndependents ()
bool	makeSubTodosIndependents (Todo *todo)
void	takeOverEvent ()
void	takeOverCalendar ()
bool	isModified ()
void	setModified (bool modified=true)
bool	isReadOnly ()
void	setReadOnly (bool readOnly=true)
void	eventUpdated (Incidence *)
void	schedule_publish (Incidence *incidence=0)
void	schedule_request (Incidence *incidence=0)
void	schedule_refresh (Incidence *incidence=0)
void	schedule_cancel (Incidence *incidence=0)
void	schedule_add (Incidence *incidence=0)
void	schedule_reply (Incidence *incidence=0)
void	schedule_counter (Incidence *incidence=0)
void	schedule_declinecounter (Incidence *incidence=0)
void	mailFreeBusy (int daysToPublish=30)
void	uploadFreeBusy ()
void	openAddressbook ()
void	editFilters ()
void	updateFilter ()
void	showIntro ()
void	showDateNavigator (bool)
void	showTodoView (bool)
void	showEventViewer (bool)
void	goDate (const QDate &date)
void	goToday ()
void	goNext ()
void	goPrevious ()
void	toggleExpand ()
void	showLeftFrame (bool show=true)
void	dialogClosing (Incidence *)
void	processMainViewSelection (Incidence *)
void	processTodoListSelection (Incidence *)
void	processIncidenceSelection (Incidence *)
void	purgeCompleted ()
void	slotCalendarChanged ()
void	slotAutoArchivingSettingsModified ()
void	importQtopia (const QString &categoriesFile, const QString &datebookFile, const QString &tasklistFile)
void	showErrorMessage (const QString &)
void	schedule (Scheduler::Method, Incidence *incidence)
void	addIncidenceOn (Incidence *, const QDate &)
void	moveIncidenceTo (Incidence *, const QDate &)
void	filterActivated (int filterNum)
Signals
void	configChanged ()
void	categoriesChanged ()
void	closingDown ()
void	closed (QWidget *)
void	modifiedChanged (bool)
void	readOnlyChanged (bool)
void	changeNavStringPrev (const QString &)
void	changeNavStringNext (const QString &)
void	organizerEventsSelected (bool)
void	groupEventsSelected (bool)
void	incidenceSelected (Incidence *)
void	todoSelected (bool)
void	subtodoSelected (bool)
void	dayPassed (const QDate &)
void	cancelAttendees (Incidence *)
void	pasteEnabled (bool)
void	statusMessage (const QString &)
void	calendarViewExpanded (bool)
void	autoArchivingSettingsModified ()
void	newIncidenceChanger (IncidenceChangerBase *)
void	exportHTML (HTMLExportSettings *)
void	newFilterListSignal (const QStringList &)
void	selectFilterSignal (int)
void	filterChanged ()
Public Member Functions
	CalendarView (QWidget parent=0, const char name=0)
virtual	~CalendarView ()
void	setCalendar (Calendar *)
Calendar *	calendar ()
KOrg::History *	history () const
KOViewManager *	viewManager () const
KODialogManager *	dialogManager () const
QWidgetStack *	viewStack () const
QWidget *	leftFrame () const
NavigatorBar *	navigatorBar () const
DateNavigator *	dateNavigator () const
KOIncidenceEditor *	editorDialog (Incidence *) const
IncidenceChangerBase *	incidenceChanger () const
QDate	startDate ()
QDate	endDate ()
void	addView (KOrg::BaseView *)
void	showView (KOrg::BaseView *)
void	addExtension (CalendarViewExtension::Factory *)
Incidence *	currentSelection ()
Incidence *	selectedIncidence ()
QString	currentFilterName () const
int	msgCalModified ()
void	adaptNavigationUnits ()
Protected Slots
void	showDates (const KCal::DateList &)
Protected Member Functions
void	setIncidenceChanger (IncidenceChangerBase *changer)
int	msgItemDelete (Incidence *incidence)
Todo *	selectedTodo ()
void	warningChangeFailed (Incidence *)
void	checkForFilteredChange (Incidence *incidence)
Classes
class	CalendarViewVisitor
class	CanDeleteIncidenceVisitor

Constructor & Destructor Documentation

CalendarView::CalendarView	(	QWidget *	parent = `0`,
		const char *	name = `0`
	)

Constructs a new calendar view widget.

Parameters:

	parent	parent window
	name	Qt internal widget object name

Definition at line 113 of file calendarview.cpp.

Member Function Documentation

void CalendarView::adaptNavigationUnits ( )

Adapt navigation units corresponding to step size of navigation of the current view.

Definition at line 1561 of file calendarview.cpp.

void CalendarView::addExtension ( CalendarViewExtension::Factory * )

Add calendar view extension widget.

CalendarView takes ownership of the objects created by the factory.

Definition at line 1770 of file calendarview.cpp.

bool CalendarView::addIncidence ( const QString & ical ) [slot]

Add an incidence to the active calendar.

Parameters:

ical

A calendar in iCalendar format containing the incidence. The calendar must consist of a VCALENDAR component which contains the incidence (VEVENT, VTODO, VJOURNAL or VFREEBUSY) and optionally a VTIMEZONE component. If there is more than one incidence, only the first is added to KOrganizer's calendar.

Definition at line 1117 of file calendarview.cpp.

void CalendarView::appointment_delete ( ) [slot]

pop up dialog confirming deletion of currently selected event in the View.

Definition at line 1149 of file calendarview.cpp.

void CalendarView::appointment_edit ( ) [slot]

pop up an Appointment Dialog to edit an existing appointment.

Get information on the appointment from the list of unique IDs that is currently in the View, called currIds.

Definition at line 1140 of file calendarview.cpp.

void CalendarView::appointment_show ( ) [slot]

pop up a dialog to show an existing appointment.

Definition at line 1131 of file calendarview.cpp.

void CalendarView::archiveCalendar ( ) [slot]

Archive old events of calendar.

Definition at line 471 of file calendarview.cpp.

void CalendarView::autoArchivingSettingsModified ( ) [signal]

Emitted when auto-archiving options were modified.

void CalendarView::cancelAttendees ( Incidence * ) [signal]

Attendees were removed from this incidence.

Only the removed attendees are present in the incidence, so we just need to send a cancel messages to all attendees groupware messages are enabled at all.

void CalendarView::categoriesChanged ( ) [signal]

Emitted when the categories were updated, and thus the categories editor dialog needs to reload the list of categories.

void CalendarView::changeIncidenceDisplay	(	Incidence *	,
		int
	)			`[slot]`

passes on the message that an event has changed to the currently activated view so that it can make appropriate display changes.

Definition at line 790 of file calendarview.cpp.

void CalendarView::changeNavStringPrev ( const QString & ) [signal]

Emitted when the unit of navigation changes.

void CalendarView::checkClipboard ( ) [slot]

Check if clipboard contains vCalendar event.

The signal pasteEnabled() is emitted as result.

Definition at line 1617 of file calendarview.cpp.

void CalendarView::closeCalendar ( ) [slot]

Close calendar.

Clear calendar data and reset views to display an empty calendar.

Definition at line 459 of file calendarview.cpp.

void CalendarView::closed ( QWidget * ) [signal]

emitted right before we die

void CalendarView::closingDown ( ) [signal]

emitted when the topwidget is closing down, so that any attached child windows can also close.

void CalendarView::configChanged ( ) [signal]

when change is made to options dialog, the topwidget will catch this and emit this signal which notifies all widgets which have registered for notification to update their settings.

void CalendarView::copyIncidence ( Incidence * ) [slot]

Copies the selected incidence using the edit_copy() method.

Definition at line 1864 of file calendarview.cpp.

QString CalendarView::currentFilterName ( ) const

Returns the name of the current filter.

Definition at line 1695 of file calendarview.cpp.

Incidence * CalendarView::currentSelection ( ) [virtual]

currentSelection() returns a pointer to the incidence selected in the current view

Implements KOrg::CalendarViewBase.

Definition at line 1822 of file calendarview.cpp.

void CalendarView::cutIncidence ( Incidence * ) [slot]

Cuts the selected incidence using the edit_cut() method.

Definition at line 1859 of file calendarview.cpp.

void CalendarView::dayPassed ( const QDate & ) [signal]

Emitted, when a day changed (i.e.

korganizer was running at midnight). The argument is the new date

bool CalendarView::deleteEvent ( Event * ) [inline, slot]

Check if deleting the supplied event is allowed.

Definition at line 315 of file calendarview.h.

bool CalendarView::deleteIncidence	(	const QString &	uid,
		bool	force = `false`
	)			`[slot]`

Delete the incidence with the given unique ID.

Returns false, if event wasn't found.

Parameters:

	uid	The UID of the incidence to delete.
	force	If true, all recurrences and sub-todos (if applicable) will be deleted without prompting for confirmation.

Definition at line 1221 of file calendarview.cpp.

void CalendarView::deleteIncidence	(	Incidence *	,
		bool	force = `false`
	)			`[slot]`

Delete the supplied incidence.

It calls the correct deleteXXX method

Parameters:

force

If true, all recurrences and sub-todos (if applicable) will be deleted without prompting for confirmation.

Definition at line 1975 of file calendarview.cpp.

bool CalendarView::deleteJournal ( Journal * ) [inline, slot]

Check if deleting the supplied journal is allowed.

Definition at line 319 of file calendarview.h.

void CalendarView::deleteSubTodosIncidence ( Todo * todo ) [slot]

Delete the supplied todo and all sub-todos.

Definition at line 1914 of file calendarview.cpp.

bool CalendarView::deleteTodo ( Todo * ) [inline, slot]

Check if deleting the todo is allowed.

Definition at line 317 of file calendarview.h.

void CalendarView::deleteTodoIncidence	(	Todo *	todo,
		bool	force = `false`
	)			`[slot]`

Delete the todo incidence, and its sub-to-dos.

Parameters:

	todo	The todo to delete.
	force	If true, all sub-todos will be deleted without prompting for confirmation.

Definition at line 1933 of file calendarview.cpp.

void CalendarView::edit_copy ( ) [slot]

copy the current appointment(s) to the clipboard

Definition at line 846 of file calendarview.cpp.

void CalendarView::edit_cut ( ) [slot]

cut the current appointment to the clipboard

Definition at line 835 of file calendarview.cpp.

void CalendarView::edit_options ( ) [slot]

edit viewing and configuration options.

Definition at line 917 of file calendarview.cpp.

void CalendarView::edit_paste ( ) [slot]

paste the current vobject(s) in the clipboard buffer into calendar

Definition at line 860 of file calendarview.cpp.

bool CalendarView::editIncidence ( Incidence * ) [slot]

Create an editor for the supplied incidence.

It calls the correct editXXX method

Definition at line 1876 of file calendarview.cpp.

void CalendarView::exportICalendar ( ) [slot]

Export as iCalendar file.

Definition at line 1522 of file calendarview.cpp.

void CalendarView::exportVCalendar ( ) [slot]

Export as vCalendar file.

Definition at line 1533 of file calendarview.cpp.

void CalendarView::exportWeb ( ) [slot]

Export as HTML file.

Definition at line 1509 of file calendarview.cpp.

void CalendarView::filterActivated ( int filterNum ) [slot]

A different filter was selected.

Definition at line 1681 of file calendarview.cpp.

void CalendarView::goDate ( const QDate & date ) [slot]

Move the current view date to the specified date.

Definition at line 609 of file calendarview.cpp.

void CalendarView::goNext ( ) [slot]

Move to the next date(s) in the current view.

Definition at line 619 of file calendarview.cpp.

void CalendarView::goPrevious ( ) [slot]

Move to the previous date(s) in the current view.

Definition at line 627 of file calendarview.cpp.

void CalendarView::goToday ( ) [slot]

Move the current view date to today.

Definition at line 614 of file calendarview.cpp.

void CalendarView::groupEventsSelected ( bool ) [signal]

Emitted when state of events selection has changed and user is attendee.

void CalendarView::incidenceSelected ( Incidence * ) [signal]

Emitted when an incidence gets selected.

If the selection is cleared the signal is emitted with 0 as argument.

bool CalendarView::isModified ( ) [slot]

query whether or not the calendar is "dirty".

Definition at line 1488 of file calendarview.cpp.

bool CalendarView::isReadOnly ( ) [slot]

query if the calendar is read-only.

Definition at line 1475 of file calendarview.cpp.

bool CalendarView::makeSubTodosIndependents ( Todo * todo ) [slot]

Make all sub-to-dos of todo independents, not update the view.

Definition at line 1200 of file calendarview.cpp.

bool CalendarView::makeSubTodosIndependents ( ) [slot]

Make all sub-to-dos of todo independents, update the view.

Definition at line 1188 of file calendarview.cpp.

void CalendarView::modifiedChanged ( bool ) [signal]

Emitted when state of modified flag changes.

void CalendarView::newEvent ( const QString & ) [slot]

Create new Event from given string.

Definition at line 962 of file calendarview.cpp.

void CalendarView::newEvent ( ) [slot]

create new event without having a date hint.

Takes current date as default hint.

Definition at line 923 of file calendarview.cpp.

void CalendarView::newEvent	(	const QDateTime &	,
		const QDateTime &	,
		bool	allDay = `false`
	)			`[slot]`

create an editeventwin with supplied date/time, and if bool is true, make the event take all day.

Definition at line 989 of file calendarview.cpp.

void CalendarView::newSubTodo ( Todo * ) [slot]

create new todo with a parent todo

Definition at line 1100 of file calendarview.cpp.

void CalendarView::newSubTodo ( ) [slot]

create new todo with a parent todo

Definition at line 1094 of file calendarview.cpp.

void CalendarView::newTodo ( const QDate & date ) [slot]

create new todo, due on date

Definition at line 1044 of file calendarview.cpp.

void CalendarView::newTodo

korganizer

CalendarView Class Reference

Detailed Description

Public Slots

Signals

Public Member Functions

Protected Slots

Protected Member Functions

Classes

Constructor & Destructor Documentation

Member Function Documentation