← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkFileChooserButton.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-05-04 12:24:25 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070504122425-0m8midgzrp40y8w2
Tags: 2.10.12-1ubuntu1
* Sync with Debian
* New upstream version:
  Fixed bugs:
  - 379414 file chooser warnings when changing path in the entry
  - 418585 GtkFileChooserDefault sizing code is not DPI independent
  - 419568 Crash in search if start with special letter
  - 435062 build dies with icon cache validation
  - 379399 Segfault to call gtk_print_operation_run twice.
  - 387889 cups backend has problems when there are too many printers
  - 418531 invalid read to gtkicontheme.c gtk_icon_theme_lookup_icon...
  - 423916 crash in color scheme code
  - 424042 Segmentation fault while quickly pressing Alt+arrows
  - 415260 Protect against negative indices when setting values in G...
  - 419171 XGetVisualInfo() may not set nxvisuals
  - 128852 Gdk cursors don't look good on win32
  - 344657 Ctrl-H doesn't toggle "Show Hidden Files" setting
  - 345345 PrintOperation::paginate is not emitted for class handler
  - 347567 GtkPrintOperation::end-print is not emitted if it's cance...
  - 369112 gtk_ui_manager_add_ui should accept unnamed separator
  - 392015 Selected menu item invisible on Windows Vista
  - 399253 MS-Windows Theme Bottom Tab placement rendering glitches
  - 399425 gtk_input_dialog_fill_axes() adds child to gtkscrolledwin...
  - 403251 [patch] little memory leak in GtkPrintJob
  - 403267 [patch] memory leak in GtkPageSetupUnixDialog
  - 403470 MS-Windows Theme tab placement other than on top leaks a ...
  - 404506 Windows system fonts that have multi-byte font names cann...
  - 405089 Incorrect window placement for GtkEventBox private window
  - 405515 Minor leak in gtkfilesystemmodel.c
  - 405539 gdk_pixbuf_save() for PNG saver can return FALSE without ...
  - 415681 gdk_window_clear_area includes an extra line and column o...
  - 418219 GtkRecentChooser should apply filter before sorting and c...
  - 418403 Scroll to printer after selecting it from settings
  - 421985 _gtk_print_operation_platform_backend_launch_preview
  - 421990 gtk_print_job_get_surface
  - 421993 gtk_print_operation_init
  - 423064 Conditional jump or move depends on uninitialised value(s...
  - 423722 Fix printing header in gtk-demo
  - 424168 gtk_print_operation_run on async preview
  - 425655 Don't install gtk+-unix-print-2.0.pc on non-UNIX platforms
  - 425786 GDK segfaults if XineramaQueryScreens fails
  - 428665 Lpr Backend gets stuck in infinite loop during gtk_enumer...
  - 429902 GtkPrintOperation leaks cairo contextes
  - 431997 First delay of GdkPixbufAnimationIter is wrong
  - 433242 Inconsistent scroll arrow position calculations
  - 433972 Placing gtk.Expander inside a gtk.TextView() changes gtk....
  - 434261 _gtk_toolbar_elide_underscores incorrectly handles some s...
  - 383354 ctrl-L should make 'Location' entry disappear
  - 418673 gtk_recent_manager_add_item
  - 429732 gtk_accel_group_finalize accesses invalid memory
  - 435028 WM_CLIENT_LEADER is wrong on the leader_window
  - 431067 Background of the header window is not updated
  - 338843 add recent files support inside the ui manager
  - 148535 add drop shadow to menus, tooltips, etc. under Windows XP
* debian/control.in:
  - Conflicts on ubuntulooks (<= 0.9.11-1)
* debian/patches/15_default-fallback-icon-theme.patch:
  - patch from Debian, fallback on gnome icon theme

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkFileChooserButton.html
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
5
<title>GtkFileChooserButton</title>
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
 
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
 
8
<link rel="up" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
 
9
<link rel="prev" href="GtkFileChooser.html" title="GtkFileChooser">
 
10
<link rel="next" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog">
 
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
 
12
<link rel="stylesheet" href="style.css" type="text/css">
 
13
<link rel="part" href="gtk.html" title="Part&#160;I.&#160;GTK+ Overview">
 
14
<link rel="part" href="gtkbase.html" title="Part&#160;II.&#160;GTK+ Core Reference">
 
15
<link rel="part" href="gtkobjects.html" title="Part&#160;III.&#160;GTK+ Widgets and Objects">
 
16
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
 
17
<link rel="chapter" href="ch02.html" title="Widget Gallery">
 
18
<link rel="chapter" href="WindowWidgets.html" title="Windows">
 
19
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
 
20
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
 
21
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
 
22
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
 
23
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
 
24
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
 
25
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
 
26
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
 
27
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
 
28
<link rel="chapter" href="Ornaments.html" title="Ornaments">
 
29
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
 
30
<link rel="chapter" href="Printing.html" title="Printing">
 
31
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
 
32
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
 
33
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
 
34
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
 
35
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
 
36
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
 
37
<link rel="part" href="migrating.html" title="Part&#160;IV.&#160;Migrating from Previous Versions of GTK+">
 
38
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
 
39
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
 
40
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
 
41
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
 
42
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
 
43
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
 
44
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
 
45
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
 
46
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
 
47
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
 
48
<link rel="part" href="pt05.html" title="Part&#160;V.&#160;GTK+ Tools">
 
49
<link rel="glossary" href="glossary.html" title="Glossary">
 
50
<link rel="index" href="ix01.html" title="Index">
 
51
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
 
52
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
 
53
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
 
54
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
 
55
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
 
56
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
 
57
</head>
 
58
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
59
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
60
<tr valign="middle">
 
61
<td><a accesskey="p" href="GtkFileChooser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
62
<td><a accesskey="u" href="SelectorWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
63
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
64
<th width="100%" align="center">GTK+ Reference Manual</th>
 
65
<td><a accesskey="n" href="GtkFileChooserDialog.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
66
</tr>
 
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3488117" class="shortcut">Top</a>
 
68
                  &#160;|&#160;
 
69
                  <a href="#id3488596" class="shortcut">Description</a>
 
70
                  &#160;|&#160;
 
71
                  <a href="#id3488408" class="shortcut">Object Hierarchy</a>
 
72
                  &#160;|&#160;
 
73
                  <a href="#id3488477" class="shortcut">Implemented Interfaces</a>
 
74
                  &#160;|&#160;
 
75
                  <a href="#id3488508" class="shortcut">Properties</a></nobr></td></tr>
 
76
</table>
 
77
<div class="refentry" lang="en">
 
78
<a name="GtkFileChooserButton"></a><div class="titlepage"></div>
 
79
<div class="refnamediv"><table width="100%"><tr>
 
80
<td valign="top">
 
81
<h2>
 
82
<a name="id3488117"></a><span class="refentrytitle">GtkFileChooserButton</span>
 
83
</h2>
 
84
<p>GtkFileChooserButton &#8212; A button to launch a file selection dialog</p>
 
85
</td>
 
86
<td valign="top" align="right"><img src="file-button.png"></td>
 
87
</tr></table></div>
 
88
<div class="refsynopsisdiv">
 
89
<h2>Synopsis</h2>
 
90
<pre class="synopsis">
 
91
 
 
92
#include &lt;gtk/gtk.h&gt;
 
93
 
 
94
 
 
95
                    <a href="GtkFileChooserButton.html#GtkFileChooserButton-struct">GtkFileChooserButton</a>;
 
96
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkFileChooserButton.html#gtk-file-chooser-button-new">gtk_file_chooser_button_new</a>         (const gchar *title,
 
97
                                                         <a href="GtkFileChooser.html#GtkFileChooserAction">GtkFileChooserAction</a> action);
 
