1 /*

     2 * Copyright (c) 2010 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:  Example of home screen widget

    15 *

    16 */

    17 

    18 #include <QDebug>

    19 #include <QGraphicsLinearLayout>

    20 #include <QGraphicsWebView>

    21 #include <HbPushButton>

    22 #include <HbLineEdit>

    23 #include <HbFrameDrawer>

    24 #include <HbFrameItem>

    25 #include <HbDeviceProfile>

    26 #include "minibrowserwidget.h"

    27 

    28 /*!

    29     \ingroup group_minibrowser_widget

    30     \class MiniBrowserWidget

    31     \brief Example implementation for home screen widget.

    32 

    33     MiniBrowserWidget derived from the HbWidget and implements 

    34     needed functions for the home screen widget. 

    35     As name suggests MiniBrowserWidget is a small web browser widget in

    36     the home screen. 

    37     

    38     Mini browser widget demonstrates the following home screen widget features:

    39     <ol>

    40     <li> home screen online/offline state, see \ref sssection_isonline </li>

    41     <li> preferences, see \ref sssection_setpreferences </li>

    42     </ol>

    43     It also shows use of HbPushButton and HbLineEdit widgets. 

    44     @image html hs_minibrowser.png

    45     

    46     

    47 */

    48 

    49 /*!

    50     Constructs a widget which is a child of \a parent, with widget flags set to \a flags.

    51     Widget creates two buttons ('go' and 'stop'), text field to write url and browser view.

    52     Note that this is just an simple example so this creates child widgets directly to the layout.

    53     For more complicated widget layouting, see Orbit documentation and especially WidgetML section of it.

    54 */

    55 MiniBrowserWidget::MiniBrowserWidget(QGraphicsItem* parent, Qt::WindowFlags flags)

    56     : HbWidget(parent, flags)

    57 {

    58     QGraphicsLinearLayout *layout = new QGraphicsLinearLayout(Qt::Vertical);

    59     setLayout(layout);

    60     

    61     QGraphicsLinearLayout *buttonLayout = new QGraphicsLinearLayout(Qt::Horizontal);

    62     mGoButton = new HbPushButton("Go");

    63     connect(mGoButton, SIGNAL(pressed()), SLOT(pressGoButton()));

    64     buttonLayout->addItem(mGoButton);

    65     mStopButton = new HbPushButton("Stop");

    66     connect(mStopButton, SIGNAL(pressed()), SLOT(pressStopButton()));

    67     buttonLayout->addItem(mStopButton);

    68     mStopButton->setEnabled(false);

    69     mEditor = new HbLineEdit();

    70     buttonLayout->addItem(mEditor);

    71     

    72     layout->addItem(buttonLayout);

    73 

    74     mWeb = new QGraphicsWebView();

    75     layout->addItem(mWeb);

    76     

    77     connect(mWeb, SIGNAL(loadStarted()), SLOT(loadStarted()));

    78     connect(mWeb, SIGNAL(loadProgress(int)), SLOT(loadProgress(int)));

    79     connect(mWeb, SIGNAL(loadFinished(bool)), SLOT(loadFinished(bool)));

    80 

    81     // maximum size of the home screen widget is (48,39) units. Convert units to pixels and 

    82     // resize minibrowser as maximum size

    83     HbFrameDrawer *drawer = new HbFrameDrawer(

    84         QLatin1String("qtg_fr_hsshortcut_normal"), HbFrameDrawer::NinePieces);

    85     setBackgroundItem(new HbFrameItem(drawer));

    86     

    87     HbDeviceProfile profile;

    88     qreal factor = profile.unitValue();

    89     setPreferredSize(48*factor, 39*factor);

    90     resize(preferredSize());

    91     

    92     mUrl = QString("http://www.nokia.com");

    93 }

    94 

    95 /*!

    96     Destructor

    97 */

    98 MiniBrowserWidget::~MiniBrowserWidget()

    99 {

   100 }

   101 

   102 /*!

   103     Returns widget's online state

   104 */

   105 // Start of snippet 1

   106 bool MiniBrowserWidget::isOnline()

   107 { 

   108     return mOnline;

   109 }

   110 

   111 /*!

   112     Sets online state of the widget as \a online

   113 */

   114 void MiniBrowserWidget::setOnline(bool online)

   115 { 

   116     mOnline = online;

   117 }

   118 // End of snippet 1

   119 

   120 /*!

   121     Returns url of the widget currently showing.

   122 */

   123 // Start of snippet 2

   124 QString MiniBrowserWidget::url() const

   125 {

   126     return mUrl;

   127 }

   128 

   129 /*!

   130     Sets url of the widget as \a url

   131 */

   132 void MiniBrowserWidget::setUrl(const QString& url)

   133 {

   134     mUrl = url;

   135 }

   136 // End of snippet 2

   137 

   138 /*!

   139     Called when widget is initialized and all to properties are set

   140 */

   141 void MiniBrowserWidget::onInitialize()

   142 {

   143     mGoButton->setEnabled(mOnline);

   144     mEditor->setText(mUrl);

   145 }

   146 

   147 /*!

   148     Called when widget is shown in the home screen

   149 */

   150 // Start of snippet 3

   151 void MiniBrowserWidget::onShow()

   152 {

   153     if (mOnline) {

   154         mWeb->load(QUrl(mUrl));

   155         mStopButton->setEnabled(true);

   156         }

   157 }

   158 // End of snippet 3

   159 

   160 /*!

   161     Called when widget is hidden from the home screen.

   162     Widget can decide what is appropriate action when 

   163     widget is not visible on the screen. At least it

   164     should not update itself as often as when on the 

   165     screen to save battery etc.

   166 */

   167 // Start of snippet 4

   168 void MiniBrowserWidget::onHide()

   169 {

   170     mWeb->stop();

   171 }

   172 // End of snippet 4

   173 

   174 /*!

   175     Slot connected to 'go' button

   176 */

   177 // Start of snippet 5

   178 void MiniBrowserWidget::pressGoButton()

   179 {

   180     setUrl(mEditor->text());

   181     if (mOnline) {

   182         mWeb->load(QUrl(mUrl));

   183         mStopButton->setEnabled(true);

   184         }

   185     QStringList list;

   186     list.append("url");

   187     emit setPreferences(list);

   188 }

   189 // End of snippet 5

   190 

   191 /*!

   192     Slot connected to 'stop' button

   193 */

   194 void MiniBrowserWidget::pressStopButton()

   195 {

   196     mWeb->stop();

   197     //mStopButton->setEnabled(false);

   198 }

   199 

   200 /*!

   201     Slot connected to webview's loadProgress signal

   202     TODO: check if this is needed.

   203 */

   204 void MiniBrowserWidget::loadProgress(int progress)

   205 {

   206     Q_UNUSED(progress)

   207     qDebug() << progress;

   208 }

   209 

   210 /*!

   211     Slot connected to webview's loadFinished signal

   212 */

   213 void MiniBrowserWidget::loadFinished(bool ok)

   214 {

   215     Q_UNUSED(ok)

   216     mStopButton->setEnabled(false);

   217 }

   218 void MiniBrowserWidget::loadStarted()

   219 {

   220 }

   221