![]() | ![]() | ![]() | GTK+ Reference Manual | ![]() |
---|
GtkFileChooserDialog — A file chooser dialog, suitable for "File/Open" or "File/Save" commands.
#include <gtk/gtk.h> GtkWidget* gtk_file_chooser_dialog_new (const gchar *title, GtkWindow *parent, GtkFileChooserAction action, const gchar *first_button_text, ...);
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);
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 |
<< GtkFileChooser | GtkFileChooserWidget >> |