Top | ![]() |
![]() |
![]() |
![]() |
GtkWidget * | gtk_file_chooser_button_new () |
GtkWidget * | gtk_file_chooser_button_new_with_dialog () |
const gchar * | gtk_file_chooser_button_get_title () |
void | gtk_file_chooser_button_set_title () |
gint | gtk_file_chooser_button_get_width_chars () |
void | gtk_file_chooser_button_set_width_chars () |
GtkFileChooser * | dialog | Write / Construct Only |
gchar * | title | Read / Write |
gint | width-chars | Read / Write |
GtkFileChooserButton implements AtkImplementorIface, GtkBuildable, GtkConstraintTarget and GtkFileChooser.
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
.
1 2 3 4 5 6 7 8 |
{ 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 will thus request little horizontal space. To give the button more space, you should call
gtk_widget_get_preferred_size()
,gtk_file_chooser_button_set_width_chars()
, or pack the button in such a way that other interface elements give space to the widget.
GtkWidget * gtk_file_chooser_button_new (const gchar *title
,GtkFileChooserAction action
);
Creates a new file-selecting button widget.
GtkWidget *
gtk_file_chooser_button_new_with_dialog
(GtkWidget *dialog
);
Creates a GtkFileChooserButton widget which uses dialog
as its
file-picking window.
Note that dialog
must be a GtkDialog (or subclass) which
implements the GtkFileChooser interface and must not have
GTK_DIALOG_DESTROY_WITH_PARENT
set.
Also note that the dialog needs to have its confirmative button
added with response GTK_RESPONSE_ACCEPT
or GTK_RESPONSE_OK
in
order for the button to take over the file selected in the dialog.
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.
void gtk_file_chooser_button_set_title (GtkFileChooserButton *button
,const gchar *title
);
Modifies the title
of the browse dialog used by button
.
gint
gtk_file_chooser_button_get_width_chars
(GtkFileChooserButton *button
);
Retrieves the width in characters of the button
widget’s entry and/or label.
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
.
“dialog”
property“dialog” GtkFileChooser *
Instance of the GtkFileChooserDialog associated with the button.
Owner: GtkFileChooserButton
Flags: Write / Construct Only
“title”
property “title” gchar *
Title to put on the GtkFileChooserDialog associated with the button.
Owner: GtkFileChooserButton
Flags: Read / Write
Default value: "Select a File"
“file-set”
signalvoid user_function (GtkFileChooserButton *widget, gpointer user_data)
The ::file-set signal is emitted when the user selects a file.
Note that this signal is only emitted when the user changes the file.
widget |
the object which received the signal. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run First