## 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 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

### 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

## See Also

GtkFileChooser, GtkDialog