98
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkFileChooserButton.html#gtk-file-chooser-button-new-with-backend">gtk_file_chooser_button_new_with_backend</a>
 
99
                                                        (const gchar *title,
 
100
                                                         <a href="GtkFileChooser.html#GtkFileChooserAction">GtkFileChooserAction</a> action,
 
101
                                                         const gchar *backend);
 
102
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a href="GtkFileChooserButton.html#gtk-file-chooser-button-new-with-dialog">gtk_file_chooser_button_new_with_dialog</a>
 
103
                                                        (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *dialog);
 
104
const gchar*        <a href="GtkFileChooserButton.html#gtk-file-chooser-button-get-title">gtk_file_chooser_button_get_title</a>   (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button);
 
105
void                <a href="GtkFileChooserButton.html#gtk-file-chooser-button-set-title">gtk_file_chooser_button_set_title</a>   (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button,
 
106
                                                         const gchar *title);
 
107
gint                <a href="GtkFileChooserButton.html#gtk-file-chooser-button-get-width-chars">gtk_file_chooser_button_get_width_chars</a>
 
108
                                                        (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button);
 
109
void                <a href="GtkFileChooserButton.html#gtk-file-chooser-button-set-width-chars">gtk_file_chooser_button_set_width_chars</a>
 
110
                                                        (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button,
 
111
                                                         gint n_chars);
 
