videocollection/videocollectionview/inc/videocollectionuiloader.h
author hgs
Thu, 01 Apr 2010 23:22:15 +0300
changeset 34 bbb98528c666
parent 30 4f111d64a341
child 35 3738fe97f027
permissions -rw-r--r--
201009
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
30
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#ifndef _VIDEOCOLLECTIONUILOADER_H_
hgs
parents:
diff changeset
    19
#define _VIDEOCOLLECTIONUILOADER_H_
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
// System includes
hgs
parents:
diff changeset
    22
#include <hbdocumentloader.h>
34
hgs
parents: 30
diff changeset
    23
#include <qhash.h>
hgs
parents: 30
diff changeset
    24
#include <qmap.h>
30
hgs
parents:
diff changeset
    25
hgs
parents:
diff changeset
    26
// Constants
hgs
parents:
diff changeset
    27
static const char* DOCML_VIDEOCOLLECTIONVIEW_FILE     = ":/layout/collectionview.docml";
hgs
parents:
diff changeset
    28
static const char* DOCML_NAME_VIEW                    = "view";
hgs
parents:
diff changeset
    29
hgs
parents:
diff changeset
    30
// Videocollection View
hgs
parents:
diff changeset
    31
static const char* DOCML_NAME_VC_HEADINGBANNER        = "vc:mBanner";
34
hgs
parents: 30
diff changeset
    32
static const char* DOCML_NAME_VC_COLLECTIONWIDGET     = "vc:mCollectionWidget";
hgs
parents: 30
diff changeset
    33
static const char* DOCML_NAME_VC_COLLECTIONCONTENTWIDGET = "vc:mCollectionContentWidget";
30
hgs
parents:
diff changeset
    34
static const char* DOCML_NAME_VC_VIDEOLISTWIDGET      = "vc:mListWidget";
hgs
parents:
diff changeset
    35
static const char* DOCML_NAME_VC_VIDEOHINTWIDGET      = "vc:mHintWidget";
hgs
parents:
diff changeset
    36
hgs
parents:
diff changeset
    37
// Videocollection Options Menu
hgs
parents:
diff changeset
    38
static const char* DOCML_NAME_OPTIONS_MENU            = "vc:mOptionsMenu";
hgs
parents:
diff changeset
    39
static const char* DOCML_NAME_SORT_MENU               = "vc:mSortBy";
hgs
parents:
diff changeset
    40
hgs
parents:
diff changeset
    41
static const char* DOCML_NAME_SORT_BY_DATE            = "vc:mDate";
hgs
parents:
diff changeset
    42
static const char* DOCML_NAME_SORT_BY_NAME            = "vc:mName";
hgs
parents:
diff changeset
    43
static const char* DOCML_NAME_SORT_BY_NUMBER_OF_ITEMS = "vc:mNumberOfItems";
hgs
parents:
diff changeset
    44
static const char* DOCML_NAME_SORT_BY_TOTAL_LENGTH    = "vc:mTotalLength";
hgs
parents:
diff changeset
    45
static const char* DOCML_NAME_SORT_BY_RATING          = "vc:mRating";
hgs
parents:
diff changeset
    46
static const char* DOCML_NAME_SORT_BY_SIZE            = "vc:mSize";
hgs
parents:
diff changeset
    47
hgs
parents:
diff changeset
    48
static const char* DOCML_NAME_ADD_TO_COLLECTION       = "vc:mAddtoCollection";
hgs
parents:
diff changeset
    49
static const char* DOCML_NAME_CREATE_COLLECTION       = "vc:mCreateNewCollection";
hgs
parents:
diff changeset
    50
static const char* DOCML_NAME_DELETE_MULTIPLE         = "vc:mDeleteMultiple";
hgs
parents:
diff changeset
    51
hgs
parents:
diff changeset
    52
static const char* DOCML_NAME_PLAY_IN_QUEUE           = "vc:mPlayInQueue";
hgs
parents:
diff changeset
    53
static const char* DOCML_NAME_PLAY_ALL_ITEMS          = "vc:mPlayAllItems";
hgs
parents:
diff changeset
    54
hgs
parents:
diff changeset
    55
// Videocollection hint widget
hgs
parents:
diff changeset
    56
static const char* DOCML_NAME_HINT_BUTTON             = "vc:mHintButton";
hgs
parents:
diff changeset
    57
