<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>gtkmm: Gtk::FileChooserButton Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespaceGtk.html">Gtk</a>::<a class="el" href="classGtk_1_1FileChooserButton.html">FileChooserButton</a>
</div>
</div>
<div class="contents">
<h1>Gtk::FileChooserButton Class Reference<br/>
<small>
[<a class="el" href="group__Widgets.html">Widgets</a>]</small>
</h1><!-- doxytag: class="Gtk::FileChooserButton" --><!-- doxytag: inherits="Gtk::HBox,Gtk::FileChooser" -->
<p>A button to launch a file chooser dialog. <a href="#_details">More...</a></p>
<p>Inherits <a class="el" href="classGtk_1_1HBox.html">Gtk::HBox</a>, and <a class="el" href="classGtk_1_1FileChooser.html">Gtk::FileChooser</a>.</p>
<div class="dynheader">
Collaboration diagram for Gtk::FileChooserButton:</div>
<div class="dynsection">
<div class="center"><img src="classGtk_1_1FileChooserButton__coll__graph.png" border="0" usemap="#Gtk_1_1FileChooserButton_coll__map" alt="Collaboration graph"/></div>
<map name="Gtk_1_1FileChooserButton_coll__map" id="Gtk_1_1FileChooserButton_coll__map">
<area shape="rect" href="classGtk_1_1HBox.html" title="Horizontal Box for laying widgets in a horizontal row." alt="" coords="139,547,221,576"/><area shape="rect" href="classGtk_1_1Box.html" title="A base class for box containers." alt="" coords="135,469,207,499"/><area shape="rect" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="113,392,217,421"/><area shape="rect" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)." alt="" coords="100,315,191,344"/><area shape="rect" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such..." alt="" coords="5,237,93,267"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="7,160,97,189"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="56,83,176,112"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="125,160,229,189"/><area shape="rect" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="63,5,169,35"/><area shape="rect" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="117,237,237,267"/><area shape="rect" href="classGtk_1_1FileChooser.html" title="Gtk::FileChooser is an interface that can be implemented by file selection widgets..." alt="" coords="215,315,335,344"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGtk_1_1FileChooserButton-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a2c68ac3c0392c0710fc4bdb7725c99a4">~FileChooserButton</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GtkFileChooserButton* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#aaf5932fe7ee1cd32d8addba40c503640">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#aaf5932fe7ee1cd32d8addba40c503640"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GtkFileChooserButton* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a1034a135ce8baf1da4a2c466189af990">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a1034a135ce8baf1da4a2c466189af990"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#afd7480a2731641ce37abb939775d6238">FileChooserButton</a> (<a class="el" href="group__gtkmmEnums.html#ga0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> action=FILE_CHOOSER_ACTION_OPEN)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new file-selecting button widget with the default title. <a href="#afd7480a2731641ce37abb939775d6238"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a89b1936bceedbe5656007077ce715b40">FileChooserButton</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& title, <a class="el" href="group__gtkmmEnums.html#ga0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> action=FILE_CHOOSER_ACTION_OPEN)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new file-selecting button widget. <a href="#a89b1936bceedbe5656007077ce715b40"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a14adbe1ae7a6ba37af6959649f9bb030">FileChooserButton</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& title, <a class="el" href="group__gtkmmEnums.html#ga0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> action, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& backend)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new file-selecting button widget using backend. <a href="#a14adbe1ae7a6ba37af6959649f9bb030"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a69b4b54a614b7312cec8c80a039f0536">FileChooserButton</a> (<a class="el" href="classGtk_1_1FileChooserDialog.html">FileChooserDialog</a>& dialog)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new file-selecting button widget which uses dialog as its file-picking window. <a href="#a69b4b54a614b7312cec8c80a039f0536"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a21a0995ec1e52fad200a726771e711de">get_title</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the title of the browse dialog used by <em>button</em>. <a href="#a21a0995ec1e52fad200a726771e711de"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#ae36fe088c746518bc1b08fcf39f18133">set_title</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& title)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Modifies the <em>title</em> of the browse dialog used by <em>button</em>. <a href="#ae36fe088c746518bc1b08fcf39f18133"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a1a500fa7a344b984e0b4e996a8304627">get_width_chars</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Retrieves the width in characters of the <em>button</em> widget's entry and/or label. <a href="#a1a500fa7a344b984e0b4e996a8304627"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a918ae15bcb96d03765084d279a970c56">set_width_chars</a> (int n_chars)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the width (in characters) that <em>button</em> will use to <em>n_chars</em>. <a href="#a918ae15bcb96d03765084d279a970c56"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a85e16d51083b0f8f79498fec19022a0d">get_focus_on_click</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns whether the button grabs focus when it is clicked with the mouse. <a href="#a85e16d51083b0f8f79498fec19022a0d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a51e5660524652f6da60e29c5c9d9ffae">set_focus_on_click</a> (gboolean focus_on_click=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets whether the button will grab focus when it is clicked with the mouse. <a href="#a51e5660524652f6da60e29c5c9d9ffae"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a16149ec54325c971d2525de8b435999a">signal_file_set</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#ad251f019b07fc3456bdd96aaf3fb8d0c">property_focus_on_click</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the button grabs focus when it is clicked with the mouse. <a href="#ad251f019b07fc3456bdd96aaf3fb8d0c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a9c99fb9ab1fdca112c728ce67529a8ff">property_focus_on_click</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the button grabs focus when it is clicked with the mouse. <a href="#a9c99fb9ab1fdca112c728ce67529a8ff"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#aff9d0bc4031cd79272b6d83d5ef30c91">property_title</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The title of the file chooser dialog. <a href="#aff9d0bc4031cd79272b6d83d5ef30c91"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a34cb061e63002c26436cb16b7aaa9540">property_title</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The title of the file chooser dialog. <a href="#a34cb061e63002c26436cb16b7aaa9540"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< int > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#ae875e9c906a106b0e5b8b3ebe7a85839">property_width_chars</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The desired width of the button widget. <a href="#ae875e9c906a106b0e5b8b3ebe7a85839"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a>< int > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a083d5fe6a22315beae20bb4a72139b9a">property_width_chars</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The desired width of the button widget. <a href="#a083d5fe6a22315beae20bb4a72139b9a"></a><br/></td></tr>
<tr><td colspan="2"><h2>Related Functions</h2></td></tr>
<tr><td colspan="2"><p>(Note that these are not member functions.) </p>
<br/><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1FileChooserButton.html">Gtk::FileChooserButton</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a7d39ab3e179b4e4b1db974ac319fd985">wrap</a> (GtkFileChooserButton* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a7d39ab3e179b4e4b1db974ac319fd985"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>A button to launch a file chooser dialog. </p>
<p>This widget lets the user select a file. It implements the <a class="el" href="classGtk_1_1FileChooser.html" title="Gtk::FileChooser is an interface that can be implemented by file selection widgets...">FileChooser</a> interface. Visually, it is a file name with a button to bring up a <a class="el" href="classGtk_1_1FileChooserDialog.html" title="Convenient file chooser window.">FileChooserDialog</a>. 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.</p>
<p>The <a class="el" href="classGtk_1_1FileChooserButton.html" title="A button to launch a file chooser dialog.">FileChooserButton</a> supports the FileChooserActions FILE_CHOOSER_ACTION_OPEN and FILE_CHOOSER_ACTION_SELECT_FOLDER.</p>
<p>The <a class="el" href="classGtk_1_1FileChooserButton.html" title="A button to launch a file chooser dialog.">FileChooserButton</a> will ellipsize the label, and will thus request little horizontal space. To give the button more space, you should call <a class="el" href="classGtk_1_1Widget.html#a98944a56dd747042b0718d177082b944" title="This function is typically used when implementing a Gtk::Container subclass.">size_request()</a>, <a class="el" href="classGtk_1_1FileChooserButton.html#a918ae15bcb96d03765084d279a970c56" title="Sets the width (in characters) that button will use to n_chars.">set_width_chars()</a>, or pack the button in such a way that other interface elements give space to the widget.</p>
<p>The <a class="el" href="classGtk_1_1FileChooserButton.html" title="A button to launch a file chooser dialog.">FileChooserButton</a> widget looks like this: </p>
<div align="center">
<img src="filechooserbutton1.png" alt="filechooserbutton1.png"/>
</div>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a2c68ac3c0392c0710fc4bdb7725c99a4"></a><!-- doxytag: member="Gtk::FileChooserButton::~FileChooserButton" ref="a2c68ac3c0392c0710fc4bdb7725c99a4" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gtk::FileChooserButton::~FileChooserButton </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="afd7480a2731641ce37abb939775d6238"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="afd7480a2731641ce37abb939775d6238" args="(FileChooserAction action=FILE_CHOOSER_ACTION_OPEN)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::FileChooserButton::FileChooserButton </td>
<td>(</td>
<td class="paramtype"><a class="el" href="group__gtkmmEnums.html#ga0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> </td>
<td class="paramname"> <em>action</em> = <code>FILE_CHOOSER_ACTION_OPEN</code></td>
<td> ) </td>
<td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a new file-selecting button widget with the default title. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>The title of the browse dialog. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>action</em> </td><td>The open mode for the widget. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>backend</em> </td><td>The name of the Gtk::FileSystem backend to use. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a89b1936bceedbe5656007077ce715b40"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="a89b1936bceedbe5656007077ce715b40" args="(const Glib::ustring &title, FileChooserAction action=FILE_CHOOSER_ACTION_OPEN)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::FileChooserButton::FileChooserButton </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"> <em>title</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__gtkmmEnums.html#ga0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> </td>
<td class="paramname"> <em>action</em> = <code>FILE_CHOOSER_ACTION_OPEN</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a new file-selecting button widget. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>The title of the browse dialog. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>action</em> </td><td>The open mode for the widget. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a14adbe1ae7a6ba37af6959649f9bb030"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="a14adbe1ae7a6ba37af6959649f9bb030" args="(const Glib::ustring &title, FileChooserAction action, const Glib::ustring &backend)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::FileChooserButton::FileChooserButton </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"> <em>title</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="group__gtkmmEnums.html#ga0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> </td>
<td class="paramname"> <em>action</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"> <em>backend</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a new file-selecting button widget using backend. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>The title of the browse dialog. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>action</em> </td><td>The open mode for the widget. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>backend</em> </td><td>The name of the Gtk::FileSystem backend to use. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a69b4b54a614b7312cec8c80a039f0536"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="a69b4b54a614b7312cec8c80a039f0536" args="(FileChooserDialog &dialog)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::FileChooserButton::FileChooserButton </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classGtk_1_1FileChooserDialog.html">FileChooserDialog</a>& </td>
<td class="paramname"> <em>dialog</em></td>
<td> ) </td>
<td><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a new file-selecting button widget which uses dialog as its file-picking window. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>dialog</em> </td><td>The dialog to use. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a85e16d51083b0f8f79498fec19022a0d"></a><!-- doxytag: member="Gtk::FileChooserButton::get_focus_on_click" ref="a85e16d51083b0f8f79498fec19022a0d" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::FileChooserButton::get_focus_on_click </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns whether the button grabs focus when it is clicked with the mouse. </p>
<p>See <a class="el" href="classGtk_1_1FileChooserButton.html#a51e5660524652f6da60e29c5c9d9ffae" title="Sets whether the button will grab focus when it is clicked with the mouse.">set_focus_on_click()</a>.</p>
<dl class="since_2_10"><dt><b><a class="el" href="since_2_10.html#_since_2_10000054">Since gtkmm 2.10:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the button grabs focus when it is clicked with the mouse. </dd></dl>
</div>
</div>
<a class="anchor" id="a21a0995ec1e52fad200a726771e711de"></a><!-- doxytag: member="Gtk::FileChooserButton::get_title" ref="a21a0995ec1e52fad200a726771e711de" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Gtk::FileChooserButton::get_title </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieves the title of the browse dialog used by <em>button</em>. </p>
<p>The returned value should not be modified or freed.</p>
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000077">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to the browse dialog's title. </dd></dl>
</div>
</div>
<a class="anchor" id="a1a500fa7a344b984e0b4e996a8304627"></a><!-- doxytag: member="Gtk::FileChooserButton::get_width_chars" ref="a1a500fa7a344b984e0b4e996a8304627" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Gtk::FileChooserButton::get_width_chars </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Retrieves the width in characters of the <em>button</em> widget's entry and/or label. </p>
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000079">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>An integer width (in characters) that the button will use to size itself. </dd></dl>
</div>
</div>
<a class="anchor" id="a1034a135ce8baf1da4a2c466189af990"></a><!-- doxytag: member="Gtk::FileChooserButton::gobj" ref="a1034a135ce8baf1da4a2c466189af990" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GtkFileChooserButton* Gtk::FileChooserButton::gobj </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GtkObject. </p>
<p>Reimplemented from <a class="el" href="classGtk_1_1HBox.html#a200e7083acf10d6075633a5bb2eef9d0">Gtk::HBox</a>.</p>
</div>
</div>
<a class="anchor" id="aaf5932fe7ee1cd32d8addba40c503640"></a><!-- doxytag: member="Gtk::FileChooserButton::gobj" ref="aaf5932fe7ee1cd32d8addba40c503640" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GtkFileChooserButton* Gtk::FileChooserButton::gobj </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GtkObject. </p>
<p>Reimplemented from <a class="el" href="classGtk_1_1HBox.html#a276c36213ef878a34ab3a16a6f2dc94b">Gtk::HBox</a>.</p>
</div>
</div>
<a class="anchor" id="a9c99fb9ab1fdca112c728ce67529a8ff"></a><!-- doxytag: member="Gtk::FileChooserButton::property_focus_on_click" ref="a9c99fb9ab1fdca112c728ce67529a8ff" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::FileChooserButton::property_focus_on_click </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether the button grabs focus when it is clicked with the mouse. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="ad251f019b07fc3456bdd96aaf3fb8d0c"></a><!-- doxytag: member="Gtk::FileChooserButton::property_focus_on_click" ref="ad251f019b07fc3456bdd96aaf3fb8d0c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::FileChooserButton::property_focus_on_click </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Whether the button grabs focus when it is clicked with the mouse. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a34cb061e63002c26436cb16b7aaa9540"></a><!-- doxytag: member="Gtk::FileChooserButton::property_title" ref="a34cb061e63002c26436cb16b7aaa9540" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::FileChooserButton::property_title </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The title of the file chooser dialog. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="aff9d0bc4031cd79272b6d83d5ef30c91"></a><!-- doxytag: member="Gtk::FileChooserButton::property_title" ref="aff9d0bc4031cd79272b6d83d5ef30c91" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::FileChooserButton::property_title </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The title of the file chooser dialog. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a083d5fe6a22315beae20bb4a72139b9a"></a><!-- doxytag: member="Gtk::FileChooserButton::property_width_chars" ref="a083d5fe6a22315beae20bb4a72139b9a" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><int> Gtk::FileChooserButton::property_width_chars </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The desired width of the button widget. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="ae875e9c906a106b0e5b8b3ebe7a85839"></a><!-- doxytag: member="Gtk::FileChooserButton::property_width_chars" ref="ae875e9c906a106b0e5b8b3ebe7a85839" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><int> Gtk::FileChooserButton::property_width_chars </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The desired width of the button widget. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a51e5660524652f6da60e29c5c9d9ffae"></a><!-- doxytag: member="Gtk::FileChooserButton::set_focus_on_click" ref="a51e5660524652f6da60e29c5c9d9ffae" args="(gboolean focus_on_click=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::FileChooserButton::set_focus_on_click </td>
<td>(</td>
<td class="paramtype">gboolean </td>
<td class="paramname"> <em>focus_on_click</em> = <code>true</code></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets whether the button will grab focus when it is clicked with the mouse. </p>
<p>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.</p>
<dl class="since_2_10"><dt><b><a class="el" href="since_2_10.html#_since_2_10000055">Since gtkmm 2.10:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>focus_on_click</em> </td><td>Whether the button grabs focus when clicked with the mouse. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ae36fe088c746518bc1b08fcf39f18133"></a><!-- doxytag: member="Gtk::FileChooserButton::set_title" ref="ae36fe088c746518bc1b08fcf39f18133" args="(const Glib::ustring &title)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::FileChooserButton::set_title </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"> <em>title</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Modifies the <em>title</em> of the browse dialog used by <em>button</em>. </p>
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000078">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>title</em> </td><td>The new browse dialog title. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a918ae15bcb96d03765084d279a970c56"></a><!-- doxytag: member="Gtk::FileChooserButton::set_width_chars" ref="a918ae15bcb96d03765084d279a970c56" args="(int n_chars)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::FileChooserButton::set_width_chars </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>n_chars</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the width (in characters) that <em>button</em> will use to <em>n_chars</em>. </p>
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000080">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>n_chars</em> </td><td>The new width, in characters. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a16149ec54325c971d2525de8b435999a"></a><!-- doxytag: member="Gtk::FileChooserButton::signal_file_set" ref="a16149ec54325c971d2525de8b435999a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > Gtk::FileChooserButton::signal_file_set </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_file_set()</code> </dd></dl>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a7d39ab3e179b4e4b1db974ac319fd985"></a><!-- doxytag: member="Gtk::FileChooserButton::wrap" ref="a7d39ab3e179b4e4b1db974ac319fd985" args="(GtkFileChooserButton *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1FileChooserButton.html">Gtk::FileChooserButton</a>* wrap </td>
<td>(</td>
<td class="paramtype">GtkFileChooserButton * </td>
<td class="paramname"> <em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>take_copy</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>object</em> </td><td>The C instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>take_copy</em> </td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>gtkmm/filechooserbutton.h</li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Tue May 4 13:21:51 2010 for gtkmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2010.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
22e237efd6851989a23adf3360bb53d0
>
files
>
332
