videocollection/videocollectionview/inc/videohintwidget.h
author hgs
Thu, 08 Jul 2010 13:05:19 +0300
changeset 44 518105d52e45
parent 41 229f037ce963
permissions -rw-r--r--
201027
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 hint widget
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
hgs
parents:
diff changeset
    19
#ifndef VIDEOHINTWIDGET_H
hgs
parents:
diff changeset
    20
#define VIDEOHINTWIDGET_H
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
#include <hbwidget.h>
34
hgs
parents: 30
diff changeset
    23
#include <hbicon.h>
30
hgs
parents:
diff changeset
    24
hgs
parents:
diff changeset
    25
class HbPushButton;
hgs
parents:
diff changeset
    26
class HbLabel;
hgs
parents:
diff changeset
    27
class VideoCollectionUiLoader;
hgs
parents:
diff changeset
    28
class QGraphicsItem;
hgs
parents:
diff changeset
    29
hgs
parents:
diff changeset
    30
/**
hgs
parents:
diff changeset
    31
 * Widget for displaying no videos text and possible hint and button for user
hgs
parents:
diff changeset
    32
 * find where to download new videos.
hgs
parents:
diff changeset
    33
 */
hgs
parents:
diff changeset
    34
class VideoHintWidget : public HbWidget
hgs
parents:
diff changeset
    35
{
hgs
parents:
diff changeset
    36
    Q_OBJECT
hgs
parents:
diff changeset
    37
hgs
parents:
diff changeset
    38
public:
hgs
parents:
diff changeset
    39
    
hgs
parents:
diff changeset
    40
    enum HintLevel {
hgs
parents:
diff changeset
    41
        AllVideos,
hgs
parents:
diff changeset
    42
        Collection
hgs
parents:
diff changeset
    43
    };
hgs
parents:
diff changeset
    44
hgs
parents:
diff changeset
    45
    /**
hgs
parents:
diff changeset
    46
     * Contructor.
hgs
parents:
diff changeset
    47
     *
hgs
parents:
diff changeset
    48
     * @param parent parent of this widget
hgs
parents:
diff changeset
    49
     */
hgs
parents:
diff changeset
    50
    VideoHintWidget(VideoCollectionUiLoader *uiLoader, QGraphicsItem *parent = 0);
hgs
parents:
diff changeset
    51
hgs
parents:
diff changeset
    52
    /**
hgs
parents:
diff changeset
    53
     * Destructor.
hgs
parents:
diff changeset
    54
     *
hgs
parents:
diff changeset
    55
     */
hgs
parents:
diff changeset
    56
    ~VideoHintWidget();
hgs
parents:
diff changeset
    57
    
hgs
parents:
diff changeset
    58
    /**
hgs
parents:
diff changeset
    59
     * Method creates colleciton wrapper, grid and list views,
hgs
parents:
diff changeset
    60
     * layout and activates correct view based on the current orientation
hgs
parents:
diff changeset
    61
     *
hgs
parents:
diff changeset
    62
     */
44
hgs
parents: 41
diff changeset
    63
    void initialize();
30
hgs
parents:
diff changeset
    64
    
hgs
parents:
diff changeset
    65
    /**
hgs
parents:
diff changeset
    66
     * Sets the level where the hint is correctly. Hint displays differently in
hgs
parents:
diff changeset
    67
     * for example collection level, than in allVideos level.
hgs
parents:
diff changeset
    68
     * 
hgs
parents:
diff changeset
    69
     * @param level The current level.
hgs
parents:
diff changeset
    70
     */
hgs
parents:
diff changeset
    71
    void setLevel(HintLevel level);
hgs
parents:
diff changeset
    72
    
hgs
parents:
diff changeset
    73
    /**
34
hgs
parents: 30
diff changeset
    74
     * Adjusts if the button is shown in landscape.
hgs
parents: 30
diff changeset
    75
     */
hgs
parents: 30
diff changeset
    76
    void setButtonShown(bool shown);
hgs
parents: 30
diff changeset
    77
    
hgs
parents: 30
diff changeset
    78
    /**
hgs
parents: 30
diff changeset
    79
     * Method enables and displays this widget.
30
hgs
parents:
diff changeset
    80
     */
34
hgs
parents: 30
diff changeset
    81
    void activate();
hgs
parents: 30
diff changeset
    82
hgs
parents: 30
diff changeset
    83
    /**
hgs
parents: 30
diff changeset
    84
     * Method disables and hides this widget.
hgs
parents: 30
diff changeset
    85
     */
hgs
parents: 30
diff changeset
    86
    void deactivate();
30
hgs
parents:
diff changeset
    87
    
hgs
parents:
diff changeset
    88
private slots:
hgs
parents:
diff changeset
    89
    
hgs
parents:
diff changeset
    90
    /**
hgs
parents:
diff changeset
    91
     * Method activates correct view based on the given orientation.
hgs
parents:
diff changeset
    92
     */
hgs
parents:
diff changeset
    93
    void orientationChangedSlot(Qt::Orientation orientation);
hgs
parents:
diff changeset
    94
    
hgs
parents:
diff changeset
    95
private:
hgs
parents:
diff changeset
    96
    
hgs
parents:
diff changeset
    97
    /**
hgs
parents:
diff changeset
    98
     * Shows/hides the correct UI components for current state.
hgs
parents:
diff changeset
    99
     */
hgs
parents:
diff changeset
   100
    void updateUiComponents();
hgs
parents:
diff changeset
   101
hgs
parents:
diff changeset
   102
private:
hgs
parents:
diff changeset
   103
    
hgs
parents:
diff changeset
   104
    Q_DISABLE_COPY(VideoHintWidget)
hgs
parents:
diff changeset
   105
    
hgs
parents:
diff changeset
   106
    /**
hgs
parents:
diff changeset
   107
     * Pointer to the XML UI (DocML) loader, not owned
hgs
parents:
diff changeset
   108
     */
hgs
parents:
diff changeset
   109
    VideoCollectionUiLoader     *mUiLoader;
41
hgs
parents: 34
diff changeset
   110
34
hgs
parents: 30
diff changeset
   111
    /**
30
hgs
parents:
diff changeset
   112
     * Current hint level.
hgs
parents:
diff changeset
   113
     */
hgs
parents:
diff changeset
   114
    HintLevel mCurrentLevel;
34
hgs
parents: 30
diff changeset
   115
    
hgs
parents: 30
diff changeset
   116
    /**
hgs
parents: 30
diff changeset
   117
     * If button is shown in landscape at all.
hgs
parents: 30
diff changeset
   118
     */
hgs
parents: 30
diff changeset
   119
    bool mButtonShown;
hgs
parents: 30
diff changeset
   120
    
hgs
parents: 30
diff changeset
   121
    /**
hgs
parents: 30
diff changeset
   122
     * true if widget has been activated.
hgs
parents: 30
diff changeset
   123
     */
hgs
parents: 30
diff changeset
   124
    bool mActivated;
44
hgs
parents: 41
diff changeset
   125
    
hgs
parents: 41
diff changeset
   126
    /**
hgs
parents: 41
diff changeset
   127
     * Localized text for the service button. 
hgs
parents: 41
diff changeset
   128
     */
hgs
parents: 41
diff changeset
   129
    QString mHintText;
30
hgs
parents:
diff changeset
   130
};
hgs
parents:
diff changeset
   131
hgs
parents:
diff changeset
   132
#endif // VIDEOHINTWIDGET_H