![]() |

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. | ||||
| bool | get_focus_on_click () const | |||
| 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. | ||||
| Glib::PropertyProxy_ReadOnly< FileChooserDialog* > | property_dialog () const | |||
| The file chooser dialog to use. | ||||
| Glib::PropertyProxy_ReadOnly< bool > | property_focus_on_click () const | |||
| Whether the button grabs focus when it is clicked with the mouse. | ||||
| Glib::PropertyProxy<bool> | property_focus_on_click () | |||
| Whether the button grabs focus when it is clicked with the mouse. | ||||
| Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_title () const | |||
| The title of the file chooser dialog. | ||||
| Glib::PropertyProxy<Glib::ustring> | property_title () | |||
| The title of the file chooser dialog. | ||||
| Glib::PropertyProxy_ReadOnly< int > | property_width_chars () const | |||
| The desired width of the button widget. | ||||
| Glib::PropertyProxy<int> | property_width_chars () | |||
| The desired width of the button widget. | ||||
| void | set_focus_on_click (gboolean focus_on_click=true) | |||
| 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. |
| bool Gtk::FileChooserButton::get_focus_on_click | ( | ) | const |
| 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] |
| Glib::PropertyProxy_ReadOnly<FileChooserDialog*> Gtk::FileChooserButton::property_dialog | ( | ) | const |
The file chooser dialog to use.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy_ReadOnly<bool> Gtk::FileChooserButton::property_focus_on_click | ( | ) | const |
Whether the button grabs focus when it is clicked with the mouse.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy<bool> Gtk::FileChooserButton::property_focus_on_click | ( | ) |
Whether the button grabs focus when it is clicked with the mouse.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy_ReadOnly<Glib::ustring> Gtk::FileChooserButton::property_title | ( | ) | const |
The title of the file chooser dialog.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy<Glib::ustring> Gtk::FileChooserButton::property_title | ( | ) |
The title of the file chooser dialog.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy_ReadOnly<int> Gtk::FileChooserButton::property_width_chars | ( | ) | const |
The desired width of the button widget.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| Glib::PropertyProxy<int> Gtk::FileChooserButton::property_width_chars | ( | ) |
The desired width of the button widget.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
| void Gtk::FileChooserButton::set_focus_on_click | ( | gboolean | focus_on_click = true |
) |
| 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 characters. |
| 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. |