1 /*

     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:

    15 *

    16 */

    17 

    18 #ifndef RADIOCAROUSELITEM_H

    19 #define RADIOCAROUSELITEM_H

    20 

    21 // System includes

    22 #include <HbWidget>

    23 #include <QScopedPointer>

    24 

    25 // User includes

    26 

    27 // Forward declarations

    28 class RadioStation;

    29 class HbIconItem;

    30 class HbTextItem;

    31 class HbRichTextItem;

    32 class HbTouchArea;

    33 class RadioCarouselItemObserver;

    34 

    35 // Class declaration

    36 class RadioCarouselItem : public HbWidget

    37 {

    38     Q_OBJECT

    39     Q_PROPERTY(Appearance appearance READ appearance WRITE setAppearance)

    40     Q_ENUMS(Appearance)

    41 

    42     friend class RadioStationCarousel;

    43 

    44 public:

    45 

    46     enum ItemFlag

    47     {

    48         NameVisible         = 1 << 0,

    49         FavoriteVisible     = 1 << 1,

    50         FavoriteTouchable   = 1 << 2,

    51         GenreVisible        = 1 << 3,

    52         RadiotextVisible    = 1 << 4,

    53         RadiotextTouchable  = 1 << 5,

    54         UrlVisible          = 1 << 6,

    55         UrlTouchable        = 1 << 7,

    56 

    57         LastFlagMarker      = 1 << 8,       // Keep this as the last flag

    58 

    59         DefaultFlags = NameVisible | FavoriteVisible | FavoriteTouchable | GenreVisible | RadiotextVisible,

    60         ManualSeekFlags = NameVisible

    61     };

    62     Q_DECLARE_FLAGS( CarouselItemFlags, ItemFlag )

    63 

    64     enum Appearance { Default, Full, ManualSeek };

    65 

    66     RadioCarouselItem( RadioCarouselItemObserver& observer, QGraphicsItem* parent, bool registerCss = false );

    67     ~RadioCarouselItem();

    68 

    69 // New functions

    70 

    71     void setAppearance( Appearance appearance );

    72     Appearance appearance() const;

    73 

    74     void setSeekLayout( bool seekLayout );

    75 

    76     void setStation( const RadioStation& station );

    77 

    78     uint frequency() const;

    79     void update( const RadioStation* station = NULL );

    80     void setFrequency( uint frequency );

    81     void cleanRdsData();

    82     void setRadioText( const QString& text );

    83 

    84     enum ItemVisibility{ AllVisible, AllHidden, IconVisible };

    85     void setItemVisibility( ItemVisibility visibility );

    86 

    87     void setIconOpacity( qreal opacity );

    88 

    89     void createPrimitives();

    90 

    91     void drawOffScreen( QPainter& painter );

    92 

    93 public slots:

    94 

    95     void updatePrimitives();

    96 

    97 private:

    98 

    99     void gestureEvent( QGestureEvent* event );

   100 

   101     void setFlags( CarouselItemFlags flags );

   102     void clearFlags( CarouselItemFlags flags );

   103 

   104     void updateVisibilities();

   105 

   106     void updateFavoriteIcon( bool isFavorite );

   107 

   108     void updateLayout();

   109 

   110 private: // data

   111 

   112     RadioCarouselItemObserver&          mObserver;

   113 

   114     QScopedPointer<RadioStation>        mStation;

   115 

   116     HbIconItem*                         mFavoriteItem;

   117     HbTextItem*                         mGenreItem;

   118     HbTouchArea*                        mFavoriteTouchArea;

   119     HbTextItem*                         mNameItem;

   120     HbRichTextItem*                     mRadiotextItem;

   121     HbTextItem*                         mUrlItem;

   122 

   123     Appearance                          mAppearance;

   124     bool                                mOwnsCss;

   125     CarouselItemFlags                   mFlags;

   126 

   127 };

   128 

   129 Q_DECLARE_OPERATORS_FOR_FLAGS( RadioCarouselItem::CarouselItemFlags )

   130 

   131 #endif // RADIOCAROUSELITEM_H