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: Positioning Indicators Info - QT Wrapper

    15 *

    16 */

    17 

    18 #ifndef POSITIONINDICATORINFO_H

    19 #define POSITIONINDICATORINFO_H

    20 

    21 #include <QObject.h>

    22 

    23 #include "posgeoaddress.h"

    24 #include "posindicatorglobal.h"

    25 

    26 class PosIndicatorInfoPrivate;

    27 

    28 class POSINDICATOR_EXPORT PosIndicatorInfo :  public QObject

    29     {    

    30     Q_OBJECT

    31     

    32 public :

    33     /*

    34      * Constructor

    35      */

    36      PosIndicatorInfo();

    37     

    38     /*

    39      * Destructor

    40      */

    41      ~PosIndicatorInfo();

    42     

    43     /**

    44      * Requests for positioning information from Positioning Indicator 

    45      * Helper Server.PosInfoUpdated() will be emitted when

    46      * position information is available.

    47      *                   

    48      */

    49      void requestPosInfo(); 

    50      

    51      /**

    52       * Cancels position info request.

    53       */

    54      void cancelPosInfo();

    55 	 

    56 private:

    57     signals:

    58     /*

    59      * Signal emitted when new position updates available

    60      * When coordinates are available, this object is 

    61      * populated with only Position attribute. 

    62      * When reverse geo-code address has been resolved, 

    63      * the only address fields will be populated.

    64      * 

    65      * @param[in] posGeoAddress - Object containing position information

    66      * @param[in] error - Any error code while retrieving position information

    67      *                  - KTimeOut - if time out during retrieval of position information

    68      */

    69     void posInfoUpdated(PosGeoAddress& posGeoAddress, int error);    

    70 

    71 private:    

    72     Q_DECLARE_PRIVATE_D(d_ptr, PosIndicatorInfo)   

    73     

    74 private:

    75     /**

    76      * Pointer to private implementation.

    77      * Owns

    78      */

    79     PosIndicatorInfoPrivate* d_ptr;

    80     };

    81 

    82 #endif /* POSITIONINDICATORINFO_H */