![]() |
![]() |
This widget lets the user select a file. It implements the FileChooser interface. Visually, it is a file name with a button to bring up a FileChooserDialog. 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.
The FileChooserButton supports the FileChooserActions FILE_CHOOSER_ACTION_OPEN and FILE_CHOOSER_ACTION_SELECT_FOLDER.
The FileChooserButton will ellipsize the label, and will thus request little horizontal space. To give the button more space, you should call size_request(), set_width_chars(), or pack the button in such a way that other interface elements give space to the widget.
Public Member Functions | ||||
FileChooserButton (FileChooserDialog& dialog) | ||||
Creates a new file-selecting button widget which uses dialog as its file-picking window. | ||||
FileChooserButton (const Glib::ustring& title, FileChooserAction action, const Glib::ustring& backend) | ||||
Creates a new file-selecting button widget using backend. | ||||
FileChooserButton (const Glib::ustring& title, FileChooserAction action=FILE_CHOOSER_ACTION_OPEN) | ||||
Creates a new file-selecting button widget. | ||||
FileChooserButton (FileChooserAction action=FILE_CHOOSER_ACTION_OPEN) | ||||
Creates a new file-selecting button widget with the default title. | ||||
Glib::ustring | get_title () const | |||
Retrieves the title of the browse dialog used by button . | ||||
int | get_width_chars () const | |||
Retrieves the width in characters of the button widget's entry and/or label. | ||||
const GtkFileChooserButton* | gobj () const | |||
Provides access to the underlying C GtkObject. | ||||
GtkFileChooserButton* | gobj () | |||
Provides access to the underlying C GtkObject. | ||||
void | set_title (const Glib::ustring& title) | |||
Modifies the title of the browse dialog used by button . | ||||
void | set_width_chars (int n_chars) | |||
Sets the width (in characters) that button will use to n_chars . | ||||
virtual | ~FileChooserButton () | |||
Related Functions | ||||
(Note that these are not member functions.) | ||||
Gtk::FileChooserButton* | wrap (GtkFileChooserButton* object, bool take_copy=false) | |||
|
virtual Gtk::FileChooserButton::~FileChooserButton | ( | ) | [virtual] |
Gtk::FileChooserButton::FileChooserButton | ( | FileChooserAction | action = FILE_CHOOSER_ACTION_OPEN |
) | [explicit] |
Creates a new file-selecting button widget with the default title.
title | The title of the browse dialog. | |
action | The open mode for the widget. | |
backend | The name of the Gtk::FileSystem backend to use. |
Gtk::FileChooserButton::FileChooserButton | ( | const Glib::ustring & | title, | |
FileChooserAction | action = FILE_CHOOSER_ACTION_OPEN | |||
) | [explicit] |
Creates a new file-selecting button widget.
title | The title of the browse dialog. | |
action | The open mode for the widget. |
Gtk::FileChooserButton::FileChooserButton | ( | const Glib::ustring & | title, | |
FileChooserAction | action, | |||
const Glib::ustring & | backend | |||
) | [explicit] |
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 Gtk::FileSystem backend to use. |
Gtk::FileChooserButton::FileChooserButton | ( | FileChooserDialog& | dialog | ) | [explicit] |
Creates a new file-selecting button widget which uses dialog as its file-picking window.
dialog | The dialog to use. |
Glib::ustring Gtk::FileChooserButton::get_title | ( | ) | const |
Retrieves the title of the browse dialog used by button .
The returned value should not be modified or freed.
int Gtk::FileChooserButton::get_width_chars | ( | ) | const |
Retrieves the width in characters of the button widget's entry and/or label.
const GtkFileChooserButton* Gtk::FileChooserButton::gobj | ( | ) | const [inline] |
GtkFileChooserButton* Gtk::FileChooserButton::gobj | ( | ) | [inline] |
void Gtk::FileChooserButton::set_title | ( | const Glib::ustring & | title | ) |
Modifies the title of the browse dialog used by button .
title | The new browse dialog title. |
void Gtk::FileChooserButton::set_width_chars | ( | int | n_chars | ) |
Sets the width (in characters) that button will use to n_chars .
n_chars | The new width, in chracters. |
Gtk::FileChooserButton* wrap | ( | GtkFileChooserButton * | object, | |
bool | take_copy = false | |||
) | [related] |
object | The C instance |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |