FileChooserRequest

Object Hierarchy:

Description:

[ CCode ( type_id = "webkit_file_chooser_request_get_type ()" ) ]
public class FileChooserRequest : Object

A request to open a file chooser.

Whenever the user interacts with an HTML input element with file type, 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 FileChooserDialog (which might be not desirable in some cases, which could prefer to use their own file chooser dialog), WebKit will fire the run_file_chooser signal with a FileChooserRequest 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 FileChooserDialog for the user to interact with.

Namespace: WebKit

Package: webkit2gtk-4.1

Content:

Properties:

public FileFilter filter { owned get; }
The filter currently associated with the request.
public string[] mime_types { get; }
A null-terminated array of strings containing the list of MIME types the file chooser dialog should handle.
public bool select_multiple { get; }
Whether the file chooser should allow selecting multiple files.
public string[] selected_files { get; }
A null-terminated array of strings containing the list of selected files associated to the current request.

Creation methods:

protected FileChooserRequest ()

Methods:

public void cancel ()
Ask WebKit to cancel the request.
public unowned string[] get_mime_types ()
Get the list of MIME types the file chooser dialog should handle.
public unowned FileFilter get_mime_types_filter ()
Get the filter currently associated with the request.
public bool get_select_multiple ()
Whether the file chooser should allow selecting multiple files.
public unowned string[] get_selected_files ()
Get the list of selected files associated to the request.
public void select_files (string[] files)
Ask WebKit to select local files for upload and complete the request.

Inherited Members:

All known members inherited from class GLib.Object