WebKitWebContext

## WebKitWebContext WebKitWebContext |

## Synopsis

    struct              WebKitWebContext;
    enum                WebKitCacheModel;
    WebKitWebContext *  webkit_web_context_get_default      (void);
    WebKitCacheModel    webkit_web_context_get_cache_model  (WebKitWebContext *context);
    void                webkit_web_context_set_cache_model  (WebKitWebContext *context,
                                                             WebKitCacheModel cache_model);
    WebKitDownload *    webkit_web_context_download_uri     (WebKitWebContext *context,
                                                             const gchar *uri);

## Object Hierarchy

      GObject
       +----WebKitWebContext

## Signals

      "download-started"                               : Run Last

## Description

## Details

### struct WebKitWebContext

    struct WebKitWebContext;

### enum WebKitCacheModel

    typedef enum {
        WEBKIT_CACHE_MODEL_DOCUMENT_VIEWER,
        WEBKIT_CACHE_MODEL_WEB_BROWSER,
        WEBKIT_CACHE_MODEL_DOCUMENT_BROWSER
    } WebKitCacheModel;

Enum values used for determining the webview cache model.

`WEBKIT_CACHE_MODEL_DOCUMENT_VIEWER` | Disable the cache completely, which substantially reduces memory usage. Useful for applications that only access a single local file, with no navigation to other pages. No remote resources will be cached.
`WEBKIT_CACHE_MODEL_WEB_BROWSER` | Improve document load speed substantially by caching a very large number of resources and previously viewed content.
`WEBKIT_CACHE_MODEL_DOCUMENT_BROWSER` | A cache model optimized for viewing a series of local files -- for example, a documentation viewer or a website designer. WebKit will cache a moderate number of resources.

### webkit_web_context_get_default ()

    WebKitWebContext *  webkit_web_context_get_default      (void);

Gets the default web context

Returns : | (transfer none) a WebKitWebContext

### webkit_web_context_get_cache_model ()

    WebKitCacheModel    webkit_web_context_get_cache_model  (WebKitWebContext *context);

Returns the current cache model. For more information about this value check the documentation of the function `webkit_web_context_set_cache_model()`.

`context` : | the WebKitWebContext
Returns : | the current WebKitCacheModel

### webkit_web_context_set_cache_model ()

    void                webkit_web_context_set_cache_model  (WebKitWebContext *context,
                                                             WebKitCacheModel cache_model);

Specifies a usage model for WebViews, which WebKit will use to determine its caching behavior. All web views follow the cache model. This cache model determines the RAM and disk space to use for caching previously viewed content .

Research indicates that users tend to browse within clusters of documents that hold resources in common, and to revisit previously visited documents. WebKit and the frameworks below it include built-in caches that take advantage of these patterns, substantially improving document load speed in browsing situations. The WebKit cache model controls the behaviors of all of these caches, including various WebCore caches.

Browsers can improve document load speed substantially by specifying WEBKIT_CACHE_MODEL_WEB_BROWSER. Applications without a browsing interface can reduce memory usage substantially by specifying WEBKIT_CACHE_MODEL_DOCUMENT_VIEWER. The default value is WEBKIT_CACHE_MODEL_WEB_BROWSER.

`context` : | the WebKitWebContext
`cache_model` : | a WebKitCacheModel

### webkit_web_context_download_uri ()

    WebKitDownload *    webkit_web_context_download_uri     (WebKitWebContext *context,
                                                             const gchar *uri);

Requests downloading of the specified URI string.

`context` : | a WebKitWebContext
`uri` : | the URI to download
Returns : | a new WebKitDownload representing the the download operation. [transfer full]

## Signal Details

### The `"download-started"` signal

    void                user_function                      (WebKitWebContext *context,
                                                            WebKitDownload   *download,
                                                            gpointer          user_data)      : Run Last

This signal is emitted when a new download request is made.

`context` : | the WebKitWebContext
`download` : | the WebKitDownload associated with this event
`user_data` : | user data set when the signal handler was connected.