videocollection/videocollectionview/inc/videolistselectiondialog.h
author hgs
Fri, 15 Oct 2010 16:29:10 +0300
changeset 67 72c709219fcd
parent 58 d2b028fd1f7d
permissions -rw-r--r--
201041
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
30
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2008 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:   Videolist selection dialog 
hgs
parents:
diff changeset
    15
* 
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#ifndef VIDEOLISTSELECTIONDIALOG_H
hgs
parents:
diff changeset
    19
#define VIDEOLISTSELECTIONDIALOG_H
hgs
parents:
diff changeset
    20
67
hgs
parents: 58
diff changeset
    21
#include <hbselectiondialog.h>
34
hgs
parents: 30
diff changeset
    22
#include <qset.h>
hgs
parents: 30
diff changeset
    23
#include <mpxitemid.h>
67
hgs
parents: 58
diff changeset
    24
#include <qpointer.h>
30
hgs
parents:
diff changeset
    25
67
hgs
parents: 58
diff changeset
    26
class QGraphicsItem;
hgs
parents: 58
diff changeset
    27
class QTimer;
hgs
parents: 58
diff changeset
    28
class VideoProxyModelGeneric;
34
hgs
parents: 30
diff changeset
    29
class VideoCollectionUiLoader;
30
hgs
parents:
diff changeset
    30
67
hgs
parents: 58
diff changeset
    31
