--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/hswidgetmodel/src/hswidget.cpp	Fri Mar 19 09:35:23 2010 +0200
@@ -0,0 +1,392 @@
+/*
+* 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:  Base class for all homescreen widgets.
+*
+*/
+#include <QGraphicsDropShadowEffect>
+
+#include "hswidget.h"
+#include "hswidget_p.h"
+#include "ihswidgetpreferenceservice.h"
+
+/*!
+    \ingroup group_hswidgetmodel group_widget_api_candidates
+    \class HsWidget
+    \brief Base class for all home screen widgets.
+
+    Widget base class declares automata for derived widget. It also overwrites
+    mouse event functions to enable all mouse events.
+*/
+
+/*!
+    \enum HsWidget::StartResult
+    
+    Return values for onStart() method.
+*/
+
+/*!
+    \enum HsWidget::StopResult
+    
+    Return values for onSuspend() method.
+*/
+/*!
+    \enum HsWidget::SuspendResult
+    
+    Return values for onSuspend() method.
+*/
+
+/*!
+    \enum HsWidget::ResumeResult
+    
+    Return values for onResume() method.
+*/
+
+
+const char WIDGET_PREFERENCE_SERVICE_KEY[]="http://homescreen.nokia.com/runtimeservices/widgetpreferenceservice";
+
+
+HsWidgetPrivate::HsWidgetPrivate(HsWidget* handle): 
+    mPublic(handle),
+    mState(WidgetStateConstructed)
+{
+
+}
+
+HsWidgetPrivate::~HsWidgetPrivate()
+{
+
+}
+
+void HsWidgetPrivate::start()
+{
+    switch(mState)
+    {
+    case WidgetStateConstructed:
+    case WidgetStateFinished:
+        break;
+
+    default:
+        return;
+    }
+
+    switch(mPublic->onStart())
+    {
+    case HsWidget::StartResultRunning:
+        mState = WidgetStateRunning;
+        break;
+
+    case HsWidget::StartResultFinished:
+        mState = WidgetStateFinished;
+        emit mPublic->succeeded();
+        break;
+
+    case HsWidget::StartResultFaulted:
+        mState = WidgetStateFinished;
+        emit mPublic->faulted();
+        break;
+    }
+}
+
+
+void HsWidgetPrivate::stop()
+{
+    switch(mState)
+    {
+    case WidgetStateRunning:
+    case WidgetStateSuspended:
+        break;
+
+    default:
+        return;
+    }
+
+    switch(mPublic->onStop())
+    {
+    case HsWidget::StopResultFinished:
+        mState = WidgetStateFinished;
+        emit mPublic->stopped();
+        break;
+
+    case HsWidget::StopResultFinishing:
+        mState = WidgetStateFinishing;
+        break;
+
+    case HsWidget::StopResultFaulted:
+        mState = WidgetStateFinished;
+        emit mPublic->faulted();
+        break;
+
+    case HsWidget::StopResultFaulting:
+        mState = WidgetStateFaulting;
+        break;
+    }
+}
+
+
+void HsWidgetPrivate::suspend()
+{
+    switch(mState)
+    {
+    case WidgetStateRunning:
+        break;
+
+    default:
+        return;
+    }
+
+    switch(mPublic->onSuspend())
+    {
+    case HsWidget::SuspendResultSuspended:
+        mState = WidgetStateSuspended;
+        break;
+
+    case HsWidget::SuspendResultFaulted:
+        mState = WidgetStateFinished;
+        emit mPublic->faulted();
+        break;
+
+    case HsWidget::SuspendResultFaulting:
+        mState = WidgetStateFaulting;
+        break;
+    }
+}
+
+void HsWidgetPrivate::resume()
+{
+    switch(mState)
+    {
+    case WidgetStateSuspended:
+        break;
+
+    default:
+        return;
+    }
+
+    switch(mPublic->onResume())
+    {
+    case HsWidget::ResumeResultRunning:
+        mState = WidgetStateRunning;
+        break;
+
+    case HsWidget::ResumeResultFaulted:
+        mState = WidgetStateFinished;
+        emit mPublic->faulted();
+        break;
+
+    case HsWidget::ResumeResultFaulting:
+        mState = WidgetStateFaulting;
+        break;
+    }
+}
+
+
+void HsWidgetPrivate::setFinished()
+{
+    switch(mState)
+    {
+    case WidgetStateConstructed:
+    case WidgetStateFinished:
+        return;
+
+    case WidgetStateRunning:
+        mState = WidgetStateFinished;
+        emit mPublic->succeeded();
+        break;
+
+    case WidgetStateSuspended:
+        mState = WidgetStateFinished;
+        emit mPublic->succeeded();
+        break;
+
+    case WidgetStateFinishing:
+        mState = WidgetStateFinished;
+        emit mPublic->stopped();
+        break;
+
+    case WidgetStateFaulting:
+        mState = WidgetStateFinished;
+        emit mPublic->faulted();
+        break;
+    }
+}
+
+
+void HsWidgetPrivate::setFaulted()
+{
+    switch(mState)
+    {
+    case WidgetStateConstructed:
+    case WidgetStateFinished:
+        return;
+
+    default:
+        break;
+    }
+
+    mState = WidgetStateFinished;
+    emit mPublic->faulted();
+}
+
+
+void HsWidgetPrivate::setFaulting()
+{
+    switch(mState)
+    {
+    case WidgetStateConstructed:
+    case WidgetStateFinished:
+    case WidgetStateFaulting:
+        return;
+
+    default:
+        break;
+    }
+
+    mState = WidgetStateFaulting;
+}
+/*!
+    Constructs a widget which is a child of \a parent, with widget flags set to \a flags.
+    
+*/
+HsWidget::HsWidget(QGraphicsItem *parent, Qt::WindowFlags flags)
+    : HbWidget(parent, flags),mD(new HsWidgetPrivate(this))
+{   
+}
+
+/*!
+    Destructor
+    
+*/
+HsWidget::~HsWidget()
+{
+    delete mD;
+}
+/*!
+    Convenience method that returns the widget preference service from dynamically
+    added meta object property.
+*/
+
+IHsWidgetPreferenceService* HsWidget::widgetPreferenceService() const
+{
+    return property(WIDGET_PREFERENCE_SERVICE_KEY).
+        value<IHsWidgetPreferenceService*>();
+}
+
+/*!
+    Widget runtime starts widget
+*/
+void HsWidget::start()
+{
+    mD->start();
+}
+
+/*!
+    Widget runtime stops widget
+*/
+void HsWidget::stop()
+{
+    mD->stop();
+}
+
+/*!
+    Widget runtime suspends widget
+*/
+void HsWidget::suspend()
+{
+    mD->suspend();
+}
+
+/*!
+    Widget runtime resumes widget
+*/
+void HsWidget::resume()
+{
+    mD->resume();
+}
+
+/*!
+    \fn void HsWidget::succeeded()
+  
+    Emitted after this widget has succesfully done its job
+*/
+
+/*!
+    \fn void HsWidget::stopped()
+    
+    Emitted after this widget has stopped
+*/
+
+/*!
+    \fn void HsWidget::faulted()
+  
+    Emitted after this widget has faulted
+*/
+
+/*!
+    \fn virtual StartResult HsWidget::onStart() = 0
+    
+    WIdget can now e.g restore preferences
+*/
+
+/*!
+    \fn virtual StopResult HsWidget::onStop() = 0
+    
+    Release resources. Widget will be destroyed.
+*/
+
+/*!
+    Called by the widget runtime. Suspends this widget.
+*/
+HsWidget::SuspendResult HsWidget::onSuspend()
+{
+    return SuspendResultSuspended;
+}
+
+/*!
+    Called by the widget runtime. Resumes this widget.
+*/
+HsWidget::ResumeResult HsWidget::onResume()
+{
+    return ResumeResultRunning;
+}
+
+/*!
+    Indicates to the widget runtime that this widget should
+    transition to the Finished state.
+*/
+void HsWidget::setFinished()
+{
+    mD->setFinished();
+}
+
+/*!
+    Indicates to the widget runtime that this widget should
+    transition to the Faulted state.
+*/
+void HsWidget::setFaulted()
+{
+    mD->setFaulted();
+}
+
+/*!
+    Indicates to the widget runtime that this widget should
+    transition to the Faulting state.
+*/
+void HsWidget::setFaulting()
+{
+    mD->setFaulting();
+}
+
+
+
+