Init Tizen 2.2.1
[framework/osp/web.git] / inc / FWebCtrlWebSetting.h
old mode 100755 (executable)
new mode 100644 (file)
index ae3531c..8ca8e07
@@ -59,8 +59,8 @@ enum CacheMode
 enum CertificateErrorHandlingMode
 {
        WEB_CERTIFICATE_ERROR_HANDLING_MODE_USER_CONFIRM,            /**< The web certificate error handling mode: The confirm popup is displayed to get the user confirmation */
-       WEB_CERTIFICATE_ERROR_HANDLING_MODE_CANCEL,                 /**< The web certificate error handling mode: The confirm popup is not displayed and the request is canceled */
-       WEB_CERTIFICATE_ERROR_HANDLING_MODE_CONTINUE                    /**< The web certificate error handling mode: The confirm popup is not displayed and the request proceeds */
+       WEB_CERTIFICATE_ERROR_HANDLING_MODE_CANCEL,                  /**< The web certificate error handling mode: The confirm popup is not displayed and the request is cancelled */
+       WEB_CERTIFICATE_ERROR_HANDLING_MODE_CONTINUE                 /**< The web certificate error handling mode: The confirm popup is not displayed and the request proceeds */
 };
 
 /**
@@ -104,8 +104,14 @@ public:
         * Sets a cache control strategy for a %Web control.
         *
         * @since               2.0
+        * @privlevel   public
+        * @privilege   %http://tizen.org/privilege/web.service
         *
-        * @param[in]   mode                    A cache mode
+        * @param[in]   mode                                    The cache mode
+        * @exception   E_SUCCESS                               The method is successful.
+        * @exception   E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
+        * @exception   E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
+        * @remarks             The specific error code can be accessed using the GetLastResult() method.
         */
        void SetCacheControl(CacheMode mode);
 
@@ -133,7 +139,7 @@ public:
         * @since               2.0
         *
         * @param[in]   enable                  Set to @c true if the %Web control uses JavaScript, @n
-        *                                                                      else @c false
+        *                                                              else @c false
         */
        void SetJavascriptEnabled(bool enable);
 
@@ -142,8 +148,8 @@ public:
         *
         * @since               2.0
         *
-        * @param[in]   enable                  Set to @c true if the %Web control must load images included in the content, @n
-        *                                                                      else @c false
+        * @param[in]   enable                  Set to @c true if the %Web control loads images included in the content, @n
+        *                                                              else @c false
         */
        void SetAutoImageLoadEnabled(bool enable);
 
@@ -152,7 +158,7 @@ public:
         *
         * @since               2.0
         *
-        * @param[in]   inputStyle              The input style of keypad
+        * @param[in]   inputStyle              The input style of the keypad
         * @remarks             If an application sets the input style to @c INPUT_STYLE_OVERLAY, the application must implement IWebKeypadEventListener to rearrange the layout of the current Form.
         *
         */
