videocollection/videocollectionview/inc/videolistselectiondialog.h
author hgs
Fri, 11 Jun 2010 09:44:20 +0300
changeset 40 13331705e488
parent 37 4eb2df7f7cbe
child 50 21fe8338c6bf
permissions -rw-r--r--
201023
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
hgs
parents:
diff changeset
    21
#include <hbdialog.h>
34
hgs
parents: 30
diff changeset
    22
#include <qset.h>
30
hgs
parents:
diff changeset
    23
#include <qitemselectionmodel.h>
34
hgs
parents: 30
diff changeset
    24
#include <mpxitemid.h>
30
hgs
parents:
diff changeset
    25
hgs
parents:
diff changeset
    26
class QGraphicItem;
hgs
parents:
diff changeset
    27
class QItemSelection;
34
hgs
parents: 30
diff changeset
    28
class HbWidget;
30
hgs
parents:
diff changeset
    29
class HbLabel;
hgs
parents:
diff changeset
    30
class HbCheckBox;
hgs
parents:
diff changeset
    31
class HbStackedWidget;
34
hgs
parents: 30
diff changeset
    32
class VideoCollectionUiLoader;
hgs
parents: 30
diff changeset
    33
class VideoCollectionWrapper;
hgs
parents: 30
diff changeset
    34
class VideoSortFilterProxyModel;
30
hgs
parents:
diff changeset
    35
class VideoListWidget;
hgs
parents:
diff changeset
    36
hgs
parents:
diff changeset
    37
