[maemo-developers] [maemo-developers] hildon_file_chooser_dialog_set_safe_folder() ?

[From: Markku Vire]

Hi,

Murray Cumming wrote:
> The documentation for hildon_file_chooser_dialog_set_safe_folder():
> http://www.maemo.org/platform/docs/api/hildon-docs/fm-html/hildon-fm-HildonFileChooserDialog.html#hildon-file-chooser-dialog-set-safe-folder
> says 
> "Sets a safe folder that is used as a fallback in a case that automatic
> location change fails."
> 
> What is "automatic location change" and when might it fail?

"automatic location change" takes place when (if) file selector detects 
that the currently selected location is not usable anymore. This can be 
because of:

* Currently selected location was on mmc and mmc was removed.
* Currently selected location was on gateway device and connection
   failed.
* Somebody removed the currently selected folder
* ... some other reason ...

In these cases file selector tries to move selection into some other 
location (usually parent folder). However, if this fails as well, safe 
folder provides a fallback location. By default, the root folder is used 
as a safe folder, but applications can provide a better fallback 
location if needed.

-Markku-