1 /*

     2 * Copyright (c) 2006 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:  The set of messages provided to Secondary Display software by

    15 *                Location Verifier dialogs.

    16 *

    17 */

    18 

    19 #ifndef LOCVERIFIERCOVERUI_H_

    20 #define LOCVERIFIERCOVERUI_H_

    21 

    22 // System Includes

    23 #include <e32base.h>

    24 

    25 // The category UID for the commands in this header file.

    26 // UID of the Location Verifier dialogs Dll ( locverifierdlg.dll )

    27 //

    28 const TUid KCatUidLocationVerifierDlgs = { 0x101f84fc };

    29 

    30 

    31 // Dialogs shown by Location System UI / Verifer dialogs. These commands are 

    32 // handled using the Secondary Display support in Avkon.

    33 // Verification dialogs seek a response from the user about the decision that

    34 // has to be taken about accepting or rejecting a Location request. 

    35 // Notification dialogs provides a notification to the user about a particular

    36 // action taken to a Location request.

    37 // All the below mentioned command are expected to display a List Query dialog.

    38 // The requestor strings for filling up the List query dialog would be supplied 

    39 // as a packaged buffer. The buffer is packed according to the below mentioned

    40 // format.

    41 // 

    42 // | Count | Length(1) | String(1) | Length(2) | String(2) | ..... | Length( Count ) | String( Count ) |

    43 // 

    44 // where,

    45 // Count   - ( 4 bytes ) - The number of requestor strings. 

    46 // Length(n) - ( 4 bytes ) - Length of the UNICODE ( UCS -2) encoded nth requestor string.

    47 // String(n) - ( Length(n) * 2 bytes ) - String for the nth requestor. String encoded in 

    48 // UNICODE ( UCS-2 )  format. Hence, each character takes 2 bytes. Hence, over all length of the

    49 // string in bytes is 2 * Length(n).

    50 // 

    51 // Each entry is packed one after another without any delimters between them

    52 //

    53 //

    54 enum TLocVerifierDlgCoverUiCmds

    55     {

    56     /**

    57      * Command ID for Location verification request when the network default policy for the 

    58      * request is accept

    59      * Request Type : Verification Request

    60      * Dialog Type : List Query Dialog

    61      * Hint String : "By default the network will accept this request on your behalf. Requesters:"

    62      */    	

    63     ECmdDefaultAccept 			= 1,

    64     

    65     /**

    66      * Command ID for Location verification request when the network default policy for 

    67      * the request is reject

    68      * Request Type : Verification Request

    69      * Dialog Type : List Query Dialog     

    70      * Hint String : "By default the network will reject this request on your behalf. Requesters:"

    71      */     

    72     ECmdDefaultReject 		  = 2,

    73     

    74     /**

    75      * Command ID for Location verification request when the network default policy for 

    76      * the request is not specified

    77      * Request Type : Verification Request

    78      * Dialog Type : List Query Dialog      

    79      * Hint String : "Your location was requested by:"

    80      */     

    81     ECmdDefaultNone   		  = 3,

    82     

    83     /**

    84      * Command ID for Location notification

    85      * Request Type : Notification Request

    86      * Dialog Type : List Query Dialog      

    87      * Hint String : "The network sent your location to:"

    88      */     

    89     ECmdNotifyAccept			  = 4,

    90     

    91     /**

    92      * Command ID for Location notification when network made "accept" decision due to timeout

    93      * Request Type : Notification Request

    94      * Dialog Type : List Query Dialog           

    95      * Hint String : "The network accepted this request on your behalf. Your location was sent to:"

    96      */     

    97     ECmdNotifyAcceptTimeout = 5,

    98     

    99     /**

   100      *Command ID for Location notification when network made "reject" decision due to timeout

   101      * Request Type : Notification Request

   102      * Dialog Type : List Query Dialog           

   103      * Hint String : "The network rejected this request on your behalf. Your location was not sent to:"

   104      */     

   105     ECmdNotifyRejectTimeout = 6,

   106     

   107     /**

   108      * Command ID for Location notification when request was rejected due to a conflict despite of user's "accept" decision.

   109      * Request Type : Notification Request

   110      * Dialog Type : List Query Dialog           

   111      * Hint String : "Unable to accept the request"

   112      */     

   113     ECmdNotifyAcceptFailure = 7,

   114     

   115     /**

   116      * Command ID for Location notification when request was accepted due to a conflict despite of user's "reject" decision.

   117      * Request Type : Notification Request

   118      * Dialog Type : List Query Dialog           

   119      * Hint String : "Unable to reject the request"

   120      */     

   121     ECmdNotifyRejectFailure = 8

   122     };

   123 

   124 #endif      // LOCVERIFIERCOVERUI_H_            

   125 // End of File