static const char* DOCML_NAME_HINT_LABEL              = "vc:mHintTextLabel";
34
hgs
parents: 30
diff changeset
    58
static const char* DOCML_NAME_NO_VIDEOS_LABEL         = "vc:mNoVideosLabel";
30
hgs
parents:
diff changeset
    59
hgs
parents:
diff changeset
    60
// video multiselection dialog
hgs
parents:
diff changeset
    61
static const char* DOCML_VIDEOSELECTIONDIALOG_FILE    = ":/layout/videolistselectiondialog.docml";
hgs
parents:
diff changeset
    62
static const char* DOCML_NAME_DIALOG                  = "mMultiSelectionDialog";
hgs
parents:
diff changeset
    63
static const char* DOCML_NAME_DLG_HEADINGLBL          = "mHeadingLabel";
34
hgs
parents: 30
diff changeset
    64
static const char* DOCML_NAME_CHECK_CONTAINER         = "mCheckBoxContainer";
30
hgs
parents:
diff changeset
    65
static const char* DOCML_NAME_MARKALL                 = "mCheckMarkAll";
hgs
parents:
diff changeset
    66
static const char* DOCML_NAME_LBL_SELECTION           = "mSelectionCount";
hgs
parents:
diff changeset
    67
static const char* DOCML_NAME_LIST_CONTAINER          = "mListContainer";
hgs
parents:
diff changeset
    68
34
hgs
parents: 30
diff changeset
    69
// async loading timeout
hgs
parents: 30
diff changeset
    70
static const int ASYNC_FIND_TIMEOUT                   = 50; // ms
hgs
parents: 30
diff changeset
    71
hgs
parents: 30
diff changeset
    72
class QActionGroup;
hgs
parents: 30
diff changeset
    73
class HbAction;
30
hgs
parents:
diff changeset
    74
hgs
parents:
diff changeset
    75
// Class declaration
34
hgs
parents: 30
diff changeset
    76
class VideoCollectionUiLoader:
hgs
parents: 30
diff changeset
    77
    public QObject,
hgs
parents: 30
diff changeset
    78
    public HbDocumentLoader
