Merge "[WebView] Minor javadoc fix for WebSettings." into qt-dev am: 63c65616ae am: e4cbd008c0 (e2e66d2e) · Commits · e / os / android_frameworks_base

core/java/android/webkit/WebSettings.java

+23 −22

Original line number	Diff line number	Diff line
		@@ -193,26 +193,24 @@ public abstract class WebSettings {
		}

		/**
		* Used with {@link #setMixedContentMode}
		*
		* In this mode, the WebView will allow a secure origin to load content from any other origin,
		* even if that origin is insecure. This is the least secure mode of operation for the WebView,
		* and where possible apps should not set this mode.
		*
		* @see #setMixedContentMode
		*/
		public static final int MIXED_CONTENT_ALWAYS_ALLOW = 0;

		/**
		* Used with {@link #setMixedContentMode}
		*
		* In this mode, the WebView will not allow a secure origin to load content from an insecure
		* origin. This is the preferred and most secure mode of operation for the WebView and apps are
		* strongly advised to use this mode.
		*
		* @see #setMixedContentMode
		*/
		public static final int MIXED_CONTENT_NEVER_ALLOW = 1;

		/**
		* Used with {@link #setMixedContentMode}
		*
		* In this mode, the WebView will attempt to be compatible with the approach of a modern web
		* browser with regard to mixed content. Some insecure content may be allowed to be loaded by
		* a secure origin and other types of content will be blocked. The types of content are allowed
		@@ -221,6 +219,8 @@ public abstract class WebSettings {
		* This mode is intended to be used by apps that are not in control of the content that they
		* render but desire to operate in a reasonably secure environment. For highest security, apps
		* are recommended to use {@link #MIXED_CONTENT_NEVER_ALLOW}.
		*
		* @see #setMixedContentMode
		*/
		public static final int MIXED_CONTENT_COMPATIBILITY_MODE = 2;

		@@ -234,30 +234,30 @@ public abstract class WebSettings {
		public @interface ForceDark {}

		/**
		* Used with {@link #setForceDark}
		*
		* Disable force dark, irrespective of the force dark mode of the WebView parent. In this mode,
		* WebView content will always be rendered as-is, regardless of whether native views are being
		* automatically darkened.
		*
		* @see #setForceDark
		*/
		public static final int FORCE_DARK_OFF = 0;

		/**
		* Used with {@link #setForceDark}
		*
		* Enable force dark dependent on the state of the WebView parent view. If the WebView parent
		* view is being automatically force darkened
		* (see: {@link android.view.View#setForceDarkAllowed}), then WebView content will be rendered
		* so as to emulate a dark theme. WebViews that are not attached to the view hierarchy will not
		* be inverted.
		*
		* @see #setForceDark
		*/
		public static final int FORCE_DARK_AUTO = 1;

		/**
		* Used with {@link #setForceDark}
		*
		* Unconditionally enable force dark. In this mode WebView content will always be rendered so
		* as to emulate a dark theme.
		*
		* @see #setForceDark
		*/
		public static final int FORCE_DARK_ON = 2;

		@@ -1471,6 +1471,7 @@ public abstract class WebSettings {
		* Set the force dark mode for this WebView.
		*
		* @param forceDark the force dark mode to set.
		* @see #getForceDark
		*/
		public void setForceDark(@ForceDark int forceDark) {
		// Stub implementation to satisfy Roboelectrc shadows that don't override this yet.
		@@ -1478,10 +1479,10 @@ public abstract class WebSettings {

		/**
		* Get the force dark mode for this WebView.
		*
		* The default force dark mode is {@link #FORCE_DARK_AUTO}
		* The default force dark mode is {@link #FORCE_DARK_AUTO}.
		*
		* @return the currently set force dark mode.
		* @see #setForceDark
		*/
		public @ForceDark int getForceDark() {
		// Stub implementation to satisfy Roboelectrc shadows that don't override this yet.
		@@ -1516,34 +1517,34 @@ public abstract class WebSettings {
		public abstract @MenuItemFlags int getDisabledActionModeMenuItems();

		/**
		* Used with {@link #setDisabledActionModeMenuItems}.
		*
		* No menu items should be disabled.
		*
		* @see #setDisabledActionModeMenuItems
		*/
		public static final int MENU_ITEM_NONE = 0;

		/**
		* Used with {@link #setDisabledActionModeMenuItems}.
		*
		* Disable menu item "Share".
		*
		* @see #setDisabledActionModeMenuItems
		*/
		public static final int MENU_ITEM_SHARE = 1 << 0;

		/**
		* Used with {@link #setDisabledActionModeMenuItems}.
		*
		* Disable menu item "Web Search".
		*
		* @see #setDisabledActionModeMenuItems
		*/
		public static final int MENU_ITEM_WEB_SEARCH = 1 << 1;

		/**
		* Used with {@link #setDisabledActionModeMenuItems}.
		*
		* Disable all the action mode menu items for text processing.
		* By default WebView searches for activities that are able to handle
		* {@link android.content.Intent#ACTION_PROCESS_TEXT} and show them in the
		* action mode menu. If this flag is set via {@link
		* #setDisabledActionModeMenuItems}, these menu items will be disabled.
		*
		* @see #setDisabledActionModeMenuItems
		*/
		public static final int MENU_ITEM_PROCESS_TEXT = 1 << 2;
		}