libopie PIM API Documentation
	Overview Class Hierarchy Classes Classes (annotated) Members Source Files Todo

oevent.h

Go to the documentation of this file.

// CONTAINS GPLed code of TT

#ifndef OPIE_PIM_EVENT_H
#define OPIE_PIM_EVENT_H

#include <qstring.h>
#include <qdatetime.h>
#include <qvaluelist.h>

#include <qpe/recordfields.h>
#include <qpe/palmtopuidgen.h>

#include "otimezone.h"
#include "opimrecord.h"

struct OCalendarHelper {
    static int week( const QDate& );
    static int ocurrence( const QDate& );

    // returns the dayOfWeek for the *first* day it finds (ignores
    // any further days!). Returns 1 (Monday) if there isn't any day found
    static int dayOfWeek( char day );

    static int monthDiff( const QDate& first, const QDate& second );

};

class OPimNotifyManager;
class ORecur;

class OEvent : public OPimRecord {
public:
    typedef QValueList<OEvent> ValueList;
    enum RecordFields {
        FUid = Qtopia::UID_ID,
        FCategories = Qtopia::CATEGORY_ID,
        FDescription = 0,
        FLocation,
    FType,
    FAlarm,
    FSound,
    FRType,
    FRWeekdays,
    FRPosition,
    FRFreq,
    FRHasEndDate,
    FREndDate,
    FRCreated,
    FRExceptions,
    FStart,
    FEnd,
    FNote,
        FTimeZone,
        FRecParent,
        FRecChildren,
    };

    OEvent(int uid = 0);

    OEvent( const OEvent& );

    OEvent( const QMap<int, QString> map );
    ~OEvent();
    OEvent &operator=( const OEvent& );

    QString description()const;
    void setDescription( const QString& description );

    QString location()const;
   void setLocation( const QString& loc );

    bool hasNotifiers()const;
    OPimNotifyManager &notifiers()const;

    ORecur recurrence()const;
    void setRecurrence( const ORecur& );
    bool hasRecurrence()const;

    QString note()const;
    void setNote( const QString& note );


    QDateTime createdDateTime()const;
    void setCreatedDateTime( const QDateTime& dt);

    void setStartDateTime( const QDateTime& );
    QDateTime startDateTime()const;

    QDateTime startDateTimeInZone()const;

    void setEndDateTime( const QDateTime& );
    QDateTime endDateTime()const;
    QDateTime endDateTimeInZone()const;

    bool isMultipleDay()const;
    bool isAllDay()const;
    void setAllDay( bool isAllDay );

    /* pin this event to a timezone! FIXME */
    void setTimeZone( const QString& timeZone );
    QString timeZone()const;


    virtual bool match( const QRegExp& )const;

    QArray<int> children()const;
    void setChildren( const QArray<int>& );
    void addChild( int uid );
    void removeChild( int uid );

    int parent()const;
    void setParent( int uid );


    /* needed reimp */
    QString toRichText()const;
    QString toShortText()const;
    QString type()const;

    QMap<int, QString> toMap()const;
    void fromMap( const QMap<int, QString>& map );
    QString recordField(int )const;

    static int rtti();

    bool loadFromStream( QDataStream& );
    bool saveToStream( QDataStream& )const;

/*    bool operator==( const OEvent& );
    bool operator!=( const OEvent& );
    bool operator<( const OEvent& );
    bool operator<=( const OEvent& );
    bool operator>( const OEvent& );
    bool operator>=(const OEvent& );
*/
private:
    inline void changeOrModify();
    void deref();
    struct Data;
    Data* data;
    class Private;
    Private* priv;

};

class OEffectiveEvent {
public:
    typedef QValueList<OEffectiveEvent> ValueList;
    enum Position { MidWay, Start, End, StartEnd };
        // If we calculate the effective event of a multi-day event
    // we have to figure out whether we are at the first day,
    // at the end, or anywhere else ("middle"). This is important
    // for the start/end times (00:00/23:59)
    // MidWay: 00:00 -> 23:59, as we are "in the middle" of a multi-
    //         day event
    // Start: start time -> 23:59
    // End: 00:00 -> end time
    // Start | End == StartEnd: for single-day events (default)
    //                          here we draw start time -> end time
    OEffectiveEvent();
    OEffectiveEvent( const OEvent& event, const QDate& startDate, Position pos = StartEnd );
    OEffectiveEvent( const OEffectiveEvent& );
    OEffectiveEvent &operator=(const OEffectiveEvent& );
    ~OEffectiveEvent();

    void setStartTime( const QTime& );
    void setEndTime( const QTime& );
    void setEvent( const OEvent& );
    void setDate( const QDate& );

    void setEffectiveDates( const QDate& from, const QDate& to );

    QString description()const;
    QString location()const;
    QString note()const;
    OEvent event()const;
    QTime startTime()const;
    QTime endTime()const;
    QDate date()const;

    /* return the length in hours */
    int length()const;
    int size()const;

    QDate startDate()const;
    QDate endDate()const;

    bool operator<( const OEffectiveEvent &e ) const;
    bool operator<=( const OEffectiveEvent &e ) const;
    bool operator==( const OEffectiveEvent &e ) const;
    bool operator!=( const OEffectiveEvent &e ) const;
    bool operator>( const OEffectiveEvent &e ) const;
    bool operator>= ( const OEffectiveEvent &e ) const;

private:
    void deref();
    inline void changeOrModify();
    class Private;
    Private* priv;
    struct Data;
    Data* data;

};
#endif

This file is part of the documentation for OPIE Version 1.1.

Documentation copyright © 1997-2003 the KDE developers. 2003 OPIE developers
Generated on Tue Feb 10 20:25:20 2004 by doxygen 1.3.5 written by Dimitri van Heesch, © 1997-2001