bluetoothengine/btnotif/inc/bluetoothdevicedialogs.h
author hgs
Fri, 23 Jul 2010 15:57:13 +0300
changeset 47 9e2a905b887f
parent 42 b72428996822
child 57 5ebadcda06cb
permissions -rw-r--r--
201029_02
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
29
48ae3789ce00 201017_2
hgs
parents:
diff changeset
     1
/*
48ae3789ce00 201017_2
hgs
parents:
diff changeset
     2
* ============================================================================
48ae3789ce00 201017_2
hgs
parents:
diff changeset
     3
*  Name        : bluetoothdevicedialogs.h
48ae3789ce00 201017_2
hgs
parents:
diff changeset
     4
*  Part of     : bluetoothengine / btnotif
48ae3789ce00 201017_2
hgs
parents:
diff changeset
     5
*  Description : Data structures for passing dialog type and formatting between btnotif and the UI component showing the actual dialogs. Also defines identifiers for Bluetooth device dialogs.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
     6
*
48ae3789ce00 201017_2
hgs
parents:
diff changeset
     7
*  Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies).
48ae3789ce00 201017_2
hgs
parents:
diff changeset
     8
*  All rights reserved.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
     9
*  This component and the accompanying materials are made available
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    10
*  under the terms of "Eclipse Public License v1.0"
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    11
*  which accompanies this distribution, and is available
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    12
*  at the URL "http://www.eclipse.org/legal/epl-v10.html".
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    13
*
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    14
*  Initial Contributors:
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    15
*  Nokia Corporation - initial contribution.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    16
*
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    17
*  Contributors:
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    18
*  Nokia Corporation
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    19
* ============================================================================
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    20
* Template version: 4.2
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    21
*/
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    22
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    23
#ifndef BLUETOOTHDEVICEDIALOGS_H
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    24
#define BLUETOOTHDEVICEDIALOGS_H
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    25
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    26
#include <btdevice.h>
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    27
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    28
/**  Enumeration for the type of notification to be launched. */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    29
enum TBTDialogResourceId
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    30
    {
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    31
    ENoResource,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    32
    EAuthorization,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    33
    EIncomingPairing,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    34
    EPinInput,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    35
    ENumericComparison,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    36
    EPasskeyDisplay,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    37
    EObexPasskeyInput,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    38
    ESetTrusted,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    39
    EBlockUnpairedDevice,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    40
    EBlockPairedDevice,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    41
    EPairingSuccess,
47
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    42
    EPairingFailureRetry,
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    43
    EPairingFailureOk,
29
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    44
    EVisibilityTimeout,
42
hgs
parents: 31
diff changeset
    45
    EUnpairedDevice,
29
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    46
    EUnusedResource	// The last ID
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    47
    };
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    48
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    49
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    50
/**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    51
 *  TBluetoothDialogParams contains device dialog parameters except for device name and type
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    52
 *
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    53
 *  @since Symbian^4
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    54
 */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    55
