qthighway/xqservice/src/xqaiwdecl.h
branchRCL_3
changeset 9 5d007b20cfd0
equal deleted inserted replaced
8:885c2596c964 9:5d007b20cfd0
       
     1 /*
       
     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
       
     3 * All rights reserved.
       
     4 *
       
     5 * This program is free software: you can redistribute it and/or modify
       
     6 * it under the terms of the GNU Lesser General Public License as published by
       
     7 * the Free Software Foundation, version 2.1 of the License.
       
     8 * 
       
     9 * This program is distributed in the hope that it will be useful,
       
    10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
       
    11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
       
    12 * GNU Lesser General Public License for more details.
       
    13 *
       
    14 * You should have received a copy of the GNU Lesser General Public License
       
    15 * along with this program.  If not, 
       
    16 * see "http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html/".
       
    17 *
       
    18 * Description: Common application interworking declarations 
       
    19 *              All declations shall have XQ prefix
       
    20 *
       
    21 */
       
    22 
       
    23 #ifndef XQAIWDECL_H
       
    24 #define XQAIWDECL_H
       
    25 
       
    26 #include <QLatin1String>
       
    27 
       
    28 //
       
    29 // All declations shall have XQ prefix
       
    30 //
       
    31 
       
    32 
       
    33 //
       
    34 // Common Application Interworking declarations
       
    35 // ---------------------------------------------
       
    36 //
       
    37 
       
    38 /*!
       
    39     \file xqaiwdecl.h
       
    40 */
       
    41 
       
    42 /*!
       
    43     \def XQI_FILE_VIEW
       
    44     File viewing interface.
       
    45     \sa XQOP_FILE_VIEW, XQOP_FILE_VIEW_SHARABLE for related operations.
       
    46 */
       
    47 /*!
       
    48     \def XQOP_FILE_VIEW
       
    49     File viewing interface related operation.
       
    50     \sa XQI_FILE_VIEW for interface definition.
       
    51 */
       
    52 /*!
       
    53     \def XQOP_FILE_VIEW_SHARABLE
       
    54     File viewing interface and related operation.
       
    55     \sa XQI_FILE_VIEW interface definition.
       
    56 */
       
    57 
       
    58 #define XQI_FILE_VIEW QLatin1String("com.nokia.symbian.IFileView")
       
    59 #define XQOP_FILE_VIEW QLatin1String("view(QString)")
       
    60 #define XQOP_FILE_VIEW_SHARABLE QLatin1String("view(XQSharableFile)")
       
    61 
       
    62 /*!
       
    63     \def XQI_URI_VIEW
       
    64     URI viewing interface.
       
    65     \sa XQOP_URI_VIEW for related operation.
       
    66 */
       
    67 /*!
       
    68     \def XQOP_URI_VIEW
       
    69     URI viewing interface related operations.
       
    70     \sa XQI_URI_VIEW for interface definition.
       
    71 */
       
    72 #define XQI_URI_VIEW QLatin1String("com.nokia.symbian.IUriView")
       
    73 #define XQOP_URI_VIEW QLatin1String("view(QString)")
       
    74 
       
    75 /*!
       
    76     \def XQI_FILE_SHARE
       
    77     File sharing interface.
       
    78     \sa XQOP_FILE_SHARE for related operations.
       
    79 */
       
    80 /*!
       
    81     \def XQOP_FILE_SHARE
       
    82     File sharing interface related operation.
       
    83     \sa XQI_FILE_SHARE for interface definition.
       
    84 */
       
    85 #define XQI_FILE_SHARE QLatin1String("com.nokia.symbian.IFileShare")
       
    86 #define XQOP_FILE_SHARE QLatin1String("send(QVariant)")
       
    87 
       
    88 /*!
       
    89     \def XQURI_SCHEME_ACTIVITY
       
    90     The scheme of the activity URI.
       
    91 */
       
    92 #define XQURI_SCHEME_ACTIVITY QLatin1String("appto")
       
    93 /*!
       
    94     \def XQURI_KEY_ACTIVITY_NAME
       
    95     Activity key name in query part of the activity URI.
       
    96 */
       
    97 #define XQURI_KEY_ACTIVITY_NAME QLatin1String("activityname")
       
    98 
       
    99 /*!
       
   100     \def XQURI_SCHEME_HTTP
       
   101     Miscellaneous needed URI scheme.
       
   102     \sa XQURI_SCHEME_HTTPS, XQURI_SCHEME_MAILTO, XQURI_SCHEME_FILE for other URI schemes.
       
   103 */
       
   104 /*!
       
   105     \def XQURI_SCHEME_HTTPS
       
   106     Miscellaneous needed URI scheme.
       
   107     \sa XQURI_SCHEME_HTTP, XQURI_SCHEME_MAILTO, XQURI_SCHEME_FILE for other URI schemes.
       
   108 */
       
   109 /*!
       
   110     \def XQURI_SCHEME_MAILTO
       
   111     Miscellaneous needed URI scheme.
       
   112     \sa XQURI_SCHEME_HTTP, XQURI_SCHEME_HTTPS, XQURI_SCHEME_FILE for other URI schemes.
       
   113 */
       
   114 /*!
       
   115     \def XQURI_SCHEME_FILE
       
   116     Miscellaneous needed URI scheme.
       
   117     \sa XQURI_SCHEME_HTTP, XQURI_SCHEME_HTTPS, XQURI_SCHEME_MAILTO for other URI schemes.
       
   118 */
       
   119 #define XQURI_SCHEME_HTTP QLatin1String("http")
       
   120 #define XQURI_SCHEME_HTTPS QLatin1String("https")
       
   121 #define XQURI_SCHEME_MAILTO QLatin1String("mailto")
       
   122 #define XQURI_SCHEME_FILE QLatin1String("file")
       
   123 
       
   124 
       
   125 /*!
       
   126     \def XQCUSTOM_PROP_AIW_TEXT_FILE
       
   127     Service XML custom property, which contains the name of text resource file that
       
   128     contains the CUSTOM_PROP_AIW_TEXT.
       
   129     \sa XQAiwRequest::createAction()
       
   130 */
       
   131 #define XQCUSTOM_PROP_AIW_TEXT_FILE QLatin1String("aiw_action_text_file")
       
   132 
       
   133 /*!
       
   134     \def XQCUSTOM_PROP_AIW_TEXT
       
   135     Service XML custom property, that contains the Text Id within the
       
   136     CUSTOM_PROP_AIW_TEXT_FILE.  The localized text is attached to
       
   137     QAction returned by the XQAiwRequest::createAction().
       
   138 */
       
   139 #define XQCUSTOM_PROP_AIW_TEXT QLatin1String("aiw_action_text")
       
   140 
       
   141 /*!
       
   142     \def XQCUSTOM_PROP_AIW_ICON
       
   143     Service XML custom property, that contains the name of the icon to be attached
       
   144     to QAction returned by the XQAiwRequest::createAction().
       
   145 */
       
   146 #define XQCUSTOM_PROP_AIW_ICON QLatin1String("aiw_action_icon")
       
   147 
       
   148 /*!
       
   149     \def XQCUSTOM_PROP_SCHEMES
       
   150     Service XML custom property, that contains schemes the XQI_URI_VIEW can handle.
       
   151 */
       
   152 #define XQCUSTOM_PROP_SCHEMES QLatin1String("schemes")
       
   153 
       
   154 /*!
       
   155     \def XQCUSTOM_PROP_AIW_SERVICE_STATUS
       
   156     Service XML custom property, which contains the name of text key that
       
   157     contains the service status.
       
   158     \sa XQApplicationManager::status()
       
   159 */
       
   160 #define XQCUSTOM_PROP_AIW_SERVICE_STATUS QLatin1String("aiw_status")
       
   161 
       
   162 /*!
       
   163     \def XQINFO_KEY_WINDOW_TITLE
       
   164     A key name for XQRequestInfo object to pass a window title
       
   165     to be shown in service application instead of the default title.
       
   166     Service application is responsible to handle the key value.
       
   167     \sa XQRequestInfo::setInfo()
       
   168 */
       
   169 #define XQINFO_KEY_WINDOW_TITLE QLatin1String("WindowTitle")
       
   170 
       
   171 
       
   172 //
       
   173 // Media related Application Interworking declarations
       
   174 // ---------------------------------------------------
       
   175 //
       
   176 
       
   177 /*!
       
   178     \def XQI_IMAGE_FETCH
       
   179     Image fetching interface.
       
   180     \sa XQOP_IMAGE_FETCH for related operations.
       
   181 */
       
   182 /*!
       
   183     \def XQOP_IMAGE_FETCH
       
   184     Image fetching interface related operation.
       
   185     \sa XQI_IMAGE_FETCH interface definition.
       
   186 */
       
   187 #define XQI_IMAGE_FETCH QLatin1String("com.nokia.symbian.IImageFetch")
       
   188 #define XQOP_IMAGE_FETCH QLatin1String("fetch()")
       
   189 
       
   190 /*!
       
   191     \def XQI_MUSIC_FETCH
       
   192     Music fetching interface.
       
   193     \sa XQOP_MUSIC_FETCH for related operations.
       
   194 */
       
   195 /*!
       
   196     \def XQOP_MUSIC_FETCH
       
   197     Music fetching  interface related operation.
       
   198     \sa XQI_MUSIC_FETCH for interface definition.
       
   199 */
       
   200 #define XQI_MUSIC_FETCH QLatin1String("com.nokia.symbian.IMusicFetch")
       
   201 #define XQOP_MUSIC_FETCH QLatin1String("fetch()")
       
   202 
       
   203 /*!
       
   204     \def XQI_TONE_FETCH
       
   205     Tones fetching interface.
       
   206     \sa XQOP_TONE_FETCH for related operations.
       
   207 */
       
   208 /*!
       
   209     \def XQOP_TONE_FETCH
       
   210     Tones fetching interface related operation.
       
   211     \sa XQI_TONE_FETCH for interface definition.
       
   212 */
       
   213 #define XQI_TONE_FETCH QLatin1String("com.nokia.symbian.IToneFetch")
       
   214 #define XQOP_TONE_FETCH QLatin1String("fetch()")
       
   215 
       
   216 /*!
       
   217     \def XQI_VIDEO_FETCH
       
   218     Video fetching interface.
       
   219     \sa XQOP_VIDEO_FETCH for related operations.
       
   220 */
       
   221 /*!
       
   222     \def XQOP_VIDEO_FETCH
       
   223     Video fetching interface related operation.
       
   224     \sa XQI_VIDEO_FETCH for interface definition.
       
   225 */
       
   226 #define XQI_VIDEO_FETCH QLatin1String("com.nokia.symbian.IVideoFetch")
       
   227 #define XQOP_VIDEO_FETCH QLatin1String("fetch()")
       
   228 
       
   229 /*!
       
   230     \enum XQService::VideoBrowseSortKey
       
   231     Video collection browser sort parameter.
       
   232     \sa XQOP_VIDEO_BROWSE for operation definition.
       
   233 */
       
   234 /*!
       
   235     \var XQService::VideoBrowseSortKey  XQService::SortUndefined
       
   236     Sort type undefined.
       
   237 */
       
   238 /*!
       
   239     \var XQService::VideoBrowseSortKey  XQService::SortDateTime
       
   240     Sort by date/time.
       
   241 */
       
   242 /*!
       
   243     \var XQService::VideoBrowseSortKey  XQService::SortTitle
       
   244     Sort by title.
       
   245 */
       
   246 /*!
       
   247     \var XQService::VideoBrowseSortKey  XQService::SortSize
       
   248     Sort by size.
       
   249 */
       
   250 namespace XQService
       
   251 {
       
   252     enum VideoBrowseSortKey
       
   253     {
       
   254         SortUndefined = 0,
       
   255         SortDateTime  = 1,
       
   256         SortTitle     = 2,
       
   257         SortSize      = 3
       
   258     };
       
   259 }
       
   260 
       
   261 /*!
       
   262     \def XQI_VIDEO_BROWSE
       
   263     Video collection browser interface.
       
   264     \sa XQOP_VIDEO_BROWSE for related operations.
       
   265 */
       
   266 /*!
       
   267     \def XQOP_VIDEO_BROWSE
       
   268     Video collection browser interface related operation.
       
   269     \sa XQI_VIDEO_BROWSE for interface definition.
       
   270 */
       
   271 #define XQI_VIDEO_BROWSE QLatin1String("com.nokia.symbian.IVideoBrowse")
       
   272 #define XQOP_VIDEO_BROWSE QLatin1String("browseVideos(int, int)")
       
   273 
       
   274 /*!
       
   275     \def XQI_VIDEO_PLAY
       
   276     Video player interface.
       
   277     \sa XQOP_VIDEO_PLAY, XQOP_VIDEO_PLAY_PD, XQOP_VIDEO_CLOSE
       
   278         for related operations.
       
   279 */
       
   280 /*!
       
   281     \def XQOP_VIDEO_PLAY
       
   282     Video player interface related operation.
       
   283     \sa XQI_VIDEO_PLAY for interface definition.
       
   284 */
       
   285 /*!
       
   286     \def XQOP_VIDEO_PLAY_PD
       
   287     Video player interface related operation.
       
   288     \sa XQI_VIDEO_PLAY for interface definition.
       
   289 */
       
   290 /*!
       
   291     \def XQOP_VIDEO_CLOSE
       
   292     Video player interface related operation.
       
   293     \sa XQI_VIDEO_PLAY for interface definition.
       
   294 */
       
   295 #define XQI_VIDEO_PLAY QLatin1String("com.nokia.symbian.IVideoView")
       
   296 #define XQOP_VIDEO_PLAY QLatin1String("playMedia(QString)")
       
   297 #define XQOP_VIDEO_PLAY_PD QLatin1String("playMedia(QString, int)")
       
   298 #define XQOP_VIDEO_CLOSE QLatin1String("closePlayer()")
       
   299 
       
   300 /*!
       
   301     \def XQI_CAMERA_CAPTURE
       
   302     Camera capture interface.
       
   303     \sa XQOP_CAMERA_CAPTURE for related operations.
       
   304 */
       
   305 /*!
       
   306     \def XQOP_CAMERA_CAPTURE
       
   307     Camera capture interface related operation.
       
   308     \sa XQI_CAMERA_CAPTURE for interface definition, \n
       
   309         XQCAMERA_INDEX, XQCAMERA_QUALITY, XQCAMERA_MODE_SWITCH,
       
   310         XQCAMERA_INDEX_SWITCH, XQCAMERA_QUALITY_CHANGE for operation
       
   311         parameters
       
   312 */
       
   313 /*!
       
   314     \def XQCAMERA_INDEX
       
   315     XQOP_CAMERA_CAPTURE operation parameter.\n \b Values (int):
       
   316     - 0 = primary
       
   317     - 1 = secondary
       
   318     \sa XQOP_CAMERA_CAPTURE for operation definition.
       
   319 */
       
   320 /*!
       
   321     \def XQCAMERA_QUALITY
       
   322     XQOP_CAMERA_CAPTURE operation parameter.\n \b Values (int):
       
   323     - 0 = default
       
   324     - 1 = lowest
       
   325     - 2 = highest
       
   326     \sa XQOP_CAMERA_CAPTURE for operation definition.
       
   327 */
       
   328 /*!
       
   329     \def XQCAMERA_MODE_SWITCH
       
   330     XQOP_CAMERA_CAPTURE operation parameter.\n \b Values (bool)
       
   331     \sa XQOP_CAMERA_CAPTURE for operation definition.
       
   332 */
       
   333 /*!
       
   334     \def XQCAMERA_INDEX_SWITCH
       
   335     XQOP_CAMERA_CAPTURE operation parameter.\n \b Values (bool)
       
   336     \sa XQOP_CAMERA_CAPTURE for operation definition.
       
   337 */
       
   338 /*!
       
   339     \def XQCAMERA_QUALITY_CHANGE
       
   340     XQOP_CAMERA_CAPTURE operation parameter.\n \b Values (bool)
       
   341     \sa XQOP_CAMERA_CAPTURE for operation definition.
       
   342 */
       
   343 #define XQI_CAMERA_CAPTURE QLatin1String("com.nokia.symbian.ICameraCapture")
       
   344 #define XQOP_CAMERA_CAPTURE QLatin1String("capture(int,QVariantMap)")
       
   345 #define XQCAMERA_INDEX QLatin1String("CameraIndex")
       
   346 #define XQCAMERA_QUALITY QLatin1String("Quality")
       
   347 #define XQCAMERA_MODE_SWITCH QLatin1String("AllowModeSwitch")
       
   348 #define XQCAMERA_INDEX_SWITCH QLatin1String("AllowCameraSwitch")
       
   349 #define XQCAMERA_QUALITY_CHANGE QLatin1String("AllowQualityChange")
       
   350 
       
   351 
       
   352 //
       
   353 // Logs related Application Interworking declarations
       
   354 // ---------------------------------------------------
       
   355 //
       
   356 
       
   357 /*!
       
   358     \enum XQService::LogsViewIndex
       
   359     XQLOGS_VIEW_INDEX parameter values.
       
   360     \sa XQOP_LOGS_SHOW for operation definition.
       
   361 */
       
   362 /*!
       
   363     \var XQService::LogsViewIndex  XQService::LogsViewAll
       
   364     All recent.
       
   365 */
       
   366 /*!
       
   367     \var XQService::LogsViewIndex  XQService::LogsViewReceived
       
   368     Received.
       
   369 */
       
   370 /*!
       
   371     \var XQService::LogsViewIndex  XQService::LogsViewCalled
       
   372     Called.
       
   373 */
       
   374 /*!
       
   375     \var XQService::LogsViewIndex  XQService::LogsViewMissed
       
   376     Missed.
       
   377 */
       
   378 namespace XQService
       
   379 {  
       
   380     enum LogsViewIndex
       
   381     {
       
   382         LogsViewAll = 0,
       
   383         LogsViewReceived,
       
   384         LogsViewCalled,
       
   385         LogsViewMissed
       
   386     };
       
   387 }
       
   388 
       
   389 /*!
       
   390     \def XQI_LOGS_VIEW
       
   391     Logs view interface.
       
   392     \sa XQOP_LOGS_SHOW for related operations.
       
   393 */
       
   394 /*!
       
   395     \def XQOP_LOGS_SHOW
       
   396     Logs view interface related operation.
       
   397     \sa XQI_LOGS_VIEW for interface definition, \n
       
   398         XQLOGS_VIEW_INDEX, XQLOGS_SHOW_DIALPAD, XQLOGS_DIALPAD_TEXT
       
   399         for operation parameters.
       
   400 */
       
   401 /*!
       
   402     \def XQLOGS_VIEW_INDEX
       
   403     XQOP_LOGS_SHOW operation parameter. \n
       
   404     \b Values (XQService::LogsViewIndex)
       
   405     \sa XQOP_LOGS_SHOW for operation definition.
       
   406 */
       
   407 /*!
       
   408     \def XQLOGS_SHOW_DIALPAD
       
   409     XQOP_LOGS_SHOW operation parameter. \n
       
   410     \b Values (bool)
       
   411     \sa XQOP_LOGS_SHOW for operation definition.
       
   412 */
       
   413 /*!
       
   414     \def XQLOGS_DIALPAD_TEXT
       
   415     XQOP_LOGS_SHOW operation parameter. \n
       
   416     \b Values (QString)
       
   417     \sa XQOP_LOGS_SHOW for operation definition.
       
   418 */
       
   419 #define XQI_LOGS_VIEW QLatin1String("com.nokia.symbian.ILogsView") 
       
   420 #define XQOP_LOGS_SHOW QLatin1String("show(QVariantMap)")
       
   421 #define XQLOGS_VIEW_INDEX QLatin1String("ViewIndex")
       
   422 #define XQLOGS_SHOW_DIALPAD QLatin1String("ShowDialpad")
       
   423 #define XQLOGS_DIALPAD_TEXT QLatin1String("DialpadText")
       
   424 
       
   425 //
       
   426 // Contacts related Application Interworking declarations
       
   427 // ------------------------------------------------------
       
   428 //
       
   429 
       
   430 /*!
       
   431     \def XQI_CONTACTS_EDIT
       
   432     Contacts related Application Interworking declaration.
       
   433     \sa XQOP_CONTACTS_EDIT_CREATE_NEW, XQOP_CONTACTS_EDIT_CREATE_NEW_WITH_SUBTYPE, XQOP_CONTACTS_EDIT_CREATE_NEW_VCARD,
       
   434         XQOP_CONTACTS_EDIT_EXISTING, XQOP_CONTACTS_EDIT_UPDATE_EXISTING, XQOP_CONTACTS_EDIT_UPDATE_EXISTING_WITH_SUBTYPE for related operations.
       
   435 */
       
   436 /*!
       
   437     \def XQOP_CONTACTS_EDIT_CREATE_NEW
       
   438     Launches editor for creating a new contact with a given detail.
       
   439     \param Parameter1 (QString) Indicates what type of contact field is supplied.
       
   440         One of the following values (you need to include qcontactdetails.h):
       
   441         - QContactPhoneNumber::DefinitionName
       
   442         - QContactEmailAddress::DefinitionName
       
   443         - QContactOnlineAccount::DefinitionName
       
   444     \param Parameter2 (QString) The actual detail value, for eg. "123456" 
       
   445     \return One of these constants defined in cntservicescontact.h:
       
   446         - KCntServicesReturnValueContactSaved
       
   447         - KCntServicesReturnValueContactDeleted
       
   448         - KCntServicesReturnValueContactNotModified
       
   449     \sa XQI_CONTACTS_EDIT for interface definition
       
   450 */
       
   451 /*!
       
   452     \def XQOP_CONTACTS_EDIT_CREATE_NEW_WITH_SUBTYPE
       
   453     Launches editor for creating a new contact with a given detail.
       
   454     \param Parameter1 (QString) Indicates what type of contact field is supplied.
       
   455         One of the following values (you need to include qcontactdetails.h):
       
   456         - QContactPhoneNumber::DefinitionName
       
   457         - QContactEmailAddress::DefinitionName
       
   458         - QContactOnlineAccount::DefinitionName
       
   459     \param Parameter2 (QString) The actual detail value, for eg. "123456"
       
   460     \param Parameter3 (QString) sub type, for eg. QContactPhoneNumber::SubTypeMobile
       
   461     \return One of these constants defined in cntservicescontact.h:
       
   462         - KCntServicesReturnValueContactSaved
       
   463         - KCntServicesReturnValueContactDeleted
       
   464         - KCntServicesReturnValueContactNotModified
       
   465     \sa XQI_CONTACTS_EDIT for interface definition
       
   466 */
       
   467 /*!
       
   468     \def XQOP_CONTACTS_EDIT_CREATE_NEW_VCARD
       
   469     Launches editor for creating a new contact based on vCard  indicated in arg.
       
   470     The user is able to edit and save the contact. 
       
   471     \param Parameter1 (QString) vCard file name including the full path.
       
   472     \return One of these constants defined in cntservicescontact.h:
       
   473         - KCntServicesReturnValueContactSaved
       
   474         - KCntServicesReturnValueContactDeleted
       
   475         - KCntServicesReturnValueContactNotModified
       
   476     \sa XQI_CONTACTS_EDIT for interface definition
       
   477 */
       
   478 /*!
       
   479     \def XQOP_CONTACTS_EDIT_EXISTING
       
   480     Launch editor for existing contact that is specified with contact ID. 
       
   481     Only the default backend storage is supported.
       
   482     \param Parameter1 (int) Contact ID.
       
   483     \return One of these constants defined in cntservicescontact.h:
       
   484         - KCntServicesReturnValueContactSaved
       
   485         - KCntServicesReturnValueContactDeleted
       
   486         - KCntServicesReturnValueContactNotModified
       
   487     \sa XQI_CONTACTS_EDIT for interface definition
       
   488 */
       
   489 /*!
       
   490     \def XQOP_CONTACTS_EDIT_UPDATE_EXISTING
       
   491     Launch editor for updating an existing contact with a given detail.
       
   492     A contact fetch view is opened first, where the user can choose which contact
       
   493     to update. 
       
   494     \param Parameter1 (QString) Indicates what type of contact field is supplied.
       
   495         One of the following values (you need to include qcontactdetails.h):
       
   496         - QContactPhoneNumber::DefinitionName
       
   497         - QContactEmailAddress::DefinitionName
       
   498         - QContactOnlineAccount::DefinitionName
       
   499     \param Parameter2 (QString) The actual detail value, for eg. "123456"
       
   500     \return One of these constants defined in cntservicescontact.h:
       
   501         - KCntServicesReturnValueContactSaved
       
   502         - KCntServicesReturnValueContactDeleted
       
   503         - KCntServicesReturnValueContactNotModified
       
   504     \sa XQI_CONTACTS_EDIT for interface definition
       
   505 */
       
   506 /*!
       
   507     \def XQOP_CONTACTS_EDIT_UPDATE_EXISTING_WITH_SUBTYPE
       
   508     Launch editor for updating an existing contact with a given detail.
       
   509     Becomes available in wk30.
       
   510     A contact fetch view is opened first, where the user can choose which contact
       
   511     to update. 
       
   512     \param Parameter1 (QString) Indicates what type of contact field is supplied.
       
   513         One of the following values (you need to include qcontactdetails.h):
       
   514         - QContactPhoneNumber::DefinitionName
       
   515         - QContactEmailAddress::DefinitionName
       
   516         - QContactOnlineAccount::DefinitionName
       
   517     \param Parameter2 (QString) The actual detail value, for eg. "123456"
       
   518     \param Parameter3 (QString) Sub type
       
   519     \return One of these constants defined in cntservicescontact.h:
       
   520         - KCntServicesReturnValueContactSaved
       
   521         - KCntServicesReturnValueContactDeleted
       
   522         - KCntServicesReturnValueContactNotModified
       
   523     \sa XQI_CONTACTS_EDIT for interface definition
       
   524  */
       
   525 #define XQI_CONTACTS_EDIT QLatin1String("com.nokia.symbian.IContactsEdit")
       
   526 #define XQOP_CONTACTS_EDIT_CREATE_NEW QLatin1String("editCreateNew(QString,QString)")
       
   527 #define XQOP_CONTACTS_EDIT_CREATE_NEW_WITH_SUBTYPE QLatin1String("editCreateNew(QString,QString,QString)")
       
   528 #define XQOP_CONTACTS_EDIT_CREATE_NEW_VCARD QLatin1String("editCreateNewFromVCard(QString)")
       
   529 #define XQOP_CONTACTS_EDIT_EXISTING QLatin1String("editExisting(int)")
       
   530 #define XQOP_CONTACTS_EDIT_UPDATE_EXISTING QLatin1String("editUpdateExisting(QString,QString)")
       
   531 #define XQOP_CONTACTS_EDIT_UPDATE_EXISTING_WITH_SUBTYPE QLatin1String("editUpdateExisting(QString,QString,QString)")
       
   532 
       
   533 /*!
       
   534     \def XQI_CONTACTS_FETCH
       
   535     Contacts related Application Interworking declaration.
       
   536     \sa XQOP_CONTACTS_FETCH_MULTIPLE, XQOP_CONTACTS_FETCH_SINGLE for related operations.
       
   537 */
       
   538 /*!
       
   539     \def XQOP_CONTACTS_FETCH_MULTIPLE
       
   540     Fetch multiple contacts. cntservicescontact.h has some constant definitions
       
   541     and a class for transforming the result.
       
   542     \param Parameter1 (QString) Title string.
       
   543     \param Parameter2 (QString) Action type string, from cntservicescontact.h 
       
   544     \return An object of type CntServicesContactList containing the contact ID.
       
   545     \sa XQI_CONTACTS_FETCH for interface definition.
       
   546 */
       
   547  /*!
       
   548     \def XQOP_CONTACTS_FETCH_SINGLE
       
   549     Fetch single contact. cntservicescontact.h has some constant definitions
       
   550     and a class for transforming the result.
       
   551     \param Parameter1 (QString) Title string.
       
   552     \param Parameter2 (QString) Action type string, from cntservicescontact.h 
       
   553     \return An object of type CntServicesContactList containing the contact ID.
       
   554     \sa XQI_CONTACTS_FETCH for interface definition.
       
   555 */
       
   556 #define XQI_CONTACTS_FETCH QLatin1String("com.nokia.symbian.IContactsFetch")
       
   557 #define XQOP_CONTACTS_FETCH_MULTIPLE QLatin1String("multiFetch(QString,QString)")
       
   558 #define XQOP_CONTACTS_FETCH_SINGLE QLatin1String("singleFetch(QString,QString)")
       
   559 
       
   560 
       
   561 /*!
       
   562     \def XQI_CONTACTS_VIEW
       
   563     Contacts related Application Interworking declaration.
       
   564     \sa XQOP_CONTACTS_VIEW_CONTACT_CARD, XQOP_CONTACTS_VIEW_TEMP_CONTACT_CARD_WITH_DETAIL,
       
   565         XQOP_CONTACTS_VIEW_GROUP for related operations.
       
   566 */
       
   567 /*!
       
   568     \def XQOP_CONTACTS_VIEW_CONTACT_CARD
       
   569     Opens contact card.
       
   570     \param Parameter1 (int) Contact ID.
       
   571     \sa XQI_CONTACTS_VIEW for interface definition.
       
   572 */
       
   573 /*!
       
   574     \def XQOP_CONTACTS_VIEW_TEMP_CONTACT_CARD_WITH_DETAIL
       
   575     Open contact card for in-memory contact which is not saved yet.
       
   576     In the UI there is an option to save the contact either by updating an
       
   577     existing contact or by creating a new one.
       
   578     \param Parameter1 (QString) Indicates what type of contact field is supplied.
       
   579         One of the following values (you need to include qcontactdetails.h):
       
   580         - QContactPhoneNumber::DefinitionName
       
   581         - QContactEmailAddress::DefinitionName
       
   582         - QContactOnlineAccount::DefinitionName
       
   583     \param Parameter2 (QString) The actual detail value, for eg. "123456"
       
   584     \sa XQI_CONTACTS_VIEW for interface definition.
       
   585 */
       
   586 /*!
       
   587     \def XQOP_CONTACTS_VIEW_GROUP
       
   588     Open the group members view.
       
   589     On the flip side of the group members view, there is the "group action" view.
       
   590     \param Parameter1 (int) The group ID (native ID).
       
   591            Only groups in the main Qt Mobility backend are supported.
       
   592     \sa XQI_CONTACTS_VIEW for interface definition.
       
   593 */
       
   594 #define XQI_CONTACTS_VIEW QLatin1String("com.nokia.symbian.IContactsView")
       
   595 #define XQOP_CONTACTS_VIEW_CONTACT_CARD QLatin1String("openContactCard(int)")
       
   596 #define XQOP_CONTACTS_VIEW_TEMP_CONTACT_CARD_WITH_DETAIL QLatin1String("openTemporaryContactCard(QString,QString)")
       
   597 #define XQOP_CONTACTS_VIEW_GROUP QLatin1String("openGroup(int)")
       
   598 
       
   599 //
       
   600 // Messaging related Application Interworking declarations
       
   601 // ------------------------------------------------------
       
   602 //
       
   603 
       
   604 /*!
       
   605     \def XQI_MESSAGE_SEND
       
   606     Messaging related Application Interworking declaration.
       
   607     \sa XQOP_MESSAGE_SEND, XQOP_MESSAGE_SEND_WITH_ID, XQOP_MESSAGE_SEND_WITH_ALIAS for related operations.
       
   608 */
       
   609 /*!
       
   610     \def XQOP_MESSAGE_SEND
       
   611     Messaging related Application Interworking interface related operation.
       
   612     \sa XQI_MESSAGE_SEND for interface definition.
       
   613 */
       
   614 /*!
       
   615     \def XQOP_MESSAGE_SEND_WITH_ID
       
   616     Messaging related Application Interworking interface related operation.
       
   617     \sa XQI_MESSAGE_SEND for interface definition.
       
   618 */
       
   619 /*!
       
   620     \def XQOP_MESSAGE_SEND_WITH_ALIAS
       
   621     Messaging related Application Interworking interface related operation.
       
   622     \sa XQI_MESSAGE_SEND for interface definition.
       
   623 */
       
   624 #define XQI_MESSAGE_SEND QLatin1String("com.nokia.symbian.IMessageSend")
       
   625 #define XQOP_MESSAGE_SEND QLatin1String("send(QVariantMap,QString)")
       
   626 #define XQOP_MESSAGE_SEND_WITH_ID QLatin1String("send(QString,qint32,QString)")
       
   627 #define XQOP_MESSAGE_SEND_WITH_ALIAS QLatin1String("send(QString,QString,QString)")
       
   628 
       
   629 /*!
       
   630     \def XQI_MESSAGE_VIEW
       
   631     Messaging related Application Interworking declaration.
       
   632     \sa XQOP_MESSAGE_VIEW for related operations.
       
   633 */
       
   634 /*!
       
   635     \def XQOP_MESSAGE_VIEW
       
   636     Messaging related Application Interworking interface related operation.
       
   637     \sa XQI_MESSAGE_VIEW for interface definition.
       
   638 */
       
   639 #define XQI_MESSAGE_VIEW QLatin1String("com.nokia.symbian.IMessageView")
       
   640 #define XQOP_MESSAGE_VIEW QLatin1String("view(int)")
       
   641 
       
   642 /*!
       
   643  Incomplete list of interfaces.
       
   644  To be completed with operation signatures and related declarations.
       
   645 */
       
   646 #define XQI_FILE_FETCH QLatin1String("com.nokia.symbian.IFileFetch")
       
   647 
       
   648 
       
   649 
       
   650 #endif