gtkFileChooserSetUri          package:RGtk2          R Documentation

_g_t_k_F_i_l_e_C_h_o_o_s_e_r_S_e_t_U_r_i

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

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

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

     gtkFileChooserSetUri(object, uri)

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

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

   'uri': [char]  the URI to set as current

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

     If the URI isn't in the current folder of 'chooser', then the
     current folder of 'chooser' will be changed to the folder
     containing 'uri'. This is equivalent to a sequence of
     'gtkFileChooserUnselectAll' followed by 'gtkFileChooserSelectUri'.

     Note that the URI 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_uri (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_uri (chooser, existing_uri);
       }


     Since  2.4

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

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

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

     Derived by RGtkGen from GTK+ documentation