class VideoListSelectionDialog: public HbDialog
hgs
parents:
diff changeset
    38
{     
hgs
parents:
diff changeset
    39
    /**
hgs
parents:
diff changeset
    40
     * definition required for emitting / connecting signals 
hgs
parents:
diff changeset
    41
     */
hgs
parents:
diff changeset
    42
    Q_OBJECT
hgs
parents:
diff changeset
    43
    
hgs
parents:
diff changeset
    44
    /**
hgs
parents:
diff changeset
    45
     * disable copy-constructor and assignment operator
hgs
parents:
diff changeset
    46
     */
hgs
parents:
diff changeset
    47
    Q_DISABLE_COPY(VideoListSelectionDialog) 
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
    
hgs
parents:
diff changeset
    50
public: 
hgs
parents:
diff changeset
    51
    
34
hgs
parents: 30
diff changeset
    52
    enum TSelectionFunction
hgs
parents: 30
diff changeset
    53
    {
hgs
parents: 30
diff changeset
    54
        EDeleteVideos,
35
hgs
parents: 34
diff changeset
    55
        EAddToCollection,        
hgs
parents: 34
diff changeset
    56
        ERemoveFromCollection,
40
hgs
parents: 37
diff changeset
    57
        ECreateCollection,
34
hgs
parents: 30
diff changeset
    58
        ESelectCollection
hgs
parents: 30
diff changeset
    59
    };
hgs
parents: 30
diff changeset
    60
    
30
hgs
parents:
diff changeset
    61
    /**
hgs
parents:
diff changeset
    62
     * Constructor
hgs
parents:
diff changeset
    63
     *
hgs
parents:
diff changeset
    64
     * @param uiLoader used to load UI components from docml
hgs
parents:
diff changeset
    65
     * @param parent item's parent component
hgs
parents:
diff changeset
    66
     */
hgs
parents:
diff changeset
    67
    VideoListSelectionDialog(VideoCollectionUiLoader *uiLoader, QGraphicsItem *parent=0);
hgs
parents:
diff changeset
    68
    
hgs
parents:
diff changeset
    69
    /**
hgs
parents:
diff changeset
    70
     * Destructor
hgs
parents:
diff changeset
    71
     */
hgs
parents:
diff changeset
    72
    ~VideoListSelectionDialog();
hgs
parents:
diff changeset
    73
   
hgs
parents:
diff changeset
    74
    /**
hgs
parents:
diff changeset
    75
     * Method setups provided title and videolist content widget.
hgs
parents:
diff changeset
    76
     * Prepares dialog for showing.
hgs
parents:
diff changeset
    77
     * If either provided title is empty or widget is NULL, dialog
hgs
parents:
diff changeset
    78
     * is in invalid state and cannot be shown using exec.
hgs
parents:
diff changeset
    79
     *
34
hgs
parents: 30
diff changeset
    80
     * @param type selection dialog function typy
hgs
parents: 30
diff changeset
    81
     * @param activeItem id of item that the selection concerns
30
hgs
parents:
diff changeset
    82
     */
34
hgs
parents: 30
diff changeset
    83
    void setupContent(int type, TMPXItemId activeItem = TMPXItemId::InvalidId());
30
hgs
parents:
diff changeset
    84
    
hgs
parents:
diff changeset
    85
public slots:
hgs
parents:
diff changeset
    86
hgs
parents:
diff changeset
    87
    /**
hgs
parents:
diff changeset
    88
     * Shows modal dialog build from the provided Videolistwidget.
hgs
parents:
diff changeset
    89
     *
hgs
parents:
diff changeset
    90
     */
35
hgs
parents: 34
diff changeset
    91
    void exec();
30
hgs
parents:
diff changeset
    92
    
37
hgs
parents: 36
diff changeset
    93
    /**
hgs
parents: 36
diff changeset
    94
     * Signaled by HbInputDialog when it's closed.
hgs
parents: 36
diff changeset
    95
     */
hgs
parents: 36
diff changeset
    96
    void newAlbumNameDialogFinished(HbAction *action);    
hgs
parents: 36
diff changeset
    97
    
30
hgs
parents:
diff changeset
    98
private slots:
hgs
parents:
diff changeset
    99
    
hgs
parents:
diff changeset
   100
    /**
hgs
parents:
diff changeset
   101
     * Slot connected to mCheckBox's stateChanged -signal. 
hgs
parents:
diff changeset
   102
     * Selects or deselects all items if mForcedCheck -flag is false.
hgs
parents:
diff changeset
   103
     * 
hgs
parents:
diff changeset
   104
     * If Forcedcehck is true, it indeicates that we want to change the checked state
hgs
parents:
diff changeset
   105
     * only, not slect or deselect anything. This is needed for example if after 
hgs
parents:
diff changeset
   106
     * all items are marked, user manually deselects item's. In that case all is not
hgs
parents:
diff changeset
   107
     * marked, so checked state needs to be changed. 
hgs
parents:
diff changeset
   108
     *
hgs
parents:
diff changeset
   109
     * @param state Qt::Checked everything should be set as selected.
hgs
parents:
diff changeset
   110
     */
hgs
parents:
diff changeset
   111
    void markAllStateChangedSlot(int state);
hgs
parents:
diff changeset
   112
    
hgs
parents:
diff changeset
   113
    /**
hgs
parents:
diff changeset
   114
     * disables or enables popup's primary action in case selection changes
hgs
parents:
diff changeset
   115
     *
hgs
parents:
diff changeset
   116
     * @param selected item selection list containing selected
hgs
parents:
diff changeset
   117
     * @param deselected item selection list containing  not selected (not used in this scope)
hgs
parents:
diff changeset
   118
     */
hgs
parents:
diff changeset
   119
    void selectionChangedSlot(const QItemSelection &selected, const QItemSelection &deselected); 
hgs
parents:
diff changeset
   120
    
hgs
parents:
diff changeset
   121
    /**
34
hgs
parents: 30
diff changeset
   122
     * connected to list's activated -signal. Called when singel item is selected.
hgs
parents: 30
diff changeset
   123
     * If dialog's selection type is ESelectCollection, saves mpx id from provided index.
hgs
parents: 30
diff changeset
   124
     * and closes dialog by triggering primary action
hgs
parents: 30
diff changeset
   125
     *
hgs
parents: 30
diff changeset
   126
     * @param index of item selected
hgs
parents: 30
diff changeset
   127
     */
hgs
parents: 30
diff changeset
   128
    void singleItemSelectedSlot(const QModelIndex &index); 
hgs
parents: 30
diff changeset
   129
    
hgs
parents: 30
diff changeset
   130
    /**
hgs
parents: 30
diff changeset
   131
     * handles model ready signal from model.
hgs
parents: 30
diff changeset
   132
     * In case dialog type is ESelectCollection and there are no data
hgs
parents: 30
diff changeset
   133
     * in model, opens up a selection dialog for user to input new album name
hgs
parents: 30
diff changeset
   134
     * In case type is something else than ESelectCollection, calls
hgs
parents: 30
diff changeset
   135
     * updateCounterSlot()
hgs
parents: 30
diff changeset
   136
     */
hgs
parents: 30
diff changeset
   137
    void modelReadySlot();
hgs
parents: 30
diff changeset
   138
    
hgs
parents: 30
diff changeset
   139
    /**
30
hgs
parents:
diff changeset
   140
     * Changes the counter value. Sets the checkbutton state based on selection count.
hgs
parents:
diff changeset
   141
     *
hgs
parents:
diff changeset
   142
     */
hgs
parents:
diff changeset
   143
    void updateCounterSlot();
hgs
parents:
diff changeset
   144
    
34
hgs
parents: 30
diff changeset
   145
    /**
hgs
parents: 30
diff changeset
   146
     * Primary action triggered signal slot.
hgs
parents: 30
diff changeset
   147
     * 
hgs
parents: 30
diff changeset
   148
     */
hgs
parents: 30
diff changeset
   149
    void primaryActionTriggeredSlot();
35
hgs
parents: 34
diff changeset
   150
    
hgs
parents: 34
diff changeset
   151
    /**
hgs
parents: 34
diff changeset
   152
     * called when dialog has been finished
hgs
parents: 34
diff changeset
   153
     * 
hgs
parents: 34
diff changeset
   154
     * @param action causing the finished
hgs
parents: 34
diff changeset
   155
     */
hgs
parents: 34
diff changeset
   156
    void finishedSlot(HbAction *action);
34
hgs
parents: 30
diff changeset
   157
      
30
hgs
parents:
diff changeset
   158
private:
hgs
parents:
diff changeset
   159
    
hgs
parents:
diff changeset
   160
    /**
34
hgs
parents: 30
diff changeset
   161
     * Method initializes dialog by getting all ui components and 
hgs
parents: 30
diff changeset
   162
     * checking if they are valid
hgs
parents: 30
diff changeset
   163
     * 
hgs
parents: 30
diff changeset
   164
     * @return bool true if inisializaion ok
hgs
parents: 30
diff changeset
   165
     */
hgs
parents: 30
diff changeset
   166
    bool initDialog();
hgs
parents: 30
diff changeset
   167
    
hgs
parents: 30
diff changeset
   168
    /**
hgs
parents: 30
diff changeset
   169
     * Method activated dialog based on value in mTypeOfSelection
hgs
parents: 30
diff changeset
   170
     */
hgs
parents: 30
diff changeset
   171
    void activateSelection();
hgs
parents: 30
diff changeset
   172
    
hgs
parents: 30
diff changeset
   173
    /**
30
hgs
parents:
diff changeset
   174
     * connects all required signals into appropriate slots 
hgs
parents:
diff changeset
   175
     * for selection mode
hgs
parents:
diff changeset
   176
     */
hgs
parents:
diff changeset
   177
    void connectSignals();
hgs
parents:
diff changeset
   178
    
hgs
parents:
diff changeset
   179
    /**
hgs
parents:
diff changeset
   180
     * disconnects all signals 
hgs
parents:
diff changeset
   181
     */
hgs
parents:
diff changeset
   182
    void disconnectSignals();
hgs
parents:
diff changeset
   183
    
34
hgs
parents: 30
diff changeset
   184
    /**
hgs
parents: 30
diff changeset
   185
     * Gets selected item's name from appropriate model.
hgs
parents: 30
diff changeset
   186
     * 
hgs
parents: 30
diff changeset
   187
     * @return QString item's name
hgs
parents: 30
diff changeset
   188
     */
hgs
parents: 30
diff changeset
   189
    QString getSelectedName();
hgs
parents: 30
diff changeset
   190
    
hgs
parents: 30
diff changeset
   191
    /**
37
hgs
parents: 36
diff changeset
   192
     * Finalizes the operation.
34
hgs
parents: 30
diff changeset
   193
     */
37
hgs
parents: 36
diff changeset
   194
    void finalize(QString albumName = "");
34
hgs
parents: 30
diff changeset
   195
    
hgs
parents: 30
diff changeset
   196
private:
30
hgs
parents:
diff changeset
   197
   
hgs
parents:
diff changeset
   198
    /**
hgs
parents:
diff changeset
   199
     * docml UI loader, not owned
hgs
parents:
diff changeset
   200
     */
hgs
parents:
diff changeset
   201
    VideoCollectionUiLoader *mUiLoader;
34
hgs
parents: 30
diff changeset
   202
    
30
hgs
parents:
diff changeset
   203
    /**
34
hgs
parents: 30
diff changeset
   204
     * type for defining selection functionality
30
hgs
parents:
diff changeset
   205
     */
34
hgs
parents: 30
diff changeset
   206
    int mTypeOfSelection;
30
hgs
parents:
diff changeset
   207
    
hgs
parents:
diff changeset
   208
    /**
hgs
parents:
diff changeset
   209
     * Selection 
hgs
parents:
diff changeset
   210
     */
hgs
parents:
diff changeset
   211
    QItemSelection mSelection;
hgs
parents:
diff changeset
   212
    
hgs
parents:
diff changeset
   213
    /**
34
hgs
parents: 30
diff changeset
   214
     * Selected video items
hgs
parents: 30
diff changeset
   215
     */
hgs
parents: 30
diff changeset
   216
    QSet<TMPXItemId> mSelectedVideos;
hgs
parents: 30
diff changeset
   217
    
hgs
parents: 30
diff changeset
   218
    /**
hgs
parents: 30
diff changeset
   219
     * selected single items album id
hgs
parents: 30
diff changeset
   220
     */
hgs
parents: 30
diff changeset
   221
    TMPXItemId mSelectedAlbumId;
hgs
parents: 30
diff changeset
   222
    
hgs
parents: 30
diff changeset
   223
    /**
40
hgs
parents: 37
diff changeset
   224
     * Text for a new album.
hgs
parents: 37
diff changeset
   225
     */
hgs
parents: 37
diff changeset
   226
    QString mNewAlbumText;
hgs
parents: 37
diff changeset
   227
    
hgs
parents: 37
diff changeset
   228
    /**
30
hgs
parents:
diff changeset
   229
     * header label
hgs
parents:
diff changeset
   230
     */
hgs
parents:
diff changeset
   231
    HbLabel *mHeading;
hgs
parents:
diff changeset
   232
    
hgs
parents:
diff changeset
   233
    /**
34
hgs
parents: 30
diff changeset
   234
     * container widget for itemcount and checkbox;
hgs
parents: 30
diff changeset
   235
     */
hgs
parents: 30
diff changeset
   236
    HbWidget *mCheckboxContainer;
hgs
parents: 30
diff changeset
   237
    
hgs
parents: 30
diff changeset
   238
    /**
30
hgs
parents:
diff changeset
   239
     * counter label from docml
hgs
parents:
diff changeset
   240
     */
hgs
parents:
diff changeset
   241
    HbLabel *mItemCount;
hgs
parents:
diff changeset
   242
    
hgs
parents:
diff changeset
   243
    /**
37
hgs
parents: 36
diff changeset
   244
     * checkbox label from docml
hgs
parents: 36
diff changeset
   245
     */
hgs
parents: 36
diff changeset
   246
    HbLabel *mCheckBoxText;
hgs
parents: 36
diff changeset
   247
    
hgs
parents: 36
diff changeset
   248
    /**
30
hgs
parents:
diff changeset
   249
     * mark all checkbox
hgs
parents:
diff changeset
   250
     */
hgs
parents:
diff changeset
   251
    HbCheckBox *mCheckBox;
hgs
parents:
diff changeset
   252
    
hgs
parents:
diff changeset
   253
    /**
hgs
parents:
diff changeset
   254
     * videolist container in dialog
hgs
parents:
diff changeset
   255
     */
hgs
parents:
diff changeset
   256
    HbStackedWidget *mListContainer;
hgs
parents:
diff changeset
   257
    
hgs
parents:
diff changeset
   258
    /**
hgs
parents:
diff changeset
   259
     * flag indicating that we've changed check-btn state 
hgs
parents:
diff changeset
   260
     * explicitly and don't wanna handle selection based on that 
hgs
parents:
diff changeset
   261
     */
34
hgs
parents: 30
diff changeset
   262
    bool mForcedCheck;  
30
hgs
parents:
diff changeset
   263
    
34
hgs
parents: 30
diff changeset
   264
    /**
hgs
parents: 30
diff changeset
   265
     * Video list model
hgs
parents: 30
diff changeset
   266
     */
hgs
parents: 30
diff changeset
   267
    VideoSortFilterProxyModel *mModel;
hgs
parents: 30
diff changeset
   268
    
hgs
parents: 30
diff changeset
   269
    /** 
hgs
parents: 30
diff changeset
   270
     * List widget to show in selection
36
hgs
parents: 35
diff changeset
   271
     */
34
hgs
parents: 30
diff changeset
   272
    VideoListWidget *mListWidget;
36
hgs
parents: 35
diff changeset
   273
    
hgs
parents: 35
diff changeset
   274
    /**
hgs
parents: 35
diff changeset
   275
     * Action to accept the selection dialog. 
hgs
parents: 35
diff changeset
   276
     */
hgs
parents: 35
diff changeset
   277
    HbAction *mPrimaryAction;
hgs
parents: 35
diff changeset
   278
    
hgs
parents: 35
diff changeset
   279
    /**
hgs
parents: 35
diff changeset
   280
     * Action to cancel the selection dialog.
hgs
parents: 35
diff changeset
   281
     */
hgs
parents: 35
diff changeset
   282
    HbAction *mSecondaryAction;
30
hgs
parents:
diff changeset
   283
};
hgs
parents:
diff changeset
   284
hgs
parents:
diff changeset
   285
#endif  //VIDEOLISTSELECTIONDIALOG_H