gtkFileChooserSetFilename       package:RGtk2       R Documentation

_g_t_k_F_i_l_e_C_h_o_o_s_e_r_S_e_t_F_i_l_e_n_a_m_e

_D_e_s_c_r_i_p_t_i_o_n:

     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.

_U_s_a_g_e:

     gtkFileChooserSetFilename(object, filename)

_A_r_g_u_m_e_n_t_s:

'object': ['GtkFileChooser']  a 'GtkFileChooser'

'filename': [char]  the filename to set as current

_D_e_t_a_i_l_s:

     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

_V_a_l_u_e:

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

_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