30
hgs
parents:
diff changeset
    79
{
34
hgs
parents: 30
diff changeset
    80
    Q_OBJECT
hgs
parents: 30
diff changeset
    81
    
hgs
parents: 30
diff changeset
    82
private:
hgs
parents: 30
diff changeset
    83
    /** actions used in menus and toolbars */
hgs
parents: 30
diff changeset
    84
    enum ActionIds
hgs
parents: 30
diff changeset
    85
    {
hgs
parents: 30
diff changeset
    86
        EActionSortBy          =  1,
hgs
parents: 30
diff changeset
    87
        EActionSortByDate,
hgs
parents: 30
diff changeset
    88
        EActionSortByName,
hgs
parents: 30
diff changeset
    89
        EACtionSortByItemCount,
hgs
parents: 30
diff changeset
    90
        EActionSortByLength,
hgs
parents: 30
diff changeset
    91
        EActionSortBySize,
hgs
parents: 30
diff changeset
    92
        EActionNewCollection,
hgs
parents: 30
diff changeset
    93
        EActionAddToCollection,
hgs
parents: 30
diff changeset
    94
        EActionDelete,
hgs
parents: 30
diff changeset
    95
        ETBActionAllVideos,
hgs
parents: 30
diff changeset
    96
        ETBActionCollections,
hgs
parents: 30
diff changeset
    97
        ETBActionServices,
hgs
parents: 30
diff changeset
    98
        ETBActionAddVideos,
hgs
parents: 30
diff changeset
    99
        ETBActionRemoveVideos,
hgs
parents: 30
diff changeset
   100
        ETBActionSortVideos
hgs
parents: 30
diff changeset
   101
    };
hgs
parents: 30
diff changeset
   102
    
hgs
parents: 30
diff changeset
   103
    /** VideoCollectionUiLoader parameter class */ 
hgs
parents: 30
diff changeset
   104
    class Params
hgs
parents: 30
diff changeset
   105
    {
hgs
parents: 30
diff changeset
   106
    public:
hgs
parents: 30
diff changeset
   107
        Params(const QString& name,
hgs
parents: 30
diff changeset
   108
            bool isWidget = false,
hgs
parents: 30
diff changeset
   109
            QObject *receiver = 0,
hgs
parents: 30
diff changeset
   110
            const char *docml = 0,
hgs
parents: 30
diff changeset
   111
            const char *member = 0):
hgs
parents: 30
diff changeset
   112
            mName(name),
hgs
parents: 30
diff changeset
   113
            mIsWidget(isWidget),
hgs
parents: 30
diff changeset
   114
            mReceiver(receiver),
hgs
parents: 30
diff changeset
   115
            mDocml(docml),
hgs
parents: 30
diff changeset
   116
            mMember(member)
hgs
parents: 30
diff changeset
   117
            {
hgs
parents: 30
diff changeset
   118
            // nothing to do 
hgs
parents: 30
diff changeset
   119
            }
hgs
parents: 30
diff changeset
   120
        
hgs
parents: 30
diff changeset
   121
        bool isDuplicate(const Params& params) const
hgs
parents: 30
diff changeset
   122
            {
hgs
parents: 30
diff changeset
   123
            bool isSame(false);
hgs
parents: 30
diff changeset
   124
            
hgs
parents: 30
diff changeset
   125
            if (mName == params.mName &&
hgs
parents: 30
diff changeset
   126
                mReceiver == params.mReceiver &&
hgs
parents: 30
diff changeset
   127
                mDocml == params.mDocml &&
hgs
parents: 30
diff changeset
   128
                mMember == params.mMember)
hgs
parents: 30
diff changeset
   129
            {
hgs
parents: 30
diff changeset
   130
                isSame = true;
hgs
parents: 30
diff changeset
   131
            }
hgs
parents: 30
diff changeset
   132
            
hgs
parents: 30
diff changeset
   133
            return isSame;
hgs
parents: 30
diff changeset
   134
            }
hgs
parents: 30
diff changeset
   135
        
hgs
parents: 30
diff changeset
   136
    public:
hgs
parents: 30
diff changeset
   137
        QString mName;
hgs
parents: 30
diff changeset
   138
        bool mIsWidget;
hgs
parents: 30
diff changeset
   139
        QObject *mReceiver;
hgs
parents: 30
diff changeset
   140
        const char *mDocml;
hgs
parents: 30
diff changeset
   141
        const char *mMember;
hgs
parents: 30
diff changeset
   142
    };
30
hgs
parents:
diff changeset
   143
hgs
parents:
diff changeset
   144
public:
34
hgs
parents: 30
diff changeset
   145
    /**
hgs
parents: 30
diff changeset
   146
     * C++ constructor.
hgs
parents: 30
diff changeset
   147
     */
30
hgs
parents:
diff changeset
   148
    VideoCollectionUiLoader();
34
hgs
parents: 30
diff changeset
   149
    
hgs
parents: 30
diff changeset
   150
    /**
hgs
parents: 30
diff changeset
   151
     * C++ destructor.
hgs
parents: 30
diff changeset
   152
     */
hgs
parents: 30
diff changeset
   153
    virtual ~VideoCollectionUiLoader();
hgs
parents: 30
diff changeset
   154
    
hgs
parents: 30
diff changeset
   155
    /**
hgs
parents: 30
diff changeset
   156
     * Starts to load a specified UI section.
hgs
parents: 30
diff changeset
   157
     * 
hgs
parents: 30
diff changeset
   158
     * @param uiSection, UI section to load.
hgs
parents: 30
diff changeset
   159
     * @param receiver, Receiver of a ready signal.
hgs
parents: 30
diff changeset
   160
     * @param widgetSlot, Slot which is called when a widget is ready.
hgs
parents: 30
diff changeset
   161
     * @param objectSlot, Slot which is called when an object is ready.
hgs
parents: 30
diff changeset
   162
     * @return None.
hgs
parents: 30
diff changeset
   163
     */
hgs
parents: 30
diff changeset
   164
    void startLoading(QSet<QString> uiSections,
hgs
parents: 30
diff changeset
   165
        QObject *receiver,
hgs
parents: 30
diff changeset
   166
        const char *widgetSlot,
hgs
parents: 30
diff changeset
   167
        const char *objectSlot);
30
hgs
parents:
diff changeset
   168
hgs
parents:
diff changeset
   169
    /**
hgs
parents:
diff changeset
   170
     * Returns the requested widget casted to correct type
hgs
parents:
diff changeset
   171
     *
hgs
parents:
diff changeset
   172
     * @param name Name of the widget
hgs
parents:
diff changeset
   173
     * @return Pointer to the widget
hgs
parents:
diff changeset
   174
     */
hgs
parents:
diff changeset
   175
    template<class T>
34
hgs
parents: 30
diff changeset
   176
    T* findWidget(const QString &name)
30
hgs
parents:
diff changeset
   177
    {
34
hgs
parents: 30
diff changeset
   178
        return qobject_cast<T*>(doFindWidget(name));
30
hgs
parents:
diff changeset
   179
    }
hgs
parents:
diff changeset
   180
hgs
parents:
diff changeset
   181
    /**
hgs
parents:
diff changeset
   182
     * Returns the requested object casted to correct type
hgs
parents:
diff changeset
   183
     *
hgs
parents:
diff changeset
   184
     * @param name Name of the object
hgs
parents:
diff changeset
   185
     * @return Pointer to the object
hgs
parents:
diff changeset
   186
     */
hgs
parents:
diff changeset
   187
    template<class T>
34
hgs
parents: 30
diff changeset
   188
    T* findObject(const QString &name)
30
hgs
parents:
diff changeset
   189
    {
34
hgs
parents: 30
diff changeset
   190
        return qobject_cast<T*>(doFindObject(name));
30
hgs
parents:
diff changeset
   191
    }
34
hgs
parents: 30
diff changeset
   192
    
hgs
parents: 30
diff changeset
   193
    /**
hgs
parents: 30
diff changeset
   194
     * Set video services in use.
hgs
parents: 30
diff changeset
   195
     */
hgs
parents: 30
diff changeset
   196
    void setIsService(bool isService);
30
hgs
parents:
diff changeset
   197
34
hgs
parents: 30
diff changeset
   198
signals:
hgs
parents: 30
diff changeset
   199
    /**
hgs
parents: 30
diff changeset
   200
     * Signals that widget has been loaded asynchonously.
hgs
parents: 30
diff changeset
   201
     * 
hgs
parents: 30
diff changeset
   202
     * @param widget, Widget which was loaded.
hgs
parents: 30
diff changeset
   203
     * @param name, Name of the widget in document.
hgs
parents: 30
diff changeset
   204
     * @return None.
hgs
parents: 30
diff changeset
   205
     */
hgs
parents: 30
diff changeset
   206
    void widgetReady(QGraphicsWidget *widget, const QString &name);
hgs
parents: 30
diff changeset
   207
hgs
parents: 30
diff changeset
   208
    /**
hgs
parents: 30
diff changeset
   209
     * Signals that object has been loaded asynchonously.
hgs
parents: 30
diff changeset
   210
     * 
hgs
parents: 30
diff changeset
   211
     * @param object, Object which was loaded.
hgs
parents: 30
diff changeset
   212
     * @param name, Name of the object in document.
hgs
parents: 30
diff changeset
   213
     * @return None.
hgs
parents: 30
diff changeset
   214
     */
hgs
parents: 30
diff changeset
   215
    void objectReady(QObject *object, const QString &name);
hgs
parents: 30
diff changeset
   216
hgs
parents: 30
diff changeset
   217
public:
hgs
parents: 30
diff changeset
   218
    /**
hgs
parents: 30
diff changeset
   219
     * Loads widget from document.
hgs
parents: 30
diff changeset
   220
     * 
hgs
parents: 30
diff changeset
   221
     * @param name, Widget name.
hgs
parents: 30
diff changeset
   222
     * @return QGraphicsWidget*.
hgs
parents: 30
diff changeset
   223
     */
hgs
parents: 30
diff changeset
   224
    QGraphicsWidget* doFindWidget(const QString &name);
hgs
parents: 30
diff changeset
   225
    
hgs
parents: 30
diff changeset
   226
    /**
hgs
parents: 30
diff changeset
   227
     * Loads object from document.
hgs
parents: 30
diff changeset
   228
     * 
hgs
parents: 30
diff changeset
   229
     * @param name, Widget name.
hgs
parents: 30
diff changeset
   230
     * @return QGraphicsWidget*.
hgs
parents: 30
diff changeset
   231
     */
hgs
parents: 30
diff changeset
   232
    QObject* doFindObject(const QString &name);
hgs
parents: 30
diff changeset
   233
    
30
hgs
parents:
diff changeset
   234
private:
34
hgs
parents: 30
diff changeset
   235
    /**
hgs
parents: 30
diff changeset
   236
     * Adds a ui section to async loading queue.
hgs
parents: 30
diff changeset
   237
     */
hgs
parents: 30
diff changeset
   238
    void addToQueue(Params &params);
hgs
parents: 30
diff changeset
   239
    
hgs
parents: 30
diff changeset
   240
    /**
hgs
parents: 30
diff changeset
   241
     * Init a specific widget.
hgs
parents: 30
diff changeset
   242
     */
hgs
parents: 30
diff changeset
   243
    void initWidget(QGraphicsWidget *widget,
hgs
parents: 30
diff changeset
   244
        const QString &name);
hgs
parents: 30
diff changeset
   245
    
hgs
parents: 30
diff changeset
   246
    /**
hgs
parents: 30
diff changeset
   247
     * Init a specific object.
hgs
parents: 30
diff changeset
   248
     */
hgs
parents: 30
diff changeset
   249
    void initObject(QObject *object,
hgs
parents: 30
diff changeset
   250
        const QString& name);
hgs
parents: 30
diff changeset
   251
    
hgs
parents: 30
diff changeset
   252
private:
hgs
parents: 30
diff changeset
   253
    /** from QObject */
hgs
parents: 30
diff changeset
   254
    void timerEvent(QTimerEvent *event); 
hgs
parents: 30
diff changeset
   255
    
hgs
parents: 30
diff changeset
   256
    /** from HbDocumentLoader */
hgs
parents: 30
diff changeset
   257
    QObject *createObject(const QString& type, const QString &name);
hgs
parents: 30
diff changeset
   258
    
hgs
parents: 30
diff changeset
   259
private:
hgs
parents: 30
diff changeset
   260
    /**
hgs
parents: 30
diff changeset
   261
     * Run next async find request from queue.
hgs
parents: 30
diff changeset
   262
     */
hgs
parents: 30
diff changeset
   263
    void runNext();
hgs
parents: 30
diff changeset
   264
    
hgs
parents: 30
diff changeset
   265
    /**
hgs
parents: 30
diff changeset
   266
     * Check that set params are valid.
hgs
parents: 30
diff changeset
   267
     */
hgs
parents: 30
diff changeset
   268
    bool isValid(const Params &params);
hgs
parents: 30
diff changeset
   269
    
hgs
parents: 30
diff changeset
   270
private:
hgs
parents: 30
diff changeset
   271
    /** async queue */
hgs
parents: 30
diff changeset
   272
    QList<Params> mQueue;
hgs
parents: 30
diff changeset
   273
    
hgs
parents: 30
diff changeset
   274
    /** timer id */
hgs
parents: 30
diff changeset
   275
    int mTimerId;
hgs
parents: 30
diff changeset
   276
    
hgs
parents: 30
diff changeset
   277
    /** list of loaded widgets */
hgs
parents: 30
diff changeset
   278
    QHash<QString, QGraphicsWidget*> mWidgets;
30
hgs
parents:
diff changeset
   279
34
hgs
parents: 30
diff changeset
   280
    /** list of loaded objects */
hgs
parents: 30
diff changeset
   281
    QHash<QString, QObject*> mObjects;
hgs
parents: 30
diff changeset
   282
    
hgs
parents: 30
diff changeset
   283
    /** menu actions */
hgs
parents: 30
diff changeset
   284
    QMap<ActionIds, HbAction*> mMenuActions;
hgs
parents: 30
diff changeset
   285
    
hgs
parents: 30
diff changeset
   286
    /** toolbar actions */
hgs
parents: 30
diff changeset
   287
    QMap<ActionIds, HbAction*> mToolbarActions;
hgs
parents: 30
diff changeset
   288
    
hgs
parents: 30
diff changeset
   289
    /** action group for "sort by" actions */
hgs
parents: 30
diff changeset
   290
    QActionGroup* mSortGroup;
hgs
parents: 30
diff changeset
   291
    
hgs
parents: 30
diff changeset
   292
    /** is service */
hgs
parents: 30
diff changeset
   293
    bool mIsService;
30
hgs
parents:
diff changeset
   294
};
hgs
parents:
diff changeset
   295
hgs
parents:
diff changeset
   296
#endif // _VIDEOCOLLECTIONUILOADER_H_