videocollection/videocollectionview/inc/videocollectionviewutils.h
author hgs
Thu, 24 Jun 2010 09:49:13 +0300
changeset 41 229f037ce963
parent 39 f6d44a0cd476
child 44 518105d52e45
permissions -rw-r--r--
201025
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: video collection view plugin's ui utils class
hgs
parents:
diff changeset
    15
* 
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#ifndef __VIDEOCOLLECTIONVIEWUTILS_H__
hgs
parents:
diff changeset
    19
#define __VIDEOCOLLECTIONVIEWUTILS_H__
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
#include <qobject.h>
36
hgs
parents: 34
diff changeset
    22
#include "videocollectioncommon.h"
30
hgs
parents:
diff changeset
    23
34
hgs
parents: 30
diff changeset
    24
class HbListView;
hgs
parents: 30
diff changeset
    25
class VideoSortFilterProxyModel;
hgs
parents: 30
diff changeset
    26
30
hgs
parents:
diff changeset
    27
class VideoCollectionViewUtils : public QObject
hgs
parents:
diff changeset
    28
{
hgs
parents:
diff changeset
    29
    Q_OBJECT
hgs
parents:
diff changeset
    30
    
hgs
parents:
diff changeset
    31
public:
hgs
parents:
diff changeset
    32
    /**
hgs
parents:
diff changeset
    33
     * Returns singleton instance for this class.
hgs
parents:
diff changeset
    34
     * 
hgs
parents:
diff changeset
    35
     * WARNING! Not safe to call this from destructor of another function scope static object!
hgs
parents:
diff changeset
    36
     * 
hgs
parents:
diff changeset
    37
     * @return The singleton instance.
hgs
parents:
diff changeset
    38
     */
hgs
parents:
diff changeset
    39
    static VideoCollectionViewUtils& instance();
hgs
parents:
diff changeset
    40
    
hgs
parents:
diff changeset
    41
    /**
hgs
parents:
diff changeset
    42
     * Saves the sorting role and order to cenrep.
hgs
parents:
diff changeset
    43
     * 
hgs
parents:
diff changeset
    44
     * @param role The sorting role.
hgs
parents:
diff changeset
    45
     * @param order The sorting order (e.g. ascending or descending).
hgs
parents:
diff changeset
    46
     * @return Zero if operation succeeded, less than zero in error cases.
hgs
parents:
diff changeset
    47
     */
36
hgs
parents: 34
diff changeset
    48
    int saveSortingValues(int role, Qt::SortOrder order, VideoCollectionCommon::TCollectionLevels target);
30
hgs
parents:
diff changeset
    49
    
hgs
parents:
diff changeset
    50
    /**
hgs
parents:
diff changeset
    51
     * Loads the sorting role and order from cenrep.
hgs
parents:
diff changeset
    52
     * 
hgs
parents:
diff changeset
    53
     * @param role On return contains the sorting role.
hgs
parents:
diff changeset
    54
     * @param order On return contains the sorting order
hgs
parents:
diff changeset
    55
     * @return Zero if operation succeeded, less than zero in error cases.
hgs
parents:
diff changeset
    56
     */
36
hgs
parents: 34
diff changeset
    57
    int loadSortingValues(int& role, Qt::SortOrder& order, VideoCollectionCommon::TCollectionLevels target);
30
hgs
parents:
diff changeset
    58
    
hgs
parents:
diff changeset
    59
    /**
hgs
parents:
diff changeset
    60
     * Get service icon resource strings from cenrep.
hgs
parents:
diff changeset
    61
     * 
hgs
parents:
diff changeset
    62
     * @param icon On return contains the resource string for icon image.
hgs
parents:
diff changeset
    63
     * @param iconPressed On return contains the resource string for pressed icon image.
hgs
parents:
diff changeset
    64
     * @return Zero if operation succeeded, less than zero in error cases. 
hgs
parents:
diff changeset
    65
     */
hgs
parents:
diff changeset
    66
    int getServiceIconStrings(QString& icon, QString& iconPressed);
hgs
parents:
diff changeset
    67
    
hgs
parents:
diff changeset
    68
    /**
hgs
parents:
diff changeset
    69
     * Get service URI string.
hgs
parents:
diff changeset
    70
     * 
hgs
parents:
diff changeset
    71
     * @return Service URI string. Invalid string in error cases.
hgs
parents:
diff changeset
    72
     */
hgs
parents:
diff changeset
    73
    QString getServiceUriString();
34
hgs
parents: 30
diff changeset
    74
    
hgs
parents: 30
diff changeset
    75
public:
hgs
parents: 30
diff changeset
    76
    /**
hgs
parents: 30
diff changeset
    77
     * Initializes list view for collection and selection dialog with common
hgs
parents: 30
diff changeset
    78
     * properties.
hgs
parents: 30
diff changeset
    79
     */
hgs
parents: 30
diff changeset
    80
    static void initListView(HbListView *view);
hgs
parents: 30
diff changeset
    81
    
hgs
parents: 30
diff changeset
    82
    /**
hgs
parents: 30
diff changeset
    83
     * Initilizes model sort values.
hgs
parents: 30
diff changeset
    84
     */
36
hgs
parents: 34
diff changeset
    85
    static void sortModel(VideoSortFilterProxyModel *model, bool async, VideoCollectionCommon::TCollectionLevels target);
39
hgs
parents: 36
diff changeset
    86
    
hgs
parents: 36
diff changeset
    87
    /**
41
hgs
parents: 39
diff changeset
    88
     * Method saves the latest videolist widget level into local activity manager 
hgs
parents: 39
diff changeset
    89
     * data container.
hgs
parents: 39
diff changeset
    90
     * 
hgs
parents: 39
diff changeset
    91
     * Note that collection id will be cleared in activity data in case level is
hgs
parents: 39
diff changeset
    92
     * all videos or collection list. 
39
hgs
parents: 36
diff changeset
    93
     * 
41
hgs
parents: 39
diff changeset
    94
     * @param level collection level
39
hgs
parents: 36
diff changeset
    95
     */
41
hgs
parents: 39
diff changeset
    96
    static void setWidgetActivityLevel(const VideoCollectionCommon::TCollectionLevels &level);
hgs
parents: 39
diff changeset
    97
   
hgs
parents: 39
diff changeset
    98
    /**
hgs
parents: 39
diff changeset
    99
     * Method gets the latest videolist widget level from local activity manager 
hgs
parents: 39
diff changeset
   100
     * data container.
hgs
parents: 39
diff changeset
   101
     * 
hgs
parents: 39
diff changeset
   102
     * @param level, reference to level variable where value is saved
hgs
parents: 39
diff changeset
   103
     */
hgs
parents: 39
diff changeset
   104
    static void getActivityWidgetLevel(VideoCollectionCommon::TCollectionLevels &level);
39
hgs
parents: 36
diff changeset
   105
    
hgs
parents: 36
diff changeset
   106
    /**
41
hgs
parents: 39
diff changeset
   107
     * method saves provided id and string into local activity
hgs
parents: 39
diff changeset
   108
     * manager data container.
39
hgs
parents: 36
diff changeset
   109
     * 
41
hgs
parents: 39
diff changeset
   110
     * @param id. Id to save
39
hgs
parents: 36
diff changeset
   111
     */
41
hgs
parents: 39
diff changeset
   112
    static void setCollectionActivityData(const TMPXItemId &id, const QString &name);
hgs
parents: 39
diff changeset
   113
    
hgs
parents: 39
diff changeset
   114
    /**
hgs
parents: 39
diff changeset
   115
     * method reads id and string from from local activity manager data 
hgs
parents: 39
diff changeset
   116
     * container and prepares MPX item id.
hgs
parents: 39
diff changeset
   117
     * 
hgs
parents: 39
diff changeset
   118
     * @param id. Id to return
hgs
parents: 39
diff changeset
   119
     */
hgs
parents: 39
diff changeset
   120
    static void getCollectionActivityData(TMPXItemId &id, QString &name);
34
hgs
parents: 30
diff changeset
   121
30
hgs
parents:
diff changeset
   122
public slots:
hgs
parents:
diff changeset
   123
    
hgs
parents:
diff changeset
   124
    /**
hgs
parents:
diff changeset
   125
     * Shows status msgs
hgs
parents:
diff changeset
   126
     *
hgs
parents:
diff changeset
   127
     * @param statusCode status code
hgs
parents:
diff changeset
   128
     * @param additional additional data gotten from the status 
hgs
parents:
diff changeset
   129
     */
hgs
parents:
diff changeset
   130
    void showStatusMsgSlot(int statusCode, QVariant &additional);
hgs
parents:
diff changeset
   131
   
hgs
parents:
diff changeset
   132
private:
hgs
parents:
diff changeset
   133
    
hgs
parents:
diff changeset
   134
    /**
hgs
parents:
diff changeset
   135
     * disables copy-constructor and assingment operator
hgs
parents:
diff changeset
   136
     */
hgs
parents:
diff changeset
   137
    Q_DISABLE_COPY(VideoCollectionViewUtils)
hgs
parents:
diff changeset
   138
    
hgs
parents:
diff changeset
   139
    /**
hgs
parents:
diff changeset
   140
     * constructor
hgs
parents:
diff changeset
   141
     */
hgs
parents:
diff changeset
   142
    VideoCollectionViewUtils();
hgs
parents:
diff changeset
   143
     
hgs
parents:
diff changeset
   144
    /**
hgs
parents:
diff changeset
   145
     * destructor
hgs
parents:
diff changeset
   146
     */
hgs
parents:
diff changeset
   147
    virtual ~VideoCollectionViewUtils();
hgs
parents:
diff changeset
   148
34
hgs
parents: 30
diff changeset
   149
private:
hgs
parents: 30
diff changeset
   150
    /** current sorting role */
36
hgs
parents: 34
diff changeset
   151
    int mVideosSortRole;
hgs
parents: 34
diff changeset
   152
    int mCollectionsSortRole;
30
hgs
parents:
diff changeset
   153
    
34
hgs
parents: 30
diff changeset
   154
    /** current sorting order */
36
hgs
parents: 34
diff changeset
   155
    Qt::SortOrder mVideosSortOrder;
hgs
parents: 34
diff changeset
   156
    Qt::SortOrder mCollectionsSortOrder;
30
hgs
parents:
diff changeset
   157
};
hgs
parents:
diff changeset
   158
hgs
parents:
diff changeset
   159
#endif //__VIDEOCOLLECTIONUIUTILS_H__
hgs
parents:
diff changeset
   160