112
gboolean            <a href="GtkFileChooserButton.html#gtk-file-chooser-button-get-focus-on-click">gtk_file_chooser_button_get_focus_on_click</a>
 
113
                                                        (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button);
 
114
void                <a href="GtkFileChooserButton.html#gtk-file-chooser-button-set-focus-on-click">gtk_file_chooser_button_set_focus_on_click</a>
 
115
                                                        (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button,
 
116
                                                         gboolean focus_on_click);
 
117
 
 
118
 
 
119
</pre>
 
120
</div>
 
121
<div class="refsect1" lang="en">
 
122
<a name="id3488408"></a><h2>Object Hierarchy</h2>
 
123
<pre class="synopsis">
 
124
 
 
125
  GObject
 
126
   +----GInitiallyUnowned
 
127
         +----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
 
128
               +----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
 
129
                     +----<a href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
 
130
                           +----<a href="GtkBox.html" title="GtkBox">GtkBox</a>
 
131
                                 +----<a href="GtkHBox.html" title="GtkHBox">GtkHBox</a>
 
132
                                       +----GtkFileChooserButton
 
133
</pre>
 
134
</div>
 
135
<div class="refsect1" lang="en">
 
136
<a name="id3488477"></a><h2>Implemented Interfaces</h2>
 
137
<p>
 
138
GtkFileChooserButton implements
 
139
 <a href="GtkFileChooser.html" title="GtkFileChooser">GtkFileChooser</a> and  AtkImplementorIface.</p>
 
140
</div>
 
141
<div class="refsect1" lang="en">
 
142
<a name="id3488508"></a><h2>Properties</h2>
 
143
<pre class="synopsis">
 
144
 
 
145
  "<a href="GtkFileChooserButton.html#GtkFileChooserButton--dialog">dialog</a>"                   <a href="GtkFileChooser.html" title="GtkFileChooser">GtkFileChooser</a>        : Write / Construct Only
 
146
  "<a href="GtkFileChooserButton.html#GtkFileChooserButton--focus-on-click">focus-on-click</a>"           gboolean              : Read / Write
 
147
  "<a href="GtkFileChooserButton.html#GtkFileChooserButton--title">title</a>"                    gchararray            : Read / Write
 
148
  "<a href="GtkFileChooserButton.html#GtkFileChooserButton--width-chars">width-chars</a>"              gint                  : Read / Write
 
149
</pre>
 
150
</div>
 
151
<div class="refsect1" lang="en">
 
152
<a name="id3488596"></a><h2>Description</h2>
 
153
<p>
 
154
The <a href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a> is a widget that lets the user select a
 
155
file.  It implements the <a href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> interface.  Visually, it is a
 
156
file name with a button to bring up a <a href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a>.
 
157
The user can then use that dialog to change the file associated with
 
158
that button.  This widget does not support setting the "select-multiple"
 
159
property to <code class="literal">TRUE</code>.
 
160
</p>
 
161
<div class="example">
 
162
<a name="id3488650"></a><p class="title"><b>Example&#160;28.&#160;Create a button to let the user select a file in /etc</b></p>
 
163
<div class="example-contents"><pre class="programlisting">
 
164
{
 
165
  GtkWidget *button;
 
166
 
 
167
  button = gtk_file_chooser_button_new (_("Select a file"),
 
168
                                        GTK_FILE_CHOOSER_ACTION_OPEN);
 
169
  gtk_file_chooser_set_current_folder (GTK_FILE_CHOOSER (button),
 
170
                                       "/etc");
 
171
}
 
