# Gtk::FileChooserButton Class Reference
[Widgets]

A button to launch a file chooser dialog. More...

Inheritance diagram for Gtk::FileChooserButton:
[legend]
Collaboration diagram for Gtk::FileChooserButton:
[legend]

List of all members.

## 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().

Since gtkmm 2.10:

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.

Since gtkmm 2.6:

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.

Since gtkmm 2.6:

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.

Since gtkmm 2.10:

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.

Since gtkmm 2.6:

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.

Since gtkmm 2.6:

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