gtkmm: Gtk::FileChooserButton Class Reference
A button to launch a file chooser dialog. More...
Public Member Functions | |
virtual | ~FileChooserButton () |
GtkFileChooserButton* | gobj () |
Provides access to the underlying C GtkObject. | |
const GtkFileChooserButton* | gobj () const |
Provides access to the underlying C GtkObject. | |
FileChooserButton (FileChooserAction action=FILE_CHOOSER_ACTION_OPEN) | |
Creates a new file-selecting button widget with the default title. | |
FileChooserButton (const Glib::ustring& title, FileChooserAction action=FILE_CHOOSER_ACTION_OPEN) | |
Creates a new file-selecting button widget. | |
FileChooserButton (FileChooserDialog& dialog) | |
Creates a new file-selecting button widget which uses dialog as its file-picking window. | |
Glib::ustring | get_title () const |
Retrieves the title of the browse dialog used by button. | |
void | set_title (const Glib::ustring& title) |
Modifies 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. | |
void | set_width_chars (int n_chars) |
Sets the width (in characters) that button will use to n_chars. | |
bool | get_focus_on_click () const |
Returns whether the button grabs focus when it is clicked with the mouse. | |
void | set_focus_on_click (gboolean focus_on_click=true) |
Sets whether the button will grab focus when it is clicked with the mouse. | |
Glib::SignalProxy0< void > | signal_file_set () |
Glib::PropertyProxy< bool > | property_focus_on_click () |
Whether the button grabs focus when it is clicked with the mouse. | |
Glib::PropertyProxy_ReadOnly < bool > | property_focus_on_click () const |
Whether the button grabs focus when it is clicked with the mouse. | |
Glib::PropertyProxy < Glib::ustring > | property_title () |
The title of the file chooser dialog. | |
Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_title () const |
The title of the file chooser dialog. | |
Glib::PropertyProxy< int > | property_width_chars () |
The desired width of the button widget, in characters. | |
Glib::PropertyProxy_ReadOnly< int > | property_width_chars () const |
The desired width of the button widget, in characters. | |
Protected Member Functions | |
virtual void | on_file_set () |
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. |
Detailed Description
A button to launch a file chooser dialog.
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.
The FileChooserButton widget looks like this:
Constructor & Destructor Documentation
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.
- Parameters:
-
title The title of the browse dialog. action The open mode for the widget.
Gtk::FileChooserButton::FileChooserButton | ( | const Glib::ustring & | title, |
FileChooserAction | action = FILE_CHOOSER_ACTION_OPEN |
||
) | [explicit] |
Creates a new file-selecting button widget.
- Parameters:
-
title The title of the browse dialog. action The open mode for the widget.
Gtk::FileChooserButton::FileChooserButton | ( | FileChooserDialog& | dialog | ) | [explicit] |
Creates a new file-selecting button widget which uses dialog as its file-picking window.
- Parameters:
-
dialog The dialog to use.
Member Function Documentation
bool Gtk::FileChooserButton::get_focus_on_click | ( | ) | const |
Returns whether the button grabs focus when it is clicked with the mouse.
See set_focus_on_click().
- Returns:
true
if the button grabs focus when it is clicked with the mouse.
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.
- Returns:
- A pointer to the browse dialog's title.
int Gtk::FileChooserButton::get_width_chars | ( | ) | const |
Retrieves the width in characters of the button widget's entry and/or label.
- Returns:
- An integer width (in characters) that the button will use to size itself.
GtkFileChooserButton* Gtk::FileChooserButton::gobj | ( | ) | [inline] |
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::HBox.
const GtkFileChooserButton* Gtk::FileChooserButton::gobj | ( | ) | const [inline] |
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::HBox.
virtual void Gtk::FileChooserButton::on_file_set | ( | ) | [protected, virtual] |
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.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
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.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
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.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
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.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly<int> Gtk::FileChooserButton::property_width_chars | ( | ) | const |
The desired width of the button widget, in characters.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy<int> Gtk::FileChooserButton::property_width_chars | ( | ) |
The desired width of the button widget, in characters.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
- Returns:
- A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
void Gtk::FileChooserButton::set_focus_on_click | ( | gboolean | focus_on_click = true | ) |
Sets whether the button will grab focus when it is clicked with the mouse.
Making mouse clicks not grab focus is useful in places like toolbars where you don't want the keyboard focus removed from the main area of the application.
- Parameters:
-
focus_on_click Whether the button grabs focus when clicked with the mouse.
void Gtk::FileChooserButton::set_title | ( | const Glib::ustring & | title | ) |
Modifies the title of the browse dialog used by button.
- Parameters:
-
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.
- Parameters:
-
n_chars The new width, in characters.
Glib::SignalProxy0< void > Gtk::FileChooserButton::signal_file_set | ( | ) |
- Prototype:
void on_my_file_set()
Friends And Related Function Documentation
Gtk::FileChooserButton* wrap | ( | GtkFileChooserButton * | object, |
bool | take_copy = false |
||
) | [related] |
A Glib::wrap() method for this object.
- Parameters:
-
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.
- Returns:
- A C++ instance that wraps this C instance.
The documentation for this class was generated from the following file:
- gtkmm/filechooserbutton.h