1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (qt-info@nokia.com)

     6 **

     7 ** This file is part of the Qt Mobility Components.

     8 **

     9 ** $QT_BEGIN_LICENSE:BSD$

    10 ** You may use this file under the terms of the BSD license as follows:

    11 **

    12 ** "Redistribution and use in source and binary forms, with or without

    13 ** modification, are permitted provided that the following conditions are

    14 ** met:

    15 **   * Redistributions of source code must retain the above copyright

    16 **     notice, this list of conditions and the following disclaimer.

    17 **   * Redistributions in binary form must reproduce the above copyright

    18 **     notice, this list of conditions and the following disclaimer in

    19 **     the documentation and/or other materials provided with the

    20 **     distribution.

    21 **   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor

    22 **     the names of its contributors may be used to endorse or promote

    23 **     products derived from this software without specific prior written

    24 **     permission.

    25 **

    26 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

    27 ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

    28 ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

    29 ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

    30 ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

    31 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

    32 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

    33 ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

    34 ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

    35 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

    36 ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."

    37 ** $QT_END_LICENSE$

    38 **

    39 ****************************************************************************/

    40 

    41 #ifndef QGEOSATELLITEDIALOG_H

    42 #define QGEOSATELLITEDIALOG_H

    43 

    44 #include <QObject>

    45 #include <QDialog>

    46 

    47 #include <qmobilityglobal.h>

    48 

    49 QTM_BEGIN_NAMESPACE

    50 class QGeoPositionInfoSource;

    51 class QGeoPositionInfo;

    52 class QGeoSatelliteInfoSource;

    53 class QGeoSatelliteInfo;

    54 QTM_END_NAMESPACE

    55 

    56 class SatelliteWidget;

    57 

    58 QT_BEGIN_NAMESPACE

    59 class QPushButton;

    60 class QTimer;

    61 QT_END_NAMESPACE

    62 

    63 QTM_USE_NAMESPACE

    64 

    65 class SatelliteDialog : public QDialog

    66 {

    67     Q_OBJECT

    68 

    69 public:

    70     enum ExitBehaviour {

    71         ExitOnFixOrCancel,

    72         ExitOnCancel

    73     };

    74 

    75     enum Ordering {

    76         OrderBySignalStrength,

    77         OrderByPrnNumber

    78     };

    79 

    80     enum StrengthScaling {

    81         ScaleToMaxAvailable,

    82         ScaleToMaxPossible

    83     };

    84 

    85     SatelliteDialog(QWidget *parent = 0,

    86                     int noSatelliteTimeoutSeconds = 30,

    87                     ExitBehaviour exitBehaviour = ExitOnFixOrCancel,

    88                     Ordering ordering = OrderBySignalStrength,

    89                     StrengthScaling scaling = ScaleToMaxPossible);

    90 

    91     void connectSources(QGeoPositionInfoSource *posSource, QGeoSatelliteInfoSource *satSource);

    92 

    93     ExitBehaviour exitBehaviour() const;

    94     void setExitBehaviour(ExitBehaviour exitBehaviour);

    95 

    96     Ordering ordering() const;

    97     void setOrdering(Ordering ordering);

    98 

    99     StrengthScaling strengthScaling() const;

   100     void setStrengthScaling(StrengthScaling scaling);

   101 

   102 private slots:

   103     void positionUpdated(const QGeoPositionInfo &pos);

   104 

   105     void satellitesInViewUpdated(const QList<QGeoSatelliteInfo> &list);

   106     void satellitesInUseUpdated(const QList<QGeoSatelliteInfo> &list);

   107 

   108     void switchButtonClicked();

   109     void noSatelliteTimeout();

   110 /*#if defined(Q_OS_SYMBIAN)

   111     // workaround for QTBUG-4771

   112     void restoreWindowTitle();

   113 #endif*/

   114 

   115 private:

   116     int m_noSatelliteTimeoutSeconds;

   117     ExitBehaviour m_exitBehaviour;

   118     Ordering m_ordering;

   119     StrengthScaling m_scaling;

   120 

   121     QTimer *noSatelliteTimer;

   122 

   123     SatelliteWidget *satelliteWidget;

   124     QPushButton *switchButton;

   125     QPushButton *cancelButton;

   126 /*#if defined(Q_OS_SYMBIAN)

   127     // workaround for QTBUG-4771

   128     QString oldTitle;

   129 #endif*/

   130 };

   131 

   132 #endif // #ifndef QGEOSATELLITEDIALOG_H