phoneplugins/infowidgetplugin/infowidget/inc/infowidget.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Wed, 23 Jun 2010 18:12:20 +0300
changeset 45 6b911d05207e
child 46 bc5a64e5bc3c
permissions -rw-r--r--
Revision: 201023 Kit: 2010125

/*
 * 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:  
 *
 */

#ifndef INFOWIDGET_H
#define INFOWIDGET_H

#include <hbwidget.h>
#include <QList>
#include <QFlags>
#include "infowidgetlayoutmanager.h"
#include "infowidgetengine.h"
#include "infowidgetpreferences.h"

// Forward declarations 
class QGraphicsSceneMouseEvent;
class QGraphicsLinearLayout;
class QTranslator; 
class HbDialog;
class HbIconItem; 
class HbMarqueeItem;
class HbLabel; 
class HbCheckBox; 
class HbPushButton;
class HbFrameItem;
class HbAction; 
class InfoWidgetEngine; 
class InfoWidgetPreferences;
 
// Class declaration
class InfoWidget : public HbWidget
{
    Q_OBJECT

public: 

    // State for animation
    enum AnimationState {
        AnimationIdle, 
        AnimationStarting,
        AnimationOngoing
    } m_animationState; 
    
    // Delay for animation start
    enum AnimationStartDelay {
        StartNoDelay, 
        StartDelayed
    }; 
    
public:    
    InfoWidget(QGraphicsItem *parent = 0, Qt::WindowFlags flags = 0);
    ~InfoWidget();

public: // From QGraphicsItem.
    QRectF boundingRect() const;
    QSizeF sizeHint(Qt::SizeHint which, const QSizeF & constraint) const;  
    QSizePolicy sizePolicy () const;  

public: // Property definitions
    Q_PROPERTY(QString homeZoneDisplay READ homeZoneDisplay WRITE setHomeZoneDisplay)
    Q_PROPERTY(QString mcnDisplay READ mcnDisplay WRITE setMcnDisplay)
    Q_PROPERTY(QString activeLineDisplay READ activeLineDisplay WRITE setActiveLineDisplay)
    Q_PROPERTY(QString satDisplay READ satDisplay WRITE setSatDisplay)
    Q_PROPERTY(QString spnDisplay READ spnDisplay WRITE setSpnDisplay)
    QString homeZoneDisplay();
    void setHomeZoneDisplay(QString value);
    QString mcnDisplay();
    void setMcnDisplay(QString value);
    QString activeLineDisplay();
    void setActiveLineDisplay(QString value);
    QString satDisplay();
    void setSatDisplay(QString value);
    QString spnDisplay();
    void setSpnDisplay(QString value);
    
protected:
    void mousePressEvent(QGraphicsSceneMouseEvent *event);
    void mouseReleaseEvent(QGraphicsSceneMouseEvent *event); 
    void mouseMoveEvent(QGraphicsSceneMouseEvent *event); 
    void changeEvent(QEvent *event);
    void timerEvent(QTimerEvent *event);
    
    void updateInfoDisplay();
    bool readPersistentPreferences();
    void initializeCheckBoxStates(); 
    bool installTranslator(QString translationFile); 
    void removeTranslators(); 
     
private: 
    void updateItemsVisibility();
    void layoutInfoDisplay(); 
    void updateInfoDisplayItem(
            InfoWidgetLayoutManager::LayoutItemRole itemRole, 
            QString text); 
    void layoutSettingsDialog();
    void initializeSettingsDialogItems();
    void startChanges(); 
    void endChanges(); 

public slots: 
    // Slots for Homescreen FW callbacks
    void onInitialize();
    void onUninitialize();
    void onShow();
    void onHide();

    // Info widget specific slots 
    void readModel(); 
    void handleModelError(int operation,int errorCode);  
    void spnDisplaySettingChanged(int state);
    void mcnDisplaySettingChanged(int state);
    void satDisplaySettingChanged(int state);

    void settingsEditingFinished();
    void settingsEditingCancelled();
    void settingsValidationFailed(); 
    void settingsDialogClosed(HbAction* action); 
    
    bool startMarquees(AnimationStartDelay delay = StartNoDelay);
    void stopMarquees(); 
    void marqueeNext(); 
    
signals: 
    void setPreferences(const QStringList &names);

private:
    Q_DISABLE_COPY(InfoWidget)
    
    // Engine for widget, owned
    QScopedPointer<InfoWidgetEngine> m_engine;
    
    // Widget preference store, owned   
    QScopedPointer<InfoWidgetPreferences> m_preferences;

    // Layout manager for widget, owned 
    QScopedPointer<InfoWidgetLayoutManager> m_layoutManager;
    
    // Translators, owned
    QList<QTranslator *> m_translators;

    // Current widget layout, not owned 
    QGraphicsLinearLayout *m_layout;
    
    // Currently animating item(s), not owned 
    HbMarqueeItem *m_animatingItem; 
    QList<HbMarqueeItem *> m_animatingItems; 
    
    // Background frame drawer, not owned
    HbFrameItem *m_backgroundFrameItem;
    
    // Id of active timer 
    int m_timerId; 
    
    // Flags 
    bool m_layoutChanging;
    bool m_dragEvent; 
    bool m_initialized;

};


#endif // INFOWIDGET_H