![]() |
![]() |
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) |
A Glib::wrap() method for this object. |
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] |
A Glib::wrap() method for this object.
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. |