NONSHARABLE_CLASS( TBluetoothDialogParams )
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    56
    {
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    57
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    58
public:
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    59
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    60
    /**  Enumeration for the type of notification to be launched. */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    61
    enum TBTDialogType
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    62
        {
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    63
        EInvalidDialog,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    64
        ENote,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    65
        EQuery,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    66
        EInput,
31
a0ea99b6fa53 201019_1
hgs
parents: 29
diff changeset
    67
        EMoreDevice,
29
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    68
        EDeviceSearch,
31
a0ea99b6fa53 201019_1
hgs
parents: 29
diff changeset
    69
        ESend,
42
hgs
parents: 31
diff changeset
    70
        EGlobalNotif,
hgs
parents: 31
diff changeset
    71
        EUserAuthorization,
47
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    72
        EReceiveProgress,
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    73
        ETransferFailed, 
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    74
        EReceiveDone
29
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    75
        };
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    76
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    77
    /**  Enumeration for the notification parameters data type to be configured. */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    78
    enum TDialogDataType
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    79
        {
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    80
        ENoParams,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    81
        EDialogType,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    82
        EResource,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    83
        EAddress,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    84
        EDialogTitle,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    85
        EDialogExt  // Id for first data type of derived class.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
    86
        };
42
hgs
parents: 31
diff changeset
    87
    
hgs
parents: 31
diff changeset
    88
    /** Enumeration for the notification dialog heading type. */
hgs
parents: 31
diff changeset
    89
    enum TDialogTitleDataType
hgs
parents: 31
diff changeset
    90
        {
hgs
parents: 31
diff changeset
    91
        EReceive,
hgs
parents: 31
diff changeset
    92
        EReceiveFromPairedDevice,
hgs
parents: 31
diff changeset
    93
        EConnect,
47
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    94
        EPairingRequest,
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    95
        ERecvFailed,
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    96
        ESendFailed,
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    97
        EReceiveCompleted
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    98
        };
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
    99
    
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
   100
    enum TDialogActionType
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
   101
        {
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
   102
        EHide,
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
   103
        EShow,
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
   104
        ECancelReceive,
9e2a905b887f 201029_02
hgs
parents: 42
diff changeset
   105
        ECancelShow
42
hgs
parents: 31
diff changeset
   106
        };
29
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   107
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   108
    inline TBluetoothDialogParams();
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   109
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   110
public: // data
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   111
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   112
    /**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   113
     * Identifier for the type of notification.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   114
     */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   115
    TInt iDialogType;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   116
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   117
    /**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   118
     * Identifier for the resource to be shown in the dialog.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   119
     */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   120
    TInt iResourceId;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   121
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   122
    /**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   123
     * Address of the remote device (not used, for future extension).
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   124
     */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   125
    TBTDevAddr iAddr;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   126
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   127
    /**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   128
     * Unused padding (not used, for future extension).
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   129
     */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   130
    TUint32 iPadding;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   131
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   132
    };
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   133
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   134
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   135
/**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   136
 *  TBluetoothDeviceDialog contains more device dialog parameters 
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   137
 *  
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   138
 *  @since Symbian^4
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   139
 */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   140
NONSHARABLE_CLASS( TBluetoothDeviceDialog ) : public TBluetoothDialogParams
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   141
    {
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   142
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   143
public:
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   144
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   145
    /**  Enumeration for the notification parameters data type to be configured. */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   146
    enum TDialogDataType
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   147
        {
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   148
        ENoParams = TBluetoothDialogParams::EDialogExt,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   149
        EDeviceName,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   150
        EDeviceClass,
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   151
        EAdditionalInt,
42
hgs
parents: 31
diff changeset
   152
        EAdditionalDesc,
hgs
parents: 31
diff changeset
   153
        EReceivingFileName,
hgs
parents: 31
diff changeset
   154
        EReceivingFileSize,
hgs
parents: 31
diff changeset
   155
        EReceivedFileCount
29
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   156
        };
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   157
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   158
    inline TBluetoothDeviceDialog();
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   159
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   160
public: // data
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   161
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   162
    /**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   163
     * The name of the remote device.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   164
     */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   165
    TBTDeviceName iDeviceName;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   166
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   167
    /**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   168
     * The class of device of the remote device.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   169
     */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   170
    TInt iDeviceClass;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   171
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   172
    /**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   173
     * Additional data depending on the resource.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   174
     */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   175
    TInt iIntParam;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   176
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   177
    /**
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   178
     * Additional data depending on the resource.
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   179
     */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   180
    TBuf<10> iDescParam;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   181
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   182
    };
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   183
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   184
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   185
/**  Typedef'ed pckgbuf to send dialog parameters to the notification framework. */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   186
typedef TPckgBuf<TBluetoothDialogParams> TBluetoothDialogParamsPckg;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   187
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   188
/**  Typedef'ed pckgbuf to send dialog parameters to the notification framework. */
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   189
typedef TPckgBuf<TBluetoothDeviceDialog> TBluetoothDeviceDialogPckg;
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   190
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   191
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   192
inline TBluetoothDialogParams::TBluetoothDialogParams()
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   193
:   iDialogType( EInvalidDialog ),
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   194
    iResourceId( ENoResource ),
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   195
    iAddr( TBTDevAddr() ),
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   196
    iPadding( 0 )
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   197
    {
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   198
    }
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   199
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   200
inline TBluetoothDeviceDialog::TBluetoothDeviceDialog()
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   201
:   iDeviceName( 0 ),
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   202
    iDeviceClass( 0 ),
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   203
    iIntParam( 0 )
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   204
    {
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   205
    }
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   206
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   207
48ae3789ce00 201017_2
hgs
parents:
diff changeset
   208
#endif // BLUETOOTHDEVICEDIALOGS_H