GtkFileChooserDialog

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

Synopsis


#include <gtk/gtk.h>


struct      GtkFileChooserDialog;
GtkWidget*  gtk_file_chooser_dialog_new     (const gchar *title,
                                             GtkWindow *parent,
                                             GtkFileChooserAction action,
                                             const gchar *first_button_text,
                                             ...);
GtkWidget*  gtk_file_chooser_dialog_new_with_backend
                                            (const gchar *title,
                                             GtkWindow *parent,
                                             GtkFileChooserAction action,
                                             const gchar *backend,
                                             const gchar *first_button_text,
                                             ...);


Object Hierarchy


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

Implemented Interfaces

GtkFileChooserDialog implements AtkImplementorIface and GtkFileChooser.

Description

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.

Example 4. Typical usage

In the simplest of cases, you can use GtkFileChooserDialog as in the following code:

GtkWidget *dialog;

dialog = gtk_file_chooser_dialog_new ("Open File",
				      parent_window,
				      GTK_FILE_CHOOSER_ACTION_OPEN,
				      GTK_STOCK_OPEN, GTK_RESPONSE_ACCEPT,
				      GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL,
				      NULL);

if (gtk_dialog_run (GTK_DIALOG (dialog)) == GTK_RESPONSE_ACCEPT)
  {
    char *filename;

    filename = gtk_file_chooser_get_filename (GTK_FILE_CHOOSER (dialog));
    open_file (filename);
    g_free (filename);
  }

gtk_widget_destroy (dialog);
      

Details

struct GtkFileChooserDialog

struct GtkFileChooserDialog;


gtk_file_chooser_dialog_new ()

GtkWidget*  gtk_file_chooser_dialog_new     (const gchar *title,
                                             GtkWindow *parent,
                                             GtkFileChooserAction action,
                                             const gchar *first_button_text,
                                             ...);

Creates a new GtkFileChooserDialog. This function is analogous to gtk_dialog_new_with_buttons().

title : Title of the dialog, or NULL
parent : Transient parent of the dialog, or NULL
action : Open or save mode for the dialog
first_button_text : stock ID or text to go in the first button, or NULL
... : response ID for the first button, then additional (button, id) pairs, ending with NULL
Returns : a new GtkFileChooserDialog

Since 2.4


gtk_file_chooser_dialog_new_with_backend ()

GtkWidget*  gtk_file_chooser_dialog_new_with_backend
                                            (const gchar *title,
                                             GtkWindow *parent,
                                             GtkFileChooserAction action,
                                             const gchar *backend,
                                             const gchar *first_button_text,
                                             ...);

Creates a new GtkFileChooserDialog with a specified backend. This is especially useful if you use gtk_file_chooser_set_local_only() to allow non-local files and you use a more expressive vfs, such as gnome-vfs, to load files.

title : Title of the dialog, or NULL
parent : Transient parent of the dialog, or NULL
action : Open or save mode for the dialog
backend : The name of the specific filesystem backend to use.
first_button_text : stock ID or text to go in the first button, or NULL
... : response ID for the first button, then additional (button, id) pairs, ending with NULL
Returns : a new GtkFileChooserDialog

Since 2.4

See Also

GtkFileChooser, GtkDialog