X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=inc%2FFAppAppControl.h;h=80ede82fe2dfbe29db9bc0e5c6047348feeedbab;hb=b54953ec1a6df32b1f10ce54ec189c9a3ad826b0;hp=edb7408ed9e0e0b2dc3ea9051a4dadf801847252;hpb=723cb43de71991cb05e4f6558dc3c680e0f2a90e;p=platform%2Fframework%2Fnative%2Fappfw.git diff --git a/inc/FAppAppControl.h b/inc/FAppAppControl.h index edb7408..80ede82 100644 --- a/inc/FAppAppControl.h +++ b/inc/FAppAppControl.h @@ -1,5 +1,4 @@ // -// Open Service Platform // Copyright (c) 2012 Samsung Electronics Co., Ltd. // // Licensed under the Apache License, Version 2.0 (the License); @@ -47,7 +46,7 @@ class IAppControlResponseListener; * For more information, see Contact Application Control. * * @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.contacts". * @since 2.0 * @endif @@ -60,9 +59,9 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_CONTACT; * * For more information, see Calendar Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. -* Instead of this variable, use the literal, L"tizen.calendar" or L"tizen.events". +* Instead of this variable, use the literal, L"tizen.calendar". * @since 2.0 * @endif */ @@ -72,12 +71,12 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_CALENDAR; * @if OSPDEPREC * The Todo %AppControl ID. * -* @brief [Deprecated] -* @deprecated This application control provider name is deprecated. -* @b OPERATION_PICK: -* @since 2.0 +* @brief [Deprecated] +* @deprecated This application control provider name is deprecated. +* @b OPERATION_PICK: +* @since 2.0 * -* @remarks This constant is currently not available. +* @remarks This constant is currently not available. * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_TODO; @@ -88,9 +87,9 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_TODO; * * For more information, see Call Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. -* Instead of this variable, use the literal, L"tizen.phone" with operation L"http://tizen.org/appcontrol/operation/dial". +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* Instead of this variable, use the literal, L"tizen.phone", with the operation L"http://tizen.org/appcontrol/operation/dial". * @since 2.0 * @endif */ @@ -103,10 +102,11 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_DIAL; * * For more information, see Call Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. -* Instead of this variable, use the literal, L"tizen.phone" with operation L"http://tizen.org/appcontrol/operation/call". -* @since 2.0 +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* Instead of this variable, use the literal, L"tizen.phone", with the operation L"http://tizen.org/appcontrol/operation/call". +* @since 2.0 +* @privlevel public * @privilege %http://tizen.org/privilege/systeminfo * * @remarks Privilege is required to use this application control. @@ -121,13 +121,14 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_CALL; * * For more information, see Message Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.messages". * @since 2.0 * -* @remarks An MMS attachment may contain either an image, audio, video, vCard, vCalendar or a combination of an image, audio, vCard, and vCalendar files. @n -* MMS attachments cannot contain a video in combination with an image or an audio file. +* @remarks +* - An MMS attachment may contain either an image, an audio, a video, a vCard, a vCalendar, or a combination of an image, an audio, a vCard, and a vCalendar file. +* - MMS attachments cannot contain a video in combination with an image or an audio file. * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_MESSAGE; @@ -138,9 +139,9 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_MESSAGE; * * For more information, see Email Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. -* Instead of this variable, use the literal, L"tizen.email". +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* Instead of this variable, use the literal, L"tizen.email". * @since 2.0 * @endif */ @@ -152,9 +153,9 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_EMAIL; * * For more information, see Media Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. -* Instead of this variable, use the literal, L"tizen.filemanager" or L"tizen.gallery". +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* Instead of this variable, use the literal, L"tizen.filemanager", or L"tizen.gallery". * @since 2.0 * @endif */ @@ -166,8 +167,8 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_MEDIA; * * For more information, see Image Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.imageviewer". * @since 2.0 * @endif @@ -180,8 +181,8 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_IMAGE; * * For more information, see Video Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.videoplayer". * @since 2.0 * @endif @@ -194,10 +195,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_VIDEO; * * For more information, see Audio Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.musicplayer". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_AUDIO; @@ -208,10 +209,11 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_AUDIO; * * For more information, see Browser Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.internet". -* @since 2.0 +* @since 2.0 +* @privlevel public * @privilege %http://tizen.org/privilege/web.service * @endif */ @@ -223,8 +225,8 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_BROWSER; * * For more information, see Camera Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.camera". * @since 2.0 * @endif @@ -237,10 +239,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_CAMERA; * * For more information, see Bluetooth Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.bluetooth". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_BT; @@ -251,8 +253,8 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_BT; * * For more information, see Settings Application Control. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.settings". * @since 2.0 * @endif @@ -265,10 +267,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_SETTINGS; * * For more information, see Contact Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.contacts". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CONTACT; @@ -279,7 +281,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CONTACT; * * For more information, see Certificate Manager Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.certificatemanager". * @since 2.0 @@ -293,9 +295,9 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CERTIFICATE_MA * * For more information, see Calendar Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. -* Instead of this variable, use the literal, L"tizen.calendar" or L"tizen.events". +* Instead of this variable, use the literal, L"tizen.calendar". * @since 2.0 * @endif */ @@ -308,10 +310,11 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CALENDAR; * * For more information, see Call Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.phone". -* @since 2.0 +* @since 2.0 +* @privlevel public * @privilege %http://tizen.org/privilege/systeminfo * * @remarks Privilege is required to use this application control. @@ -325,14 +328,14 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CALL; * * For more information, see Message Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.messages". -* @since 2.0 +* @since 2.0 * -* @remarks An MMS attachment may contain either an image, audio, video, vCard, vCalendar or a combination of an image, audio, vCard, and vCalendar files. @n -* MMS attachments cannot contain a video in combination with an image or an audio file. @n -* From Tizen 2.0, the CC and BCC recipients are merged with the TO recipients when launching the MMS app control. +* @remarks An MMS attachment may contain either an image, an audio, a video, a vCard, a vCalendar, or a combination of an image, an audio, a vCard, and a vCalendar file. @n +* MMS attachments cannot contain a video in combination with an image or an audio file. @n +* From %Tizen 2.0, the CC and BCC recipients are merged with the TO recipients while launching the MMS application control. * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_MESSAGE; @@ -343,10 +346,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_MESSAGE; * * For more information, see Email Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.email". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_EMAIL; @@ -357,9 +360,9 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_EMAIL; * * For more information, see Media Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. -* Instead of this variable, use the literal, L"tizen.filemanager" or L"tizen.gallery". +* Instead of this variable, use the literal, L"tizen.filemanager", or L"tizen.gallery". * @since 2.0 * @endif */ @@ -371,22 +374,22 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_MEDIA; * * For more information, see Image Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.imageviewer". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_IMAGE; -/* +/** * @if OSPDEPREC -* The ImageCrop application control provider ID @n +* The Image Editor %AppControl provider ID @n * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in a future release. * use the literal, L"tizen.imageeditor", instead of this variable. -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_IMAGE_EDITOR; @@ -397,7 +400,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_IMAGE_EDITOR; * * For more information, see Video Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.videoplayer". * @since 2.0 @@ -411,10 +414,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_VIDEO; * * For more information, see Audio Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.musicplayer". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_AUDIO; @@ -425,10 +428,11 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_AUDIO; * * For more information, see Browser Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.internet". -* @since 2.0 +* @since 2.0 +* @privlevel public * @privilege %http://tizen.org/privilege/web.service * * @remarks Privilege is required to use this application control. @@ -442,10 +446,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_BROWSER; * * For more information, see Camera Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.camera". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CAMERA; @@ -456,12 +460,12 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_CAMERA; * * For more information, see Bluetooth Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.bluetooth". -* @since 2.0 +* @since 2.0 * -* @remarks Bluetooth functionality cannot be tested on the Emulator. +* @remarks Bluetooth functionality cannot be tested on the Emulator. * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_BLUETOOTH; @@ -472,7 +476,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_BLUETOOTH; * * For more information, see Settings Application Control. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"tizen.settings". * @since 2.0 @@ -485,8 +489,8 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_PROVIDER_SETTINGS; * Operation Add. @n * Adds an application item. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/add". * @since 2.0 * @endif @@ -496,12 +500,12 @@ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_ADD; /** * @if OSPDEPREC * Operation Pick. @n -* Picks some application item(s). +* Picks an application item(s). * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/pick". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_PICK; @@ -511,10 +515,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_PICK; * Operation Edit. @n * Edits an application item. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/edit". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_EDIT; @@ -524,10 +528,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_EDIT; * Operation View. @n * Shows the application content. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/view". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_VIEW; @@ -537,10 +541,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_VIEW; * Operation Play. @n * Plays the application content. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/view". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_PLAY; @@ -550,10 +554,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_PLAY; * Operation Default. @n * * Uses the default operation specific to the application control. -* An application control can export its functionality using an operation. If the application control exports only one operation, OPERATION_DEFAULT can act as an alias for the operation. +* An application control can export its functionality using an operation. If the application control exports only one operation, ::OPERATION_DEFAULT can act as the alias for that operation. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/main". * @since 2.0 * @endif @@ -564,8 +568,8 @@ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_DEFAULT; * @if OSPDEPREC * Operation Capture. * -* @brief [Deprecated] -* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. +* @brief [Deprecated] +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/createcontent". * @since 2.0 * @endif @@ -578,10 +582,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String OPERATION_CAPTURE; * Operation Add. @n * Adds an application item. * -* @brief [Deprecated] +* @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/add". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_ADD; @@ -640,7 +644,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_CONFIGURE; * Operation Default. @n * * Uses the default operation specific to the application control. -* An application control can export its functionality using an operation. If the application control exports only one operation, OPERATION_DEFAULT can act as an alias for the operation. +* An application control can export its functionality using an operation. If the application control exports only one operation, ::OPERATION_DEFAULT can act as an alias for that operation. * * @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. @@ -680,12 +684,12 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_EDIT; * @if OSPDEPREC * Operation Main. @n * -* All the application exports the implicit %AppControl with %APPCONTROL_OPERATION_MAIN operation. +* All the applications export the implicit %AppControl with the %APPCONTROL_OPERATION_MAIN operation. * * @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/main". -* @since 2.0 +* @since 2.0 * @endif */ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_MAIN; @@ -693,10 +697,10 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_MAIN; /** * @if OSPDEPREC * Operation Pick. @n -* Picks some application item(s). +* Picks an application item(s). * * @brief [Deprecated] -* @deprecated This variable is providyed only for backward compatibility and will be deleted in the near future. +* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. * Instead of this variable, use the literal, L"http://tizen.org/appcontrol/operation/pick". * @since 2.0 * @endif @@ -719,7 +723,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_PLAY; /** * @if OSPDEPREC * Operation Record. @n -* Records the content. +* Records the application content. * * @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. @@ -732,7 +736,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_RECORD; /** * @if OSPDEPREC * Operation Share. @n -* Shares the contents. +* Shares the application content. * * @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. @@ -758,7 +762,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_VIEW; /** * @if OSPDEPREC * Operation Crop. @n -* Shows image with the crop rectangle. +* Shows the image with the crop rectangle. * * @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. @@ -770,7 +774,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_OPERATION_CROP; /** * @if OSPDEPREC - * Not specified category. + * No specified category. * * @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. @@ -870,7 +874,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_CATEGORY_EMAIL; /** * @if OSPDEPREC * The media category. @n - * Specifying App::APPCONTROL_CATEGORY_MEDIA is equivalent to specifying all the App::APPCONTROL_CATEGORY_AUDIO, + * Specifying %APPCONTROL_CATEGORY_MEDIA is equivalent to specifying the App::APPCONTROL_CATEGORY_AUDIO, * App::APPCONTROL_CATEGORY_IMAGE, and App::APPCONTROL_CATEGORY_VIDEO categories. * * @brief [Deprecated] @@ -970,7 +974,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_CATEGORY_VIDEO; /** * @if OSPDEPREC - * The complete URI handling category corresponding to AppManager::StartAppControl(). + * The complete URI handling category corresponding to the AppManager::StartAppControl() method. * * @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. @@ -1003,7 +1007,7 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_RESULT_FAILED; /** * @if OSPDEPREC - * The %AppControl operation is canceled. + * The %AppControl operation is cancelled. * * @brief [Deprecated] * @deprecated This variable is provided only for backward compatibility and will be deleted in the near future. @@ -1028,9 +1032,9 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_RESULT_TERMINATED; * @brief This class represents the application control behavior. * @since 2.0 * -* @final This class is not intended for extension. +* @final This class is not intended for extension. * -* The %AppControl class represents the application control behavior that provides a standard mechanism for using specific operations exported by other applications. +* The %AppControl class represents the application control behavior that provides a standard mechanism for using specific operations exported by other applications. * * For more information on the class features, see Application Controls. * @@ -1040,27 +1044,18 @@ _OSP_EXPORT_ extern const Tizen::Base::String APPCONTROL_RESULT_TERMINATED; * * * @code -* -* using namespace Tizen::Base::Collection; * using namespace Tizen::App; * * void -* MyAppClass::AppControlCallSample(void) +* MyAppClass::AppControlDialSample(void) * { -* HashMap extraData; -* String telKey = L"tel"; -* String telVal = L"1234567890"; -* String typeKey = L"type"; -* String typeVal = L"voice"; * -* extraData.Construct(); -* extraData.Add(&telKey, &telVal); -* extraData.Add(&typeKey, &typeVal); +* String telUri = L"tel:12345678900"; * -* AppControl* pAc = AppManager::FindAppControlN(L"tizen.phone", L"http://tizen.org/appcontrol/operation/call"); +* AppControl* pAc = AppManager::FindAppControlN(L"tizen.phone", L"http://tizen.org/appcontrol/operation/dial"); * if(pAc) * { -* pAc->Start(null, null, &extraData, null); +* pAc->Start(&telUri, null, null, null); * delete pAc; * } * } @@ -1089,27 +1084,25 @@ public: * IAppControlResponseListener due to lack of argument capability. @n * Instead of using this method, use Start(). * @since 2.0 + * @privlevel public * @privilege %http://tizen.org/privilege/application.launch * * @return An error code - * @param[in] pDataList The data list to deliver to the resolved application control @n - * The maximum size of the list is 4096 bytes. - * @param[in] pListener The application control callback listener @n - * Some application controls need to get the callback result by implementing the IAppControlEventListener interface. + * @param[in] pDataList The data list to deliver to the resolved application control @n + * The maximum size of the list is 4096 bytes. + * @param[in] pListener The application control callback listener @n + * Some application controls get the callback result by implementing the IAppControlEventListener interface. * @exception E_SUCCESS The method is successful. * @exception E_MAX_EXCEEDED The size of @c pDataList has exceeded the maximum limit. - * @exception E_OBJ_NOT_FOUND The target application control resource is not found. - * @exception E_IN_PROGRESS The application control is in progress: @n - * - The application has already started an %AppControl. @n + * @exception E_OBJ_NOT_FOUND The target application control resource has not been found. + * @exception E_IN_PROGRESS The application control is in progress: + * - The application has already started an %AppControl. * - The target application has already started. * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method. * @exception E_SYSTEM The method cannot proceed due to a severe system error. - * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate of target application. @b Since: @b 2.1 - * @remarks If the IAppControlEventListener instance (@c pListener) needs to get the - * callback result for an application control, it must be valid till - * IAppControlEventListener::OnAppControlCompleted() is invoked. - * For example, a form object listener must not be deleted before the - * system invokes %IAppControlEventListener::OnAppControlCompleted(). + * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate as that of the target application. @b Since: @b 2.1 + * @remarks If the specified @c pListener needs to get the callback result for an application control, it must be valid till IAppControlEventListener::OnAppControlCompleted() is invoked. @n + * For example, a form object listener must not be deleted before the system invokes %IAppControlEventListener::OnAppControlCompleted(). * @see AppManager::FindAppControlN() * @see AppManager::FindAppControlsN() * @endif @@ -1117,30 +1110,31 @@ public: result Start(const Tizen::Base::Collection::IList* pDataList, IAppControlEventListener* pListener); /** - * Starts the found application control. @n - * Once the found application starts, the calling application goes to the background and the found + * Starts the located application control. @n + * Once the located application starts, the calling application goes to the background and the located * application is displayed. * * @since 2.0 + * @privlevel public * @privilege %http://tizen.org/privilege/application.launch * * @return An error code - * @param[in] pUriData A pointer to the URI data - * @param[in] pDataType A pointer to the MIME type (RFC 2046) data - * @param[in] pExtraData A pointer to an argument map of key and value pair where the key is of type String and the value is of type String or of type ArrayList of String to deliver to the resolved application @n - * The maximum size is 16 kilo bytes. - * @param[in] pListener The application control callback listener @n - * Some application need to get the result by implementing the IAppControlResponseListener interface. + * @param[in] pUriData A pointer to the URI data + * @param[in] pDataType A pointer to the MIME type (RFC 2046) data + * @param[in] pExtraData A pointer to the argument map of the key and value pair, where the key is of type Tizen::Base::String and the value is of type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String, which is delivered to the resolved application @n + * The maximum size is 16 kilo bytes. + * @param[in] pListener The application control callback listener @n + * Some applications get the result by implementing the IAppControlResponseListener interface. * @exception E_SUCCESS The method is successful. * @exception E_MAX_EXCEEDED The size of @c pExtraData has exceeded the maximum limit. - * @exception E_OBJ_NOT_FOUND The target application control is not found. + * @exception E_OBJ_NOT_FOUND The target application control has not been found. * @exception E_IN_PROGRESS The application control is in progress: @n * - The application has already started an %AppControl. * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method. * @exception E_SYSTEM The method cannot proceed due to a severe system error. - * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate of target application. @b Since: @b 2.1 - * @remarks If the calling application needs to get some result for application control, - * it must be valid till IAppControlResponseListener::OnAppControlCompleteResponseReceived() is invoked. + * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate as that of the target application. @b Since: @b 2.1 + * @remarks If the calling application needs to get some result for the application control, + * it must be valid till IAppControlResponseListener::OnAppControlCompleteResponseReceived() is invoked. @n * For example, a form object listener must not be deleted before the * system invokes %IAppControlResponseListener::OnAppControlCompleteResponseReceived(). * @see AppManager::FindAppControlN() @@ -1149,32 +1143,32 @@ public: result Start(const Tizen::Base::String* pUriData, const Tizen::Base::String* pDataType, const Tizen::Base::Collection::IMap* pExtraData, IAppControlResponseListener* pListener); /** - * Finds the matching application control with given operation ID, URI pattern, data type, and category and - * starts the found one. @n - * If there are more than one application controls found, then the selection is shown for user and the one that the user selects is started. + * Finds the matching application control with the given operation ID, URI pattern, data type, and category, after which it + * starts the found application control. @n + * If more than one application control is found, then user selection is enabled and the one selected by the user is started. * When the found application control is started, the URI pattern, MIME type, and extra data is delivered using IAppControlProviderEventListener. * * @since 2.0 + * @privlevel public * @privilege %http://tizen.org/privilege/application.launch * * @return An error code - * @param[in] operationId The operation ID - * @param[in] pUriPattern A URI pattern which is used for application control resolution and is delivered as the argument - * @param[in] pDataType The MIME type (RFC 2046) or file extension @n - * The '.' prefix must be used when specifying the file extension. - * @param[in] pCategory The application control category - * @param[in] pExtraData A pointer to an argument map of key and value pair where the key is of type Tizen::Base::String and the value is of - * type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String to deliver to - * the resolved application @n - * The maximum size is 16 kilo bytes. - * @param[in] pListener A listener that gets notified - * @exception E_SUCCESS The method is successful. - * @exception E_MAX_EXCEEDED The size of @c pDataList has exceeded the maximum limit. - * @exception E_OBJ_NOT_FOUND The application control is not found. - * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method. + * @param[in] operationId The operation ID + * @param[in] pUriPattern The URI pattern that is used for the application control resolution which is delivered as an argument + * @param[in] pDataType The MIME type (RFC 2046) or file extension @n + * The '.' prefix must be used while specifying the file extension. + * @param[in] pCategory The application control category + * @param[in] pExtraData A pointer to the argument map of the key and value pair, where the key is of type Tizen::Base::String and the value is of + * type %Tizen::Base::String or of type Tizen::Base::Collection::ArrayList of %Tizen::Base::String which is delivered to + * the resolved application @n + * The maximum size is 16 kilo bytes. + * @param[in] pListener The listener that gets notified + * @exception E_SUCCESS The method is successful. + * @exception E_MAX_EXCEEDED The size of @c pDataList has exceeded the maximum limit. + * @exception E_OBJ_NOT_FOUND The application control has not been found. + * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method. * @exception E_SYSTEM The method cannot proceed due to a severe system error. - * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate of target application. @b Since: @b 2.1 - * @see IAppControlResponseListener + * @exception E_ILLEGAL_ACCESS The application is not signed with the same certificate as that of the target application. @b Since: @b 2.1 */ static result FindAndStart(const Tizen::Base::String& operationId, const Tizen::Base::String* pUriPattern, const Tizen::Base::String* pDataType, const Tizen::Base::String* pCategory, const Tizen::Base::Collection::IMap* pExtraData, IAppControlResponseListener* pListener); @@ -1183,7 +1177,7 @@ public: * * @since 2.0 * - * @param[in] pListener The listener to stop receiving the application control result + * @param[in] pListener The listener to stop from receiving the application control result */ static void StopAppControlResponseListener(IAppControlResponseListener* pListener); @@ -1192,7 +1186,7 @@ public: * * @since 2.0 * - * @return The name of the application providing this %AppControl instance + * @return The name of the application that provides this %AppControl instance */ Tizen::Base::String GetAppName(void) const; @@ -1206,16 +1200,16 @@ public: AppId GetAppId(void) const; /** - * @if OSPDEPREC + * @if OSPDEPREC * Gets the associated application control provider ID. * * @brief [Deprecated] - * @deprecated This method is deprecated because application ID replaced the role of provider ID. @n + * @deprecated This method is deprecated because the application ID has replaced the role of the provider ID. @n * Instead of using this method, use GetAppId(). * @since 2.0 * * @return The application control provider ID - * @endif + * @endif */ Tizen::Base::String GetAppControlProviderId(void) const; @@ -1233,9 +1227,9 @@ public: * * @since 2.0 * - * @return A pointer to the list of application control categories, @n - * else @c null if an error occurs - * @exception E_SUCCESS The method is successful. + * @return A pointer to the list of application control categories, @n + * else @c null if an error occurs + * @exception E_SUCCESS The method is successful. * @exception E_OUT_OF_MEMORY The memory is insufficient. * @exception E_SYSTEM A system error has occurred. * @remarks The specific error code can be accessed using the GetLastResult() method. @@ -1245,16 +1239,19 @@ public: /** * Stops the activated application control. @n - * The %Stop() method works only with the following %AppControls provided by the platform: + * The %Stop() method works only with the following AppControls provided by the platform: * tizen.bluetooth, tizen.calendar, tizen.camera, tizen.certificatemanager, tizen.contacts, * tizen.email, tizen.filemanager, tizen.gallery, tizen.imageviewer, tizen.mmsmessages, and tizen.smsmessages. * * @since 2.0 + * @privlevel public + * @privilege %http://tizen.org/privilege/application.launch * - * @return An error code - * @exception E_SUCCESS The method is successful. - * @exception E_SYSTEM A system error has occurred. - * @exception E_INVALID_OPERATION The application control is not permitted to call this method. + * @return An error code + * @exception E_SUCCESS The method is successful. + * @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method. + * @exception E_SYSTEM A system error has occurred. + * @exception E_INVALID_OPERATION The application control is not permitted to call this method. * @remarks This method is asynchronous. */ result Stop(void);