gtkFileChooserSetFilename {RGtk2} | R Documentation

## gtkFileChooserSetFilename

### Description

Sets `filename` as the current filename for the file chooser, by changing to the file's parent folder and actually selecting the file in list. If the `chooser` is in `GTK_FILE_CHOOSER_ACTION_SAVE` mode, the file's base name will also appear in the dialog's file name entry.

### Usage

    gtkFileChooserSetFilename(object, filename)

### Arguments

``object`` | a `GtkFileChooser`
``filename`` | the filename to set as current

### Details

If the file name isn't in the current folder of `chooser`, then the current folder of `chooser` will be changed to the folder containing `filename`. This is equivalent to a sequence of `gtkFileChooserUnselectAll` followed by `gtkFileChooserSelectFilename`.

Note that the file must exist, or nothing will be done except for the directory change.

If you are implementing a File/Save As... dialog, you should use this function if you already have a file name to which the user may save; for example, when the user opens an existing file and then does File/Save As... on it. If you don't have a file name already – for example, if the user just created a new file and is saving it for the first time, do not call this function. Instead, use something similar to this:

    if (document_is_new)
      {
        /* the user just created a new document */
        gtk_file_chooser_set_current_folder (chooser, default_folder_for_saving);
        gtk_file_chooser_set_current_name (chooser, "Untitled document");
      }
    else
      {
        /* the user edited an existing document */
        gtk_file_chooser_set_filename (chooser, existing_filename);
      }

Since 2.4

### Value

[logical] `TRUE` if both the folder could be changed and the file was selected successfully, `FALSE` otherwise.

### Author(s)

Derived by RGtkGen from GTK+ documentation

[Package RGtk2 version 2.20.40 Index]