/usr/share/gtk-doc/html/pygtk/class-gtkfilechooserbutton.html is in python-gtk2-doc 2.24.0-4ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.FileChooserButton</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtkfilechooser.html" title="gtk.FileChooser"><link rel="next" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.FileChooserButton</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkfilechooser.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkfilechooserdialog.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.FileChooserButton"><a name="class-gtkfilechooserbutton"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.FileChooserButton</h2><p>gtk.FileChooserButton — a button to launch a <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a>
(new in PyGTK 2.6)</p></div><div class="refsect1" title="Synopsis"><a name="id3707900"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.FileChooserButton</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkhbox.html" title="gtk.HBox">gtk.HBox</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkfilechooserbutton.html#constructor-gtkfilechooserbutton" title="gtk.FileChooserButton">gtk.FileChooserButton</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>backend</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkfilechooserbutton.html#constructor-gtkfilechooserbutton2" title="gtk.FileChooserButton">gtk.FileChooserButton</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dialog</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfilechooserbutton.html#method-gtkfilechooserbutton--get-title" title="gtk.FileChooserButton.get_title">get_title</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfilechooserbutton.html#method-gtkfilechooserbutton--set-title" title="gtk.FileChooserButton.set_title">set_title</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfilechooserbutton.html#method-gtkfilechooserbutton--get-width-chars" title="gtk.FileChooserButton.get_width_chars">get_width_chars</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code></code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfilechooserbutton.html#method-gtkfilechooserbutton--set-width-chars" title="gtk.FileChooserButton.set_width_chars">set_width_chars</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>n_chars</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfilechooserbutton.html#method-gtkfilechooserbutton--get-focus-on-click" title="gtk.FileChooserButton.get_focus_on_click">get_focus_on_click</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfilechooserbutton.html#method-gtkfilechooserbutton--set-focus-on-click" title="gtk.FileChooserButton.set_focus_on_click">set_focus_on_click</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_on_click</code></strong></span></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3708157"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
+-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
+-- <a class="link" href="class-gtkbox.html" title="gtk.Box">gtk.Box</a>
+-- <a class="link" href="class-gtkhbox.html" title="gtk.HBox">gtk.HBox</a>
+-- <a class="link" href="class-gtkfilechooserbutton.html" title="gtk.FileChooserButton">gtk.FileChooserButton</a> (implements <a class="link" href="class-gtkfilechooser.html" title="gtk.FileChooser">gtk.FileChooser</a>)</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id3708221"></a><h2>Implemented Interfaces</h2><p>
<a class="link" href="class-gtkfilechooserbutton.html" title="gtk.FileChooserButton"><code class="classname">gtk.FileChooserButton</code></a>
implements
<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
</p></div><div class="refsect1" title="gtk.FileChooserButton Properties"><a name="properties-gtkfilechooserbutton"></a><h2>gtk.FileChooserButton Properties</h2><p><a class="link" href="class-gtkfilechooser.html#properties-gtkfilechooser" title="gtk.FileChooser Properties">gtk.FileChooser Properties</a></p><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p><p><a class="link" href="class-gtkbox.html#properties-gtkbox" title="gtk.Box Properties">gtk.Box Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"dialog"</td><td valign="top">Write-Construct Only</td><td valign="top">The <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a>
associated with the button. Available in GTK+ 2.6.</td></tr><tr valign="top"><td valign="top">"focus-on-click"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> the <a class="link" href="class-gtkfilechooserbutton.html" title="gtk.FileChooserButton"><code class="classname">gtk.FileChooserButton</code></a>
button grabs focus when it is clicked with the mouse. Default
value: <code class="literal">True</code>. Available in GTK+
2.10.</td></tr><tr valign="top"><td valign="top">"title"</td><td valign="top">Read-Write</td><td valign="top">The string to use as the title on the <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a>
associated with the button. Default value: "Select A
File". Available in GTK+ 2.6.</td></tr><tr valign="top"><td valign="top">"width-chars"</td><td valign="top">Read-Write</td><td valign="top">The width of the entry and label inside the button, in
characters. Allowed values: >= -1. Default value:
-1. Available in GTK+ 2.6.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.FileChooserButton Style Properties"><a name="style-properties-gtkfilechooserbutton"></a><h2>gtk.FileChooserButton Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p></div><div class="refsect1" title="gtk.FileChooserButton Child Properties"><a name="child-properties-gtkfilechooserbutton"></a><h2>gtk.FileChooserButton Child Properties</h2><p><a class="link" href="class-gtkbox.html#child-properties-gtkbox" title="gtk.Box Child Properties">gtk.Box Child Properties</a></p></div><div class="refsect1" title="gtk.FileChooserButton Signal Prototypes"><a name="signal-prototypes-gtkfilechooserbutton"></a><h2>gtk.FileChooserButton Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><p><a class="link" href="class-gtkfilechooser.html#signal-prototypes-gtkfilechooser" title="gtk.FileChooser Signal Prototypes">gtk.FileChooser Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtkfilechooserbutton.html#signal-gtkfilechooserbutton--file-set" title='The "file-set" gtk.FileChooserButton Signal'>file-set</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>filechooserbutton</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id3708614"></a><h2>Description</h2><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This widget is available in PyGTK 2.6 and above.</p></div><p>The <a class="link" href="class-gtkfilechooserbutton.html" title="gtk.FileChooserButton"><code class="classname">gtk.FileChooserButton</code></a>
is a widget that lets the user select a file. It implements the <a class="link" href="class-gtkfilechooser.html" title="gtk.FileChooser"><code class="classname">gtk.FileChooser</code></a>
interface. Visually, it is a file name with a button to bring up a <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></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 <code class="literal">True</code>. For example to create a <a class="link" href="class-gtkfilechooserbutton.html" title="gtk.FileChooserButton"><code class="classname">gtk.FileChooserButton</code></a>
and set the current folder to '/etc' use:</p><pre class="programlisting">
filechooserbutton = gtk.FileChooserButton('Select a File')
filechooserbutton.set_current_folder('/etc')
</pre><p>The <a class="link" href="class-gtkfilechooserbutton.html" title="gtk.FileChooserButton"><code class="classname">gtk.FileChooserButton</code></a>
supports the <code class="literal">gtk.FILE_CHOOSER_ACTION_OPEN</code> and
<code class="literal">gtk.FILE_CHOOSER_ACTION_SELECT_FOLDER</code> actions of the
<a class="xref" href="gtk-constants.html#gtk-filechooser-action-constants" title="GTK FileChooser Action Constants">GTK FileChooser Action Constants</a>.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The <a class="link" href="class-gtkfilechooserbutton.html" title="gtk.FileChooserButton"><code class="classname">gtk.FileChooserButton</code></a>
will ellipsize the label, and thus will thus request little horizontal
space. To give the button more space, you should call the <a class="link" href="class-gtkwidget.html#method-gtkwidget--size-request" title="gtk.Widget.size_request"><code class="methodname">gtk.Widget.size_request</code>()</a>
method, the <a class="link" href="class-gtkfilechooserbutton.html#method-gtkfilechooserbutton--set-width-chars" title="gtk.FileChooserButton.set_width_chars"><code class="methodname">set_width_chars</code>()</a>
method, or pack the button in such a way that other interface elements
give space to the widget.</p></div></div><div class="refsect1" title="Constructor"><a name="id3708753"></a><h2>Constructor</h2><div class="refsect2" title="gtk.FileChooserButton"><a name="constructor-gtkfilechooserbutton"></a><h3>gtk.FileChooserButton</h3><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.FileChooserButton</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>backend</code></strong></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>title</code></strong> :</span></p></td><td>the title of the browse dialog</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>backend</code></strong> :</span></p></td><td>the name of a file system backend or
<code class="literal">None</code></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-gtkfilechooserbutton.html" title="gtk.FileChooserButton"><code class="classname">gtk.FileChooserButton</code></a></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This constructor is available in PyGTK 2.6 and above.</p></div><p>Creates a new button widget that opens a <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a>
when clicked. The title of the <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a>
is specified by <em class="parameter"><code>title</code></em>. If
<em class="parameter"><code>backend</code></em> is specified it is the name of a file system
backend.</p></div><div class="refsect2" title="gtk.FileChooserButton"><a name="constructor-gtkfilechooserbutton2"></a><h3>gtk.FileChooserButton</h3><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.FileChooserButton</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>dialog</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>dialog</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-gtkfilechooserbutton.html" title="gtk.FileChooserButton"><code class="classname">gtk.FileChooserButton</code></a></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This constructor is available in PyGTK 2.6 and above.</p></div><p>Creates a new button widget that opens a <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a>
specified by <em class="parameter"><code>dialog</code></em> when clicked.</p></div></div><div class="refsect1" title="Methods"><a name="id3709043"></a><h2>Methods</h2><div class="refsect2" title="gtk.FileChooserButton.get_title"><a name="method-gtkfilechooserbutton--get-title"></a><h3>gtk.FileChooserButton.get_title</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_title</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the title of the <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_title</code>() method returns the
value of the "title" property which contains the title of the associated
<a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a>.</p></div><div class="refsect2" title="gtk.FileChooserButton.set_title"><a name="method-gtkfilechooserbutton--set-title"></a><h3>gtk.FileChooserButton.set_title</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_title</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>title</code></strong> :</span></p></td><td>a string to use as the title of the associated
<a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_title</code>() method sets the "title"
property to the value of <em class="parameter"><code>title</code></em>. The "title" property
contains the title string of the associated <a class="link" href="class-gtkfilechooserdialog.html" title="gtk.FileChooserDialog"><code class="classname">gtk.FileChooserDialog</code></a>.</p></div><div class="refsect2" title="gtk.FileChooserButton.get_width_chars"><a name="method-gtkfilechooserbutton--get-width-chars"></a><h3>gtk.FileChooserButton.get_width_chars</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_width_chars</span>()</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :, </span><span class="term"><strong class="parameter"><code></code></strong> :</span></p></td><td>the width in characters of the
button</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_width_chars</code>() method returns
the value of the "width-characters" property which contains the number of
characters the button width should be set to.</p></div><div class="refsect2" title="gtk.FileChooserButton.set_width_chars"><a name="method-gtkfilechooserbutton--set-width-chars"></a><h3>gtk.FileChooserButton.set_width_chars</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_width_chars</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>n_chars</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>n_chars</code></strong> :</span></p></td><td>the width in characters for the
button</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_width_chars</code>() method sets the
"width-chars" property to the value of <em class="parameter"><code>n_chars</code></em>. The
"width-chars" property contains the width in characters that the button
should be set to.</p></div><div class="refsect2" title="gtk.FileChooserButton.get_focus_on_click"><a name="method-gtkfilechooserbutton--get-focus-on-click"></a><h3>gtk.FileChooserButton.get_focus_on_click</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_focus_on_click</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the button grabs
focus when it is clicked with the mouse.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">get_focus_on_click</code>() method returns
the value of the "focus-on-click" property. If the return value is
<code class="literal">True</code> if the button grabs focus when it is clicked
with the mouse. See the <a class="link" href="class-gtkfilechooserbutton.html#method-gtkfilechooserbutton--set-focus-on-click" title="gtk.FileChooserButton.set_focus_on_click"><code class="methodname">set_focus_on_click()</code></a>
method.</p></div><div class="refsect2" title="gtk.FileChooserButton.set_focus_on_click"><a name="method-gtkfilechooserbutton--set-focus-on-click"></a><h3>gtk.FileChooserButton.set_focus_on_click</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_focus_on_click</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_on_click</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>focus_on_click</code></strong> :</span></p></td><td>If <code class="literal">True</code>, the button grabs
focus when clicked with the mouse</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">set_focus_on_click</code>() method sets
the "focus-on-click" property to the value of
<em class="parameter"><code>focus_on_click</code></em>. If
<em class="parameter"><code>focus_on_click</code></em> is <code class="literal">True</code>, the
button will grab focus when it is clicked with the mouse. Making
mouse clicks not grab focus is useful in places like toolbars where
you don't want the keyboard focus removed from the main area of the
application.</p></div></div><div class="refsect1" title="Signals"><a name="id3709584"></a><h2>Signals</h2><div class="refsect2" title='The "file-set" gtk.FileChooserButton Signal'><a name="signal-gtkfilechooserbutton--file-set"></a><h3>The "file-set" gtk.FileChooserButton Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>filechooserbutton</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>filechooserbutton</code></em> :</span></p></td><td>the filechooserbutton that received the signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified with the
<PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in GTK+ 2.12 and above.</p></div><p>
The "file-set" signal is emitted when the user selects a file.
</p><p>
Note that this signal is only emitted when the user changes the file.
</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtkfilechooser.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gtkfilechooserdialog.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.FileChooser </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.FileChooserDialog</td></tr></table></div></body></html>
|