172
</pre></div>
 
173
</div>
 
174
<br class="example-break"><p>
 
175
The <a href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a> supports the <a href="GtkFileChooser.html#GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a>s <a href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a> and <a href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a>.
 
176
</p>
 
177
<div class="important" style="margin-left: 0.5in; margin-right: 0.5in;">
 
178
<h3 class="title">Important</h3>
 
179
<p>
 
180
The <a href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a> will ellipsize the label,
 
181
and thus will thus request little horizontal space.  To give the button
 
182
more space, you should call <a href="GtkWidget.html#gtk-widget-size-request"><code class="function">gtk_widget_size_request()</code></a>,
 
183
<a href="GtkFileChooserButton.html#gtk-file-chooser-button-set-width-chars"><code class="function">gtk_file_chooser_button_set_width_chars()</code></a>, or pack the button in
 
184
such a way that other interface elements give space to the widget.
 
185
</p>
 
186
</div>
 
187
</div>
 
188
<div class="refsect1" lang="en">
 
189
<a name="id3488757"></a><h2>Details</h2>
 
190
<div class="refsect2" lang="en">
 
191
<a name="id3488767"></a><h3>
 
192
<a name="GtkFileChooserButton-struct"></a>GtkFileChooserButton</h3>
 
193
<a class="indexterm" name="id3488781"></a><pre class="programlisting">typedef struct _GtkFileChooserButton GtkFileChooserButton;</pre>
 
194
<p>
 
195
This should not be accessed directly.  Use the accessor functions below. 
 
196
</p>
 
197
</div>
 
198
<hr>
 
199
<div class="refsect2" lang="en">
 
200
<a name="id3488798"></a><h3>
 
201
<a name="gtk-file-chooser-button-new"></a>gtk_file_chooser_button_new ()</h3>
 
202
<a class="indexterm" name="id3488814"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_file_chooser_button_new         (const gchar *title,
 
203
                                                         <a href="GtkFileChooser.html#GtkFileChooserAction">GtkFileChooserAction</a> action);</pre>
 
204
<p>
 
205
Creates a new file-selecting button widget.</p>
 
206
<p>
 
207
 
 
208
</p>
 
209
<div class="variablelist"><table border="0">
 
210
<col align="left" valign="top">
 
211
<tbody>
 
212
<tr>
 
213
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
 
214
<td> the title of the browse dialog.
 
215
</td>
 
216
</tr>
 
217
<tr>
 
218
<td><span class="term"><em class="parameter"><code>action</code></em>&#160;:</span></td>
 
219
<td> the open mode for the widget.
 
220
</td>
 
221
</tr>
 
222
<tr>
 
223
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
224
<td> a new button widget.
 
225
 
 
226
</td>
 
227
</tr>
 
228
</tbody>
 
229
</table></div>
 
230
<p class="since">Since  2.6
 
231
</p>
 
232
</div>
 
233
<hr>
 
234
<div class="refsect2" lang="en">
 
235
<a name="id3488905"></a><h3>
 
236
<a name="gtk-file-chooser-button-new-with-backend"></a>gtk_file_chooser_button_new_with_backend ()</h3>
 
237
<a class="indexterm" name="id3488921"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_file_chooser_button_new_with_backend
 
238
                                                        (const gchar *title,
 
239
                                                         <a href="GtkFileChooser.html#GtkFileChooserAction">GtkFileChooserAction</a> action,
 
240
                                                         const gchar *backend);</pre>
 
241
<p>
 
242
Creates a new file-selecting button widget using <em class="parameter"><code>backend</code></em>.</p>
 
243
<p>
 
244
 
 
245
</p>
 
246
<div class="variablelist"><table border="0">
 
247
<col align="left" valign="top">
 
248
<tbody>
 
249
<tr>
 
250
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
 
251
<td> the title of the browse dialog.
 
252
</td>
 
253
</tr>
 
254
<tr>
 
255
<td><span class="term"><em class="parameter"><code>action</code></em>&#160;:</span></td>
 
256
<td> the open mode for the widget.
 
257
</td>
 
258
</tr>
 
259
<tr>
 
260
<td><span class="term"><em class="parameter"><code>backend</code></em>&#160;:</span></td>
 
