WebSettings 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
管理 WebView 的设置状态。
[Android.Runtime.Register("android/webkit/WebSettings", DoNotGenerateAcw=true)]
public abstract class WebSettings : Java.Lang.Object[<Android.Runtime.Register("android/webkit/WebSettings", DoNotGenerateAcw=true)>]
type WebSettings = class
inherit Object- 继承
- 属性
注解
管理 WebView 的设置状态。 首次创建 WebView 时，它将获取一组默认设置。 这些默认设置将从任何 getter 调用返回。
WebSettings从WebView#getSettings()中获取的对象与 WebView 的生命相关。 如果 WebView 已销毁，则任何方法调用WebSettings都将引发 。IllegalStateException
Java文档android.webkit.WebSettings。
本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。
构造函数
| 名称 | 说明 |
|---|---|
| WebSettings() |
管理 WebView 的设置状态。 |
| WebSettings(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
字段
| 名称 | 说明 |
|---|---|
| ForceDarkAuto |
启用强制深色，具体取决于 WebView 父视图的状态。 |
| ForceDarkOff |
禁用强制深色，而不考虑 WebView 父级的强制深色模式。 |
| ForceDarkOn |
无条件地启用强制深色。 |
| MenuItemNone |
已过时.
不应禁用任何菜单项。 |
| MenuItemProcessText |
已过时.
禁用文本处理的所有操作模式菜单项。 |
| MenuItemShare |
已过时.
禁用菜单项“共享”。 |
| MenuItemWebSearch |
已过时.
禁用菜单项“Web 搜索”。 |
| MixedContentAlwaysAllow |
已过时.
在此模式下，WebView 将允许安全源从任何其他源加载内容，即使该源不安全。 |
| MixedContentCompatibilityMode |
已过时.
在此模式下，WebView 将尝试与新式 Web 浏览器在混合内容方面的方法兼容。 |
| MixedContentNeverAllow |
已过时.
在此模式下，WebView 不允许安全源从不安全的源加载内容。 |
属性
| 名称 | 说明 |
|---|---|
| AlgorithmicDarkeningAllowed |
获取此 WebView 是否允许算法变暗。 - 或 - 控制是否允许算法变暗。 |
| AllowContentAccess |
获取此 WebView 是否支持内容 URL 访问。 |
| AllowFileAccess |
获取此 WebView 是否支持文件访问。 |
| AllowFileAccessFromFileURLs |
获取在文件方案 URL 上下文中运行的 JavaScript 是否可以从其他文件方案 URL 访问内容。 |
| AllowUniversalAccessFromFileURLs |
获取在文件方案 URL 上下文中运行的 JavaScript 是否可以从任何源访问内容。 |
| BlockNetworkImage |
获取 WebView 是否不从网络加载图像资源。 |
| BlockNetworkLoads |
获取 WebView 是否不从网络加载任何资源。 |
| BuiltInZoomControls |
获取内置于 WebView 中的缩放机制是否正在使用。 |
| CacheMode |
获取用于重写缓存模式的当前设置。 |
| Class |
返回此 |
| CursiveFontFamily |
获取 Cursive 字体系列名称。 |
| DatabaseEnabled |
获取是否启用数据库存储 API。 |
| DatabasePath |
获取保存数据库存储 API 数据库的路径。 |
| DefaultFixedFontSize |
获取默认固定字号。 |
| DefaultFontSize |
获取默认字体大小。 |
| DefaultTextEncodingName |
获取默认文本编码名称。 |
| DefaultZoom |
获取页面的默认缩放密度。 |
| DisabledActionModeMenuItems |
管理 WebView 的设置状态。 |
| DisplayZoomControls |
获取使用内置缩放机制时 WebView 是否显示屏幕缩放控件。 |
| DomStorageEnabled |
获取是否启用 DOM 存储 API。 |
| FantasyFontFamily |
获取幻想字体系列名称。 |
| FixedFontFamily |
获取固定字体系列名称。 |
| ForceDark |
获取此 WebView 的强制深色模式。 - 或 - 为此 WebView 设置强制深色模式。 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| JavaScriptCanOpenWindowsAutomatically |
获取 JavaScript 是否可以自动打开窗口。 |
| JavaScriptEnabled |
获取是否启用 JavaScript。 |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| JniPeerMembers |
管理 WebView 的设置状态。 |
| LightTouchEnabled |
获取是否启用光接触。 |
| LoadsImagesAutomatically |
获取 WebView 是否加载图像资源。 |
| LoadWithOverviewMode |
获取此 WebView 是否以概述模式加载页面。 |
| MediaPlaybackRequiresUserGesture |
获取 WebView 是否需要用户手势来播放媒体。 |
| MinimumFontSize |
获取最小字号。 |
| MinimumLogicalFontSize |
获取最小逻辑字号。 |
| MixedContentMode |
获取有关从安全源加载不安全内容时 WebView 的当前行为。 |
| NavDump |
已过时.
获取是否启用转储导航缓存。 - 或 - 启用将页面导航缓存转储到文本文件。 |
| OffscreenPreRaster |
管理 WebView 的设置状态。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| PluginsEnabled |
已过时.
获取是否启用插件。 - 或 - 设置 WebView 是否应启用插件。 |
| PluginsPath |
已过时.
获取包含插件库的目录。 - 或 - 设置 WebView 使用的插件的自定义路径。 |
| SafeBrowsingEnabled |
管理 WebView 的设置状态。 |
| SansSerifFontFamily |
获取 sans-serif 字体系列名称。 |
| SaveFormData |
获取 WebView 是否保存表单数据。 |
| SavePassword |
获取 WebView 是否保存密码。 |
| SerifFontFamily |
获取 serif 字体系列名称。 |
| StandardFontFamily |
获取标准字体系列名称。 |
| TextZoom |
获取页面的文本缩放百分比。 |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
| UseDoubleTree |
已过时.
控制了不再存在的呈现优化。 - 或 - 控制了不再存在的呈现优化。 |
| UserAgent |
已过时.
获取用户代理作为整数代码。 - 或 - 使用整数代码设置用户代理字符串。 |
| UserAgentString |
获取 WebView 的用户代理字符串。 |
| UseWebViewBackgroundForOverscrollBackground |
已过时.
获取此 WebView 是否使用 WebView 的背景而不是滚动背景的内部模式。 - 或 - 设置 WebView 是否将其背景用于滚动背景。 |
| UseWideViewPort |
获取 WebView 是否支持“视区”HTML 元标记或使用宽视区。 |
方法
| 名称 | 说明 |
|---|---|
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| EnableSmoothTransition() |
已过时.
获取 WebView 在平移或缩放时是否启用平滑转换。 |
| Equals(Object) |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetDefaultUserAgent(Context) |
返回 WebView 使用的默认 User-Agent。 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetLayoutAlgorithm() |
获取当前布局算法。 |
| GetPluginState() |
已过时.
获取有关插件是否已启用的当前状态。 |
| GetTextSize() |
已过时.
获取页面的文本大小。 |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| SetAppCacheEnabled(Boolean) |
设置是否应启用应用程序缓存 API。 |
| SetAppCacheMaxSize(Int64) |
已过时.
设置应用程序缓存内容的最大大小。 |
| SetAppCachePath(String) |
设置应用程序缓存文件的路径。 |
| SetEnableSmoothTransition(Boolean) |
已过时.
设置 WebView 是在平移或缩放时还是承载 WebView 的窗口没有焦点时启用平滑切换。 |
| SetGeolocationDatabasePath(String) |
已过时.
设置应保存地理位置数据库的路径。 |
| SetGeolocationEnabled(Boolean) |
设置是否启用地理位置。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetLayoutAlgorithm(WebSettings+LayoutAlgorithm) |
设置基础布局算法。 |
| SetNeedInitialFocus(Boolean) |
告知 WebView 在调用时 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| SetPluginState(WebSettings+PluginState) |
已过时.
告知 WebView 按需启用、禁用或具有插件。 |
| SetRenderPriority(WebSettings+RenderPriority) |
已过时.
设置呈现线程的优先级。 |
| SetSupportMultipleWindows(Boolean) |
设置 WebView 是否应支持多个窗口。 |
| SetSupportZoom(Boolean) |
设置 WebView 是否应支持使用其屏幕缩放控件和手势进行缩放。 |
| SetTextSize(WebSettings+TextSize) |
已过时.
设置页面的文本大小。 |
| SupportMultipleWindows() |
获取 WebView 是否支持多个窗口。 |
| SupportZoom() |
获取 WebView 是否支持缩放。 |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
使当前线程等待，直到唤醒它，通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| IJavaPeerable.Finalized() |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
管理 WebView 的设置状态。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
管理 WebView 的设置状态。 (继承自 JavaObject) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
管理 WebView 的设置状态。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |