decide_destination


Description:

public signal bool decide_destination (string suggested_filename)

This signal is emitted after response is received to decide a destination for the download using set_destination.

If this signal is not handled, the file will be downloaded to g_user_directory_download directory using suggested_filename.

Since 2.40, you may handle this signal asynchronously by returning true without calling set_destination. This indicates intent to eventually call set_destination. In this case, the download will not proceed until the destination is set or cancelled with cancel.

Parameters:

suggested_filename

the filename suggested for the download

Returns:

true to stop other handlers from being invoked for the event, or false to propagate the event further.