|  |  |  | GTK+ Reference Manual |  | 
|---|
| GtkFileChooserButtonGtkFileChooserButton — A button to launch a file selection dialog |  | 
#include <gtk/gtk.h>
            GtkFileChooserButton;
GtkWidget*  gtk_file_chooser_button_new     (const gchar *title,
                                             GtkFileChooserAction action);
GtkWidget*  gtk_file_chooser_button_new_with_backend
                                            (const gchar *title,
                                             GtkFileChooserAction action,
                                             const gchar *backend);
GtkWidget*  gtk_file_chooser_button_new_with_dialog
                                            (GtkWidget *dialog);
const gchar* gtk_file_chooser_button_get_title
                                            (GtkFileChooserButton *button);
void        gtk_file_chooser_button_set_title
                                            (GtkFileChooserButton *button,
                                             const gchar *title);
gint        gtk_file_chooser_button_get_width_chars
                                            (GtkFileChooserButton *button);
void        gtk_file_chooser_button_set_width_chars
                                            (GtkFileChooserButton *button,
                                             gint n_chars);
GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkHBox +----GtkFileChooserButton
"dialog" GtkFileChooserDialog : Write / Construct Only "title" gchararray : Read / Write "width-chars" gint : Read / Write
The GtkFileChooserButton is a widget that lets the user select a
file.  It implements the GtkFileChooser interface.  Visually, it is a
file name with a button to bring up a GtkFileChooserDialog.
The user can then use that dialog to change the file associated with
that button.  This widget does not support setting the "select-multiple"
property to TRUE.
Example 5. Create a button to let the user select a file in /etc
{
  GtkWidget *button;
  button = gtk_file_chooser_button_new (_("Select a file"),
                                        GTK_FILE_CHOOSER_ACTION_OPEN);
  gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (button),
                                       "/etc");
}
The GtkFileChooserButton supports the GtkFileChooserActions GTK_FILE_CHOOSER_ACTION_OPEN and GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
The GtkFileChooserButton will ellipsize the label,
and thus will thus request little horizontal space.  To give the button
more space, you should call gtk_widget_size_request(),
gtk_file_chooser_button_set_width_chars(), or pack the button in
such a way that other interface elements give space to the widget.
typedef struct _GtkFileChooserButton GtkFileChooserButton;
This should not be accessed directly. Use the accessor functions below.
GtkWidget* gtk_file_chooser_button_new (const gchar *title, GtkFileChooserAction action);
Creates a new file-selecting button widget.
| title: | the title of the browse dialog. | 
| action: | the open mode for the widget. | 
| Returns : | a new button widget. | 
Since 2.6
GtkWidget* gtk_file_chooser_button_new_with_backend (const gchar *title, GtkFileChooserAction action, const gchar *backend);
Creates a new file-selecting button widget using backend.
| title: | the title of the browse dialog. | 
| action: | the open mode for the widget. | 
| backend: | the name of the GtkFileSystem backend to use. | 
| Returns : | a new button widget. | 
Since 2.6
GtkWidget* gtk_file_chooser_button_new_with_dialog (GtkWidget *dialog);
Creates a GtkFileChooserButton widget which uses dialog as it's
file-picking window. Note that dialog must be a GtkFileChooserDialog (or
subclass).
| dialog: | the GtkFileChooserDialog widget to use. | 
| Returns : | a new button widget. | 
Since 2.6
const gchar* gtk_file_chooser_button_get_title (GtkFileChooserButton *button);
Retrieves the title of the browse dialog used by button. The returned value
should not be modified or freed.
| button: | the button widget to examine. | 
| Returns : | a pointer to the browse dialog's title. | 
Since 2.6
void        gtk_file_chooser_button_set_title
                                            (GtkFileChooserButton *button,
                                             const gchar *title);
Modifies the title of the browse dialog used by button.
| button: | the button widget to modify. | 
| title: | the new browse dialog title. | 
Since 2.6
gint gtk_file_chooser_button_get_width_chars (GtkFileChooserButton *button);
Retrieves the width in characters of the button widget's entry and/or label.
| button: | the button widget to examine. | 
| Returns : | an integer width (in characters) that the button will use to size itself. | 
Since 2.6
void        gtk_file_chooser_button_set_width_chars
                                            (GtkFileChooserButton *button,
                                             gint n_chars);
Sets the width (in characters) that button will use to n_chars.
| button: | the button widget to examine. | 
| n_chars: | the new width, in characters. | 
Since 2.6
dialog" property"dialog" GtkFileChooserDialog : Write / Construct Only
Instance of the GtkFileChooserDialog associated with the button.
Since 2.6
title" property"title" gchararray : Read / Write
Title to put on the GtkFileChooserDialog associated with the button.
Default value: "Select A File"
Since 2.6
width-chars" property"width-chars" gint : Read / Write
The width of the entry and label inside the button, in characters.
Allowed values: >= -1
Default value: -1
Since 2.6
| << GtkFileChooser | GtkFileChooserDialog >> |