GtkFileChooserDialog

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

Synopsis


#include <gtk/gtk.h>


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


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 2. 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

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

See Also

GtkFileChooser, GtkDialog