261
<td> the name of the <span class="type">GtkFileSystem</span> backend to use.
 
262
</td>
 
263
</tr>
 
264
<tr>
 
265
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
266
<td> a new button widget.
 
267
 
 
268
</td>
 
269
</tr>
 
270
</tbody>
 
271
</table></div>
 
272
<p class="since">Since  2.6
 
273
</p>
 
274
</div>
 
275
<hr>
 
276
<div class="refsect2" lang="en">
 
277
<a name="id3489051"></a><h3>
 
278
<a name="gtk-file-chooser-button-new-with-dialog"></a>gtk_file_chooser_button_new_with_dialog ()</h3>
 
279
<a class="indexterm" name="id3489067"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_file_chooser_button_new_with_dialog
 
280
                                                        (<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *dialog);</pre>
 
281
<p>
 
282
Creates a <a href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a> widget which uses <em class="parameter"><code>dialog</code></em> as it's
 
283
file-picking window. Note that <em class="parameter"><code>dialog</code></em> must be a <a href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> (or
 
284
subclass) which implements the <a href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> interface and must 
 
285
not have <a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS"><code class="literal">GTK_DIALOG_DESTROY_WITH_PARENT</code></a> set.</p>
 
286
<p>
 
287
 
 
288
</p>
 
289
<div class="variablelist"><table border="0">
 
290
<col align="left" valign="top">
 
291
<tbody>
 
292
<tr>
 
293
<td><span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></td>
 
294
<td> the widget to use as dialog
 
295
</td>
 
296
</tr>
 
297
<tr>
 
298
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
299
<td> a new button widget.
 
300
 
 
301
</td>
 
302
</tr>
 
303
</tbody>
 
304
</table></div>
 
305
<p class="since">Since  2.6
 
306
</p>
 
307
</div>
 
308
<hr>
 
309
<div class="refsect2" lang="en">
 
310
<a name="id3489186"></a><h3>
 
311
<a name="gtk-file-chooser-button-get-title"></a>gtk_file_chooser_button_get_title ()</h3>
 
312
<a class="indexterm" name="id3489202"></a><pre class="programlisting">const gchar*        gtk_file_chooser_button_get_title   (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button);</pre>
 
313
<p>
 
314
Retrieves the title of the browse dialog used by <em class="parameter"><code>button</code></em>. The returned value
 
315
should not be modified or freed.</p>
 
316
<p>
 
317
 
 
318
</p>
 
319
<div class="variablelist"><table border="0">
 
320
<col align="left" valign="top">
 
321
<tbody>
 
322
<tr>
 
323
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
324
<td> the button widget to examine.
 
325
</td>
 
326
</tr>
 
327
<tr>
 
328
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
329
<td> a pointer to the browse dialog's title.
 
330
 
 
331
</td>
 
332
</tr>
 
333
</tbody>
 
334
</table></div>
 
335
<p class="since">Since  2.6
 
336
</p>
 
337
</div>
 
338
<hr>
 
339
<div class="refsect2" lang="en">
 
340
<a name="id3489279"></a><h3>
 
341
<a name="gtk-file-chooser-button-set-title"></a>gtk_file_chooser_button_set_title ()</h3>
 
342
<a class="indexterm" name="id3489296"></a><pre class="programlisting">void                gtk_file_chooser_button_set_title   (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button,
 
343
                                                         const gchar *title);</pre>
 
344
<p>
 
345
Modifies the <em class="parameter"><code>title</code></em> of the browse dialog used by <em class="parameter"><code>button</code></em>.</p>
 
346
<p>
 
347
 
 
348
</p>
 
349
<div class="variablelist"><table border="0">
 
350
<col align="left" valign="top">
 
351
<tbody>
 
352
<tr>
 
353
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
354
<td> the button widget to modify.
 
355
</td>
 
356
</tr>
 
357
<tr>
 
358
<td><span class="term"><em class="parameter"><code>title</code></em>&#160;:</span></td>
 
359
<td> the new browse dialog title.
 
360
</td>
 
361
</tr>
 
362
</tbody>
 
363
</table></div>
 
364
<p class="since">Since  2.6
 
365
</p>
 
366
</div>
 
367
<hr>
 
