WebKit2.Download (original) (raw)
Class
WebKit2Download
Description [src]
class WebKit2.Download : GObject.Object
{
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 WebKitURIResponseobjects. 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_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.
Methods inherited from GObject (43)
Please see GObject for a full list of methods.
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.
since: 2.6
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 toWebKitDownload::received-data signal to track the progress.
Signals
WebKit2.Download::created-destination
This signal is emitted after WebKitDownload::decide-destination and beforeWebKitDownload::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 for the download using webkit_download_set_destination(). If this signal is not handled, the file will be downloaded to G_USER_DIRECTORY_DOWNLOADdirectory 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 errorWEBKIT_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::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
);
}No description available.
Class members
parent_class: GObjectClass
No description available.
decide_destination: gboolean (* decide_destination) ( WebKitDownload* download, const gchar* suggested_filename )
No description available.
_webkit_reserved0: void (* _webkit_reserved0) ( void )
No description available.
_webkit_reserved1: void (* _webkit_reserved1) ( void )
No description available.
_webkit_reserved2: void (* _webkit_reserved2) ( void )
No description available.
_webkit_reserved3: void (* _webkit_reserved3) ( void )
No description available.