![]() | ![]() | ![]() | GTK+ Reference Manual | ![]() |
---|
GtkFileChooserDialog — A file chooser dialog, suitable for "File/Open" or "File/Save" commands.
#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, ...);
GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----GtkDialog +----GtkFileChooserDialog
GtkFileChooserDialog implements AtkImplementorIface and GtkFileChooser.
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);
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
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
<< GtkFileChooser | GtkFileChooserWidget >> |