368
<div class="refsect2" lang="en">
 
369
<a name="id3489388"></a><h3>
 
370
<a name="gtk-file-chooser-button-get-width-chars"></a>gtk_file_chooser_button_get_width_chars ()</h3>
 
371
<a class="indexterm" name="id3489404"></a><pre class="programlisting">gint                gtk_file_chooser_button_get_width_chars
 
372
                                                        (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button);</pre>
 
373
<p>
 
374
Retrieves the width in characters of the <em class="parameter"><code>button</code></em> widget's entry and/or label.</p>
 
375
<p>
 
376
 
 
377
</p>
 
378
<div class="variablelist"><table border="0">
 
379
<col align="left" valign="top">
 
380
<tbody>
 
381
<tr>
 
382
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
383
<td> the button widget to examine.
 
384
</td>
 
385
</tr>
 
386
<tr>
 
387
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
388
<td> an integer width (in characters) that the button will use to size itself.
 
389
 
 
390
</td>
 
391
</tr>
 
392
</tbody>
 
393
</table></div>
 
394
<p class="since">Since  2.6
 
395
</p>
 
396
</div>
 
397
<hr>
 
398
<div class="refsect2" lang="en">
 
399
<a name="id3489481"></a><h3>
 
400
<a name="gtk-file-chooser-button-set-width-chars"></a>gtk_file_chooser_button_set_width_chars ()</h3>
 
401
<a class="indexterm" name="id3489498"></a><pre class="programlisting">void                gtk_file_chooser_button_set_width_chars
 
402
                                                        (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button,
 
403
                                                         gint n_chars);</pre>
 
404
<p>
 
405
Sets the width (in characters) that <em class="parameter"><code>button</code></em> will use to <em class="parameter"><code>n_chars</code></em>.</p>
 
406
<p>
 
407
 
 
408
</p>
 
409
<div class="variablelist"><table border="0">
 
410
<col align="left" valign="top">
 
411
<tbody>
 
412
<tr>
 
413
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
414
<td> the button widget to examine.
 
415
</td>
 
416
</tr>
 
417
<tr>
 
418
<td><span class="term"><em class="parameter"><code>n_chars</code></em>&#160;:</span></td>
 
419
<td> the new width, in characters.
 
420
</td>
 
421
</tr>
 
422
</tbody>
 
423
</table></div>
 
424
<p class="since">Since  2.6
 
425
</p>
 
426
</div>
 
427
<hr>
 
428
<div class="refsect2" lang="en">
 
429
<a name="id3489591"></a><h3>
 
430
<a name="gtk-file-chooser-button-get-focus-on-click"></a>gtk_file_chooser_button_get_focus_on_click ()</h3>
 
431
<a class="indexterm" name="id3489608"></a><pre class="programlisting">gboolean            gtk_file_chooser_button_get_focus_on_click
 
432
                                                        (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button);</pre>
 
433
<p>
 
434
Returns whether the button grabs focus when it is clicked with the mouse.
 
435
See <a href="GtkFileChooserButton.html#gtk-file-chooser-button-set-focus-on-click"><code class="function">gtk_file_chooser_button_set_focus_on_click()</code></a>.</p>
 
436
<p>
 
437
 
 
438
</p>
 
439
<div class="variablelist"><table border="0">
 
440
<col align="left" valign="top">
 
441
<tbody>
 
442
<tr>
 
443
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
444
<td> a <a href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a>
 
445
</td>
 
446
</tr>
 
447
<tr>
 
448
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
449
<td> <code class="literal">TRUE</code> if the button grabs focus when it is clicked with
 
450
              the mouse.
 
451
 
 
452
</td>
 
453
</tr>
 
454
</tbody>
 
455
</table></div>
 
456
<p class="since">Since  2.10
 
457
</p>
 
458
</div>
 
459
<hr>
 
460
<div class="refsect2" lang="en">
 
461
<a name="id3489710"></a><h3>
 
462
<a name="gtk-file-chooser-button-set-focus-on-click"></a>gtk_file_chooser_button_set_focus_on_click ()</h3>
 
463
<a class="indexterm" name="id3489726"></a><pre class="programlisting">void                gtk_file_chooser_button_set_focus_on_click
 