class VideoListSelectionDialog: public HbSelectionDialog
hgs
parents: 58
diff changeset
    32
{
30
hgs
parents:
diff changeset
    33
    /**
hgs
parents:
diff changeset
    34
     * definition required for emitting / connecting signals 
hgs
parents:
diff changeset
    35
     */
hgs
parents:
diff changeset
    36
    Q_OBJECT
hgs
parents:
diff changeset
    37
    
hgs
parents:
diff changeset
    38
    /**
hgs
parents:
diff changeset
    39
     * disable copy-constructor and assignment operator
hgs
parents:
diff changeset
    40
     */
hgs
parents:
diff changeset
    41
    Q_DISABLE_COPY(VideoListSelectionDialog) 
hgs
parents:
diff changeset
    42
hgs
parents:
diff changeset
    43
    
hgs
parents:
diff changeset
    44
public: 
hgs
parents:
diff changeset
    45
    
34
hgs
parents: 30
diff changeset
    46
    enum TSelectionFunction
hgs
parents: 30
diff changeset
    47
    {
67
hgs
parents: 58
diff changeset
    48
        ENoFunction = -1,
34
hgs
parents: 30
diff changeset
    49
        EDeleteVideos,
35
hgs
parents: 34
diff changeset
    50
        EAddToCollection,        
hgs
parents: 34
diff changeset
    51
        ERemoveFromCollection,
40
hgs
parents: 37
diff changeset
    52
        ECreateCollection,
34
hgs
parents: 30
diff changeset
    53
        ESelectCollection
hgs
parents: 30
diff changeset
    54
    };
hgs
parents: 30
diff changeset
    55
    
30
hgs
parents:
diff changeset
    56
    /**
hgs
parents:
diff changeset
    57
     * Constructor
hgs
parents:
diff changeset
    58
     *
hgs
parents:
diff changeset
    59
     * @param parent item's parent component
hgs
parents:
diff changeset
    60
     */
67
hgs
parents: 58
diff changeset
    61
    VideoListSelectionDialog(QGraphicsItem *parent=0);
hgs
parents: 58
diff changeset
    62
30
hgs
parents:
diff changeset
    63
    /**
hgs
parents:
diff changeset
    64
     * Destructor
hgs
parents:
diff changeset
    65
     */
hgs
parents:
diff changeset
    66
    ~VideoListSelectionDialog();
hgs
parents:
diff changeset
    67
   
hgs
parents:
diff changeset
    68
    /**
hgs
parents:
diff changeset
    69
     * Method setups provided title and videolist content widget.
hgs
parents:
diff changeset
    70
     * Prepares dialog for showing.
hgs
parents:
diff changeset
    71
     * If either provided title is empty or widget is NULL, dialog
hgs
parents:
diff changeset
    72
     * is in invalid state and cannot be shown using exec.
hgs
parents:
diff changeset
    73
     *
34
hgs
parents: 30
diff changeset
    74
     * @param type selection dialog function typy
hgs
parents: 30
diff changeset
    75
     * @param activeItem id of item that the selection concerns
30
hgs
parents:
diff changeset
    76
     */
67
hgs
parents: 58
diff changeset
    77
    void setupContent(VideoListSelectionDialog::TSelectionFunction type, TMPXItemId activeItem = TMPXItemId::InvalidId());
hgs
parents: 58
diff changeset
    78
30
hgs
parents:
diff changeset
    79
public slots:
hgs
parents:
diff changeset
    80
hgs
parents:
diff changeset
    81
    /**
hgs
parents:
diff changeset
    82
     * Shows modal dialog build from the provided Videolistwidget.
hgs
parents:
diff changeset
    83
     *
hgs
parents:
diff changeset
    84
     */
35
hgs
parents: 34
diff changeset
    85
    void exec();
30
hgs
parents:
diff changeset
    86
    
37
hgs
parents: 36
diff changeset
    87
    /**
hgs
parents: 36
diff changeset
    88
     * Signaled by HbInputDialog when it's closed.
hgs
parents: 36
diff changeset
    89
     */
hgs
parents: 36
diff changeset
    90
    void newAlbumNameDialogFinished(HbAction *action);    
hgs
parents: 36
diff changeset
    91
    
30
hgs
parents:
diff changeset
    92
private slots:
hgs
parents:
diff changeset
    93
    
hgs
parents:
diff changeset
    94
    /**
67
hgs
parents: 58
diff changeset
    95
     * disables or enables popup's primary action in case selection changes
30
hgs
parents:
diff changeset
    96
     */
67
hgs
parents: 58
diff changeset
    97
    void selectionChangedSlot();
hgs
parents: 58
diff changeset
    98
34
hgs
parents: 30
diff changeset
    99
    /**
50
hgs
parents: 40
diff changeset
   100
     * Handles model ready signal from model.
34
hgs
parents: 30
diff changeset
   101
     */
hgs
parents: 30
diff changeset
   102
    void modelReadySlot();
hgs
parents: 30
diff changeset
   103
    
hgs
parents: 30
diff changeset
   104
    /**
50
hgs
parents: 40
diff changeset
   105
     * Handles album list ready signal from model.
hgs
parents: 40
diff changeset
   106
     */
hgs
parents: 40
diff changeset
   107
    void albumListReadySlot();
hgs
parents: 40
diff changeset
   108
    
hgs
parents: 40
diff changeset
   109
    /**
34
hgs
parents: 30
diff changeset
   110
     * Primary action triggered signal slot.
hgs
parents: 30
diff changeset
   111
     * 
hgs
parents: 30
diff changeset
   112
     */
hgs
parents: 30
diff changeset
   113
    void primaryActionTriggeredSlot();
35
hgs
parents: 34
diff changeset
   114
    
hgs
parents: 34
diff changeset
   115
    /**
hgs
parents: 34
diff changeset
   116
     * called when dialog has been finished
hgs
parents: 34
diff changeset
   117
     * 
hgs
parents: 34
diff changeset
   118
     * @param action causing the finished
hgs
parents: 34
diff changeset
   119
     */
hgs
parents: 34
diff changeset
   120
    void finishedSlot(HbAction *action);
67
hgs
parents: 58
diff changeset
   121
hgs
parents: 58
diff changeset
   122
    /**
hgs
parents: 58
diff changeset
   123
     * Signaled when view scrolling starts, pauses thumbnail creation.
hgs
parents: 58
diff changeset
   124
     *
hgs
parents: 58
diff changeset
   125
     */
hgs
parents: 58
diff changeset
   126
    void scrollingStartedSlot();
hgs
parents: 58
diff changeset
   127
hgs
parents: 58
diff changeset
   128
    /**
hgs
parents: 58
diff changeset
   129
     * Signaled when view scrolling ends, initiates thumbnail fetching
hgs
parents: 58
diff changeset
   130
     * at index of first visible item and enables creation of thumbnails.
hgs
parents: 58
diff changeset
   131
     *
hgs
parents: 58
diff changeset
   132
     */
hgs
parents: 58
diff changeset
   133
    void scrollingEndedSlot();
hgs
parents: 58
diff changeset
   134
hgs
parents: 58
diff changeset
   135
    /**
hgs
parents: 58
diff changeset
   136
     * Signaled when view scroll position changes, initiates timer to
hgs
parents: 58
diff changeset
   137
     * fetch thumbnails at index of first visible item.
hgs
parents: 58
diff changeset
   138
     *
hgs
parents: 58
diff changeset
   139
     * @param newPosition scroll position
hgs
parents: 58
diff changeset
   140
     *
hgs
parents: 58
diff changeset
   141
     */
hgs
parents: 58
diff changeset
   142
    void scrollPositionChangedSlot(const QPointF &newPosition);
hgs
parents: 58
diff changeset
   143
hgs
parents: 58
diff changeset
   144
    /**
hgs
parents: 58
diff changeset
   145
     * Signaled when scroll position timer triggers. Starts fetching thumbnails
hgs
parents: 58
diff changeset
   146
     * for visible items.
hgs
parents: 58
diff changeset
   147
     *
hgs
parents: 58
diff changeset
   148
     */
hgs
parents: 58
diff changeset
   149
    void scrollPositionTimerSlot();
hgs
parents: 58
diff changeset
   150
hgs
parents: 58
diff changeset
   151
    /**
hgs
parents: 58
diff changeset
   152
     * Fetches thumbnails for the visible items.
hgs
parents: 58
diff changeset
   153
     *
hgs
parents: 58
diff changeset
   154
     */
hgs
parents: 58
diff changeset
   155
    void fetchThumbnailsForVisibleItems();
hgs
parents: 58
diff changeset
   156
30
hgs
parents:
diff changeset
   157
private:
hgs
parents:
diff changeset
   158
    
hgs
parents:
diff changeset
   159
    /**
34
hgs
parents: 30
diff changeset
   160
     * Method initializes dialog by getting all ui components and 
hgs
parents: 30
diff changeset
   161
     * checking if they are valid
hgs
parents: 30
diff changeset
   162
     * 
hgs
parents: 30
diff changeset
   163
     * @return bool true if inisializaion ok
hgs
parents: 30
diff changeset
   164
     */
hgs
parents: 30
diff changeset
   165
    bool initDialog();
67
hgs
parents: 58
diff changeset
   166
hgs
parents: 58
diff changeset
   167
    /**
hgs
parents: 58
diff changeset
   168
     * Method initializes list by setting the model
hgs
parents: 58
diff changeset
   169
     *
hgs
parents: 58
diff changeset
   170
     * @param model to be set
hgs
parents: 58
diff changeset
   171
     *
hgs
parents: 58
diff changeset
   172
     * @return bool true if inisializaion ok
hgs
parents: 58
diff changeset
   173
     */
hgs
parents: 58
diff changeset
   174
    bool initList(VideoProxyModelGeneric *model);
hgs
parents: 58
diff changeset
   175
34
hgs
parents: 30
diff changeset
   176
    /**
hgs
parents: 30
diff changeset
   177
     * Method activated dialog based on value in mTypeOfSelection
67
hgs
parents: 58
diff changeset
   178
     *
hgs
parents: 58
diff changeset
   179
     * @param changeMode true if dialog mode is changed from multiselection to noselection while visible
hgs
parents: 58
diff changeset
   180
     *
34
hgs
parents: 30
diff changeset
   181
     */
67
hgs
parents: 58
diff changeset
   182
    void activateSelection(bool changeMode = false);
hgs
parents: 58
diff changeset
   183
34
hgs
parents: 30
diff changeset
   184
    /**
30
hgs
parents:
diff changeset
   185
     * connects all required signals into appropriate slots 
hgs
parents:
diff changeset
   186
     * for selection mode
hgs
parents:
diff changeset
   187
     */
hgs
parents:
diff changeset
   188
    void connectSignals();
hgs
parents:
diff changeset
   189
    
hgs
parents:
diff changeset
   190
    /**
hgs
parents:
diff changeset
   191
     * disconnects all signals 
hgs
parents:
diff changeset
   192
     */
hgs
parents:
diff changeset
   193
    void disconnectSignals();
hgs
parents:
diff changeset
   194
    
34
hgs
parents: 30
diff changeset
   195
    /**
hgs
parents: 30
diff changeset
   196
     * Gets selected item's name from appropriate model.
hgs
parents: 30
diff changeset
   197
     * 
hgs
parents: 30
diff changeset
   198
     * @return QString item's name
hgs
parents: 30
diff changeset
   199
     */
hgs
parents: 30
diff changeset
   200
    QString getSelectedName();
hgs
parents: 30
diff changeset
   201
    
hgs
parents: 30
diff changeset
   202
    /**
37
hgs
parents: 36
diff changeset
   203
     * Finalizes the operation.
34
hgs
parents: 30
diff changeset
   204
     */
37
hgs
parents: 36
diff changeset
   205
    void finalize(QString albumName = "");
34
hgs
parents: 30
diff changeset
   206
    
hgs
parents: 30
diff changeset
   207
private:
30
hgs
parents:
diff changeset
   208
   
hgs
parents:
diff changeset
   209
    /**
34
hgs
parents: 30
diff changeset
   210
     * type for defining selection functionality
30
hgs
parents:
diff changeset
   211
     */
67
hgs
parents: 58
diff changeset
   212
    VideoListSelectionDialog::TSelectionFunction mTypeOfSelection;
hgs
parents: 58
diff changeset
   213
30
hgs
parents:
diff changeset
   214
    /**
34
hgs
parents: 30
diff changeset
   215
     * Selected video items
hgs
parents: 30
diff changeset
   216
     */
hgs
parents: 30
diff changeset
   217
    QSet<TMPXItemId> mSelectedVideos;
hgs
parents: 30
diff changeset
   218
    
hgs
parents: 30
diff changeset
   219
    /**
hgs
parents: 30
diff changeset
   220
     * selected single items album id
hgs
parents: 30
diff changeset
   221
     */
hgs
parents: 30
diff changeset
   222
    TMPXItemId mSelectedAlbumId;
hgs
parents: 30
diff changeset
   223
    
hgs
parents: 30
diff changeset
   224
    /**
40
hgs
parents: 37
diff changeset
   225
     * Text for a new album.
hgs
parents: 37
diff changeset
   226
     */
hgs
parents: 37
diff changeset
   227
    QString mNewAlbumText;
hgs
parents: 37
diff changeset
   228
    
hgs
parents: 37
diff changeset
   229
    /**
34
hgs
parents: 30
diff changeset
   230
     * Video list model
hgs
parents: 30
diff changeset
   231
     */
58
hgs
parents: 50
diff changeset
   232
    VideoProxyModelGeneric *mModel;
34
hgs
parents: 30
diff changeset
   233
    
50
hgs
parents: 40
diff changeset
   234
    /**
hgs
parents: 40
diff changeset
   235
     * Boolean to know if the model is ready or not. 
hgs
parents: 40
diff changeset
   236
     */
hgs
parents: 40
diff changeset
   237
    bool mModelReady;
hgs
parents: 40
diff changeset
   238
    
hgs
parents: 40
diff changeset
   239
    /**
hgs
parents: 40
diff changeset
   240
     * Boolean to know if album list is ready or not.
hgs
parents: 40
diff changeset
   241
     */
hgs
parents: 40
diff changeset
   242
    bool mAlbumListReady;
67
hgs
parents: 58
diff changeset
   243
hgs
parents: 58
diff changeset
   244
    /**
hgs
parents: 58
diff changeset
   245
     * Boolean to know if listview has been initialised or not.
36
hgs
parents: 35
diff changeset
   246
     */
67
hgs
parents: 58
diff changeset
   247
    bool mListInitialised;
hgs
parents: 58
diff changeset
   248
36
hgs
parents: 35
diff changeset
   249
    /**
hgs
parents: 35
diff changeset
   250
     * Action to accept the selection dialog. 
hgs
parents: 35
diff changeset
   251
     */
67
hgs
parents: 58
diff changeset
   252
    QPointer<HbAction> mPrimaryAction;
hgs
parents: 58
diff changeset
   253
36
hgs
parents: 35
diff changeset
   254
    /**
hgs
parents: 35
diff changeset
   255
     * Action to cancel the selection dialog.
hgs
parents: 35
diff changeset
   256
     */
67
hgs
parents: 58
diff changeset
   257
    QPointer<HbAction> mSecondaryAction;
hgs
parents: 58
diff changeset
   258
hgs
parents: 58
diff changeset
   259
    /**
hgs
parents: 58
diff changeset
   260
     * Timer used to report thumbnail fetches class index of
hgs
parents: 58
diff changeset
   261
     * first visible item when view is scrolling.
hgs
parents: 58
diff changeset
   262
     */
hgs
parents: 58
diff changeset
   263
    QPointer<QTimer> mScrollPositionTimer;
30
hgs
parents:
diff changeset
   264
};
hgs
parents:
diff changeset
   265
hgs
parents:
diff changeset
   266
#endif  //VIDEOLISTSELECTIONDIALOG_H