{
public:
/**
- * The object is not fully constructed after this constructor is called. For full construction, the Construct() method must be called right after calling this constructor.
+ * The object is not fully constructed after this constructor is called.
+ * For full construction, the Construct() method must be called right after calling this constructor.
*
* @since 2.0
*/
virtual ~CallManager(void);
/**
- * Initializes a new instance of this class. @n
- * This is the two phase construction.
+ * Initializes a new instance of %CallManager. @n
+ * This is a two phase construction.
*
- * @since 2.0
- * @feature %http://tizen.org/feature/network.telephony
- * @return An error code
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
- * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
+ * @since 2.0
+ * @feature %http://tizen.org/feature/network.telephony
+ * @return An error code
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
+ * @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @remarks Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
+ * @remarks Before calling this method, check whether the feature is supported by Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
*/
result Construct(void);
/**
- * Initializes a new instance of this class. @n
- * This is the two phase construction.
+ * Initializes a new instance of %CallManager. @n
+ * This is a two phase construction.
*
- * @since 2.0
- * @feature %http://tizen.org/feature/network.telephony
- * @return An error code
- * @param[in] listener The listener for change in status of a call
- * @exception E_SUCCESS The method is successful.
- * @exception E_SYSTEM A system error has occurred.
+ * @since 2.0
+ * @feature %http://tizen.org/feature/network.telephony
+ * @return An error code
+ * @param[in] listener The listener for the change in the call status
+ * @exception E_SUCCESS The method is successful.
+ * @exception E_SYSTEM A system error has occurred.
* @exception E_UNSUPPORTED_OPERATION The Emulator or target device does not support the required feature. @b Since: @b 2.1
* For more information, see <a href="../org.tizen.gettingstarted/html/tizen_overview/application_filtering.htm">Application Filtering</a>.
- * @remarks Before calling this method, check whether the feature is supported by %Tizen::System::SystemInfo::GetValue() methods.
+ * @remarks Before calling this method, check whether the feature is supported by Tizen::System::SystemInfo::GetValue(const Tizen::Base::String&, bool&).
*/
result Construct(ITelephonyCallEventListener& listener);
* @privlevel platform
* @privilege %http://tizen.org/privilege/callforward
*
- * @return An error code
+ * @return An error code
* @param[in] pListener An ITelephonyCallForwardListener instance @n
- * The parameter can be set to @c null to remove listener.
+ * The parameter can be set to @c null to remove the listener.
* @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.
result SetCallForwardListener(ITelephonyCallForwardListener* pListener);
/**
- * Requests call forwarding with the specified number. @n
- * The %RequestCallForward() method sends the request to the network, and receives the response asynchronously.
+ * Requests call forwarding to the specified number. @n
+ * The %RequestCallForward() method sends a request to the network, and receives the response asynchronously.
*
* @since 2.0
*
* @privlevel platform
* @privilege %http://tizen.org/privilege/callforward
*
- * @return An error code
- * @param[in] phoneNumber The phone number for call forwarding
+ * @return An error code
+ * @param[in] phoneNumber The phone number for call forwarding
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE This instance is in an invalid state.
- * @exception E_INVALID_FORMAT The specified phone number is in an invalid format.
+ * @exception E_INVALID_FORMAT The specified @c phoneNumber is in an invalid format.
* @exception E_IN_PROGRESS The previous request is in progress.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_NETWORK_UNAVAILABLE The operation has failed because the device is in the offline mode.
- * @exception E_SERVICE_UNAVAILABLE The operation has failed because the device is out of the coverage area or in the emergency mode.
+ * @exception E_SERVICE_UNAVAILABLE The operation has failed because the device is either out of the coverage area or in the emergency mode.
* @exception E_SYSTEM A system error has occurred.
- * @remarks The call will be forwarded unconditionally. Voice call only. @n
- * The phone number can start with plus(+) and the remaining part must be number.
+ * @remarks
+ * - This method forwards the call unconditionally and supports only voice call. @n
+ * - The phone number must start with a plus(+) sign and the remaining part must be the number.
* @see ITelephonyCallForwardListener::OnTelephonyCallForwardResponseReceived()
*/
result RequestCallForward(const Tizen::Base::String& phoneNumber);
* @privlevel platform
* @privilege %http://tizen.org/privilege/callforward
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_STATE This instance is in an invalid state.
* @exception E_IN_PROGRESS The previous request is in progress.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_NETWORK_UNAVAILABLE The operation has failed because the device is in the offline mode.
- * @exception E_SERVICE_UNAVAILABLE The operation has failed because the device is out of the coverage area or in the emergency mode.
+ * @exception E_SERVICE_UNAVAILABLE The operation has failed because the device is either out of the coverage area or in the emergency mode.
* @exception E_SYSTEM A system error has occurred.
* @see ITelephonyCallForwardListener::OnTelephonyCallForwardStopped()
*/
result StopCallForward(void);
/**
- * Gets the phone number to which the call must be forwarded.
+ * Gets the phone number to which the call is forwarded.
*
- * @since 2.0
+ * @since 2.0
*
* @privlevel platform
* @privilege %http://tizen.org/privilege/callforward
*
- * @return An error code
+ * @return An error code
* @exception E_SUCCESS The method is successful.
* @exception E_IN_PROGRESS The previous request is in progress.
* @exception E_PRIVILEGE_DENIED The application does not have the privilege to call this method.
* @exception E_NETWORK_UNAVAILABLE The operation has failed because the device is in the offline mode.
- * @exception E_SERVICE_UNAVAILABLE The operation has failed because the device is out of the coverage area or in the emergency mode.
+ * @exception E_SERVICE_UNAVAILABLE The operation has failed because the device is either out of the coverage area or in the emergency mode.
* @exception E_SYSTEM A system error has occurred.
- * @see ITelephonyCallForwardListener::OnTelephonyCallForwardNumberReceived
+ * @see ITelephonyCallForwardListener::OnTelephonyCallForwardNumberReceived()
*/
result GetCallForwardNumber(void) const;
/**
- * Gets the call type of the current call.
+ * Gets the current call type.
*
* @since 2.0
*
CallType GetCurrentCallType(void) const;
/**
- * Gets the call status of the current call.
+ * Gets the current call status.
*
* @since 2.0
*