1 files changed, 152 insertions, 0 deletions
diff --git a/doc/src/snippets/qtorganizerdocsample/qtorganizerdocsample.cpp b/doc/src/snippets/qtorganizerdocsample/qtorganizerdocsample.cpp
new file mode 100644
index 0000000000..f172fafe19
--- /dev/null
+++ b/doc/src/snippets/qtorganizerdocsample/qtorganizerdocsample.cpp
@@ -0,0 +1,152 @@
+/****************************************************************************
+**
+** 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]
+}
+