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