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

     2 **

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

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (developer.feedback@nokia.com)

     6 **

     7 ** This file is part of the HbCore module of the UI Extensions for Mobile.

     8 **

     9 ** GNU Lesser General Public License Usage

    10 ** This file may be used under the terms of the GNU Lesser General Public

    11 ** License version 2.1 as published by the Free Software Foundation and

    12 ** appearing in the file LICENSE.LGPL included in the packaging of this file.

    13 ** Please review the following information to ensure the GNU Lesser General

    14 ** Public License version 2.1 requirements will be met:

    15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

    16 **

    17 ** In addition, as a special exception, Nokia gives you certain additional

    18 ** rights.  These rights are described in the Nokia Qt LGPL Exception

    19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

    20 **

    21 ** If you have questions regarding the use of this file, please contact

    22 ** Nokia at developer.feedback@nokia.com.

    23 **

    24 ****************************************************************************/

    25 #ifndef HBDEVICEDIALOG_H

    26 #define HBDEVICEDIALOG_H

    27 

    28 #include <hbglobal.h>

    29 

    30 #include <QObject>

    31 #include <QVariant>

    32 #include <QtGlobal>

    33 #include <QMap>

    34 #include <QEventLoop>

    35 #include <QFlags>

    36 

    37 class HbDeviceDialogPrivate;

    38 

    39 class HB_CORE_EXPORT HbDeviceDialog : public QObject

    40 {

    41     Q_OBJECT

    42 

    43 public:

    44 

    45     enum DeviceDialogError{

    46         FrameworkErrors = 0x00000000,

    47         PluginErrors = 0x10000000,

    48         ErrorTypeMask = 0xf0000000,

    49         CancelledError = 0x0fffffff,

    50         SystemCancelledError = 0x0ffffffe

    51     };

    52 

    53     enum DeviceDialogFlag{

    54         NoFlags = 0,

    55         ImmediateResourceReservationFlag = 1

    56     };

    57     Q_DECLARE_FLAGS(DeviceDialogFlags, DeviceDialogFlag)

    58 

    59     explicit HbDeviceDialog(DeviceDialogFlags f = NoFlags, QObject *parent = 0);

    60     ~HbDeviceDialog();

    61 

    62     bool show(const QString &deviceDialogType, const QVariantMap &parameters);

    63     bool update(const QVariantMap &parameters);

    64     bool waitForClosed(QEventLoop::ProcessEventsFlag flags = QEventLoop::AllEvents);

    65     QVariantMap receivedData() const;

    66     int error() const;

    67     bool cancel();

    68 

    69 signals:

    70     void dataReceived(QVariantMap data);

    71     void deviceDialogClosed();

    72     void error(int error);

    73 

    74 protected:

    75     HbDeviceDialog(HbDeviceDialogPrivate &dd, DeviceDialogFlags f = NoFlags,

    76         QObject *parent = 0);

    77     HbDeviceDialogPrivate *d_ptr;

    78 

    79 private:

    80     Q_DECLARE_PRIVATE_D(d_ptr, HbDeviceDialog)

    81     Q_DISABLE_COPY(HbDeviceDialog)

    82 };

    83 

    84 #endif // HBDEVICEDIALOG_H