WebKit.FileChooserRequest – webkit2gtk-4.0

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 <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 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

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:

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

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref