qthighway/xqservice/src/xqaiwdecl.h
changeset 24 9d760f716ca8
parent 19 46686fb6258c
equal deleted inserted replaced
19:46686fb6258c 24:9d760f716ca8
    34 // Common Application Interworking declarations
    34 // Common Application Interworking declarations
    35 // ---------------------------------------------
    35 // ---------------------------------------------
    36 //
    36 //
    37 
    37 
    38 /*!
    38 /*!
    39  File viewing interface and related operations
    39     \file xqaiwdecl.h
    40 */
    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 
    41 #define XQI_FILE_VIEW QLatin1String("com.nokia.symbian.IFileView")
    58 #define XQI_FILE_VIEW QLatin1String("com.nokia.symbian.IFileView")
    42 #define XQOP_FILE_VIEW QLatin1String("view(QString)")
    59 #define XQOP_FILE_VIEW QLatin1String("view(QString)")
    43 #define XQOP_FILE_VIEW_SHARABLE QLatin1String("view(XQSharableFile)")
    60 #define XQOP_FILE_VIEW_SHARABLE QLatin1String("view(XQSharableFile)")
    44 
    61 
    45 /*!
    62 /*!
    46  URI viewing interface and related operations
    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.
    47 */
    71 */
    48 #define XQI_URI_VIEW QLatin1String("com.nokia.symbian.IUriView")
    72 #define XQI_URI_VIEW QLatin1String("com.nokia.symbian.IUriView")
    49 #define XQOP_URI_VIEW QLatin1String("view(QString)")
    73 #define XQOP_URI_VIEW QLatin1String("view(QString)")
    50 
    74 
    51 /*!
    75 /*!
    52  File sharing interface and related operations
    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.
    53 */
    84 */
    54 #define XQI_FILE_SHARE QLatin1String("com.nokia.symbian.IFileShare")
    85 #define XQI_FILE_SHARE QLatin1String("com.nokia.symbian.IFileShare")
    55 #define XQOP_FILE_SHARE QLatin1String("send(QVariant)")
    86 #define XQOP_FILE_SHARE QLatin1String("send(QVariant)")
    56 
    87 
    57 /*!
    88 /*!
    58  The scheme of the activity URI
    89     \def XQURI_SCHEME_ACTIVITY
       
    90     The scheme of the activity URI.
    59 */
    91 */
    60 #define XQURI_SCHEME_ACTIVITY QLatin1String("appto")
    92 #define XQURI_SCHEME_ACTIVITY QLatin1String("appto")
    61 /*!
    93 /*!
    62  Activity key name in query part of the activity URI
    94     \def XQURI_KEY_ACTIVITY_NAME
       
    95     Activity key name in query part of the activity URI.
    63 */
    96 */
    64 #define XQURI_KEY_ACTIVITY_NAME QLatin1String("activityname")
    97 #define XQURI_KEY_ACTIVITY_NAME QLatin1String("activityname")
    65 
    98 
    66 /*!
    99 /*!
    67  Miscellaneous needed URI schemes
   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.
    68 */
   118 */
    69 #define XQURI_SCHEME_HTTP QLatin1String("http")
   119 #define XQURI_SCHEME_HTTP QLatin1String("http")
    70 #define XQURI_SCHEME_HTTPS QLatin1String("https")
   120 #define XQURI_SCHEME_HTTPS QLatin1String("https")
    71 #define XQURI_SCHEME_MAILTO QLatin1String("mailto")
   121 #define XQURI_SCHEME_MAILTO QLatin1String("mailto")
    72 #define XQURI_SCHEME_FILE QLatin1String("file")
   122 #define XQURI_SCHEME_FILE QLatin1String("file")
    73 
   123 
    74 
   124 
    75 /*!
   125 /*!
    76  Service XML custom property, which contains the name of text resource file that
   126     \def XQCUSTOM_PROP_AIW_TEXT_FILE
    77  contains the CUSTOM_PROP_AIW_TEXT.
   127     Service XML custom property, which contains the name of text resource file that
    78  \see XQAiwRequest::createAction()
   128     contains the CUSTOM_PROP_AIW_TEXT.
       
   129     \sa XQAiwRequest::createAction()
    79 */
   130 */
    80 #define XQCUSTOM_PROP_AIW_TEXT_FILE QLatin1String("aiw_action_text_file")
   131 #define XQCUSTOM_PROP_AIW_TEXT_FILE QLatin1String("aiw_action_text_file")
    81 
   132 
    82 /*!
   133 /*!
    83  Service XML custom property, that contains the Text Id within the
   134     \def XQCUSTOM_PROP_AIW_TEXT
    84  CUSTOM_PROP_AIW_TEXT_FILE.  The localized text is attached to
   135     Service XML custom property, that contains the Text Id within the
    85  to QAction returned by the XQAiwRequest::createAction()
   136     CUSTOM_PROP_AIW_TEXT_FILE.  The localized text is attached to
       
   137     QAction returned by the XQAiwRequest::createAction().
    86 */
   138 */
    87 #define XQCUSTOM_PROP_AIW_TEXT QLatin1String("aiw_action_text")
   139 #define XQCUSTOM_PROP_AIW_TEXT QLatin1String("aiw_action_text")
    88 
   140 
    89 /*!
   141 /*!
    90  Service XML custom property, that contains the name of the icon to be attached
   142     \def XQCUSTOM_PROP_AIW_ICON
    91  to QAction returned by the XQAiwRequest::createAction()
   143     Service XML custom property, that contains the name of the icon to be attached
       
   144     to QAction returned by the XQAiwRequest::createAction().
    92 */
   145 */
    93 #define XQCUSTOM_PROP_AIW_ICON QLatin1String("aiw_action_icon")
   146 #define XQCUSTOM_PROP_AIW_ICON QLatin1String("aiw_action_icon")
    94 
   147 
    95 /*!
   148 /*!
    96  Service XML custom property, that contains schemes the XQI_URI_VIEW can handle
   149     \def XQCUSTOM_PROP_SCHEMES
       
   150     Service XML custom property, that contains schemes the XQI_URI_VIEW can handle.
    97 */
   151 */
    98 #define XQCUSTOM_PROP_SCHEMES QLatin1String("schemes")
   152 #define XQCUSTOM_PROP_SCHEMES QLatin1String("schemes")
    99 
   153 
   100 /*!
   154 /*!
   101  Service XML custom property, which contains the name of text key that
   155     \def XQCUSTOM_PROP_AIW_SERVICE_STATUS
   102  contains the service status
   156     Service XML custom property, which contains the name of text key that
   103  \see XQApplicationMgr::isEnabled()
   157     contains the service status.
       
   158     \sa XQApplicationManager::status()
   104 */
   159 */
   105 #define XQCUSTOM_PROP_AIW_SERVICE_STATUS QLatin1String("aiw_status")
   160 #define XQCUSTOM_PROP_AIW_SERVICE_STATUS QLatin1String("aiw_status")
   106 
   161 
   107 /*!
   162 /*!
   108  A key name for XQRequestInfo object to pass a window title
   163     \def XQINFO_KEY_WINDOW_TITLE
   109  to be shown in service application instead of the default title.
   164     A key name for XQRequestInfo object to pass a window title
   110  Service application is responsible to handle the key value.
   165     to be shown in service application instead of the default title.
   111  \see XQApplicationMgr::XQRequestInfo::setInfo()
   166     Service application is responsible to handle the key value.
       
   167     \sa XQRequestInfo::setInfo()
   112 */
   168 */
   113 #define XQINFO_KEY_WINDOW_TITLE QLatin1String("WindowTitle")
   169 #define XQINFO_KEY_WINDOW_TITLE QLatin1String("WindowTitle")
   114 
   170 
   115 
   171 
   116 //
   172 //
   117 // Media related Application Interworking declarations
   173 // Media related Application Interworking declarations
   118 // ---------------------------------------------------
   174 // ---------------------------------------------------
   119 //
   175 //
   120 
   176 
   121 /*!
   177 /*!
   122  Image fetching interface and related operations
   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.
   123 */
   186 */
   124 #define XQI_IMAGE_FETCH QLatin1String("com.nokia.symbian.IImageFetch")
   187 #define XQI_IMAGE_FETCH QLatin1String("com.nokia.symbian.IImageFetch")
   125 #define XQOP_IMAGE_FETCH QLatin1String("fetch()")
   188 #define XQOP_IMAGE_FETCH QLatin1String("fetch()")
   126 
   189 
   127 /*!
   190 /*!
   128  Music fetching interface and related operations
   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.
   129 */
   199 */
   130 #define XQI_MUSIC_FETCH QLatin1String("com.nokia.symbian.IMusicFetch")
   200 #define XQI_MUSIC_FETCH QLatin1String("com.nokia.symbian.IMusicFetch")
   131 #define XQOP_MUSIC_FETCH QLatin1String("fetch()")
   201 #define XQOP_MUSIC_FETCH QLatin1String("fetch()")
   132 
   202 
   133 /*!
   203 /*!
   134  Tones fetching interface and related operations
   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.
   135 */
   212 */
   136 #define XQI_TONE_FETCH QLatin1String("com.nokia.symbian.IToneFetch")
   213 #define XQI_TONE_FETCH QLatin1String("com.nokia.symbian.IToneFetch")
   137 #define XQOP_TONE_FETCH QLatin1String("fetch()")
   214 #define XQOP_TONE_FETCH QLatin1String("fetch()")
   138 
   215 
   139 /*!
   216 /*!
   140  Video fetching interface and related operations
   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.
   141 */
   225 */
   142 #define XQI_VIDEO_FETCH QLatin1String("com.nokia.symbian.IVideoFetch")
   226 #define XQI_VIDEO_FETCH QLatin1String("com.nokia.symbian.IVideoFetch")
   143 #define XQOP_VIDEO_FETCH QLatin1String("fetch()")
   227 #define XQOP_VIDEO_FETCH QLatin1String("fetch()")
   144 
   228 
   145 /*!
   229 /*!
   146  Video collection browser interface and related operations
   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.
   147 */
   249 */
   148 namespace XQService
   250 namespace XQService
   149 {
   251 {
   150     enum VideoBrowseSortKey
   252     enum VideoBrowseSortKey
   151     {
   253     {
   153         SortDateTime  = 1,
   255         SortDateTime  = 1,
   154         SortTitle     = 2,
   256         SortTitle     = 2,
   155         SortSize      = 3
   257         SortSize      = 3
   156     };
   258     };
   157 }
   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 */
   158 #define XQI_VIDEO_BROWSE QLatin1String("com.nokia.symbian.IVideoBrowse")
   271 #define XQI_VIDEO_BROWSE QLatin1String("com.nokia.symbian.IVideoBrowse")
   159 #define XQOP_VIDEO_BROWSE QLatin1String("browseVideos(int, int)")
   272 #define XQOP_VIDEO_BROWSE QLatin1String("browseVideos(int, int)")
   160 
   273 
   161 /*!
   274 /*!
   162  Video player interface and related operations
   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.
   163 */
   294 */
   164 #define XQI_VIDEO_PLAY QLatin1String("com.nokia.symbian.IVideoView")
   295 #define XQI_VIDEO_PLAY QLatin1String("com.nokia.symbian.IVideoView")
   165 #define XQOP_VIDEO_PLAY QLatin1String("playMedia(QString)")
   296 #define XQOP_VIDEO_PLAY QLatin1String("playMedia(QString)")
   166 #define XQOP_VIDEO_PLAY_PD QLatin1String("playMedia(QString, int)")
   297 #define XQOP_VIDEO_PLAY_PD QLatin1String("playMedia(QString, int)")
   167 #define XQOP_VIDEO_CLOSE QLatin1String("closePlayer()")
   298 #define XQOP_VIDEO_CLOSE QLatin1String("closePlayer()")
   168 
   299 
   169 /*!
   300 /*!
   170  Camera capture interface and related operations
   301     \def XQI_CAMERA_CAPTURE
   171  Operation: capture(int mode, QVariantMap parameters)
   302     Camera capture interface.
   172   mode: image = 0, video = 1
   303     \sa XQOP_CAMERA_CAPTURE for related operations.
   173   parameters: 
   304 */
   174    CameraIndex: int:  primary = 0, secondary = 1
   305 /*!
   175    Quality: int: 0 = default, 1 = lowest, 2 = highest
   306     \def XQOP_CAMERA_CAPTURE
   176    AllowModeSwitch: bool
   307     Camera capture interface related operation.
   177    AllowCamera_switch: bool
   308     \sa XQI_CAMERA_CAPTURE for interface definition, \n
   178    allow_quality_change: bool
   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.
   179 */
   342 */
   180 #define XQI_CAMERA_CAPTURE QLatin1String("com.nokia.symbian.ICameraCapture")
   343 #define XQI_CAMERA_CAPTURE QLatin1String("com.nokia.symbian.ICameraCapture")
   181 #define XQOP_CAMERA_CAPTURE QLatin1String("capture(int,QVariantMap)")
   344 #define XQOP_CAMERA_CAPTURE QLatin1String("capture(int,QVariantMap)")
   182 #define XQCAMERA_INDEX QLatin1String("CameraIndex")
   345 #define XQCAMERA_INDEX QLatin1String("CameraIndex")
   183 #define XQCAMERA_QUALITY QLatin1String("Quality")
   346 #define XQCAMERA_QUALITY QLatin1String("Quality")
   190 // Logs related Application Interworking declarations
   353 // Logs related Application Interworking declarations
   191 // ---------------------------------------------------
   354 // ---------------------------------------------------
   192 //
   355 //
   193 
   356 
   194 /*!
   357 /*!
   195   Logs view interface and related operations constants
   358     \enum XQService::LogsViewIndex
   196   Operation: XQOP_LOGS_SHOW   (show(QVariantMap))
   359     XQLOGS_VIEW_INDEX parameter values.
   197     parameters: 
   360     \sa XQOP_LOGS_SHOW for operation definition.
   198       XQLOGS_VIEW_INDEX: enum LogsViewIndex: 0 - all recent, 1 - received, 2 - called, 3 - missed
   361 */
   199       XQLOGS_SHOW_DIALPAD: bool
   362 /*!
   200       XQLOGS_DIALPAD_TEXT: QString
   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.
   201 */
   377 */
   202 namespace XQService
   378 namespace XQService
   203 {  
   379 {  
   204     enum LogsViewIndex
   380     enum LogsViewIndex
   205     {
   381     {
   207         LogsViewReceived,
   383         LogsViewReceived,
   208         LogsViewCalled,
   384         LogsViewCalled,
   209         LogsViewMissed
   385         LogsViewMissed
   210     };
   386     };
   211 }
   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 */
   212 #define XQI_LOGS_VIEW QLatin1String("com.nokia.symbian.ILogsView") 
   419 #define XQI_LOGS_VIEW QLatin1String("com.nokia.symbian.ILogsView") 
   213 #define XQOP_LOGS_SHOW QLatin1String("show(QVariantMap)")
   420 #define XQOP_LOGS_SHOW QLatin1String("show(QVariantMap)")
   214 #define XQLOGS_VIEW_INDEX QLatin1String("ViewIndex")
   421 #define XQLOGS_VIEW_INDEX QLatin1String("ViewIndex")
   215 #define XQLOGS_SHOW_DIALPAD QLatin1String("ShowDialpad")
   422 #define XQLOGS_SHOW_DIALPAD QLatin1String("ShowDialpad")
   216 #define XQLOGS_DIALPAD_TEXT QLatin1String("DialpadText")
   423 #define XQLOGS_DIALPAD_TEXT QLatin1String("DialpadText")
   219 // Contacts related Application Interworking declarations
   426 // Contacts related Application Interworking declarations
   220 // ------------------------------------------------------
   427 // ------------------------------------------------------
   221 //
   428 //
   222 
   429 
   223 /*!
   430 /*!
   224   Contact editing interface.
   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
   225  */
   524  */
   226 #define XQI_CONTACTS_EDIT QLatin1String("com.nokia.symbian.IContactsEdit")
   525 #define XQI_CONTACTS_EDIT QLatin1String("com.nokia.symbian.IContactsEdit")
   227 
       
   228 /*!
       
   229  Launches editor for creating a new contact with a given detail.
       
   230     Parameter1: Indicates what type of contact field is supplied.
       
   231         One of the following values:
       
   232           QContactPhoneNumber::DefinitionName
       
   233           QContactEmailAddress::DefinitionName
       
   234           QContactOnlineAccount::DefinitionName
       
   235      (you need to include qcontactdetails.h)
       
   236     Parameter2: The actual detail value, for eg. "123456" 
       
   237  \return One of these constants defined in cntservicescontact.h:
       
   238          KCntServicesReturnValueContactSaved
       
   239          KCntServicesReturnValueContactDeleted
       
   240          KCntServicesReturnValueContactNotModified
       
   241  */
       
   242 #define XQOP_CONTACTS_EDIT_CREATE_NEW QLatin1String("editCreateNew(QString,QString)")
   526 #define XQOP_CONTACTS_EDIT_CREATE_NEW QLatin1String("editCreateNew(QString,QString)")
   243 
       
   244 /*!
       
   245  Launches editor for creating a new contact with a given detail.
       
   246  Becomes available in wk30.
       
   247     Parameter1: Indicates what type of contact field is supplied.
       
   248         One of the following values:
       
   249           QContactPhoneNumber::DefinitionName
       
   250           QContactEmailAddress::DefinitionName
       
   251           QContactOnlineAccount::DefinitionName
       
   252       (you need to include qcontactdetails.h)
       
   253     Parameter2: The actual detail value, for eg. "123456"
       
   254     Parameter3: sub type, for eg. QContactPhoneNumber::SubTypeMobile
       
   255  \return One of these constants defined in cntservicescontact.h:
       
   256          KCntServicesReturnValueContactSaved
       
   257          KCntServicesReturnValueContactDeleted
       
   258          KCntServicesReturnValueContactNotModified
       
   259  */
       
   260 #define XQOP_CONTACTS_EDIT_CREATE_NEW_WITH_SUBTYPE QLatin1String("editCreateNew(QString,QString,QString)")
   527 #define XQOP_CONTACTS_EDIT_CREATE_NEW_WITH_SUBTYPE QLatin1String("editCreateNew(QString,QString,QString)")
   261 
       
   262 /*!
       
   263  Launches editor for creating a new contact based on vCard  indicated in arg.
       
   264  The user is able to edit and save the contact. 
       
   265  Parameter1: vCard file name including the full path.
       
   266  \return One of these constants defined in cntservicescontact.h:
       
   267          KCntServicesReturnValueContactSaved
       
   268          KCntServicesReturnValueContactDeleted
       
   269          KCntServicesReturnValueContactNotModified
       
   270  */
       
   271 #define XQOP_CONTACTS_EDIT_CREATE_NEW_VCARD QLatin1String("editCreateNewFromVCard(QString)")
   528 #define XQOP_CONTACTS_EDIT_CREATE_NEW_VCARD QLatin1String("editCreateNewFromVCard(QString)")
   272 
       
   273 /*!
       
   274  Launch editor for existing contact that is specified with contact ID. 
       
   275  Only the default backend storage is supported.
       
   276 Parameter1: Contact ID.
       
   277  \return One of these constants defined in cntservicescontact.h:
       
   278          KCntServicesReturnValueContactSaved
       
   279          KCntServicesReturnValueContactDeleted
       
   280          KCntServicesReturnValueContactNotModified
       
   281  */
       
   282 #define XQOP_CONTACTS_EDIT_EXISTING QLatin1String("editExisting(int)")
   529 #define XQOP_CONTACTS_EDIT_EXISTING QLatin1String("editExisting(int)")
   283 
       
   284 /*!
       
   285  Launch editor for updating an existing contact with a given detail.
       
   286  A contact fetch view is opened first, where the user can choose which contact
       
   287  to update. 
       
   288     Parameter1: Indicates what type of contact field is supplied.
       
   289         One of the following values:
       
   290           QContactPhoneNumber::DefinitionName
       
   291           QContactEmailAddress::DefinitionName
       
   292           QContactOnlineAccount::DefinitionName
       
   293       (you need to include qcontactdetails.h)
       
   294     Parameter2: The actual detail value, for eg. "123456"
       
   295  \return One of these constants defined in cntservicescontact.h:
       
   296          KCntServicesReturnValueContactSaved
       
   297          KCntServicesReturnValueContactDeleted
       
   298          KCntServicesReturnValueContactNotModified
       
   299  */
       
   300 #define XQOP_CONTACTS_EDIT_UPDATE_EXISTING QLatin1String("editUpdateExisting(QString,QString)")
   530 #define XQOP_CONTACTS_EDIT_UPDATE_EXISTING QLatin1String("editUpdateExisting(QString,QString)")
   301 
       
   302 
       
   303 /*!
       
   304  Launch editor for updating an existing contact with a given detail.
       
   305  Becomes available in wk30.
       
   306  A contact fetch view is opened first, where the user can choose which contact
       
   307  to update. 
       
   308     Parameter1: Indicates what type of contact field is supplied.
       
   309         One of the following values:
       
   310           QContactPhoneNumber::DefinitionName
       
   311           QContactEmailAddress::DefinitionName
       
   312           QContactOnlineAccount::DefinitionName
       
   313       (you need to include qcontactdetails.h)
       
   314     Parameter2: The actual detail value, for eg. "123456"
       
   315  \return One of these constants defined in cntservicescontact.h:
       
   316          KCntServicesReturnValueContactSaved
       
   317          KCntServicesReturnValueContactDeleted
       
   318          KCntServicesReturnValueContactNotModified
       
   319  */
       
   320 #define XQOP_CONTACTS_EDIT_UPDATE_EXISTING_WITH_SUBTYPE QLatin1String("editUpdateExisting(QString,QString,QString)")
   531 #define XQOP_CONTACTS_EDIT_UPDATE_EXISTING_WITH_SUBTYPE QLatin1String("editUpdateExisting(QString,QString,QString)")
   321 
   532 
   322 /*!
   533 /*!
   323  Contacts fetching interface.
   534     \def XQI_CONTACTS_FETCH
   324  */
   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 */
   325 #define XQI_CONTACTS_FETCH QLatin1String("com.nokia.symbian.IContactsFetch")
   556 #define XQI_CONTACTS_FETCH QLatin1String("com.nokia.symbian.IContactsFetch")
   326 
       
   327 /*!
       
   328  Fetch multiple contacts
       
   329  cntservicescontact.h has some constant definitions and a class for
       
   330  transforming the result.
       
   331  Parameter1: Title string.
       
   332  Parameter2: Action type string, from cntservicescontact.h 
       
   333  \return An object of type CntServicesContactList containing the contact ID.
       
   334  */
       
   335 #define XQOP_CONTACTS_FETCH_MULTIPLE QLatin1String("multiFetch(QString,QString)")
   557 #define XQOP_CONTACTS_FETCH_MULTIPLE QLatin1String("multiFetch(QString,QString)")
   336 
       
   337 /*!
       
   338  Fetch multiple contacts
       
   339  cntservicescontact.h has some constant definitions and a class for
       
   340  transforming the result.
       
   341  Parameter1: Title string.
       
   342  Parameter2: Action type string, from cntservicescontact.h 
       
   343  \return An object of type CntServicesContactList containing the contact ID.
       
   344  */
       
   345 #define XQOP_CONTACTS_FETCH_SINGLE QLatin1String("singleFetch(QString,QString)")
   558 #define XQOP_CONTACTS_FETCH_SINGLE QLatin1String("singleFetch(QString,QString)")
   346 
   559 
   347 /*!
   560 
   348  Contacts viewing interface.
   561 /*!
   349  */
   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 */
   350 #define XQI_CONTACTS_VIEW QLatin1String("com.nokia.symbian.IContactsView")
   594 #define XQI_CONTACTS_VIEW QLatin1String("com.nokia.symbian.IContactsView")
   351 
       
   352 /*!
       
   353  Opens contact card.
       
   354  Parameter1: Contact ID.
       
   355  */
       
   356 #define XQOP_CONTACTS_VIEW_CONTACT_CARD QLatin1String("openContactCard(int)")
   595 #define XQOP_CONTACTS_VIEW_CONTACT_CARD QLatin1String("openContactCard(int)")
   357 
       
   358 /*!
       
   359  Open contact card for in-memory contact which is not saved yet.
       
   360  In the UI there is an option to save the contact either by updating an
       
   361  existing contact or by creating a new one. 
       
   362 
       
   363     Parameter1: Indicates what type of contact field is supplied.
       
   364         One of the following values:
       
   365           QContactPhoneNumber::DefinitionName
       
   366           QContactEmailAddress::DefinitionName
       
   367           QContactOnlineAccount::DefinitionName
       
   368       (you need to include qcontactdetails.h)
       
   369     Parameter2: The actual detail value, for eg. "123456"
       
   370  */
       
   371 #define XQOP_CONTACTS_VIEW_TEMP_CONTACT_CARD_WITH_DETAIL QLatin1String("openTemporaryContactCard(QString,QString)")
   596 #define XQOP_CONTACTS_VIEW_TEMP_CONTACT_CARD_WITH_DETAIL QLatin1String("openTemporaryContactCard(QString,QString)")
   372 
       
   373 /*!
       
   374  Open the group members view.
       
   375  On the flip side of the group members view, there is the "group action" view.
       
   376  Parameter: The group ID. (native ID)
       
   377             Only groups in the main Qt Mobility backend are supported.
       
   378 */
       
   379 #define XQOP_CONTACTS_VIEW_GROUP QLatin1String("openGroup(int)")
   597 #define XQOP_CONTACTS_VIEW_GROUP QLatin1String("openGroup(int)")
   380 
   598 
   381 //
   599 //
   382 // Messaging related Application Interworking declarations
   600 // Messaging related Application Interworking declarations
   383 // ------------------------------------------------------
   601 // ------------------------------------------------------
   384 //
   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 */
   385 #define XQI_MESSAGE_SEND QLatin1String("com.nokia.symbian.IMessageSend")
   624 #define XQI_MESSAGE_SEND QLatin1String("com.nokia.symbian.IMessageSend")
   386 
   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)")
   387 
   641 
   388 /*!
   642 /*!
   389  Incomplete list of interfaces.
   643  Incomplete list of interfaces.
   390  To be completed with operation signatures and related declarations.
   644  To be completed with operation signatures and related declarations.
   391 */
   645 */