GtkFileChooserButton
A button to launch a file selection dialog
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.
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_set_current_folder (GTK_FILE_CHOOSER (button),
"/etc");
}
The #GtkFileChooserButton supports all four #GtkFileChooserActions that the #GtkFileChooser supports. Two of the actions,
%GTK_FILE_CHOOSER_ACTION_SAVE and
%GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER, give the button the appearance
of an entry next to a button. The user can type the name of a file in
this entry, and it will complete as it types. The other two actions,
%GTK_FILE_CHOOSER_ACTION_OPEN and
%GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER, make the #GtkFileChooserAction
look like a #GtkButton.
Using GtkFileChooserButton in save mode
{
GtkWidget *button;
button = gtk_file_chooser_button_new (_("Save as..."));
gtk_file_chooser_set_action (GTK_FILE_CHOOSER (button),
GTK_FILE_CHOOSER_ACTION_SAVE);
gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER_BUTTON (button),
DEFAULT_SAVE_DIRECTORY);
}
The #GtkFileChooserButton will ellipsize the label while in Open mode,
and thus will thus request little horizontal space. To give the dialog
more space, you should call gtk_widget_size_request(), or pack it in
such a way that other interface elements give space to the widget.
#GtkFileChooserDialog
This should not be accessed directly. Use the accessor functions below.
%TRUE, if the #GtkFileChooserDialog associated with the button has been
made visible. This can also be set by the application, though it is
rarely useful to do so.
Instance of the #GtkFileChooserDialog associated with the button.
Title to put on the #GtkFileChooserDialog associated with the button.
@title:
@Returns:
@title:
@backend:
@Returns:
@dialog:
@Returns:
@button:
@Returns:
@button:
@title:
@button:
@Returns:
@button:
@is_active: