| GTK+ Reference Manual | ||||
|---|---|---|---|---|
#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 6. 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) and must not have GTK_DIALOG_DESTROY_WITH_PARENT set.
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