IncidenceEditorNG::ConflictResolver Class Reference

#include <conflictresolver.h>

Inheritance diagram for IncidenceEditorNG::ConflictResolver:

Signals
void	conflictsDetected (int number)
void	dateTimesChanged (const QDateTime &newStart, const QDateTime &newEnd)
void	freeSlotsAvailable (const KCalendarCore::Period::List &)

Public Slots
void	findAllFreeSlots ()
void	freebusyDataChanged ()
void	setEarliestDate (QDate newDate)
void	setEarliestDateTime (const QDateTime &newDateTime)
void	setEarliestTime (QTime newTime)
void	setLatestDate (QDate newDate)
void	setLatestDateTime (const QDateTime &newDateTime)
void	setLatestTime (QTime newTime)
void	setResolution (int seconds)

Public Member Functions
	ConflictResolver (QWidget *parentWidget, QObject *parent=nullptr)
KCalendarCore::Period::List	availableSlots () const
void	clearAttendees ()
bool	containsAttendee (const KCalendarCore::Attendee &attendee)
bool	findFreeSlot (const KCalendarCore::Period &dateTimeRange)
void	insertAttendee (const CalendarSupport::FreeBusyItem::Ptr &freebusy)
void	insertAttendee (const KCalendarCore::Attendee &attendee)
CalendarSupport::FreeBusyItemModel *	model () const
void	removeAttendee (const KCalendarCore::Attendee &attendee)
void	setAllowedWeekdays (const QBitArray &weekdays)
void	setMandatoryRoles (const QSet< KCalendarCore::Attendee::Role > &roles)
Public Member Functions inherited from QObject
	QObject (QObject *parent)
QBindable< QString >	bindableObjectName ()
bool	blockSignals (bool block)
const QObjectList &	children () const const
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const char *signal, const QObject *receiver, const char *method) const const
bool	disconnect (const QObject *receiver, const char *method) const const
void	dumpObjectInfo () const const
void	dumpObjectTree () const const
QList< QByteArray >	dynamicPropertyNames () const const
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QString &name, Qt::FindChildOptions options) const const
QList< T >	findChildren (Qt::FindChildOptions options) const const
bool	inherits (const char *className) const const
void	installEventFilter (QObject *filterObj)
bool	isQuickItemType () const const
bool	isWidgetType () const const
bool	isWindowType () const const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const const
void	moveToThread (QThread *targetThread)
QString	objectName () const const
void	objectNameChanged (const QString &objectName)
QObject *	parent () const const
QVariant	property (const char *name) const const
	Q_CLASSINFO (Name, Value)
	Q_EMIT Q_EMIT
	Q_ENUM (...)
	Q_ENUM_NS (...)
	Q_ENUMS (...)
	Q_FLAG (...)
	Q_FLAG_NS (...)
	Q_FLAGS (...)
	Q_GADGET Q_GADGET
	Q_GADGET_EXPORT (EXPORT_MACRO)
	Q_INTERFACES (...)
	Q_INVOKABLE Q_INVOKABLE
	Q_MOC_INCLUDE Q_MOC_INCLUDE
	Q_NAMESPACE Q_NAMESPACE
	Q_NAMESPACE_EXPORT (EXPORT_MACRO)
	Q_OBJECT Q_OBJECT
	Q_PROPERTY (...)
	Q_REVISION Q_REVISION
	Q_SET_OBJECT_NAME (Object)
	Q_SIGNAL Q_SIGNAL
	Q_SIGNALS Q_SIGNALS
	Q_SLOT Q_SLOT
	Q_SLOTS Q_SLOTS
T	qobject_cast (const QObject *object)
T	qobject_cast (QObject *object)
	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
void	removeEventFilter (QObject *obj)
void	setObjectName (const QString &name)
void	setObjectName (QAnyStringView name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	setProperty (const char *name, QVariant &&value)
bool	signalsBlocked () const const
int	startTimer (int interval, Qt::TimerType timerType)
int	startTimer (std::chrono::milliseconds interval, Qt::TimerType timerType)
QThread *	thread () const const

Additional Inherited Members
Public Types inherited from QObject
typedef	QObjectList
Properties inherited from QObject
	objectName
Static Public Member Functions inherited from QObject
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
bool	disconnect (const QMetaObject::Connection &connection)
bool	disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
bool	disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
bool	disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
QString	tr (const char *sourceText, const char *disambiguation, int n)
Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const QMetaMethod &signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const QMetaMethod &signal)
bool	isSignalConnected (const QMetaMethod &signal) const const
int	receivers (const char *signal) const const
QObject *	sender () const const
int	senderSignalIndex () const const
virtual void	timerEvent (QTimerEvent *event)

Detailed Description

Takes a list of attendees and event info (e.g., min time start, max time end) fetches their freebusy information, then identifies conflicts and periods of non-conflict.

It exposes these periods so another class can display them to the user and allow them to choose a correct time.

Author

Casey Link

Definition at line 34 of file conflictresolver.h.

Constructor & Destructor Documentation

