+/****************************************************************************

+**

+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

+** All rights reserved.

+** Contact: Nokia Corporation (qt-info@nokia.com)

+**

+** This file is part of the Qt Mobility Components.

+**

+** $QT_BEGIN_LICENSE:LGPL$

+** No Commercial Usage

+** This file contains pre-release code and may not be distributed.

+** You may use this file in accordance with the terms and conditions

+** contained in the Technology Preview License Agreement accompanying

+** this package.

+**

+** GNU Lesser General Public License Usage

+** Alternatively, this file may be used under the terms of the GNU Lesser

+** General Public License version 2.1 as published by the Free Software

+** Foundation and appearing in the file LICENSE.LGPL included in the

+** packaging of this file. Please review the following information to

+** ensure the GNU Lesser General Public License version 2.1 requirements

+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

+**

+** In addition, as a special exception, Nokia gives you certain additional

+** rights. These rights are described in the Nokia Qt LGPL Exception

+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

+**

+** If you have questions regarding the use of this file, please contact

+** Nokia at qt-info@nokia.com.

+**

+**

+**

+**

+**

+**

+**

+**

+** $QT_END_LICENSE$

+**

+****************************************************************************/

+

+#include "qmobilityglobal.h"

+#include "qtorganizer.h"

+

+#include <QDebug>

+#include <QCoreApplication>

+#include <QObject>

+#include <QTimer>

+

+QTM_USE_NAMESPACE

+

+static void snippets();

+

+int main(int argc, char* argv[])

+{

+ snippets();

+ return 0;

+}

+

+void snippets()

+{

+ //! [Instantiating the default manager for the platform]

+ QOrganizerItemManager defaultManager;

+ //! [Instantiating the default manager for the platform]

+

+ //! [Instantiating a specific manager]

+ QOrganizerItemManager specificManager("KCal");

+ //! [Instantiating a specific manager]

+

+ //! [Creating a recurrent event]

+ QOrganizerEvent recEvent;

+ /*recEvent.setRecurrence(7pm to 8pm every wednesday for three months);*/

+ recEvent.setPriority(QOrganizerItem::HighPriority);

+ recEvent.setLocation("Meeting Room 8");

+ recEvent.setDescription("A meeting every wednesday to discuss the vitally important topic of marshmallows");

+ recEvent.setLabel("Marshmallow Conference");

+ defaultManager.saveItem(&recEvent);

+ //! [Creating a recurrent event]

+

+ //! [Retrieving occurrences of a particular recurrent event within a time period]

+ // XXX TODO: make this more convenient.

+ // QOIM::itemInstances(item, startDateTime, endDateTime, count) ?

+ // QOI::instanceFilter(start, end) ?

+ QOrganizerItemDetailFilter dfil;

+ dfil.setDetailDefinition(QOrganizerItemParentInfo::DefinitionName, QOrganizerItemParentInfo::FieldParentId);

+ dfil.setValue(recEvent.id());

+

+ QOrganizerItemPeriodFilter pfil;

+ pfil.setStartDate(QDateTime::current(), endOfThisMonth());

+

+ QOrganizerItemIntersectionFilter ifil;

+ ifil << dfil << pfil;

+

+ QList<QOrganizerItem> instances = defaultManager.itemInstances(ifil);

+ //! [Retrieving occurrences of a particular recurrent event within a time period]

+

+ //! [Retrieving the next 5 occurrences of a particular recurrent event]

+ // XXX TODO: make this more convenient.

+ // QOIM::itemInstances(item, startDateTime, endDateTime, count) ?

+ //! [Retrieving the next 5 occurrences of a particular recurrent event]

+

+ //! [Retrieving the next 10 occurrences of any item (Agenda View)]

+ // XXX TODO: make this more convenient.

+ // QOIM::itemInstances(count) ?

+ //! [Retrieving the next 10 occurrences of any item (Agenda View)]

+

+ //! [Creating a non-recurrent entry]

+ // a default constructed journal will have it's date/time set to the current date/time.

+ QOrganizerJournal journal;

+ journal.setNote("The conference went well. We all agree that marshmallows are awesome, "\

+ "but we were unable to reach any agreement as to how we could possibly "\

+ "increase our intake of marshmallows. Several action points were assigned "\

+ "to various members of the group; I have been tasked with finding a good "\

+ "recipe that combines both marshmallows and chocolate, by next Wednesday.");

+ defaultManager.saveItem(&journal);

+ //! [Creating a non-recurrent entry]

+

+

+ //! [Editing a non-recurrent entry]

+ QOrganizerItemNote recipe;

+ recipe.setNote("Serves: 8. Ingredients: 500g Milk Chocolate, 500g Marshmallows. Step 1: Put the marshmallows into 8 separate bowls. Step 2: Melt the chocolate. Step 3: Pour the chocolate over the marshmallows in the bowls. Step 4: Put the bowls into the refrigerator for 20 minutes; serve chilled.");

+ journal.saveDetail(&recipe);

+ defaultManager.saveItem(&journal);

+ //! [Editing a non-recurrent entry]

+

+ //! [Retrieving any entry (not occurrence) which matches a search criteria]

+ // XXX TODO: make this more convenient.

+ // QOrganizerItemLocation::matchLocationName("Meeting Room 8") ?

+ QOrganizerItemDetailFilter locationFilter;

+ locationFilter.setDetailDefinition(QOrganizerItemLocation::DefinitionName, QOrganizerItemLocation::FieldLocationName);

+ locationFilter.setValue("Meeting Room 8");

+ QList<QOrganizerItem> entries = defaultManager.items(locationFilter);

+ //! [Retrieving any entry (not occurrence) which matches a search criteria]

+

+ //! [Creating an exception to a particular recurrent event]

+ QOrganizerItemEventTimeRange newTime;

+ newTime.setStartDateTime("6pm");

+ newTime.setEndDateTime("8pm");

+ QOrganizerItemNote newNote;

+ newNote.setNote("The next meeting will go for an hour longer (starting one "\

+ "hour earlier than usual), since we have scheduled one hour"\

+ "to taste the results of the recipe that I will be presenting "\

+ "at the meeting.");

+

+ // the following line should be made simpler via QOIM::itemInstances(item, startDateTime, endDateTime, count)...

+ QOrganizerEventOccurrence nextMarshmallowMeeting = QOrganizerEventOccurrence(defaultManager.itemInstances(dfil).first());

+ nextMarshmallowMeeting.saveDetail(&newTime);

+ nextMarshmallowMeeting.saveDetail(&newNote);

+ defaultManager.saveItem(&nextMarshmallowMeeting);

+ //! [Creating an exception to a particular recurrent event]

+}

+