@@ -160,7 +166,7 @@ public:
 
        /**
         * Gets the value of the cache control strategy for a %Web control. @n
-        * The default is @c WEB_CACHE_VALIDATED.
+        * The default value is @c WEB_CACHE_VALIDATED.
         *
         * @since               2.0
         *
@@ -170,7 +176,7 @@ public:
 
        /**
         * Gets the font size of the content. @n
-        * The default is @c 17.
+        * The default size is @c 16.
         *
         * @since               2.0
         *
@@ -180,7 +186,7 @@ public:
 
        /**
         * Gets the text encoding of the content of a %Web control. @n
-        * The default is UTF-8.
+        * The default encoding is UTF-8.
         *
         * @since               2.0
         *
@@ -190,57 +196,64 @@ public:
 
        /**
         * Checks whether a %Web control uses JavaScript. @n
-        * The default is true.
+        * The default value is @c true.
         *
         * @since               2.0
         *
         * @return              @c true if JavaScript is enabled and used by a %Web control, @n
-        *                                      else @c false
+        *                              else @c false
         */
        bool IsJavascriptEnabled(void) const;
 
        /**
         * Checks whether a %Web control loads images included in the content automatically. @n
-        * The default is true.
+        * The default value is @c true.
         *
         * @since               2.0
         *
         * @return              @c true if auto image loading is enabled, @n
-        *                                      else @c false
+        *                              else @c false
         */
        bool IsAutoImageLoadEnabled(void) const;
 
        /**
         * Gets the input style of the keypad, which is displayed for the <input> or <textarea> tag. @n
-        * The default is @c INPUT_STYLE_FULLSCREEN.
+        * The default style is @c INPUT_STYLE_FULLSCREEN.
         *
         * @since               2.0
         *
-        * @return              The input style of keypad
+        * @return              The input style of the keypad
         */
        Tizen::Ui::Controls::InputStyle GetInputStyle(void) const;
 
        /**
-        * Sets a certificate error handling mode for a %Web control.
+        * Sets the certificate error handling mode for a %Web control.
         *
         * @since               2.0
         *
-        * @param[in]   mode                    A certificate error handling mode
+        * @privlevel   public
+        * @privilege   %http://tizen.org/privilege/web.service
+        *
+        * @param[in]   mode                                    The certificate error handling mode
+        * @exception   E_SUCCESS                               The method is successful.
+        * @exception   E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
+        * @exception   E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
+        * @remarks             The specific error code can be accessed using the GetLastResult() method.
         */
        void SetCertificateErrorHandlingMode(CertificateErrorHandlingMode mode);
 
        /**
         * Gets the value of the certificate error handling mode for a %Web control. @n
-        * The default is @c WEB_CERTIFICATE_ERROR_HANDLING_MODE_USER_CONFIRM.
+        * The default value is @c WEB_CERTIFICATE_ERROR_HANDLING_MODE_USER_CONFIRM.
         *
         * @since               2.0
         *
-        * @return              A certificate error handling mode
+        * @return              The certificate error handling mode
         */
        CertificateErrorHandlingMode GetCertificateErrorHandlingMode(void) const;
 
        /**
-        * Sets a user agent for a %Web control.
+        * Sets the user agent for a %Web control.
         *
         * @since               2.0
         *
@@ -249,116 +262,134 @@ public:
        void SetUserAgent(const Tizen::Base::String& agent);
 
        /**
-        * Gets a value of user agent for a %Web control.
+        * Gets the value of the user agent for a %Web control.
         *
         * @since               2.0
         *
-        * @return              The value of user agent
+        * @return              The value of the user agent
         */
        Tizen::Base::String GetUserAgent(void) const;
 
        /**
-        * Decides if a %Web control loads the resized contents to fit width automatically.
+        * Decides if a %Web control loads the resized contents to fit the width automatically.
         *
         * @since               2.0
         *
-        * @param[in]   enable                  Set to @c true if the %Web control should load contents to fit width, @n
-        *                                                                      else @c false
+        * @param[in]   enable                  Set to @c true if the %Web control should load contents to fit the width, @n
+        *                                                              else @c false
         */
        void SetAutoFittingEnabled(bool enable);
 
        /**
-        * Checks whether a %Web control loads the resize contents to fit width. @n
-        * The default is true.
+        * Checks whether a %Web control loads the resized contents to fit the width. @n
+        * The default value is @c true.
         *
         * @since               2.0
         *
         * @return              @c true if auto fitting is enabled, @n
-        *                                      else @c false
+        *                              else @c false
         */
        bool IsAutoFittingEnabled(void) const;
 
        /**
-        * Decides if a %Web control allows JavaScript to open new window.
+        * Decides if a %Web control allows JavaScript to open new window.
         *
         * @since               2.0
         *
-        * @param[in]   enable                  Set to @c true if the %Web control should allow JavaScript to open new window, @n
-        *                                                                      else @c false
+        * @param[in]   enable                  Set to @c true if the %Web control should allow JavaScript to open new window, @n
+        *                                                              else @c false
         */
        void SetJavaScriptPopupEnabled(bool enable);
 
        /**
-        * Checks whether a %Web control allows JavaScript to open new window. Returns true if opening new window by JavaScript is enabled. @n
-        * The default is true.
+        * Checks whether a %Web control allows JavaScript to open a new window.
+        * The default value is @c true.
         *
         * @since               2.0
         *
-        * @return              @c true if opening new window by JavaScript is enabled, @n
-        *                                      else @c false
+        * @return              @c true if opening new window by JavaScript is enabled, @n
+        *                              else @c false
         */
        bool IsJavaScriptPopupEnabled(void) const;
 
        /**
-        * Decides if a %Web control supports html5 geolocation feature.
+        * Decides if a %Web control supports the HTML5 geolocation feature.
         *
         * @since               2.0
+        * @privlevel   public
+        * @privilege   %http://tizen.org/privilege/web.service
         *
-        * @param[in]   enable                  Set to @c true if the %Web control should support html5 geolocation feature, @n
-        *                                                                      else @c false
+        * @param[in]   enable                                  Set to @c true if the %Web control should support the HTML5 geolocation feature, @n
+        *                                                                              else @c false
+        * @exception   E_SUCCESS                               The method is successful.
+        * @exception   E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
+        * @exception   E_USER_NOT_CONSENTED    The user has blocked the application from calling this method. @b Since: @b 2.1
+        * @remarks             The specific error code can be accessed using the GetLastResult() method.
         */
        void SetGeolocationEnabled(bool enable);
 
        /**
-        * Checks whether a %Web control supports html5 geolocation feature. Returns true if html5 geolocation feature is enabled. @n
-        * The default is true.
+        * Checks whether a %Web control supports the HTML5 geolocation feature.
+        * The default value is @c true.
         *
         * @since               2.0
         *
-        * @return              @c true if html5 geolocation feature is enabled, @n
-        *                                      else @c false
+        * @return              @c true if the HTML5 geolocation feature is enabled, @n
+        *                              else @c false
         */
        bool IsGeolocationEnabled(void) const;
 
        /**
-        * Decides if a %Web control saves form data automatically and supports autocomplete feature.
+        * Decides if a %Web control saves the form data automatically and supports the autocomplete feature.
         *
         * @since               2.1
+        * @privlevel   public
+        * @privilege   %http://tizen.org/privilege/web.service
         *
-        * @param[in]   enable                  Set to @c true if the %Web control should save form data automatically and supports autocomplete feature, @n
-        *                                                                      else @c false
+        * @param[in]   enable                                  Set to @c true if the %Web control should save the form data automatically and supports the autocomplete feature, @n
+        *                                                                              else @c false
+        * @exception   E_SUCCESS                               The method is successful.
+        * @exception   E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
+        * @exception   E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+        * @remarks             The specific error code can be accessed using the GetLastResult() method.
         */
        void SetAutoFormDataShowEnabled(bool enable);
 
        /**
-        * Checks whether %Web control saves form data automatically and supports autocomplete feature. Returns true if those are enabled. @n
-        * The default is true.
+        * Checks whether a %Web control saves the form data automatically and supports the autocomplete feature.
+        * The default value is @c true.
         *
         * @since               2.1
         *
-        * @return              @c true if saving form data and autocomplete feature are enabled, @n
-        *                                      else @c false
+        * @return              @c true if the %Web control saves the form data and enables the autocomplete feature, @n
+        *                              else @c false
         */
        bool IsAutoFormDataShowEnabled(void) const;
 
        /**
-        * Decides if a %Web control saves id/password for login form automatically and supports autofill feature.
+        * Decides if a %Web control saves the ID/password for a login form automatically and supports the autofill feature.
         * 
         * @since               2.1
+        * @privlevel   public
+        * @privilege   %http://tizen.org/privilege/web.service
         *
-        * @param[in]   enable                  Set to @c true if the %Web control should save login id/password automatically and supports autofill feature, @n
-        *                                                                      else @c false
+        * @param[in]   enable                                  Set to @c true if the %Web control should save the login ID/password automatically and supports the autofill feature, @n
+        *                                                                              else @c false
+        * @exception   E_SUCCESS                               The method is successful.
+        * @exception   E_PRIVILEGE_DENIED              The application does not have the privilege to call this method.
+        * @exception   E_USER_NOT_CONSENTED    The user has blocked the application from calling this method.
+        * @remarks             The specific error code can be accessed using the GetLastResult() method.
         */
        void SetAutoLoginFormFillEnabled(bool enable);
 
        /**
-        * Checks whether %Web control saves id/password for login form automatically and supports autofill feature. Returns true if those are enabled. @n
-        * The default is true.
+        * Checks whether a %Web control saves the ID/password for a login form automatically and supports the autofill feature.
+        * The default value is @c true.
         *
         * @since               2.1
         *
-        * @return              @c true if saving id/password for login form and autofill feature are enabled, @n
-        *                                      else @c false
+        * @return              @c true if the %Web control saves the ID/password for a login form and enables the autofill feature, @n
+        *                              else @c false
         */
        bool IsAutoLoginFormFillEnabled(void) const;
 
@@ -377,19 +408,19 @@ public:
         * @since               2.0
         *
         * @return              @c true if the two instances match, @n
-        *                                      else @c false
+        *                              else @c false
         * @param[in]   obj                             The object to compare with the current instance
         * @remarks             This method returns @c true if and only if the two instances contain the same elements.
         * @see                 Tizen::Base::Object::Equals()
         */
-       virtual bool Equals(const Object& obj) const;
+       virtual bool Equals(const Tizen::Base::Object& obj) const;
 
        /**
         * Copying of objects using this copy assignment operator is allowed. 
         *
         * @since               2.0
         *
-        * @param[in]   setting                 The instance of the %WebSetting class to assign from
+        * @param[in]   setting                 The instance of the %WebSetting class to assign
         */
        WebSetting& operator =(const WebSetting& setting);