Class
WebKit2Download
Description [src]
class WebKit2.Download : GObject.Object {
parent: GObject,
priv: WebKitDownloadPrivate*
}Object used to communicate with the application when downloading.
WebKitDownload carries information about a download request and
response, including a WebKitURIRequest and a WebKitURIResponse
objects. The application may use this object to control the
download process, or to simply figure out what is to be downloaded,
and handle the download process itself.
Instance methods
webkit_download_cancel
Cancels the download.
webkit_download_get_allow_overwrite
Returns the current value of the WebKitDownload:allow-overwrite property.
Available since: 2.6
webkit_download_get_destination
Obtains the URI to which the downloaded file will be written.
webkit_download_get_elapsed_time
Gets the elapsed time in seconds, including any fractional part.
webkit_download_get_estimated_progress
Gets the value of the WebKitDownload:estimated-progress property.
Gets the value of the WebKitDownload:estimated-progress property.
You can monitor the estimated progress of the download operation by
connecting to the notify::estimated-progress signal of download.
webkit_download_get_received_data_length
Gets the length of the data already downloaded for download.
webkit_download_get_request
Retrieves the WebKitURIRequest object that backs the download process.
webkit_download_get_response
Retrieves the WebKitURIResponse object that backs the download process.
webkit_download_get_web_view
Get the WebKitWebView that initiated the download.
webkit_download_set_allow_overwrite
Sets the WebKitDownload:allow-overwrite property.
Available since: 2.6
webkit_download_set_destination
Sets the URI to which the downloaded file will be written.
Properties
WebKit2.Download:allow-overwrite
Whether or not the download is allowed to overwrite an existing file on
disk. If this property is FALSE and the destination already exists,
the download will fail.
Available since: 2.6
WebKit2.Download:destination
The local URI to where the download will be saved.
WebKit2.Download:estimated-progress
An estimate of the percent completion for the download operation.
This value will range from 0.0 to 1.0. The value is an estimate
based on the total number of bytes expected to be received for
a download.
If you need a more accurate progress information you can connect to
WebKitDownload::received-data signal to track the progress.
WebKit2.Download:response
The WebKitURIResponse associated with this download.
Signals
WebKit2.Download::created-destination
This signal is emitted after WebKitDownload::decide-destination and before
WebKitDownload::received-data to notify that destination file has been
created successfully at destination.
WebKit2.Download::decide-destination
This signal is emitted after response is received to
decide a destination URI for the download. If this signal is not
handled the file will be downloaded to G_USER_DIRECTORY_DOWNLOAD
directory using suggested_filename.
WebKit2.Download::failed
This signal is emitted when an error occurs during the download
operation. The given error, of the domain WEBKIT_DOWNLOAD_ERROR,
contains further details of the failure. If the download is cancelled
with webkit_download_cancel(), this signal is emitted with error
WEBKIT_DOWNLOAD_ERROR_CANCELLED_BY_USER. The download operation finishes
after an error and WebKitDownload::finished signal is emitted after this one.
WebKit2.Download::finished
This signal is emitted when download finishes successfully or due to an error.
In case of errors WebKitDownload::failed signal is emitted before this one.
WebKit2.Download::received-data
This signal is emitted after response is received, every time new data has been written to the destination. It’s useful to know the progress of the download operation.
Signals inherited from GObject (1)
GObject.Object::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.
Class structure
struct WebKit2DownloadClass {
GObjectClass parent_class;
gboolean (* decide_destination) (
WebKitDownload* download,
const gchar* suggested_filename
);
void (* _webkit_reserved0) (
void
);
void (* _webkit_reserved1) (
void
);
void (* _webkit_reserved2) (
void
);
void (* _webkit_reserved3) (
void
);
}Class members
parent_class |
|
| No description available. | |
decide_destination |
|
| No description available. | |
_webkit_reserved0 |
|
| No description available. | |
_webkit_reserved1 |
|
| No description available. | |
_webkit_reserved2 |
|
| No description available. | |
_webkit_reserved3 |
|
| No description available. |