Class

WPEWebKitFileChooserRequest

Description [src] 

class WPEWebKit.FileChooserRequest : GObject.Object {
  parent: GObject
}

A request to open a file chooser.

Whenever the user interacts with an <input type=’file’ /> HTML element, WebKit will need to show a dialog to choose one or more files to be uploaded to the server along with the rest of the form data. For that to happen in a general way, instead of just opening a GtkFileChooserDialog (which might be not desirable in some cases, which could prefer to use their own file chooser dialog), WebKit will fire the WebKitWebView::run-file-chooser signal with a WebKitFileChooserRequest object, which will allow the client application to specify the files to be selected, to inspect the details of the request (e.g. if multiple selection should be allowed) and to cancel the request, in case nothing was selected.

In case the client application does not wish to handle this signal, WebKit will provide a default handler which will asynchronously run a regular GtkFileChooserDialog for the user to interact with.

Hierarchy

hierarchy this WebKitFileChooserRequest ancestor_0 GObject ancestor_0--this

Ancestors

Instance methods

webkit_file_chooser_request_cancel

Ask WebKit to cancel the request. It’s important to do this in case no selection has been made in the client, otherwise the request won’t be properly completed and the browser will keep the request pending forever, which might cause the browser to hang.

webkit_file_chooser_request_get_mime_types

Get the list of MIME types the file chooser dialog should handle, in the format specified in RFC 2046 for “media types”. Its contents depend on the value of the ‘accept’ attribute for HTML input elements. This function should normally be called before presenting the file chooser dialog to the user, to decide whether to allow the user to select multiple files at once or only one.

webkit_file_chooser_request_get_select_multiple

Determine whether the file chooser associated to this WebKitFileChooserRequest should allow selecting multiple files, which depends on the HTML input element having a ‘multiple’ attribute defined.

webkit_file_chooser_request_get_selected_files

Get the list of selected files currently associated to the request. Initially, the return value of this method contains any files selected in previous file chooser requests for this HTML input element. Once webkit_file_chooser_request_select_files, the value will reflect whatever files are given.

webkit_file_chooser_request_select_files

Ask WebKit to select local files for upload and complete the request.

Methods inherited from GObject (42)

Please see GObject for a full list of methods.

Properties

WPEWebKit.FileChooserRequest:mime-types

A NULL-terminated array of strings containing the list of MIME types the file chooser dialog should handle. See webkit_file_chooser_request_get_mime_types() for more details.

WPEWebKit.FileChooserRequest:select-multiple

Whether the file chooser should allow selecting multiple files. See webkit_file_chooser_request_get_select_multiple() for more details.

WPEWebKit.FileChooserRequest:selected-files

A NULL-terminated array of strings containing the list of selected files associated to the current request. See webkit_file_chooser_request_get_selected_files() for more details.

Signals

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 WPEWebKitFileChooserRequestClass {
  GObjectClass parent_class;
  void (* _webkit_reserved0) (
void
  );
  void (* _webkit_reserved1) (
void
  );
  void (* _webkit_reserved2) (
void
  );
  void (* _webkit_reserved3) (
void
  );
  
}
Class members
parent_class 
GObjectClass
  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.