464
                                                        (<a href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a> *button,
 
465
                                                         gboolean focus_on_click);</pre>
 
466
<p>
 
467
Sets whether the button will grab focus when it is clicked with the mouse.
 
468
Making mouse clicks not grab focus is useful in places like toolbars where
 
469
you don't want the keyboard focus removed from the main area of the
 
470
application.</p>
 
471
<p>
 
472
 
 
473
</p>
 
474
<div class="variablelist"><table border="0">
 
475
<col align="left" valign="top">
 
476
<tbody>
 
477
<tr>
 
478
<td><span class="term"><em class="parameter"><code>button</code></em>&#160;:</span></td>
 
479
<td> a <a href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a>
 
480
</td>
 
481
</tr>
 
482
<tr>
 
483
<td><span class="term"><em class="parameter"><code>focus_on_click</code></em>&#160;:</span></td>
 
484
<td> whether the button grabs focus when clicked with the mouse
 
485
</td>
 
486
</tr>
 
487
</tbody>
 
488
</table></div>
 
489
<p class="since">Since  2.10
 
490
</p>
 
491
</div>
 
492
</div>
 
493
<div class="refsect1" lang="en">
 
494
<a name="id3489821"></a><h2>Property Details</h2>
 
495
<div class="refsect2" lang="en">
 
496
<a name="id3489831"></a><h3>
 
497
<a name="GtkFileChooserButton--dialog"></a>The "<code class="literal">dialog</code>" property</h3>
 
498
<a class="indexterm" name="id3489848"></a><pre class="programlisting">  "dialog"                   <a href="GtkFileChooser.html" title="GtkFileChooser">GtkFileChooser</a>        : Write / Construct Only</pre>
 
499
<p>
 
500
Instance of the <a href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a> associated with the button.</p>
 
501
<p>
 
502
 
 
503
</p>
 
504
<p>Since  2.6
 
505
</p>
 
506
</div>
 
507
<hr>
 
508
<div class="refsect2" lang="en">
 
509
<a name="id3489890"></a><h3>
 
510
<a name="GtkFileChooserButton--focus-on-click"></a>The "<code class="literal">focus-on-click</code>" property</h3>
 
511
<a class="indexterm" name="id3489908"></a><pre class="programlisting">  "focus-on-click"           gboolean              : Read / Write</pre>
 
512
<p>
 
513
Whether the <a href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a> button grabs focus when it is clicked
 
514
with the mouse.</p>
 
515
<p>
 
516
 
 
517
</p>
 
518
<p>Default value: TRUE</p>
 
519
<p>Since  2.10
 
520
</p>
 
521
</div>
 
522
<hr>
 
523
<div class="refsect2" lang="en">
 
524
<a name="id3489953"></a><h3>
 
525
<a name="GtkFileChooserButton--title"></a>The "<code class="literal">title</code>" property</h3>
 
526
<a class="indexterm" name="id3489969"></a><pre class="programlisting">  "title"                    gchararray            : Read / Write</pre>
 
527
<p>
 
528
Title to put on the <a href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a> associated with the button.</p>
 
529
<p>
 
530
 
 
531
</p>
 
532
<p>Default value: "Select A File"</p>
 
533
<p>Since  2.6
 
534
</p>
 
535
</div>
 
536
<hr>
 
537
<div class="refsect2" lang="en">
 
538
<a name="id3490015"></a><h3>
 
539
<a name="GtkFileChooserButton--width-chars"></a>The "<code class="literal">width-chars</code>" property</h3>
 
540
<a class="indexterm" name="id3490032"></a><pre class="programlisting">  "width-chars"              gint                  : Read / Write</pre>
 
541
<p>
 
542
The width of the entry and label inside the button, in characters.</p>
 
543
<p>
 
544
 
 
545
</p>
 
546
<p>Allowed values: &gt;= -1</p>
 
547
<p>Default value: -1</p>
 
548
<p>Since  2.6
 
549
</p>
 
550
</div>
 
551
</div>
 
552
<div class="refsect1" lang="en">
 
553
<a name="id3490072"></a><h2>See Also</h2>
 
554
<p>
 
555
<a href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a>
 
556
</p>
 
557
</div>
 
558
</div>
 
559
</body>
 
560
</html>