ConflictResolver()

ConflictResolver::ConflictResolver ( QWidget * parentWidget, QObject * parent = nullptr )

explicit

Parameters

parentWidget

is passed to Akonadi when fetching free/busy data.

Definition at line 20 of file conflictresolver.cpp.

Member Function Documentation

availableSlots()

KCalendarCore::Period::List ConflictResolver::availableSlots ( ) const

nodiscard

Returns a list of date time ranges that conform to the search constraints.

See also

setMandatoryRoles

setAllowedWeekdays

Definition at line 458 of file conflictresolver.cpp.

clearAttendees()

void ConflictResolver::clearAttendees

(

)

Clear all attendees.

Definition at line 73 of file conflictresolver.cpp.

conflictsDetected

void IncidenceEditorNG::ConflictResolver::conflictsDetected ( int number )

signal

Emitted when there are conflicts.

Parameters

number

the number of conflicts

containsAttendee()

bool ConflictResolver::containsAttendee ( const KCalendarCore::Attendee & attendee )

nodiscard

Returns whether the resolver contains the attendee.

Definition at line 78 of file conflictresolver.cpp.

dateTimesChanged

void IncidenceEditorNG::ConflictResolver::dateTimesChanged ( const QDateTime & newStart, const QDateTime & newEnd )

signal

Emitted when the user changes the start and end dateTimes for the incidence.

findAllFreeSlots

void ConflictResolver::findAllFreeSlots ( )

slot

Definition at line 215 of file conflictresolver.cpp.

findFreeSlot()

bool ConflictResolver::findFreeSlot ( const KCalendarCore::Period & dateTimeRange )

nodiscard

Finds a free slot in the future which has at least the same size as the initial slot.

Definition at line 178 of file conflictresolver.cpp.

freebusyDataChanged

void ConflictResolver::freebusyDataChanged ( )

slot

Definition at line 127 of file conflictresolver.cpp.

freeSlotsAvailable

void IncidenceEditorNG::ConflictResolver::freeSlotsAvailable ( const KCalendarCore::Period::List & )

signal

Emitted when the resolver locates new free slots.

insertAttendee() [1/2]

void ConflictResolver::insertAttendee

(

const CalendarSupport::FreeBusyItem::Ptr &

freebusy

)

Definition at line 60 of file conflictresolver.cpp.

insertAttendee() [2/2]

void ConflictResolver::insertAttendee

(

const KCalendarCore::Attendee &

attendee

)

Add an attendee The attendees free busy info will be fetched and integrated into the resolver.

Definition at line 53 of file conflictresolver.cpp.

model()

CalendarSupport::FreeBusyItemModel * ConflictResolver::model

(

)

const

Definition at line 468 of file conflictresolver.cpp.

removeAttendee()

void ConflictResolver::removeAttendee

(

const KCalendarCore::Attendee &

attendee

)

Removes an attendee The attendee will no longer be considered when resolving conflicts.

Definition at line 67 of file conflictresolver.cpp.

setAllowedWeekdays()

void ConflictResolver::setAllowedWeekdays

(

const QBitArray &

weekdays

)

Constrain the free time slot search to the weekdays identified by their KCalendarSystem integer representation Default is Monday - Friday.

Parameters

weekdays

a 7 bit array indicating the allowed days (bit 0=Monday, value 1=allowed).

See also

KCalendarSystem

Definition at line 441 of file conflictresolver.cpp.

setEarliestDate

void ConflictResolver::setEarliestDate ( QDate newDate )

slot

Set the timeframe constraints.

These control the timeframe for which conflicts are to be resolved.

Definition at line 83 of file conflictresolver.cpp.

setEarliestDateTime

void ConflictResolver::setEarliestDateTime ( const QDateTime & newDateTime )

slot

Definition at line 115 of file conflictresolver.cpp.

setEarliestTime

void ConflictResolver::setEarliestTime ( QTime newTime )

slot

Definition at line 91 of file conflictresolver.cpp.

setLatestDate

void ConflictResolver::setLatestDate ( QDate newDate )

slot

Definition at line 99 of file conflictresolver.cpp.

setLatestDateTime

void ConflictResolver::setLatestDateTime ( const QDateTime & newDateTime )

slot

Definition at line 121 of file conflictresolver.cpp.

setLatestTime

void ConflictResolver::setLatestTime ( QTime newTime )

slot

Definition at line 107 of file conflictresolver.cpp.

setMandatoryRoles()

void ConflictResolver::setMandatoryRoles

(

const QSet< KCalendarCore::Attendee::Role > &

roles

)

Constrain the free time slot search to the set participant roles.

Mandatory roles are considered the minimum required to attend the meeting, so only those attendees with the mandatory roles will be considered in the search. Default is all roles are mandatory.

Parameters

roles

the set of mandatory participant roles

Definition at line 447 of file conflictresolver.cpp.

setResolution

void ConflictResolver::setResolution ( int seconds )

slot

Definition at line 463 of file conflictresolver.cpp.

---

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

• conflictresolver.h
• conflictresolver.cpp