<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> <title>gtkmm 2.4: Gtk::FileChooserButton Class Reference</title> <link href="doxygen.css" rel="stylesheet" type="text/css"> </head> <body bgcolor="#ffffff"> <table border="0" width="100%"> <tr> <td width="10%" height="40"><img src="../../images/gtkmm_logo.gif" alt="logo" border="0" width="100%" height="100%"/></td> <td width="90%" height="40"><img src="../../images/top.gif" alt="top" width="100%" height="40"/></td> </tr> </table> <center> <a class="qindex" href="../../index.html">Main Page</a> <a href="group__Widgets.html">Widgets</a> <a class="qindex" href="namespaces.html"> Namespaces</a> <a href="../../tutorial/html/index.html"> Book</a> </center> <hr width="100%"/> <!-- begin main content --> <div id="content"> <!-- Generated by Doxygen 1.5.1 --> <div class="nav"> <a class="el" href="namespaceGtk.html">Gtk</a>::<a class="el" href="classGtk_1_1FileChooserButton.html">FileChooserButton</a></div> <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" -->Inheritance diagram for Gtk::FileChooserButton:<p><center><img src="classGtk_1_1FileChooserButton__inherit__graph.png" border="0" usemap="#Gtk_1_1FileChooserButton__inherit__map" alt="Inheritance graph"></center> <map name="Gtk_1_1FileChooserButton__inherit__map"> <area href="classGtk_1_1HBox.html" shape="rect" coords="149,548,235,575" alt=""> <area href="classGtk_1_1Box.html" shape="rect" coords="144,471,219,498" alt=""> <area href="classGtk_1_1Container.html" shape="rect" coords="119,394,231,420" alt=""> <area href="classGtk_1_1Widget.html" shape="rect" coords="108,316,201,343" alt=""> <area href="classGtk_1_1Object.html" shape="rect" coords="5,239,96,266" alt=""> <area doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1Object.html" shape="rect" coords="8,162,101,188" alt=""> <area doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ObjectBase.html" shape="rect" coords="59,84,184,111" alt=""> <area doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1Interface.html" shape="rect" coords="131,162,240,188" alt=""> <area doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classsigc_1_1trackable.html" shape="rect" coords="65,7,177,34" alt=""> <area href="classAtk_1_1Implementor.html" shape="rect" coords="120,239,251,266" alt=""> <area href="classGtk_1_1FileChooser.html" shape="rect" coords="225,316,351,343" alt=""> </map> <center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="classGtk_1_1FileChooserButton-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2> A button to launch a file chooser dialog. <p> This widget lets the user select a file. It implements the <a class="el" href="classGtk_1_1FileChooser.html">FileChooser</a> interface. Visually, it is a file name with a button to bring up a <a class="el" href="classGtk_1_1FileChooserDialog.html">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> The <a class="el" href="classGtk_1_1FileChooserButton.html">FileChooserButton</a> supports the FileChooserActions FILE_CHOOSER_ACTION_OPEN and FILE_CHOOSER_ACTION_SELECT_FOLDER.<p> The <a class="el" href="classGtk_1_1FileChooserButton.html">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#28f5e9cb2557e422225fd6b81c098a57">size_request()</a>, <a class="el" href="classGtk_1_1FileChooserButton.html#918ae15bcb96d03765084d279a970c56">set_width_chars()</a>, or pack the button in such a way that other interface elements give space to the widget.<p> The <a class="el" href="classGtk_1_1FileChooserButton.html">FileChooserButton</a> widget looks like this: <div align="center"> <img src="filechooserbutton1.png" alt="filechooserbutton1.png"> </div> <p> <table border="0" cellpadding="0" cellspacing="0"> <tr><td></td></tr> <tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#69b4b54a614b7312cec8c80a039f0536">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="#69b4b54a614b7312cec8c80a039f0536"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#14adbe1ae7a6ba37af6959649f9bb030">FileChooserButton</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& title, <a class="el" href="group__gtkmmEnums.html#g0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> action, const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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="#14adbe1ae7a6ba37af6959649f9bb030"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#89b1936bceedbe5656007077ce715b40">FileChooserButton</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& title, <a class="el" href="group__gtkmmEnums.html#g0d6076e7637ec501f26296e65fee2212">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="#89b1936bceedbe5656007077ce715b40"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#fd7480a2731641ce37abb939775d6238">FileChooserButton</a> (<a class="el" href="group__gtkmmEnums.html#g0d6076e7637ec501f26296e65fee2212">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="#fd7480a2731641ce37abb939775d6238"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#0339a7dc466791772a99b7bb3ae9d60a">get_focus_on_click</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Return value: <code>true</code> if the button grabs focus when it is clicked with. <a href="#0339a7dc466791772a99b7bb3ae9d60a"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#bd90ccd5b6164aa5497fd62431cb39f9">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="#bd90ccd5b6164aa5497fd62431cb39f9"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#5793a7fd6221e2bfce082128d8245b22">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="#5793a7fd6221e2bfce082128d8245b22"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">const GtkFileChooserButton* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#133ce004d9ed3c7676c81b5924f14319">gobj</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#133ce004d9ed3c7676c81b5924f14319"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">GtkFileChooserButton* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#af5932fe7ee1cd32d8addba40c503640">gobj</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#af5932fe7ee1cd32d8addba40c503640"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<br> bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#c401450a2448eeafd9802161d6ad918b">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="#c401450a2448eeafd9802161d6ad918b"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#d251f019b07fc3456bdd96aaf3fb8d0c">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="#d251f019b07fc3456bdd96aaf3fb8d0c"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<br> <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#c815c5204f350abe522b949df4ef232d">property_title</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">The title of the file chooser dialog. <a href="#c815c5204f350abe522b949df4ef232d"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#ff9d0bc4031cd79272b6d83d5ef30c91">property_title</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">The title of the file chooser dialog. <a href="#ff9d0bc4031cd79272b6d83d5ef30c91"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<br> int > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#194cc6d8fa5257c4abebe98b9de12f50">property_width_chars</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">The desired width of the button widget. <a href="#194cc6d8fa5257c4abebe98b9de12f50"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><int> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#e875e9c906a106b0e5b8b3ebe7a85839">property_width_chars</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">The desired width of the button widget. <a href="#e875e9c906a106b0e5b8b3ebe7a85839"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#51e5660524652f6da60e29c5c9d9ffae">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="#51e5660524652f6da60e29c5c9d9ffae"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#e36fe088c746518bc1b08fcf39f18133">set_title</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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="#e36fe088c746518bc1b08fcf39f18133"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#918ae15bcb96d03765084d279a970c56">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="#918ae15bcb96d03765084d279a970c56"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#2c68ac3c0392c0710fc4bdb7725c99a4">~FileChooserButton</a> ()</td></tr> <tr><td colspan="2"><br><h2>Related Functions</h2></td></tr> <tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr> <tr><td class="memItemLeft" nowrap 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#7d39ab3e179b4e4b1db974ac319fd985">wrap</a> (GtkFileChooserButton* object, bool take_copy=false)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#7d39ab3e179b4e4b1db974ac319fd985"></a><br></td></tr> </table> <hr><h2>Constructor & Destructor Documentation</h2> <a class="anchor" name="2c68ac3c0392c0710fc4bdb7725c99a4"></a><!-- doxytag: member="Gtk::FileChooserButton::~FileChooserButton" ref="2c68ac3c0392c0710fc4bdb7725c99a4" 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 width="100%"><code> [virtual]</code></td> </tr> </table> </div> <div class="memdoc"> <p> </div> </div><p> <a class="anchor" name="fd7480a2731641ce37abb939775d6238"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="fd7480a2731641ce37abb939775d6238" 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#g0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> </td> <td class="paramname"> <em>action</em> = <code>FILE_CHOOSER_ACTION_OPEN</code> </td> <td> ) </td> <td width="100%"><code> [explicit]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Creates a new file-selecting button widget with the default title. <p> <dl compact><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> </dl> </div> </div><p> <a class="anchor" name="89b1936bceedbe5656007077ce715b40"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="89b1936bceedbe5656007077ce715b40" 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" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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#g0d6076e7637ec501f26296e65fee2212">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 width="100%"><code> [explicit]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Creates a new file-selecting button widget. <p> <dl compact><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> </dl> </div> </div><p> <a class="anchor" name="14adbe1ae7a6ba37af6959649f9bb030"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="14adbe1ae7a6ba37af6959649f9bb030" 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" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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#g0d6076e7637ec501f26296e65fee2212">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" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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 width="100%"><code> [explicit]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Creates a new file-selecting button widget using backend. <p> <dl compact><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> </dl> </div> </div><p> <a class="anchor" name="69b4b54a614b7312cec8c80a039f0536"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="69b4b54a614b7312cec8c80a039f0536" 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 width="100%"><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 compact><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> </dl> </div> </div><p> <hr><h2>Member Function Documentation</h2> <a class="anchor" name="0339a7dc466791772a99b7bb3ae9d60a"></a><!-- doxytag: member="Gtk::FileChooserButton::get_focus_on_click" ref="0339a7dc466791772a99b7bb3ae9d60a" 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 width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> Return value: <code>true</code> if the button grabs focus when it is clicked with. <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the button grabs focus when it is clicked with the mouse.</dd></dl> <dl compact><dt><b><a class="el" href="newin2p10s.html#_newin2p10s000056">Since gtkmm 2.10:</a></b></dt><dd></dd></dl> </div> </div><p> <a class="anchor" name="bd90ccd5b6164aa5497fd62431cb39f9"></a><!-- doxytag: member="Gtk::FileChooserButton::get_title" ref="bd90ccd5b6164aa5497fd62431cb39f9" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Gtk::FileChooserButton::get_title </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> Retrieves the title of the browse dialog used by <em>button</em>. <p> The returned value should not be modified or freed. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A pointer to the browse dialog's title.</dd></dl> <dl compact><dt><b><a class="el" href="newin2p6s.html#_newin2p6s000080">Since gtkmm 2.6:</a></b></dt><dd></dd></dl> </div> </div><p> <a class="anchor" name="5793a7fd6221e2bfce082128d8245b22"></a><!-- doxytag: member="Gtk::FileChooserButton::get_width_chars" ref="5793a7fd6221e2bfce082128d8245b22" 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 width="100%"> 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="return" compact><dt><b>Returns:</b></dt><dd>An integer width (in characters) that the button will use to size itself.</dd></dl> <dl compact><dt><b><a class="el" href="newin2p6s.html#_newin2p6s000082">Since gtkmm 2.6:</a></b></dt><dd></dd></dl> </div> </div><p> <a class="anchor" name="133ce004d9ed3c7676c81b5924f14319"></a><!-- doxytag: member="Gtk::FileChooserButton::gobj" ref="133ce004d9ed3c7676c81b5924f14319" 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 width="100%"> 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#8d593e8c0968da4a503800487cfff8d7">Gtk::HBox</a>. </div> </div><p> <a class="anchor" name="af5932fe7ee1cd32d8addba40c503640"></a><!-- doxytag: member="Gtk::FileChooserButton::gobj" ref="af5932fe7ee1cd32d8addba40c503640" 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 width="100%"><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#276c36213ef878a34ab3a16a6f2dc94b">Gtk::HBox</a>. </div> </div><p> <a class="anchor" name="c401450a2448eeafd9802161d6ad918b"></a><!-- doxytag: member="Gtk::FileChooserButton::property_focus_on_click" ref="c401450a2448eeafd9802161d6ad918b" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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 width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> Whether the button grabs focus when it is clicked with the mouse. <p> You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><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><p> <a class="anchor" name="d251f019b07fc3456bdd96aaf3fb8d0c"></a><!-- doxytag: member="Gtk::FileChooserButton::property_focus_on_click" ref="d251f019b07fc3456bdd96aaf3fb8d0c" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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 width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Whether the button grabs focus when it is clicked with the mouse. <p> You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><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><p> <a class="anchor" name="c815c5204f350abe522b949df4ef232d"></a><!-- doxytag: member="Gtk::FileChooserButton::property_title" ref="c815c5204f350abe522b949df4ef232d" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::FileChooserButton::property_title </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> The title of the file chooser dialog. <p> You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><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><p> <a class="anchor" name="ff9d0bc4031cd79272b6d83d5ef30c91"></a><!-- doxytag: member="Gtk::FileChooserButton::property_title" ref="ff9d0bc4031cd79272b6d83d5ef30c91" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::FileChooserButton::property_title </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> The title of the file chooser dialog. <p> You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><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><p> <a class="anchor" name="194cc6d8fa5257c4abebe98b9de12f50"></a><!-- doxytag: member="Gtk::FileChooserButton::property_width_chars" ref="194cc6d8fa5257c4abebe98b9de12f50" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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 width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> The desired width of the button widget. <p> You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><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><p> <a class="anchor" name="e875e9c906a106b0e5b8b3ebe7a85839"></a><!-- doxytag: member="Gtk::FileChooserButton::property_width_chars" ref="e875e9c906a106b0e5b8b3ebe7a85839" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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 width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> The desired width of the button widget. <p> You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><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><p> <a class="anchor" name="51e5660524652f6da60e29c5c9d9ffae"></a><!-- doxytag: member="Gtk::FileChooserButton::set_focus_on_click" ref="51e5660524652f6da60e29c5c9d9ffae" 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 width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Sets whether the button will grab focus when it is clicked with the mouse. <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 compact><dt><b><a class="el" href="newin2p10s.html#_newin2p10s000057">Since gtkmm 2.10:</a></b></dt><dd></dd></dl> <dl compact><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> </dl> </div> </div><p> <a class="anchor" name="e36fe088c746518bc1b08fcf39f18133"></a><!-- doxytag: member="Gtk::FileChooserButton::set_title" ref="e36fe088c746518bc1b08fcf39f18133" 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" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"> <em>title</em> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Modifies the <em>title</em> of the browse dialog used by <em>button</em>. <p> <dl compact><dt><b><a class="el" href="newin2p6s.html#_newin2p6s000081">Since gtkmm 2.6:</a></b></dt><dd></dd></dl> <dl compact><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> </dl> </div> </div><p> <a class="anchor" name="918ae15bcb96d03765084d279a970c56"></a><!-- doxytag: member="Gtk::FileChooserButton::set_width_chars" ref="918ae15bcb96d03765084d279a970c56" 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 width="100%"></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 compact><dt><b><a class="el" href="newin2p6s.html#_newin2p6s000083">Since gtkmm 2.6:</a></b></dt><dd></dd></dl> <dl compact><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> </dl> </div> </div><p> <hr><h2>Friends And Related Function Documentation</h2> <a class="anchor" name="7d39ab3e179b4e4b1db974ac319fd985"></a><!-- doxytag: member="Gtk::FileChooserButton::wrap" ref="7d39ab3e179b4e4b1db974ac319fd985" 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 width="100%"><code> [related]</code></td> </tr> </table> </div> <div class="memdoc"> <p> A <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <p> <dl compact><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> </dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl> </div> </div><p> <hr>The documentation for this class was generated from the following file:<ul> <li><a class="el" href="filechooserbutton_8h.html">filechooserbutton.h</a></ul> </div> <!-- end main content --> <hr><address><small> Generated for gtkmm 2.4 by <a href="http://www.doxygen.org/index.html"> Doxygen</a> 1.5.1 © 1997-2001</small></address> </body> </html>