java.lang.Object | |
↳ | android.webkit.WebSettings |
Manages settings state for a WebView. When a WebView is first created, it obtains a set of default settings. These default settings will be returned from any getter call. A WebSettings object obtained from WebView.getSettings() is tied to the life of the WebView. If a WebView has been destroyed, any method call on WebSettings will throw an IllegalStateException.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
WebSettings.LayoutAlgorithm | Enum for controlling the layout of html. | ||||||||||
WebSettings.RenderPriority | |||||||||||
WebSettings.TextSize | Enum for specifying the text size. | ||||||||||
WebSettings.ZoomDensity | Enum for specifying the WebView's desired density. |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | LOAD_CACHE_ELSE_NETWORK | Use cache if content is there, even if expired (eg, history nav) If it is not in the cache, load from network. | |||||||||
int | LOAD_CACHE_ONLY | Don't use the network, load from cache only. | |||||||||
int | LOAD_DEFAULT | Default cache usage pattern Use with setCacheMode(int) . |
|||||||||
int | LOAD_NORMAL | Normal cache usage pattern Use with setCacheMode(int) . |
|||||||||
int | LOAD_NO_CACHE | Don't use the cache, load from network
Use with setCacheMode(int) . |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns true if this WebView supports file access.
| |||||||||||
Return true if the WebView will block network image.
| |||||||||||
Returns true if the zoom mechanism built into WebView is being used.
| |||||||||||
Return the current setting for overriding the cache mode.
| |||||||||||
Get the cursive font family name.
| |||||||||||
Returns true if database storage API is enabled.
| |||||||||||
Return the path to where database storage API databases are saved for
the current WebView.
| |||||||||||
Get the default fixed font size.
| |||||||||||
Get the default font size.
| |||||||||||
Get the default text encoding name.
| |||||||||||
Get the default zoom density of the page.
| |||||||||||
Returns true if the DOM Storage API's are enabled.
| |||||||||||
Get the fantasy font family name.
| |||||||||||
Get the fixed font family name.
| |||||||||||
Return true if javascript can open windows automatically.
| |||||||||||
Return true if javascript is enabled.
| |||||||||||
Return the current layout algorithm.
| |||||||||||
Returns true if light touches are enabled.
| |||||||||||
Returns true if this WebView loads page with overview mode
| |||||||||||
Return true if the WebView will load image resources automatically.
| |||||||||||
Get the minimum font size.
| |||||||||||
Get the minimum logical font size.
| |||||||||||
Returns true if dumping the navigation cache is enabled.
| |||||||||||
Return true if plugins are enabled.
| |||||||||||
TODO: need to add @Deprecated
| |||||||||||
Get the sans-serif font family name.
| |||||||||||
Return whether the WebView is saving form data.
| |||||||||||
Return whether the WebView is saving password.
| |||||||||||
Get the serif font family name.
| |||||||||||
Get the standard font family name.
| |||||||||||
Get the text size of the page.
| |||||||||||
This method is deprecated.
This setting controlled a rendering optimization
that is no longer present. Setting it now has no effect.
| |||||||||||
This method is deprecated.
Please use getUserAgentString instead.
| |||||||||||
Return the WebView's user-agent string.
| |||||||||||
Enable or disable file access within WebView.
| |||||||||||
Tell the WebView to enable Application Caches API.
| |||||||||||
Set the maximum size for the Application Caches content.
| |||||||||||
Set a custom path to the Application Caches files.
| |||||||||||
Tell the WebView to block network image.
| |||||||||||
Sets whether the zoom mechanism built into WebView is used.
| |||||||||||
Override the way the cache is used.
| |||||||||||
Set the cursive font family name.
| |||||||||||
Set whether the database storage API is enabled.
| |||||||||||
Set the path to where database storage API databases should be saved.
| |||||||||||
Set the default fixed font size.
| |||||||||||
Set the default font size.
| |||||||||||
Set the default text encoding name to use when decoding html pages.
| |||||||||||
Set the default zoom density of the page.
| |||||||||||
Set whether the DOM storage API is enabled.
| |||||||||||
Set the fantasy font family name.
| |||||||||||
Set the fixed font family name.
| |||||||||||
Set the path where the Geolocation permissions database should be saved.
| |||||||||||
Sets whether Geolocation is enabled.
| |||||||||||
Tell javascript to open windows automatically.
| |||||||||||
Tell the WebView to enable javascript execution.
| |||||||||||
Set the underlying layout algorithm.
| |||||||||||
Enables using light touches to make a selection and activate mouseovers.
| |||||||||||
Set whether the WebView loads a page with overview mode.
| |||||||||||
Tell the WebView to load image resources automatically.
| |||||||||||
Set the minimum font size.
| |||||||||||
Set the minimum logical font size.
| |||||||||||
Enables dumping the pages navigation cache to a text file.
| |||||||||||
Tell the WebView whether it needs to set a node to have focus when
requestFocus(int, android.graphics.Rect) is called. | |||||||||||
Tell the WebView to enable plugins.
| |||||||||||
TODO: need to add @Deprecated
| |||||||||||
Set the priority of the Render thread.
| |||||||||||
Set the sans-serif font family name.
| |||||||||||
Store whether the WebView is saving form data.
| |||||||||||
Store whether the WebView is saving password.
| |||||||||||
Set the serif font family name.
| |||||||||||
Set the standard font family name.
| |||||||||||
Tell the WebView whether it supports multiple windows.
| |||||||||||
Set whether the WebView supports zoom
| |||||||||||
Set the text size of the page.
| |||||||||||
This method is deprecated.
This setting controlled a rendering optimization
that is no longer present. Setting it now has no effect.
| |||||||||||
Tell the WebView to use the wide viewport
| |||||||||||
This method is deprecated.
Please use setUserAgentString instead.
| |||||||||||
Set the WebView's user-agent string.
| |||||||||||
Returns whether the WebView supports zoom
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class java.lang.Object
|
Use cache if content is there, even if expired (eg, history nav)
If it is not in the cache, load from network.
Use with setCacheMode(int)
.
Don't use the network, load from cache only.
Use with setCacheMode(int)
.
Default cache usage pattern Use with setCacheMode(int)
.
Normal cache usage pattern Use with setCacheMode(int)
.
Don't use the cache, load from network
Use with setCacheMode(int)
.
Returns true if this WebView supports file access.
Return true if the WebView will block network image. The default is false.
Returns true if the zoom mechanism built into WebView is being used.
Return the current setting for overriding the cache mode. For a full
description, see the setCacheMode(int)
function.
Get the cursive font family name. The default is "cursive".
Returns true if database storage API is enabled.
Return the path to where database storage API databases are saved for the current WebView.
Get the default fixed font size. The default is 16.
Get the default font size. The default is 16.
Get the default text encoding name. The default is "Latin-1".
Get the default zoom density of the page. This should be called from UI thread.
Returns true if the DOM Storage API's are enabled.
Get the fantasy font family name. The default is "fantasy".
Get the fixed font family name. The default is "monospace".
Return true if javascript can open windows automatically. The default is false.
Return true if javascript is enabled. Note: The default is false.
Return the current layout algorithm. The default is NARROW_COLUMNS.
Returns true if light touches are enabled.
Returns true if this WebView loads page with overview mode
Return true if the WebView will load image resources automatically. The default is true.
Get the minimum font size. The default is 8.
Get the minimum logical font size. The default is 8.
Returns true if dumping the navigation cache is enabled.
Return true if plugins are enabled.
Get the sans-serif font family name.
Return whether the WebView is saving form data.
Get the serif font family name. The default is "serif".
Get the standard font family name. The default is "sans-serif".
Get the text size of the page.
This method is deprecated.
This setting controlled a rendering optimization
that is no longer present. Setting it now has no effect.
This method is deprecated.
Please use getUserAgentString instead.
Return user-agent as int
Return the WebView's user-agent string.
Enable or disable file access within WebView. File access is enabled by default.
Tell the WebView to enable Application Caches API.
flag | True if the WebView should enable Application Caches. |
---|
Set the maximum size for the Application Caches content.
appCacheMaxSize | the maximum size in bytes. |
---|
Set a custom path to the Application Caches files. The client must ensure it exists before this call.
appCachePath | String path to the directory containing Application Caches files. The appCache path can be the empty string but should not be null. Passing null for this parameter will result in a no-op. |
---|
Tell the WebView to block network image. This is only checked when getLoadsImagesAutomatically() is true.
flag | True if the WebView should block network image |
---|
Sets whether the zoom mechanism built into WebView is used.
Override the way the cache is used. The way the cache is used is based on the navigation option. For a normal page load, the cache is checked and content is re-validated as needed. When navigating back, content is not revalidated, instead the content is just pulled from the cache. This function allows the client to override this behavior.
mode | One of the LOAD_ values. |
---|
Set the cursive font family name.
font | A font family name. |
---|
Set whether the database storage API is enabled.
flag | boolean True if the WebView should use the database storage API. |
---|
Set the path to where database storage API databases should be saved. This will update WebCore when the Sync runs in the C++ side.
databasePath | String path to the directory where databases should be saved. May be the empty string but should never be null. |
---|
Set the default fixed font size.
size | A non-negative integer between 1 and 72. Any number outside the specified range will be pinned. |
---|
Set the default font size.
size | A non-negative integer between 1 and 72. Any number outside the specified range will be pinned. |
---|
Set the default text encoding name to use when decoding html pages.
encoding | The text encoding name. |
---|
Set the default zoom density of the page. This should be called from UI thread.
zoom | A ZoomDensity value |
---|
Set whether the DOM storage API is enabled.
flag | boolean True if the WebView should use the DOM storage API. |
---|
Set the fantasy font family name.
font | A font family name. |
---|
Set the fixed font family name.
font | A font family name. |
---|
Set the path where the Geolocation permissions database should be saved. This will update WebCore when the Sync runs in the C++ side.
databasePath | String path to the directory where the Geolocation permissions database should be saved. May be the empty string but should never be null. |
---|
Sets whether Geolocation is enabled.
flag | Whether Geolocation should be enabled. |
---|
Tell javascript to open windows automatically. This applies to the javascript function window.open().
flag | True if javascript can open windows automatically. |
---|
Tell the WebView to enable javascript execution.
flag | True if the WebView should execute javascript. |
---|
Set the underlying layout algorithm. This will cause a relayout of the WebView.
l | A LayoutAlgorithm enum specifying the algorithm to use. |
---|
Enables using light touches to make a selection and activate mouseovers.
Set whether the WebView loads a page with overview mode.
Tell the WebView to load image resources automatically.
flag | True if the WebView should load images automatically. |
---|
Set the minimum font size.
size | A non-negative integer between 1 and 72. Any number outside the specified range will be pinned. |
---|
Set the minimum logical font size.
size | A non-negative integer between 1 and 72. Any number outside the specified range will be pinned. |
---|
Enables dumping the pages navigation cache to a text file.
Tell the WebView whether it needs to set a node to have focus when
requestFocus(int, android.graphics.Rect)
is called.
Tell the WebView to enable plugins.
flag | True if the WebView should load plugins. |
---|
TODO: need to add @Deprecated
Set the priority of the Render thread. Unlike the other settings, this one only needs to be called once per process. The default is NORMAL.
priority | RenderPriority, can be normal, high or low. |
---|
Set the sans-serif font family name.
font | A font family name. |
---|
Store whether the WebView is saving form data.
Store whether the WebView is saving password.
Set the serif font family name. The default is "sans-serif".
font | A font family name. |
---|
Set the standard font family name.
font | A font family name. |
---|
Tell the WebView whether it supports multiple windows. TRUE means
that onCreateWindow(WebView, boolean, boolean, Message)
is implemented by the host application.
Set whether the WebView supports zoom
Set the text size of the page.
t | A TextSize value for increasing or decreasing the text. |
---|
This method is deprecated.
This setting controlled a rendering optimization
that is no longer present. Setting it now has no effect.
Tell the WebView to use the wide viewport
This method is deprecated.
Please use setUserAgentString instead.
Tell the WebView about user-agent string.
ua | 0 if the WebView should use an Android user-agent string, 1 if the WebView should use a desktop user-agent string. |
---|
Set the WebView's user-agent string. If the string "ua" is null or empty, it will use the system default user-agent string.
onCreateWindow(WebView, boolean, boolean, Message)
is implemented by the host application.