//
-// Open Service Platform
// Copyright (c) 2012 Samsung Electronics Co., Ltd.
//
// Licensed under the Apache License, Version 2.0 (the License);
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_contact.htm">Contact Application Control</a>.
*
* @brief <i> [Deprecated] </i>
-* @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
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_calendar.htm">Calendar Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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
*/
* @if OSPDEPREC
* The Todo %AppControl ID.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This application control provider name is deprecated.
-* @b OPERATION_PICK:
-* @since 2.0
+* @brief <i> [Deprecated] </i>
+* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_call.htm">Call Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @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 <i> [Deprecated] </i>
+* @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
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_call.htm">Call Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @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 <i> [Deprecated] </i>
+* @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.
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_message.htm">Message Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_email.htm">Email Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @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 <i> [Deprecated] </i>
+* @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
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_media.htm">Media Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @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 <i> [Deprecated] </i>
+* @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
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_image.htm">Image Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_video.htm">Video Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_audio.htm">Audio Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_browser.htm">Browser Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_camera.htm">Camera Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_bluetooth.htm">Bluetooth Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_settings.htm">Settings Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_contact.htm">Contact Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_certmgr.htm">Certificate Manager Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_calendar.htm">Calendar Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_call.htm">Call Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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.
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_message.htm">Message Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_email.htm">Email Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_media.htm">Media Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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
*/
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_image.htm">Image Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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 <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_video.htm">Video Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_audio.htm">Audio Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_browser.htm">Browser Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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.
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_camera.htm">Camera Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_bluetooth.htm">Bluetooth Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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;
*
* For more information, see <a href="../org.tizen.native.appprogramming/html/guide/app/appcontrol_settings.htm">Settings Application Control</a>.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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
* Operation Add. @n
* Adds an application item.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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
/**
* @if OSPDEPREC
* Operation Pick. @n
-* Picks some application item(s).
+* Picks an application item(s).
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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;
* Operation Edit. @n
* Edits an application item.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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;
* Operation View. @n
* Shows the application content.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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;
* Operation Play. @n
* Plays the application content.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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;
* 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 <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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
* @if OSPDEPREC
* Operation Capture.
*
-* @brief <i> [Deprecated] </i>
-* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
+* @brief <i> [Deprecated] </i>
+* @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
* Operation Add. @n
* Adds an application item.
*
-* @brief <i> [Deprecated] </i>
+* @brief <i> [Deprecated] </i>
* @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;
* 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 <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* @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 <i> [Deprecated] </i>
* @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;
/**
* @if OSPDEPREC
* Operation Pick. @n
-* Picks some application item(s).
+* Picks an application item(s).
*
* @brief <i> [Deprecated] </i>
-* @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
/**
* @if OSPDEPREC
* Operation Record. @n
-* Records the content.
+* Records the application content.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @if OSPDEPREC
* Operation Share. @n
-* Shares the contents.
+* Shares the application content.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @if OSPDEPREC
* Operation Crop. @n
-* Shows image with the crop rectangle.
+* Shows the image with the crop rectangle.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @if OSPDEPREC
- * Not specified category.
+ * No specified category.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @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 <i> [Deprecated] </i>
/**
* @if OSPDEPREC
- * The complete URI handling category corresponding to AppManager::StartAppControl().
+ * The complete URI handling category corresponding to the AppManager::StartAppControl() method.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
/**
* @if OSPDEPREC
- * The %AppControl operation is canceled.
+ * The %AppControl operation is cancelled.
*
* @brief <i> [Deprecated] </i>
* @deprecated This variable is provided only for backward compatibility and will be deleted in the near future.
* @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 <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
*
*
*
* @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;
* }
* }
* 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
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 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()
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 String and the value is of type 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);
*
* @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);
*
* @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;
AppId GetAppId(void) const;
/**
- * @if OSPDEPREC
+ * @if OSPDEPREC
* Gets the associated application control provider ID.
*
* @brief <i> [Deprecated] </i>
- * @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;
*
* @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.
/**
* Stops the activated application control. @n
- * The %Stop() method works only with the following %AppControls provided by the platform:
- * App::APPCONTROL_PROVIDER_AUDIO, App::APPCONTROL_PROVIDER_BLUETOOTH, @n
- * App::APPCONTROL_PROVIDER_CALENDAR, App::APPCONTROL_PROVIDER_CAMERA, @n
- * App::APPCONTROL_PROVIDER_CERTIFICATE_MANAGER, App::APPCONTROL_PROVIDER_CONTACT, @n
- * App::APPCONTROL_PROVIDER_EMAIL, App::APPCONTROL_PROVIDER_IMAGE, @n
- * App::APPCONTROL_PROVIDER_MEDIA, App::APPCONTROL_PROVIDER_MESSAGE, @n
- * and App::APPCONTROL_PROVIDER_VIDEO.
+ * 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);