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

[From: Murray Cumming]

On Tue, 2006-10-24 at 17:19 +0300, Markku Vire wrote:
> 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.

Thanks. It would be great if you could add that to the documentation if
you can.

-- 
Murray Cumming
murrayc at murrayc.com
www.murrayc.com
www.openismus.com