GtkFileChooserDialog          package:RGtk2          R Documentation

_G_t_k_F_i_l_e_C_h_o_o_s_e_r_D_i_a_l_o_g

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

     A file chooser dialog, suitable for "File/Open" or "File/Save"
     commands

_M_e_t_h_o_d_s _a_n_d _F_u_n_c_t_i_o_n_s:

     'gtkFileChooserDialogNew(title = NULL, parent = NULL, action, ...,
     show = TRUE)'
      'gtkFileChooserDialogNewWithBackend(title = NULL, parent = NULL,
     action, backend, ..., show = TRUE)'
      'gtkFileChooserDialog(title = NULL, parent = NULL, action, ...,
     backend, show = TRUE)'

_H_i_e_r_a_r_c_h_y:

     GObject
        +----GInitiallyUnowned
              +----GtkObject
                    +----GtkWidget
                          +----GtkContainer
                                +----GtkBin
                                      +----GtkWindow
                                            +----GtkDialog

     +----GtkFileChooserDialog 

_I_n_t_e_r_f_a_c_e_s:

     GtkFileChooserDialog implements AtkImplementorIface, 
     'GtkBuildable' and  'GtkFileChooser'.

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

     'GtkFileChooserDialog' is a dialog box suitable for use with
     "File/Open" or "File/Save as" commands.  This widget works by
     putting a 'GtkFileChooserWidget' inside a 'GtkDialog'.  It exposes
     the 'GtkFileChooserIface' interface, so you can use all of the
     'GtkFileChooser' functions on the file chooser dialog as well as
     those for 'GtkDialog'.

     Note that 'GtkFileChooserDialog' does not have any methods of its
     own.  Instead, you should use the functions that work on a
     'GtkFileChooser'.

     _Typical usage_


     ######
     # Request a file from the user and open it
     ######

     # This is how one creates a dialog with buttons and associated
     response codes.
     # (Please ignore the C "Response Code" example in the next
     section)
     dialog <- gtkFileChooserDialog("Open File", parent_window, "open",
                                    "gtk-cancel",
     GtkResponseType["cancel"], 
                                    "gtk-open",
     GtkResponseType["accept"])

     if (dialog$run() == GtkResponseType["accept"]) {
       filename <- dialog$getFilename()
       f <- file(filename)
     }

     dialog$destroy()


_R_e_s_p_o_n_s_e _C_o_d_e_s:

     'GtkFileChooserDialog' inherits from 'GtkDialog', so buttons that
     go in its action area have response codes such as
     'GTK_RESPONSE_ACCEPT' and 'GTK_RESPONSE_CANCEL'.  For example, you
     could call 'gtkFileChooserDialogNew' as follows:

     GtkWidget *dialog;

     dialog = gtk_file_chooser_dialog_new ("Open File",
                                           parent_window,

     GTK_FILE_CHOOSER_ACTION_OPEN,
                                           GTK_STOCK_CANCEL,
     GTK_RESPONSE_CANCEL,
                                           GTK_STOCK_OPEN,
     GTK_RESPONSE_ACCEPT,
                                           NULL);

      This will create buttons for "Cancel" and "Open" that use stock
     response identifiers from 'GtkResponseType'.  For most dialog
     boxes you can use your own custom response codes rather than the
     ones in 'GtkResponseType', but 'GtkFileChooserDialog' assumes that
     its "accept"-type action, e.g. an "Open" or "Save" button, _will_
     have one of the following response codes:

        *  'GTK_RESPONSE_ACCEPT'

        *  'GTK_RESPONSE_OK'

        *  'GTK_RESPONSE_YES'

        *  'GTK_RESPONSE_APPLY'

     This is because 'GtkFileChooserDialog' must intercept responses
     and switch to folders if appropriate, rather than letting the
     dialog terminate - the implementation uses these known response
     codes to know which responses can be blocked if appropriate.
     *PLEASE NOTE:*     To summarize, make sure you use a stock
     response code when you use 'GtkFileChooserDialog' to ensure proper
     operation.

_S_t_r_u_c_t_u_r_e_s:


     '_G_t_k_F_i_l_e_C_h_o_o_s_e_r_D_i_a_l_o_g' _undocumented _


_C_o_n_v_e_n_i_e_n_t _C_o_n_s_t_r_u_c_t_i_o_n:

     'gtkFileChooserDialog' is the result of collapsing the
     constructors of 'GtkFileChooserDialog' ('gtkFileChooserDialogNew',
     'gtkFileChooserDialogNewWithBackend') and accepts a subset of its
     arguments matching the required arguments of one of its delegate
     constructors.

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

     Derived by RGtkGen from GTK+ documentation

_R_e_f_e_r_e_n_c_e_s:

     <URL:
     http://developer.gnome.org/doc/API/2.0/gtk/GtkFileChooserDialog.html>

_S_e_e _A_l_s_o:

     'GtkFileChooser' 'GtkDialog'

