--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/notes/notesui/notesviews/src/notestodoview.cpp Tue Aug 31 15:13:43 2010 +0300
@@ -0,0 +1,555 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+* Definition file for NotesTodoView class.
+*
+*/
+
+// System includes
+#include <QDateTime>
+#include <HbListView>
+#include <HbListWidget>
+#include <HbAction>
+#include <HbTextEdit>
+#include <HbInstance>
+#include <HbMainWindow>
+#include <HbMenu>
+#include <HbDialog>
+#include <HbLabel>
+#include <HbAbstractViewItem>
+#include <HbGroupBox>
+#include <HbListViewItem>
+
+// User includes
+#include <agendautil.h>
+#include "agendaeventviewer.h"
+#include "notestodoview.h"
+#include "notescommon.h"
+#include "notesdocloader.h"
+#include "notesmodel.h"
+#include "notessortfilterproxymodel.h"
+#include "noteseditor.h"
+#include "OstTraceDefinitions.h"
+#ifdef OST_TRACE_COMPILER_IN_USE
+#include "notestodoviewTraces.h"
+#endif
+
+
+/*!
+ \class NotesTodoView
+ \brief The main view of the notes application. Responsible for displaying
+ notes and todos.
+
+ \sa NotesViewManager
+ */
+
+/*!
+ Constructs the NotesTodoView object.
+
+ \param parent The parent of type QGraphicsWidget.
+ */
+NotesTodoView::NotesTodoView(QGraphicsWidget *parent)
+:HbView(parent),
+ mSelectedItem(0),
+ mDeleteAction(0),
+ mIsLongTop(false)
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_NOTESTODOVIEW_ENTRY );
+ // Nothing yet.
+ OstTraceFunctionExit0( NOTESTODOVIEW_NOTESTODOVIEW_EXIT );
+}
+
+/*!
+ Destructor.
+ */
+NotesTodoView::~NotesTodoView()
+{
+ OstTraceFunctionEntry0( DUP1_NOTESTODOVIEW_NOTESTODOVIEW_ENTRY );
+ if (mDocLoader) {
+ delete mDocLoader;
+ mDocLoader = 0;
+ }
+ OstTraceFunctionExit0( DUP1_NOTESTODOVIEW_NOTESTODOVIEW_EXIT );
+}
+
+/*!
+ Called by the NotesViewManager after loading the view from the docml.
+ The initializaion/setup of the view is done here.
+
+ \param controller The NotesAppController object.
+ \param docLoader Pointer to NotesDocLoader object.
+ */
+void NotesTodoView::setupView(
+ NotesAppControllerIf &controllerIf, NotesDocLoader *docLoader)
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_SETUPVIEW_ENTRY );
+ mDocLoader = docLoader;
+ mAppControllerIf = &controllerIf;
+ mNotesModel = mAppControllerIf->notesModel();
+ mAgendaUtil = mAppControllerIf->agendaUtil();
+
+ mProxyModel = new NotesSortFilterProxyModel(*mAgendaUtil, this);
+ mProxyModel->setDynamicSortFilter(true);
+ mProxyModel->setSourceModel(mNotesModel->sourceModel());
+
+ mProxyModel->setFilterRole(NotesNamespace::TypeRole);
+ mProxyModel->setFilterRegExp(QRegExp(QString("todo")));
+
+ NotesSortFilterProxyModel *subModel =
+ new NotesSortFilterProxyModel(*mAgendaUtil, this);
+ subModel->setDynamicSortFilter(true);
+ subModel->setSourceModel(mProxyModel);
+
+ // Get the list object from the document and update the model.
+ mListView = static_cast<HbListView *>
+ (mDocLoader->findWidget("todoListView"));
+ // Update the list view model.
+ mListView->setModel(subModel);
+ // Setup the operations that can be done with a list view.
+ connect(
+ mListView, SIGNAL(activated(const QModelIndex &)),
+ this, SLOT(handleItemReleased(const QModelIndex &)));
+ connect(
+ mListView,
+ SIGNAL(longPressed(HbAbstractViewItem *, const QPointF &)),
+ this,
+ SLOT(handleItemLongPressed(HbAbstractViewItem *, const QPointF &)));
+
+ // Get the empty list string.
+ mEmptyListLabel = static_cast<HbLabel *> (
+ mDocLoader->findWidget("emptyListLabel"));
+
+ // Get the toolbar/menu actions.
+ mAddTodoAction = static_cast<HbAction *> (
+ mDocLoader->findObject("newTodoAction"));
+ connect(
+ mAddTodoAction, SIGNAL(triggered()),
+ this, SLOT(createNewTodo()));
+
+ mAllNotesAction = static_cast<HbAction *> (
+ mDocLoader->findObject("allNotesAction"));
+ connect(
+ mAllNotesAction, SIGNAL(triggered()),
+ this, SLOT(displayAllNotesView()));
+
+ mViewCollectionAction = static_cast<HbAction *> (
+ mDocLoader->findObject("displayCollectionsAction"));
+
+ connect(
+ mViewCollectionAction, SIGNAL(changed()),
+ this, SLOT(handleActionStateChanged()));
+ connect(
+ mViewCollectionAction, SIGNAL(triggered()),
+ this, SLOT(displayCollectionView()));
+
+ // Handles the orientation change for list items
+ HbMainWindow *window = hbInstance->allMainWindows().first();
+ handleOrientationChanged(window->orientation());
+ connect(
+ window, SIGNAL(orientationChanged(Qt::Orientation)),
+ this, SLOT(handleOrientationChanged(Qt::Orientation)));
+
+ mSubTitle = static_cast<HbGroupBox *>(
+ mDocLoader->findWidget("subtitleGroupBox"));
+
+ connect(
+ mAgendaUtil, SIGNAL(entryAdded(ulong)),
+ this,SLOT(updateSubTitle(ulong)));
+ connect(
+ mAgendaUtil, SIGNAL(entryDeleted(ulong)),
+ this,SLOT(updateSubTitle(ulong)));
+ connect(
+ mAgendaUtil, SIGNAL(entryUpdated(ulong)),
+ this, SLOT(updateSubTitle(ulong)));
+
+ // Set the graphics size for the icons.
+ HbListViewItem *prototype = mListView->listItemPrototype();
+ prototype->setGraphicsSize(HbListViewItem::SmallIcon);
+ OstTraceFunctionExit0( NOTESTODOVIEW_SETUPVIEW_EXIT );
+}
+
+/*
+ Updates the title text for the first launch
+ */
+void NotesTodoView::updateTitle()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_UPDATETITLE_ENTRY );
+ updateSubTitle();
+ OstTraceFunctionExit0( NOTESTODOVIEW_UPDATETITLE_EXIT );
+}
+
+/*!
+ Opens the to-do editor to create a new to-do.
+ */
+void NotesTodoView::createNewTodo()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_CREATENEWTODO_ENTRY );
+ mNotesEditor = new NotesEditor(mAgendaUtil, this);
+ connect(
+ mNotesEditor, SIGNAL(editingCompleted(bool)),
+ this, SLOT(handleEditingCompleted(bool)));
+
+ mNotesEditor->create(NotesEditor::CreateTodo);
+ OstTraceFunctionExit0( NOTESTODOVIEW_CREATENEWTODO_EXIT );
+}
+
+/*!
+ Handles the pressing of a list item in the view.
+
+ Here we open the editor for viewing/editing.
+
+ \param index Reference to the QModelIndex representing the view item.
+ \sa HbAbstractViewItem
+ */
+void NotesTodoView::handleItemReleased(const QModelIndex &index)
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_HANDLEITEMRELEASED_ENTRY );
+ if(!mIsLongTop) {
+ // Sanity check.
+ if (!index.isValid()) {
+ OstTraceFunctionExit0( NOTESTODOVIEW_HANDLEITEMRELEASED_EXIT );
+ return;
+ }
+
+ // First get the id of the to-do and get the corresponding information from
+ // agendautil.
+ ulong toDoId = index.data(NotesNamespace::IdRole).value<qulonglong>();
+
+ if (0 >= toDoId) {
+ // Something wrong.
+ OstTraceFunctionExit0( DUP1_NOTESTODOVIEW_HANDLEITEMRELEASED_EXIT );
+ return;
+ }
+
+ // Construct agenda event viewer.
+ mAgendaEventViewer = new AgendaEventViewer(mAgendaUtil, this);
+
+ connect(
+ mAgendaEventViewer, SIGNAL(viewingCompleted(const QDate)),
+ this, SLOT(handleViewingCompleted()));
+ // Launch agenda event viewer
+ mAgendaEventViewer->view(toDoId, AgendaEventViewer::ActionEditDelete);
+ }
+ OstTraceFunctionExit0( DUP2_NOTESTODOVIEW_HANDLEITEMRELEASED_EXIT );
+}
+
+/*!
+ Displays a list item specific context menu.
+
+ \param item The HbAbstractViewItem that was long pressed.
+ \param coords The position where mouse was pressed.
+
+ \sa HbAbstractViewItem, HbListView, HbMenu.
+ */
+void NotesTodoView::handleItemLongPressed(
+ HbAbstractViewItem *item, const QPointF &coords)
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_HANDLEITEMLONGPRESSED_ENTRY );
+ mSelectedItem = item;
+ mIsLongTop = true;
+
+ // Get the entry of the selected item.
+ ulong noteId = item->modelIndex().data(
+ NotesNamespace::IdRole).value<qulonglong>();
+ AgendaEntry entry = mAgendaUtil->fetchById(noteId);
+
+ // Display a context specific menu.
+ HbMenu *contextMenu = new HbMenu();
+ connect(
+ contextMenu,SIGNAL(aboutToClose()),
+ this, SLOT(handleMenuClosed()));
+
+ // Add actions to the context menu.
+ mOpenAction =
+ contextMenu->addAction(hbTrId("txt_common_menu_open"));
+
+ mEditAction = contextMenu->addAction(
+ hbTrId("txt_common_menu_edit"));
+
+ mDeleteAction = contextMenu->addAction(
+ hbTrId("txt_common_menu_delete"));
+
+ if (AgendaEntry::TypeTodo == entry.type()) {
+ if (AgendaEntry::TodoNeedsAction == entry.status()) {
+ mTodoStatusAction = contextMenu->addAction(
+ hbTrId("txt_notes_menu_mark_as_done"));
+ } else if (AgendaEntry::TodoCompleted == entry.status()) {
+ mTodoStatusAction =
+ contextMenu->addAction(
+ hbTrId("txt_notes_menu_mark_as_not_done"));
+ }
+ }
+
+ // Show the menu.
+ contextMenu->open(this, SLOT(selectedMenuAction(HbAction*)));
+ contextMenu->setPreferredPos(coords);
+ OstTraceFunctionExit0( NOTESTODOVIEW_HANDLEITEMLONGPRESSED_EXIT );
+}
+
+/*!
+ Slot to delete a selected to-do.
+ */
+void NotesTodoView::deleteTodo()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_DELETETODO_ENTRY );
+ Q_ASSERT(mSelectedItem);
+
+ QModelIndex index = mSelectedItem->modelIndex();
+ if (!index.isValid()) {
+ OstTraceFunctionExit0( NOTESTODOVIEW_DELETETODO_EXIT );
+ return;
+ }
+ ulong entryId =
+ index.data(NotesNamespace::IdRole).value<qulonglong>();
+ if (!entryId) {
+ OstTraceFunctionExit0( DUP1_NOTESTODOVIEW_DELETETODO_EXIT );
+ return;
+ }
+
+ // Emit the signal. Delete would be handled in view manager.
+ emit deleteEntry(entryId);
+
+ mSelectedItem = 0;
+ OstTraceFunctionExit0( DUP2_NOTESTODOVIEW_DELETETODO_EXIT );
+}
+
+/*!
+ Marks to-do entry as done or undone based on the completed value.
+ */
+void NotesTodoView::markTodoStatus()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_MARKTODOSTATUS_ENTRY );
+ ulong entryId = mSelectedItem->modelIndex().data(
+ NotesNamespace::IdRole).value<qulonglong>();
+ AgendaEntry entry = mAgendaUtil->fetchById(entryId);
+
+ QDateTime currentDateTime = QDateTime::currentDateTime();
+
+ if (AgendaEntry::TodoNeedsAction == entry.status()) {
+ mAgendaUtil->setCompleted(entry, true, currentDateTime);
+ } else if (AgendaEntry::TodoCompleted == entry.status()) {
+ mAgendaUtil->setCompleted(entry, false, currentDateTime);
+ }
+ OstTraceFunctionExit0( NOTESTODOVIEW_MARKTODOSTATUS_EXIT );
+}
+
+/*!
+ Opens to-do in an editor.
+ */
+void NotesTodoView::editTodo()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_EDITTODO_ENTRY );
+ QModelIndex index = mSelectedItem->modelIndex();
+
+ // Sanity check.
+ if (!index.isValid()) {
+ OstTraceFunctionExit0( NOTESTODOVIEW_EDITTODO_EXIT );
+ return;
+ }
+
+ // First get the id of the note and get the corresponding information from
+ // agendautil.
+ ulong noteId = index.data(NotesNamespace::IdRole).value<qulonglong>();
+
+ if (0 >= noteId) {
+ // Something wrong.
+ OstTraceFunctionExit0( DUP1_NOTESTODOVIEW_EDITTODO_EXIT );
+ return;
+ }
+
+ // Get the entry details.
+ AgendaEntry entry = mAgendaUtil->fetchById(noteId);
+
+ if (entry.isNull()) {
+ // Entry invalid.
+ OstTraceFunctionExit0( DUP2_NOTESTODOVIEW_EDITTODO_EXIT );
+ return;
+ }
+
+ // Now launch the editor with the obtained info.
+ mNotesEditor = new NotesEditor(mAgendaUtil, this);
+ connect(
+ mNotesEditor, SIGNAL(editingCompleted(bool)),
+ this, SLOT(handleEditingCompleted(bool)));
+ mNotesEditor->edit(entry);
+ OstTraceFunctionExit0( DUP3_NOTESTODOVIEW_EDITTODO_EXIT );
+}
+
+/*!
+ Slot to handle the signal editingCompleted by the notes editor.
+
+ \param status Boolean value indicating whether the note was saved or not.
+
+ \sa NotesEditor.
+ */
+void NotesTodoView::handleEditingCompleted(bool status)
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_HANDLEEDITINGCOMPLETED_ENTRY );
+ Q_UNUSED(status)
+
+ // Cleanup.
+ mNotesEditor->deleteLater();
+ OstTraceFunctionExit0( NOTESTODOVIEW_HANDLEEDITINGCOMPLETED_EXIT );
+}
+
+/*!
+ Directs the view manager to display the Collections view.
+ */
+void NotesTodoView::displayCollectionView()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_DISPLAYCOLLECTIONVIEW_ENTRY );
+ // Switch to collections view.
+ mAppControllerIf->switchToView(NotesNamespace::NotesCollectionViewId);
+ OstTraceFunctionExit0( NOTESTODOVIEW_DISPLAYCOLLECTIONVIEW_EXIT );
+}
+
+/*!
+ Directs the view manager to display the All notes view.
+ */
+void NotesTodoView::displayAllNotesView()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_DISPLAYALLNOTESVIEW_ENTRY );
+ // Switch to collections view.
+ mAppControllerIf->switchToView(NotesNamespace::NotesMainViewId);
+ OstTraceFunctionExit0( NOTESTODOVIEW_DISPLAYALLNOTESVIEW_EXIT );
+}
+
+/*!
+ Slot to handle signal editingCompleted by the to-do editor
+ */
+void NotesTodoView::handleEditingCompleted()
+{
+ OstTraceFunctionEntry0( DUP1_NOTESTODOVIEW_HANDLEEDITINGCOMPLETED_ENTRY );
+ // Cleanup.
+ mNotesEditor->deleteLater();
+ OstTraceFunctionExit0( DUP1_NOTESTODOVIEW_HANDLEEDITINGCOMPLETED_EXIT );
+}
+
+/*!
+ Slot to handle signal handleViewingompleted by the agenda event viewer
+ */
+void NotesTodoView::handleViewingCompleted()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_HANDLEVIEWINGCOMPLETED_ENTRY );
+ // Cleanup.
+ mAgendaEventViewer->deleteLater();
+ OstTraceFunctionExit0( NOTESTODOVIEW_HANDLEVIEWINGCOMPLETED_EXIT );
+}
+
+/*!
+ Slot to handle the case when the state of an action has changed.
+ */
+void NotesTodoView::handleActionStateChanged()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_HANDLEACTIONSTATECHANGED_ENTRY );
+ mAllNotesAction->setChecked(true);
+ OstTraceFunctionExit0( NOTESTODOVIEW_HANDLEACTIONSTATECHANGED_EXIT );
+}
+
+/*!
+ Handles the orientation changes.Updates the list
+ item when orientation is changed
+
+ \param orientation Value of the orientation
+ */
+void NotesTodoView::handleOrientationChanged(Qt::Orientation orientation)
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_HANDLEORIENTATIONCHANGED_ENTRY );
+ HbListViewItem *prototype = mListView->listItemPrototype();
+
+ if (Qt::Horizontal == orientation) {
+ prototype->setStretchingStyle(HbListViewItem::StretchLandscape);
+ } else {
+ prototype->setStretchingStyle(HbListViewItem::NoStretching);
+ }
+ OstTraceFunctionExit0( NOTESTODOVIEW_HANDLEORIENTATIONCHANGED_EXIT );
+}
+
+/*!
+ Updates the sub heading text
+ */
+void NotesTodoView::updateSubTitle(ulong id)
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_UPDATESUBTITLE_ENTRY );
+ Q_UNUSED(id)
+
+ // Get the number of incompleted to-do entries.
+ QList<ulong> entries = mAgendaUtil->entryIds(
+ AgendaUtil::IncludeIncompletedTodos);
+ mSubTitle->setHeading(
+ hbTrId("txt_notes_subhead_todos_ln_pending",entries.count()));
+
+ if (0 < mProxyModel->rowCount()) {
+ mEmptyListLabel->hide();
+ mListView->show();
+ } else {
+ mEmptyListLabel->show();
+ mListView->hide();
+ }
+ OstTraceFunctionExit0( NOTESTODOVIEW_UPDATESUBTITLE_EXIT );
+}
+
+/*
+ Opens the to-do viewer to view the to-do.
+ */
+void NotesTodoView::openTodo()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_OPENTODO_ENTRY );
+ ulong noteId = mSelectedItem->modelIndex().data(
+ NotesNamespace::IdRole).value<qulonglong>();
+ AgendaEntry entry = mAgendaUtil->fetchById(noteId);
+
+ // Construct agenda event viewer.
+ mAgendaEventViewer = new AgendaEventViewer(mAgendaUtil, this);
+
+ connect(
+ mAgendaEventViewer, SIGNAL(viewingCompleted(bool)),
+ this, SLOT(handleViewingCompleted(bool)));
+
+ // Launch agenda event viewer
+ mAgendaEventViewer->view(
+ entry, AgendaEventViewer::ActionEditDelete);
+ OstTraceFunctionExit0( NOTESTODOVIEW_OPENTODO_EXIT );
+}
+
+/*
+ Slot to handle the context menu actions.
+ */
+void NotesTodoView::selectedMenuAction(HbAction *action)
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_SELECTEDMENUACTION_ENTRY );
+ if (action == mOpenAction) {
+ openTodo();
+ } else if (action == mEditAction) {
+ editTodo();
+ } else if (action == mDeleteAction) {
+ deleteTodo();
+ } else if (action == mTodoStatusAction) {
+ markTodoStatus();
+ }
+ OstTraceFunctionExit0( NOTESTODOVIEW_SELECTEDMENUACTION_EXIT );
+}
+
+
+/*!
+ Slot to handle the context menu closed.
+ */
+void NotesTodoView::handleMenuClosed()
+{
+ OstTraceFunctionEntry0( NOTESTODOVIEW_HANDLEMENUCLOSED_ENTRY );
+ mIsLongTop = false;
+ OstTraceFunctionExit0( NOTESTODOVIEW_HANDLEMENUCLOSED_EXIT );
+}
+
+// End of file --Don't remove this.