1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
<title>gtkmm: Gtk::FileChooserButton Class Reference</title>
6
<link href="tabs.css" rel="stylesheet" type="text/css"/>
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
10
<!-- Generated by Doxygen 1.7.3 -->
13
<table cellspacing="0" cellpadding="0">
15
<tr style="height: 56px;">
16
<td style="padding-left: 0.5em;">
17
<div id="projectname">gtkmm <span id="projectnumber">3.0.1</span></div>
23
<div id="navrow1" class="tabs">
25
<li><a href="index.html"><span>Main Page</span></a></li>
26
<li><a href="pages.html"><span>Related Pages</span></a></li>
27
<li><a href="modules.html"><span>Modules</span></a></li>
28
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
29
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
32
<div id="navrow2" class="tabs2">
34
<li><a href="annotated.html"><span>Class List</span></a></li>
35
<li><a href="classes.html"><span>Class Index</span></a></li>
36
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
37
<li><a href="functions.html"><span>Class Members</span></a></li>
40
<div id="nav-path" class="navpath">
42
<li class="navelem"><a class="el" href="namespaceGtk.html">Gtk</a> </li>
43
<li class="navelem"><a class="el" href="classGtk_1_1FileChooserButton.html">FileChooserButton</a> </li>
49
<a href="#pub-methods">Public Member Functions</a> |
50
<a href="#pro-methods">Protected Member Functions</a> |
51
<a href="#related">Related Functions</a> </div>
52
<div class="headertitle">
53
<h1>Gtk::FileChooserButton Class Reference<div class="ingroups"><a class="el" href="group__Widgets.html">Widgets</a></div></h1> </div>
55
<div class="contents">
56
<!-- doxytag: class="Gtk::FileChooserButton" --><!-- doxytag: inherits="Gtk::HBox,Gtk::FileChooser" -->
57
<p>A button to launch a file chooser dialog. <a href="#_details">More...</a></p>
58
<div class="dynheader">
59
Inheritance diagram for Gtk::FileChooserButton:</div>
60
<div class="dyncontent">
61
<div class="center"><img src="classGtk_1_1FileChooserButton__inherit__graph.png" border="0" usemap="#Gtk_1_1FileChooserButton_inherit__map" alt="Inheritance graph"/></div>
62
<map name="Gtk_1_1FileChooserButton_inherit__map" id="Gtk_1_1FileChooserButton_inherit__map">
63
<area shape="rect" id="node2" href="classGtk_1_1HBox.html" title="Horizontal Box for laying widgets in a horizontal row." alt="" coords="327,566,409,597"/><area shape="rect" id="node4" href="classGtk_1_1Box.html" title="A base class for box containers." alt="" coords="321,486,396,517"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="183,406,289,437"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="157,326,248,357"/><area shape="rect" id="node10" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="5,246,93,277"/><area shape="rect" id="node12" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="121,166,212,197"/><area shape="rect" id="node14" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="196,86,316,117"/><area shape="rect" id="node20" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="295,166,399,197"/><area shape="rect" id="node16" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="203,6,309,37"/><area shape="rect" id="node18" href="classGtk_1_1Buildable.html" title="A base class for objects that can be built by Gtk::Builder." alt="" coords="117,246,221,277"/><area shape="rect" id="node25" href="classGtk_1_1Orientable.html" title="This interface is implemented by all widgets that can be oriented horizontally or vertically..." alt="" coords="307,326,416,357"/><area shape="rect" id="node28" href="classGtk_1_1FileChooser.html" title="Gtk::FileChooser is an interface that can be implemented by file selection widgets." alt="" coords="396,406,516,437"/><area shape="rect" id="node23" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="245,246,368,277"/></map>
64
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
65
<div class="dynheader">
66
Collaboration diagram for Gtk::FileChooserButton:</div>
67
<div class="dyncontent">
68
<div class="center"><img src="classGtk_1_1FileChooserButton__coll__graph.png" border="0" usemap="#Gtk_1_1FileChooserButton_coll__map" alt="Collaboration graph"/></div>
69
<map name="Gtk_1_1FileChooserButton_coll__map" id="Gtk_1_1FileChooserButton_coll__map">
70
<area shape="rect" id="node2" href="classGtk_1_1HBox.html" title="Horizontal Box for laying widgets in a horizontal row." alt="" coords="327,566,409,597"/><area shape="rect" id="node4" href="classGtk_1_1Box.html" title="A base class for box containers." alt="" coords="321,486,396,517"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="183,406,289,437"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="157,326,248,357"/><area shape="rect" id="node10" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="5,246,93,277"/><area shape="rect" id="node12" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="121,166,212,197"/><area shape="rect" id="node14" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="196,86,316,117"/><area shape="rect" id="node20" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="295,166,399,197"/><area shape="rect" id="node16" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="203,6,309,37"/><area shape="rect" id="node18" href="classGtk_1_1Buildable.html" title="A base class for objects that can be built by Gtk::Builder." alt="" coords="117,246,221,277"/><area shape="rect" id="node25" href="classGtk_1_1Orientable.html" title="This interface is implemented by all widgets that can be oriented horizontally or vertically..." alt="" coords="307,326,416,357"/><area shape="rect" id="node28" href="classGtk_1_1FileChooser.html" title="Gtk::FileChooser is an interface that can be implemented by file selection widgets." alt="" coords="396,406,516,437"/><area shape="rect" id="node23" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="245,246,368,277"/></map>
71
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
73
<p><a href="classGtk_1_1FileChooserButton-members.html">List of all members.</a></p>
74
<table class="memberdecls">
75
<tr><td colspan="2"><h2><a name="pub-methods"></a>
76
Public Member Functions</h2></td></tr>
77
<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>
78
<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>
79
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#aaf5932fe7ee1cd32d8addba40c503640"></a><br/></td></tr>
80
<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>
81
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a1034a135ce8baf1da4a2c466189af990"></a><br/></td></tr>
82
<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>
83
<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>
84
<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" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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>
85
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new file-selecting button widget. <a href="#a89b1936bceedbe5656007077ce715b40"></a><br/></td></tr>
86
<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>
87
<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>
88
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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>
89
<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>
90
<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" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>& title)</td></tr>
91
<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>
92
<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>
93
<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>
94
<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>
95
<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>
96
<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>
97
<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>
98
<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>
99
<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>
100
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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>
101
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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>
102
<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>
103
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
104
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a9c99fb9ab1fdca112c728ce67529a8ff">property_focus_on_click</a> () const </td></tr>
105
<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>
106
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/>
107
< <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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>
108
<tr><td class="mdescLeft"> </td><td class="mdescRight">The title of the file chooser dialog. <a href="#aff9d0bc4031cd79272b6d83d5ef30c91"></a><br/></td></tr>
109
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
110
< <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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>
111
<tr><td class="mdescLeft"> </td><td class="mdescRight">The title of the file chooser dialog. <a href="#a34cb061e63002c26436cb16b7aaa9540"></a><br/></td></tr>
112
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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>
113
<tr><td class="mdescLeft"> </td><td class="mdescRight">The desired width of the button widget, in characters. <a href="#ae875e9c906a106b0e5b8b3ebe7a85839"></a><br/></td></tr>
114
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/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>
115
<tr><td class="mdescLeft"> </td><td class="mdescRight">The desired width of the button widget, in characters. <a href="#a083d5fe6a22315beae20bb4a72139b9a"></a><br/></td></tr>
116
<tr><td colspan="2"><h2><a name="pro-methods"></a>
117
Protected Member Functions</h2></td></tr>
118
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1FileChooserButton.html#a4830c8396e98c88920cd23cbc81c3b5d">on_file_set</a> ()</td></tr>
119
<tr><td colspan="2"><h2><a name="related"></a>
120
Related Functions</h2></td></tr>
121
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
122
<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>
123
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a7d39ab3e179b4e4b1db974ac319fd985"></a><br/></td></tr>
125
<hr/><a name="_details"></a><h2>Detailed Description</h2>
126
<div class="textblock"><p>A button to launch a file chooser dialog. </p>
127
<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>
128
<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>
129
<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 size_request(), <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>
130
<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>
132
<img src="filechooserbutton1.png" alt="filechooserbutton1.png"/>
134
</div><hr/><h2>Constructor & Destructor Documentation</h2>
135
<a class="anchor" id="a2c68ac3c0392c0710fc4bdb7725c99a4"></a><!-- doxytag: member="Gtk::FileChooserButton::~FileChooserButton" ref="a2c68ac3c0392c0710fc4bdb7725c99a4" args="()" -->
136
<div class="memitem">
137
<div class="memproto">
138
<table class="memname">
140
<td class="memname">virtual Gtk::FileChooserButton::~FileChooserButton </td>
142
<td class="paramname"></td><td>)</td>
143
<td><code> [virtual]</code></td>
151
<a class="anchor" id="afd7480a2731641ce37abb939775d6238"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="afd7480a2731641ce37abb939775d6238" args="(FileChooserAction action=FILE_CHOOSER_ACTION_OPEN)" -->
152
<div class="memitem">
153
<div class="memproto">
154
<table class="memname">
156
<td class="memname">Gtk::FileChooserButton::FileChooserButton </td>
158
<td class="paramtype"><a class="el" href="group__gtkmmEnums.html#ga0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> </td>
159
<td class="paramname"><em>action</em> = <code>FILE_CHOOSER_ACTION_OPEN</code></td><td>)</td>
160
<td><code> [explicit]</code></td>
166
<p>Creates a new file-selecting button widget with the default title. </p>
167
<dl><dt><b>Parameters:</b></dt><dd>
168
<table class="params">
169
<tr><td class="paramname">title</td><td>The title of the browse dialog. </td></tr>
170
<tr><td class="paramname">action</td><td>The open mode for the widget. </td></tr>
177
<a class="anchor" id="a89b1936bceedbe5656007077ce715b40"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="a89b1936bceedbe5656007077ce715b40" args="(const Glib::ustring &title, FileChooserAction action=FILE_CHOOSER_ACTION_OPEN)" -->
178
<div class="memitem">
179
<div class="memproto">
180
<table class="memname">
182
<td class="memname">Gtk::FileChooserButton::FileChooserButton </td>
184
<td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
185
<td class="paramname"><em>title</em>, </td>
188
<td class="paramkey"></td>
190
<td class="paramtype"><a class="el" href="group__gtkmmEnums.html#ga0d6076e7637ec501f26296e65fee2212">FileChooserAction</a> </td>
191
<td class="paramname"><em>action</em> = <code>FILE_CHOOSER_ACTION_OPEN</code> </td>
196
<td></td><td><code> [explicit]</code></td>
202
<p>Creates a new file-selecting button widget. </p>
203
<dl><dt><b>Parameters:</b></dt><dd>
204
<table class="params">
205
<tr><td class="paramname">title</td><td>The title of the browse dialog. </td></tr>
206
<tr><td class="paramname">action</td><td>The open mode for the widget. </td></tr>
213
<a class="anchor" id="a69b4b54a614b7312cec8c80a039f0536"></a><!-- doxytag: member="Gtk::FileChooserButton::FileChooserButton" ref="a69b4b54a614b7312cec8c80a039f0536" args="(FileChooserDialog &dialog)" -->
214
<div class="memitem">
215
<div class="memproto">
216
<table class="memname">
218
<td class="memname">Gtk::FileChooserButton::FileChooserButton </td>
220
<td class="paramtype"><a class="el" href="classGtk_1_1FileChooserDialog.html">FileChooserDialog</a>& </td>
221
<td class="paramname"><em>dialog</em></td><td>)</td>
222
<td><code> [explicit]</code></td>
228
<p>Creates a new file-selecting button widget which uses dialog as its file-picking window. </p>
229
<dl><dt><b>Parameters:</b></dt><dd>
230
<table class="params">
231
<tr><td class="paramname">dialog</td><td>The dialog to use. </td></tr>
238
<hr/><h2>Member Function Documentation</h2>
239
<a class="anchor" id="a85e16d51083b0f8f79498fec19022a0d"></a><!-- doxytag: member="Gtk::FileChooserButton::get_focus_on_click" ref="a85e16d51083b0f8f79498fec19022a0d" args="() const " -->
240
<div class="memitem">
241
<div class="memproto">
242
<table class="memname">
244
<td class="memname">bool Gtk::FileChooserButton::get_focus_on_click </td>
246
<td class="paramname"></td><td>)</td>
253
<p>Returns whether the button grabs focus when it is clicked with the mouse. </p>
254
<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>
255
<dl class="since_2_10"><dt><b><a class="el" href="since_2_10.html#_since_2_10000052">Since gtkmm 2.10:</a></b></dt><dd></dd></dl>
256
<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>
260
<a class="anchor" id="a21a0995ec1e52fad200a726771e711de"></a><!-- doxytag: member="Gtk::FileChooserButton::get_title" ref="a21a0995ec1e52fad200a726771e711de" args="() const " -->
261
<div class="memitem">
262
<div class="memproto">
263
<table class="memname">
265
<td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> Gtk::FileChooserButton::get_title </td>
267
<td class="paramname"></td><td>)</td>
274
<p>Retrieves the title of the browse dialog used by <em>button</em>. </p>
275
<p>The returned value should not be modified or freed.</p>
276
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000071">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
277
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to the browse dialog's title. </dd></dl>
281
<a class="anchor" id="a1a500fa7a344b984e0b4e996a8304627"></a><!-- doxytag: member="Gtk::FileChooserButton::get_width_chars" ref="a1a500fa7a344b984e0b4e996a8304627" args="() const " -->
282
<div class="memitem">
283
<div class="memproto">
284
<table class="memname">
286
<td class="memname">int Gtk::FileChooserButton::get_width_chars </td>
288
<td class="paramname"></td><td>)</td>
295
<p>Retrieves the width in characters of the <em>button</em> widget's entry and/or label. </p>
296
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000073">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
297
<dl class="return"><dt><b>Returns:</b></dt><dd>An integer width (in characters) that the button will use to size itself. </dd></dl>
301
<a class="anchor" id="aaf5932fe7ee1cd32d8addba40c503640"></a><!-- doxytag: member="Gtk::FileChooserButton::gobj" ref="aaf5932fe7ee1cd32d8addba40c503640" args="()" -->
302
<div class="memitem">
303
<div class="memproto">
304
<table class="memname">
306
<td class="memname">GtkFileChooserButton* Gtk::FileChooserButton::gobj </td>
308
<td class="paramname"></td><td>)</td>
309
<td><code> [inline]</code></td>
315
<p>Provides access to the underlying C GtkObject. </p>
317
<p>Reimplemented from <a class="el" href="classGtk_1_1HBox.html#a276c36213ef878a34ab3a16a6f2dc94b">Gtk::HBox</a>.</p>
321
<a class="anchor" id="a1034a135ce8baf1da4a2c466189af990"></a><!-- doxytag: member="Gtk::FileChooserButton::gobj" ref="a1034a135ce8baf1da4a2c466189af990" args="() const " -->
322
<div class="memitem">
323
<div class="memproto">
324
<table class="memname">
326
<td class="memname">const GtkFileChooserButton* Gtk::FileChooserButton::gobj </td>
328
<td class="paramname"></td><td>)</td>
329
<td> const<code> [inline]</code></td>
335
<p>Provides access to the underlying C GtkObject. </p>
337
<p>Reimplemented from <a class="el" href="classGtk_1_1HBox.html#a200e7083acf10d6075633a5bb2eef9d0">Gtk::HBox</a>.</p>
341
<a class="anchor" id="a4830c8396e98c88920cd23cbc81c3b5d"></a><!-- doxytag: member="Gtk::FileChooserButton::on_file_set" ref="a4830c8396e98c88920cd23cbc81c3b5d" args="()" -->
342
<div class="memitem">
343
<div class="memproto">
344
<table class="memname">
346
<td class="memname">virtual void Gtk::FileChooserButton::on_file_set </td>
348
<td class="paramname"></td><td>)</td>
349
<td><code> [protected, virtual]</code></td>
357
<a class="anchor" id="ad251f019b07fc3456bdd96aaf3fb8d0c"></a><!-- doxytag: member="Gtk::FileChooserButton::property_focus_on_click" ref="ad251f019b07fc3456bdd96aaf3fb8d0c" args="()" -->
358
<div class="memitem">
359
<div class="memproto">
360
<table class="memname">
362
<td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::FileChooserButton::property_focus_on_click </td>
364
<td class="paramname"></td><td>)</td>
371
<p>Whether the button grabs focus when it is clicked with the mouse. </p>
372
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
373
<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>
377
<a class="anchor" id="a9c99fb9ab1fdca112c728ce67529a8ff"></a><!-- doxytag: member="Gtk::FileChooserButton::property_focus_on_click" ref="a9c99fb9ab1fdca112c728ce67529a8ff" args="() const " -->
378
<div class="memitem">
379
<div class="memproto">
380
<table class="memname">
382
<td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::FileChooserButton::property_focus_on_click </td>
384
<td class="paramname"></td><td>)</td>
391
<p>Whether the button grabs focus when it is clicked with the mouse. </p>
392
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
393
<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>
397
<a class="anchor" id="aff9d0bc4031cd79272b6d83d5ef30c91"></a><!-- doxytag: member="Gtk::FileChooserButton::property_title" ref="aff9d0bc4031cd79272b6d83d5ef30c91" args="()" -->
398
<div class="memitem">
399
<div class="memproto">
400
<table class="memname">
402
<td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::FileChooserButton::property_title </td>
404
<td class="paramname"></td><td>)</td>
411
<p>The title of the file chooser dialog. </p>
412
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
413
<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>
417
<a class="anchor" id="a34cb061e63002c26436cb16b7aaa9540"></a><!-- doxytag: member="Gtk::FileChooserButton::property_title" ref="a34cb061e63002c26436cb16b7aaa9540" args="() const " -->
418
<div class="memitem">
419
<div class="memproto">
420
<table class="memname">
422
<td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::FileChooserButton::property_title </td>
424
<td class="paramname"></td><td>)</td>
431
<p>The title of the file chooser dialog. </p>
432
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
433
<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>
437
<a class="anchor" id="a083d5fe6a22315beae20bb4a72139b9a"></a><!-- doxytag: member="Gtk::FileChooserButton::property_width_chars" ref="a083d5fe6a22315beae20bb4a72139b9a" args="() const " -->
438
<div class="memitem">
439
<div class="memproto">
440
<table class="memname">
442
<td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><int> Gtk::FileChooserButton::property_width_chars </td>
444
<td class="paramname"></td><td>)</td>
451
<p>The desired width of the button widget, in characters. </p>
452
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
453
<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>
457
<a class="anchor" id="ae875e9c906a106b0e5b8b3ebe7a85839"></a><!-- doxytag: member="Gtk::FileChooserButton::property_width_chars" ref="ae875e9c906a106b0e5b8b3ebe7a85839" args="()" -->
458
<div class="memitem">
459
<div class="memproto">
460
<table class="memname">
462
<td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><int> Gtk::FileChooserButton::property_width_chars </td>
464
<td class="paramname"></td><td>)</td>
471
<p>The desired width of the button widget, in characters. </p>
472
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
473
<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>
477
<a class="anchor" id="a51e5660524652f6da60e29c5c9d9ffae"></a><!-- doxytag: member="Gtk::FileChooserButton::set_focus_on_click" ref="a51e5660524652f6da60e29c5c9d9ffae" args="(gboolean focus_on_click=true)" -->
478
<div class="memitem">
479
<div class="memproto">
480
<table class="memname">
482
<td class="memname">void Gtk::FileChooserButton::set_focus_on_click </td>
484
<td class="paramtype">gboolean </td>
485
<td class="paramname"><em>focus_on_click</em> = <code>true</code></td><td>)</td>
492
<p>Sets whether the button will grab focus when it is clicked with the mouse. </p>
493
<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>
494
<dl class="since_2_10"><dt><b><a class="el" href="since_2_10.html#_since_2_10000053">Since gtkmm 2.10:</a></b></dt><dd></dd></dl>
495
<dl><dt><b>Parameters:</b></dt><dd>
496
<table class="params">
497
<tr><td class="paramname">focus_on_click</td><td>Whether the button grabs focus when clicked with the mouse. </td></tr>
504
<a class="anchor" id="ae36fe088c746518bc1b08fcf39f18133"></a><!-- doxytag: member="Gtk::FileChooserButton::set_title" ref="ae36fe088c746518bc1b08fcf39f18133" args="(const Glib::ustring &title)" -->
505
<div class="memitem">
506
<div class="memproto">
507
<table class="memname">
509
<td class="memname">void Gtk::FileChooserButton::set_title </td>
511
<td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
512
<td class="paramname"><em>title</em></td><td>)</td>
519
<p>Modifies the <em>title</em> of the browse dialog used by <em>button</em>. </p>
520
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000072">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
521
<dl><dt><b>Parameters:</b></dt><dd>
522
<table class="params">
523
<tr><td class="paramname">title</td><td>The new browse dialog title. </td></tr>
530
<a class="anchor" id="a918ae15bcb96d03765084d279a970c56"></a><!-- doxytag: member="Gtk::FileChooserButton::set_width_chars" ref="a918ae15bcb96d03765084d279a970c56" args="(int n_chars)" -->
531
<div class="memitem">
532
<div class="memproto">
533
<table class="memname">
535
<td class="memname">void Gtk::FileChooserButton::set_width_chars </td>
537
<td class="paramtype">int </td>
538
<td class="paramname"><em>n_chars</em></td><td>)</td>
545
<p>Sets the width (in characters) that <em>button</em> will use to <em>n_chars</em>. </p>
546
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000074">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
547
<dl><dt><b>Parameters:</b></dt><dd>
548
<table class="params">
549
<tr><td class="paramname">n_chars</td><td>The new width, in characters. </td></tr>
556
<a class="anchor" id="a16149ec54325c971d2525de8b435999a"></a><!-- doxytag: member="Gtk::FileChooserButton::signal_file_set" ref="a16149ec54325c971d2525de8b435999a" args="()" -->
557
<div class="memitem">
558
<div class="memproto">
559
<table class="memname">
561
<td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > Gtk::FileChooserButton::signal_file_set </td>
563
<td class="paramname"></td><td>)</td>
569
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_file_set()</code> </dd></dl>
573
<hr/><h2>Friends And Related Function Documentation</h2>
574
<a class="anchor" id="a7d39ab3e179b4e4b1db974ac319fd985"></a><!-- doxytag: member="Gtk::FileChooserButton::wrap" ref="a7d39ab3e179b4e4b1db974ac319fd985" args="(GtkFileChooserButton *object, bool take_copy=false)" -->
575
<div class="memitem">
576
<div class="memproto">
577
<table class="memname">
579
<td class="memname"><a class="el" href="classGtk_1_1FileChooserButton.html">Gtk::FileChooserButton</a>* wrap </td>
581
<td class="paramtype">GtkFileChooserButton * </td>
582
<td class="paramname"><em>object</em>, </td>
585
<td class="paramkey"></td>
587
<td class="paramtype">bool </td>
588
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
593
<td></td><td><code> [related]</code></td>
599
<p>A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
600
<dl><dt><b>Parameters:</b></dt><dd>
601
<table class="params">
602
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
603
<tr><td class="paramname">take_copy</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>
607
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
611
<hr/>The documentation for this class was generated from the following file:<ul>
612
<li>gtkmm/filechooserbutton.h</li>
615
<hr class="footer"/><address class="footer"><small>Generated on Mon May 9 2011 10:20:08 for gtkmm by 
616
<a href="http://www.doxygen.org/index.html">
617
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>