~ubuntu-branches/ubuntu/gutsy/libgnomeui/gutsy-updates

« back to all changes in this revision

Viewing changes to doc/reference/html/GnomeEntry.html

  • Committer: Bazaar Package Importer
  • Author(s): Loic Minier
  • Date: 2007-10-17 18:03:35 UTC
  • mfrom: (1.1.23 upstream)
  • Revision ID: james.westby@ubuntu.com-20071017180335-cwv4tnukylfb41xd
Tags: 2.20.1.1-0ubuntu1
* Targetting GNOME 2.20.1 SRU at gutsy-proposed.
* New upstream stable release; no API change.
  - i18n fixing (Christian Persch, Takao Fujiwara)
  - CD-ROMs not shown in the file chooser (Federico Meña Quintero)
  - Better user feedback when creating a dir fails (Richard Hult)
  - Fix http://bugzilla.gnome.org/show_bug.cgi?id=485922 - Errors from
    GtkFileSystemGnomeVFS are not translated, and are too general.
    (Federico Meña Quintero)
* New upstream stable release; no API change.
  - Fix crash in thumbnail (Fernando Herrera, Christian Persch)
  - Revert change that added new strings [bug #485922] (Vincent Untz)

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>GnomeEntry</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
7
<link rel="start" href="index.html" title="GNOME UI Library Reference Manual">
8
8
<link rel="up" href="deprecated.html" title="Deprecated Modules">
9
9
<link rel="prev" href="libgnomeui-gnome-dialog-util.html" title="gnome-dialog-util">
38
38
<th width="100%" align="center">GNOME UI Library Reference Manual</th>
39
39
<td><a accesskey="n" href="GnomeFileEntry.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
40
40
</tr>
41
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2946239" class="shortcut">Top</a>
42
 
                  &#160;|&#160;
43
 
                  <a href="#id2946708" class="shortcut">Description</a>
44
 
                  &#160;|&#160;
45
 
                  <a href="#id2946516" class="shortcut">Object Hierarchy</a>
46
 
                  &#160;|&#160;
47
 
                  <a href="#id2946594" class="shortcut">Implemented Interfaces</a>
48
 
                  &#160;|&#160;
49
 
                  <a href="#id2946631" class="shortcut">Properties</a>
50
 
                  &#160;|&#160;
51
 
                  <a href="#id2946681" class="shortcut">Signals</a></nobr></td></tr>
 
41
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2727780" class="shortcut">Top</a>
 
42
                  &#160;|&#160;
 
43
                  <a href="#id2728249" class="shortcut">Description</a>
 
44
                  &#160;|&#160;
 
45
                  <a href="#id2728057" class="shortcut">Object Hierarchy</a>
 
46
                  &#160;|&#160;
 
47
                  <a href="#id2728135" class="shortcut">Implemented Interfaces</a>
 
48
                  &#160;|&#160;
 
49
                  <a href="#id2728172" class="shortcut">Properties</a>
 
50
                  &#160;|&#160;
 
51
                  <a href="#id2728222" class="shortcut">Signals</a></nobr></td></tr>
52
52
</table>
53
53
<div class="refentry" lang="en">
54
54
<a name="GnomeEntry"></a><div class="titlepage"></div>
55
55
<div class="refnamediv"><table width="100%"><tr>
56
56
<td valign="top">
57
57
<h2>
58
 
<a name="id2946239"></a><span class="refentrytitle">GnomeEntry</span>
 
58
<a name="id2727780"></a><span class="refentrytitle">GnomeEntry</span>
59
59
</h2>
60
60
<p>GnomeEntry</p>
61
61
</td>
68
68
#include &lt;libgnomeui/libgnomeui.h&gt;
69
69
 
70
70
 
71
 
                    <a class="link" href="GnomeEntry.html#GnomeEntryPrivate">GnomeEntryPrivate</a>;
72
 
                    <a class="link" href="GnomeEntry.html#GnomeEntry-struct">GnomeEntry</a>;
73
 
<a
74
 
href="../gtk/GtkWidget.html"
75
 
>GtkWidget</a>*          <a class="link" href="GnomeEntry.html#gnome-entry-new">gnome_entry_new</a>                     (const <a
76
 
href="../glib/glib-Basic-Types.html#gchar"
77
 
>gchar</a> *history_id);
78
 
<a
79
 
href="../gtk/GtkWidget.html"
80
 
>GtkWidget</a>*          <a class="link" href="GnomeEntry.html#gnome-entry-gtk-entry">gnome_entry_gtk_entry</a>               (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);
81
 
const <a
82
 
href="../glib/glib-Basic-Types.html#gchar"
83
 
>gchar</a>*        <a class="link" href="GnomeEntry.html#gnome-entry-get-history-id">gnome_entry_get_history_id</a>          (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);
84
 
void                <a class="link" href="GnomeEntry.html#gnome-entry-set-history-id">gnome_entry_set_history_id</a>          (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
85
 
                                                         const <a
86
 
href="../glib/glib-Basic-Types.html#gchar"
87
 
>gchar</a> *history_id);
88
 
void                <a class="link" href="GnomeEntry.html#gnome-entry-set-max-saved">gnome_entry_set_max_saved</a>           (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
89
 
                                                         <a
90
 
href="../glib/glib-Basic-Types.html#guint"
91
 
>guint</a> max_saved);
92
 
<a
93
 
href="../glib/glib-Basic-Types.html#guint"
94
 
>guint</a>               <a class="link" href="GnomeEntry.html#gnome-entry-get-max-saved">gnome_entry_get_max_saved</a>           (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);
95
 
void                <a class="link" href="GnomeEntry.html#gnome-entry-prepend-history">gnome_entry_prepend_history</a>         (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
96
 
                                                         <a
97
 
href="../glib/glib-Basic-Types.html#gboolean"
98
 
>gboolean</a> save,
99
 
                                                         const <a
100
 
href="../glib/glib-Basic-Types.html#gchar"
101
 
>gchar</a> *text);
102
 
void                <a class="link" href="GnomeEntry.html#gnome-entry-append-history">gnome_entry_append_history</a>          (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
103
 
                                                         <a
104
 
href="../glib/glib-Basic-Types.html#gboolean"
105
 
>gboolean</a> save,
106
 
                                                         const <a
107
 
href="../glib/glib-Basic-Types.html#gchar"
108
 
>gchar</a> *text);
109
 
void                <a class="link" href="GnomeEntry.html#gnome-entry-clear-history">gnome_entry_clear_history</a>           (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);
 
71
                    <a href="GnomeEntry.html#GnomeEntryPrivate">GnomeEntryPrivate</a>;
 
72
                    <a href="GnomeEntry.html#GnomeEntry-struct">GnomeEntry</a>;
 
73
GtkWidget*          <a href="GnomeEntry.html#gnome-entry-new">gnome_entry_new</a>                     (const gchar *history_id);
 
74
GtkWidget*          <a href="GnomeEntry.html#gnome-entry-gtk-entry">gnome_entry_gtk_entry</a>               (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);
 
75
const gchar*        <a href="GnomeEntry.html#gnome-entry-get-history-id">gnome_entry_get_history_id</a>          (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);
 
76
void                <a href="GnomeEntry.html#gnome-entry-set-history-id">gnome_entry_set_history_id</a>          (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
 
77
                                                         const gchar *history_id);
 
78
void                <a href="GnomeEntry.html#gnome-entry-set-max-saved">gnome_entry_set_max_saved</a>           (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
 
79
                                                         guint max_saved);
 
80
guint               <a href="GnomeEntry.html#gnome-entry-get-max-saved">gnome_entry_get_max_saved</a>           (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);
 
81
void                <a href="GnomeEntry.html#gnome-entry-prepend-history">gnome_entry_prepend_history</a>         (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
 
82
                                                         gboolean save,
 
83
                                                         const gchar *text);
 
84
void                <a href="GnomeEntry.html#gnome-entry-append-history">gnome_entry_append_history</a>          (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
 
85
                                                         gboolean save,
 
86
                                                         const gchar *text);
 
87
void                <a href="GnomeEntry.html#gnome-entry-clear-history">gnome_entry_clear_history</a>           (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);
110
88
 
111
89
</pre>
112
90
</div>
113
91
<div class="refsect1" lang="en">
114
 
<a name="id2946516"></a><h2>Object Hierarchy</h2>
 
92
<a name="id2728057"></a><h2>Object Hierarchy</h2>
115
93
<pre class="synopsis">
116
94
 
117
 
  <a
118
 
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
119
 
>GObject</a>
120
 
   +----<a
121
 
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
122
 
>GInitiallyUnowned</a>
123
 
         +----<a
124
 
href="../gtk/GtkObject.html"
125
 
>GtkObject</a>
126
 
               +----<a
127
 
href="../gtk/GtkWidget.html"
128
 
>GtkWidget</a>
129
 
                     +----<a
130
 
href="../gtk/GtkContainer.html"
131
 
>GtkContainer</a>
132
 
                           +----<a
133
 
href="../gtk/GtkBox.html"
134
 
>GtkBox</a>
135
 
                                 +----<a
136
 
href="../gtk/GtkHBox.html"
137
 
>GtkHBox</a>
138
 
                                       +----<a
139
 
href="../gtk/GtkCombo.html"
140
 
>GtkCombo</a>
 
95
  GObject
 
96
   +----GInitiallyUnowned
 
97
         +----GtkObject
 
98
               +----GtkWidget
 
99
                     +----GtkContainer
 
100
                           +----GtkBox
 
101
                                 +----GtkHBox
 
102
                                       +----GtkCombo
141
103
                                             +----GnomeEntry
142
104
</pre>
143
105
</div>
144
106
<div class="refsect1" lang="en">
145
 
<a name="id2946594"></a><h2>Implemented Interfaces</h2>
 
107
<a name="id2728135"></a><h2>Implemented Interfaces</h2>
146
108
<p>
147
109
GnomeEntry implements
148
 
 AtkImplementorIface,  <a
149
 
href="../gtk/gtk-gtkbuildable.html#GtkBuildable"
150
 
>GtkBuildable</a> and  <a
151
 
href="../gtk/GtkEditable.html"
152
 
>GtkEditable</a>.</p>
153
 
</div>
154
 
<div class="refsect1" lang="en">
155
 
<a name="id2946631"></a><h2>Properties</h2>
156
 
<pre class="synopsis">
157
 
 
158
 
  "<a class="link" href="GnomeEntry.html#GnomeEntry--gtk-entry">gtk-entry</a>"                <a
159
 
href="../gtk/GtkEntry.html"
160
 
>GtkEntry</a>              : Read
161
 
  "<a class="link" href="GnomeEntry.html#GnomeEntry--history-id">history-id</a>"               <a
162
 
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
163
 
>gchararray</a>            : Read / Write
164
 
</pre>
165
 
</div>
166
 
<div class="refsect1" lang="en">
167
 
<a name="id2946681"></a><h2>Signals</h2>
168
 
<pre class="synopsis">
169
 
 
170
 
  "<a class="link" href="GnomeEntry.html#GnomeEntry-activate">activate</a>"                                       : Run Last
171
 
</pre>
172
 
</div>
173
 
<div class="refsect1" lang="en">
174
 
<a name="id2946708"></a><h2>Description</h2>
 
110
 AtkImplementorIface,  GtkBuildable and  GtkEditable.</p>
 
111
</div>
 
112
<div class="refsect1" lang="en">
 
113
<a name="id2728172"></a><h2>Properties</h2>
 
114
<pre class="synopsis">
 
115
 
 
116
  "<a href="GnomeEntry.html#GnomeEntry--gtk-entry">gtk-entry</a>"                GtkEntry              : Read
 
117
  "<a href="GnomeEntry.html#GnomeEntry--history-id">history-id</a>"               gchararray            : Read / Write
 
118
</pre>
 
119
</div>
 
120
<div class="refsect1" lang="en">
 
121
<a name="id2728222"></a><h2>Signals</h2>
 
122
<pre class="synopsis">
 
123
 
 
124
  "<a href="GnomeEntry.html#GnomeEntry-activate">activate</a>"                                       : Run Last
 
125
</pre>
 
126
</div>
 
127
<div class="refsect1" lang="en">
 
128
<a name="id2728249"></a><h2>Description</h2>
175
129
<p>
176
130
 
177
131
</p>
178
132
</div>
179
133
<div class="refsect1" lang="en">
180
 
<a name="id2946722"></a><h2>Details</h2>
 
134
<a name="id2728263"></a><h2>Details</h2>
181
135
<div class="refsect2" lang="en">
182
 
<a name="id2946732"></a><h3>
 
136
<a name="id2728273"></a><h3>
183
137
<a name="GnomeEntryPrivate"></a>GnomeEntryPrivate</h3>
184
 
<a class="indexterm" name="id2946748"></a><pre class="programlisting">typedef struct _GnomeEntryPrivate GnomeEntryPrivate;</pre>
 
138
<a class="indexterm" name="id2728288"></a><pre class="programlisting">typedef struct _GnomeEntryPrivate GnomeEntryPrivate;</pre>
185
139
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
186
140
<h3 class="title">Warning</h3>
187
141
<p><code class="literal">GnomeEntryPrivate</code> is deprecated and should not be used in newly-written code.</p>
192
146
</div>
193
147
<hr>
194
148
<div class="refsect2" lang="en">
195
 
<a name="id2946776"></a><h3>
 
149
<a name="id2728317"></a><h3>
196
150
<a name="GnomeEntry-struct"></a>GnomeEntry</h3>
197
 
<a class="indexterm" name="id2946789"></a><pre class="programlisting">typedef struct _GnomeEntry GnomeEntry;</pre>
 
151
<a class="indexterm" name="id2728330"></a><pre class="programlisting">typedef struct _GnomeEntry GnomeEntry;</pre>
198
152
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
199
153
<h3 class="title">Warning</h3>
200
154
<p><code class="literal">GnomeEntry</code> is deprecated and should not be used in newly-written code.</p>
205
159
</div>
206
160
<hr>
207
161
<div class="refsect2" lang="en">
208
 
<a name="id2946816"></a><h3>
 
162
<a name="id2728357"></a><h3>
209
163
<a name="gnome-entry-new"></a>gnome_entry_new ()</h3>
210
 
<a class="indexterm" name="id2946832"></a><pre class="programlisting"><a
211
 
href="../gtk/GtkWidget.html"
212
 
>GtkWidget</a>*          gnome_entry_new                     (const <a
213
 
href="../glib/glib-Basic-Types.html#gchar"
214
 
>gchar</a> *history_id);</pre>
 
164
<a class="indexterm" name="id2728372"></a><pre class="programlisting">GtkWidget*          gnome_entry_new                     (const gchar *history_id);</pre>
215
165
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
216
166
<h3 class="title">Warning</h3>
217
167
<p><code class="literal">gnome_entry_new</code> is deprecated and should not be used in newly-written code.</p>
219
169
<p>
220
170
Creates a new GnomeEntry widget.  If  <em class="parameter"><code>history_id</code></em> is
221
171
not <a
222
 
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
 
172
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
223
173
><code class="literal">NULL</code></a>, then the history list will be saved and restored between
224
174
uses under the given id.</p>
225
175
<p>
229
179
<col align="left" valign="top">
230
180
<tbody>
231
181
<tr>
232
 
<td><p><span class="term"><em class="parameter"><code>history_id</code></em>&#160;:</span></p></td>
 
182
<td><span class="term"><em class="parameter"><code>history_id</code></em>&#160;:</span></td>
233
183
<td> If not <a
234
 
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
 
184
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
235
185
><code class="literal">NULL</code></a>, the text id under which history data is stored
236
186
</td>
237
187
</tr>
238
188
<tr>
239
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
189
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
240
190
<td> Newly-created GnomeEntry widget.
241
191
</td>
242
192
</tr>
245
195
</div>
246
196
<hr>
247
197
<div class="refsect2" lang="en">
248
 
<a name="id2946934"></a><h3>
 
198
<a name="id2728475"></a><h3>
249
199
<a name="gnome-entry-gtk-entry"></a>gnome_entry_gtk_entry ()</h3>
250
 
<a class="indexterm" name="id2946949"></a><pre class="programlisting"><a
251
 
href="../gtk/GtkWidget.html"
252
 
>GtkWidget</a>*          gnome_entry_gtk_entry               (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);</pre>
 
200
<a class="indexterm" name="id2728490"></a><pre class="programlisting">GtkWidget*          gnome_entry_gtk_entry               (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);</pre>
253
201
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
254
202
<h3 class="title">Warning</h3>
255
203
<p><code class="literal">gnome_entry_gtk_entry</code> is deprecated and should not be used in newly-written code.</p>
263
211
<col align="left" valign="top">
264
212
<tbody>
265
213
<tr>
266
 
<td><p><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></p></td>
 
214
<td><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></td>
267
215
<td> Pointer to GnomeEntry object.
268
216
</td>
269
217
</tr>
270
218
<tr>
271
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
219
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
272
220
<td> Pointer to GtkEntry widget.
273
221
</td>
274
222
</tr>
277
225
</div>
278
226
<hr>
279
227
<div class="refsect2" lang="en">
280
 
<a name="id2947024"></a><h3>
 
228
<a name="id2728565"></a><h3>
281
229
<a name="gnome-entry-get-history-id"></a>gnome_entry_get_history_id ()</h3>
282
 
<a class="indexterm" name="id2947040"></a><pre class="programlisting">const <a
283
 
href="../glib/glib-Basic-Types.html#gchar"
284
 
>gchar</a>*        gnome_entry_get_history_id          (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);</pre>
 
230
<a class="indexterm" name="id2728581"></a><pre class="programlisting">const gchar*        gnome_entry_get_history_id          (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);</pre>
285
231
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
286
232
<h3 class="title">Warning</h3>
287
233
<p><code class="literal">gnome_entry_get_history_id</code> is deprecated and should not be used in newly-written code.</p>
295
241
<col align="left" valign="top">
296
242
<tbody>
297
243
<tr>
298
 
<td><p><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></p></td>
 
244
<td><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></td>
299
245
<td> Pointer to GnomeEntry object.
300
246
</td>
301
247
</tr>
302
248
<tr>
303
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
249
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
304
250
<td> The current history id.
305
251
</td>
306
252
</tr>
309
255
</div>
310
256
<hr>
311
257
<div class="refsect2" lang="en">
312
 
<a name="id2947115"></a><h3>
 
258
<a name="id2728656"></a><h3>
313
259
<a name="gnome-entry-set-history-id"></a>gnome_entry_set_history_id ()</h3>
314
 
<a class="indexterm" name="id2947132"></a><pre class="programlisting">void                gnome_entry_set_history_id          (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
315
 
                                                         const <a
316
 
href="../glib/glib-Basic-Types.html#gchar"
317
 
>gchar</a> *history_id);</pre>
 
260
<a class="indexterm" name="id2728672"></a><pre class="programlisting">void                gnome_entry_set_history_id          (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
 
261
                                                         const gchar *history_id);</pre>
318
262
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
319
263
<h3 class="title">Warning</h3>
320
264
<p><code class="literal">gnome_entry_set_history_id</code> is deprecated and should not be used in newly-written code.</p>
329
273
<col align="left" valign="top">
330
274
<tbody>
331
275
<tr>
332
 
<td><p><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></p></td>
 
276
<td><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></td>
333
277
<td> Pointer to GnomeEntry object.
334
278
</td>
335
279
</tr>
336
280
<tr>
337
 
<td><p><span class="term"><em class="parameter"><code>history_id</code></em>&#160;:</span></p></td>
 
281
<td><span class="term"><em class="parameter"><code>history_id</code></em>&#160;:</span></td>
338
282
<td> the text id under which history data is stored
339
283
</td>
340
284
</tr>
343
287
</div>
344
288
<hr>
345
289
<div class="refsect2" lang="en">
346
 
<a name="id2947218"></a><h3>
 
290
<a name="id2728759"></a><h3>
347
291
<a name="gnome-entry-set-max-saved"></a>gnome_entry_set_max_saved ()</h3>
348
 
<a class="indexterm" name="id2947234"></a><pre class="programlisting">void                gnome_entry_set_max_saved           (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
349
 
                                                         <a
350
 
href="../glib/glib-Basic-Types.html#guint"
351
 
>guint</a> max_saved);</pre>
 
292
<a class="indexterm" name="id2728775"></a><pre class="programlisting">void                gnome_entry_set_max_saved           (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
 
293
                                                         guint max_saved);</pre>
352
294
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
353
295
<h3 class="title">Warning</h3>
354
296
<p><code class="literal">gnome_entry_set_max_saved</code> is deprecated and should not be used in newly-written code.</p>
358
300
to the config file.
359
301
Zero is an acceptable value for <em class="parameter"><code>max_saved</code></em>, but the same thing is
360
302
accomplished by setting the history id of <em class="parameter"><code>gentry</code></em> to <a
361
 
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
 
303
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
362
304
><code class="literal">NULL</code></a>.</p>
363
305
<p>
364
306
 
367
309
<col align="left" valign="top">
368
310
<tbody>
369
311
<tr>
370
 
<td><p><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></p></td>
 
312
<td><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></td>
371
313
<td> Pointer to GnomeEntry object.
372
314
</td>
373
315
</tr>
374
316
<tr>
375
 
<td><p><span class="term"><em class="parameter"><code>max_saved</code></em>&#160;:</span></p></td>
 
317
<td><span class="term"><em class="parameter"><code>max_saved</code></em>&#160;:</span></td>
376
318
<td> Maximum number of history items to save
377
319
</td>
378
320
</tr>
381
323
</div>
382
324
<hr>
383
325
<div class="refsect2" lang="en">
384
 
<a name="id2947344"></a><h3>
 
326
<a name="id2728885"></a><h3>
385
327
<a name="gnome-entry-get-max-saved"></a>gnome_entry_get_max_saved ()</h3>
386
 
<a class="indexterm" name="id2947360"></a><pre class="programlisting"><a
387
 
href="../glib/glib-Basic-Types.html#guint"
388
 
>guint</a>               gnome_entry_get_max_saved           (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);</pre>
 
328
<a class="indexterm" name="id2728901"></a><pre class="programlisting">guint               gnome_entry_get_max_saved           (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);</pre>
389
329
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
390
330
<h3 class="title">Warning</h3>
391
331
<p><code class="literal">gnome_entry_get_max_saved</code> is deprecated and should not be used in newly-written code.</p>
393
333
<p>
394
334
Get internal limit on number of history items saved
395
335
to the config file
396
 
See #<a class="link" href="GnomeEntry.html#gnome-entry-set-max-saved"><code class="function">gnome_entry_set_max_saved()</code></a>.</p>
 
336
See #<a href="GnomeEntry.html#gnome-entry-set-max-saved"><code class="function">gnome_entry_set_max_saved()</code></a>.</p>
397
337
<p>
398
338
 
399
339
</p>
401
341
<col align="left" valign="top">
402
342
<tbody>
403
343
<tr>
404
 
<td><p><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></p></td>
 
344
<td><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></td>
405
345
<td> Pointer to GnomeEntry object.
406
346
</td>
407
347
</tr>
408
348
<tr>
409
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
349
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
410
350
<td> An unsigned integer
411
351
</td>
412
352
</tr>
415
355
</div>
416
356
<hr>
417
357
<div class="refsect2" lang="en">
418
 
<a name="id2947445"></a><h3>
 
358
<a name="id2728986"></a><h3>
419
359
<a name="gnome-entry-prepend-history"></a>gnome_entry_prepend_history ()</h3>
420
 
<a class="indexterm" name="id2947461"></a><pre class="programlisting">void                gnome_entry_prepend_history         (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
421
 
                                                         <a
422
 
href="../glib/glib-Basic-Types.html#gboolean"
423
 
>gboolean</a> save,
424
 
                                                         const <a
425
 
href="../glib/glib-Basic-Types.html#gchar"
426
 
>gchar</a> *text);</pre>
 
360
<a class="indexterm" name="id2729002"></a><pre class="programlisting">void                gnome_entry_prepend_history         (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
 
361
                                                         gboolean save,
 
362
                                                         const gchar *text);</pre>
427
363
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
428
364
<h3 class="title">Warning</h3>
429
365
<p><code class="literal">gnome_entry_prepend_history</code> is deprecated and should not be used in newly-written code.</p>
430
366
</div>
431
367
<p>
432
368
Adds a history item of the given <em class="parameter"><code>text</code></em> to the head of
433
 
the history list inside <em class="parameter"><code>gentry</code></em>.  If <em class="parameter"><code>save</code></em> is <a
434
 
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
435
 
><code class="literal">TRUE</code></a>, the history
 
369
the history list inside <em class="parameter"><code>gentry</code></em>.  If <em class="parameter"><code>save</code></em> is <code class="literal">TRUE</code>, the history
436
370
item will be saved in the config file (assuming that <em class="parameter"><code>gentry</code></em>'s
437
371
history id is not <a
438
 
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
 
372
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
439
373
><code class="literal">NULL</code></a>).
440
374
Duplicates are automatically removed from the history list.
441
375
The history list is automatically saved if needed.</p>
446
380
<col align="left" valign="top">
447
381
<tbody>
448
382
<tr>
449
 
<td><p><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></p></td>
 
383
<td><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></td>
450
384
<td> Pointer to GnomeEntry object.
451
385
</td>
452
386
</tr>
453
387
<tr>
454
 
<td><p><span class="term"><em class="parameter"><code>save</code></em>&#160;:</span></p></td>
455
 
<td> If <a
456
 
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
457
 
><code class="literal">TRUE</code></a>, history entry will be saved to config file
 
388
<td><span class="term"><em class="parameter"><code>save</code></em>&#160;:</span></td>
 
389
<td> If <code class="literal">TRUE</code>, history entry will be saved to config file
458
390
</td>
459
391
</tr>
460
392
<tr>
461
 
<td><p><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></p></td>
 
393
<td><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
462
394
<td> Text to add
463
395
</td>
464
396
</tr>
467
399
</div>
468
400
<hr>
469
401
<div class="refsect2" lang="en">
470
 
<a name="id2947627"></a><h3>
 
402
<a name="id2729168"></a><h3>
471
403
<a name="gnome-entry-append-history"></a>gnome_entry_append_history ()</h3>
472
 
<a class="indexterm" name="id2947643"></a><pre class="programlisting">void                gnome_entry_append_history          (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
473
 
                                                         <a
474
 
href="../glib/glib-Basic-Types.html#gboolean"
475
 
>gboolean</a> save,
476
 
                                                         const <a
477
 
href="../glib/glib-Basic-Types.html#gchar"
478
 
>gchar</a> *text);</pre>
 
404
<a class="indexterm" name="id2729184"></a><pre class="programlisting">void                gnome_entry_append_history          (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
 
405
                                                         gboolean save,
 
406
                                                         const gchar *text);</pre>
479
407
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
480
408
<h3 class="title">Warning</h3>
481
409
<p><code class="literal">gnome_entry_append_history</code> is deprecated and should not be used in newly-written code.</p>
482
410
</div>
483
411
<p>
484
412
Adds a history item of the given <em class="parameter"><code>text</code></em> to the tail
485
 
of the history list inside <em class="parameter"><code>gentry</code></em>.  If <em class="parameter"><code>save</code></em> is <a
486
 
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
487
 
><code class="literal">TRUE</code></a>, the
 
413
of the history list inside <em class="parameter"><code>gentry</code></em>.  If <em class="parameter"><code>save</code></em> is <code class="literal">TRUE</code>, the
488
414
history item will be saved in the config file (assuming that
489
415
<em class="parameter"><code>gentry</code></em>'s history id is not <a
490
 
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
 
416
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
491
417
><code class="literal">NULL</code></a>).
492
418
Duplicates are automatically removed from the history list.
493
419
The history list is automatically saved if needed.</p>
498
424
<col align="left" valign="top">
499
425
<tbody>
500
426
<tr>
501
 
<td><p><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></p></td>
 
427
<td><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></td>
502
428
<td> Pointer to GnomeEntry object.
503
429
</td>
504
430
</tr>
505
431
<tr>
506
 
<td><p><span class="term"><em class="parameter"><code>save</code></em>&#160;:</span></p></td>
507
 
<td> If <a
508
 
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
509
 
><code class="literal">TRUE</code></a>, history entry will be saved to config file
 
432
<td><span class="term"><em class="parameter"><code>save</code></em>&#160;:</span></td>
 
433
<td> If <code class="literal">TRUE</code>, history entry will be saved to config file
510
434
</td>
511
435
</tr>
512
436
<tr>
513
 
<td><p><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></p></td>
 
437
<td><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
514
438
<td> Text to add
515
439
</td>
516
440
</tr>
519
443
</div>
520
444
<hr>
521
445
<div class="refsect2" lang="en">
522
 
<a name="id2947808"></a><h3>
 
446
<a name="id2729349"></a><h3>
523
447
<a name="gnome-entry-clear-history"></a>gnome_entry_clear_history ()</h3>
524
 
<a class="indexterm" name="id2947825"></a><pre class="programlisting">void                gnome_entry_clear_history           (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);</pre>
 
448
<a class="indexterm" name="id2729366"></a><pre class="programlisting">void                gnome_entry_clear_history           (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);</pre>
525
449
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
526
450
<h3 class="title">Warning</h3>
527
451
<p><code class="literal">gnome_entry_clear_history</code> is deprecated and should not be used in newly-written code.</p>
534
458
<div class="variablelist"><table border="0">
535
459
<col align="left" valign="top">
536
460
<tbody><tr>
537
 
<td><p><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></p></td>
 
461
<td><span class="term"><em class="parameter"><code>gentry</code></em>&#160;:</span></td>
538
462
<td> Pointer to GnomeEntry object.
539
463
</td>
540
464
</tr></tbody>
542
466
</div>
543
467
</div>
544
468
<div class="refsect1" lang="en">
545
 
<a name="id2947888"></a><h2>Property Details</h2>
 
469
<a name="id2729429"></a><h2>Property Details</h2>
546
470
<div class="refsect2" lang="en">
547
 
<a name="id2947899"></a><h3>
548
 
<a name="GnomeEntry--gtk-entry"></a>The "<code class="literal">gtk-entry</code>" property</h3>
549
 
<a class="indexterm" name="id2947916"></a><pre class="programlisting">  "gtk-entry"                <a
550
 
href="../gtk/GtkEntry.html"
551
 
>GtkEntry</a>              : Read</pre>
 
471
<a name="id2729440"></a><h3>
 
472
<a name="GnomeEntry--gtk-entry"></a>The <code class="literal">"gtk-entry"</code> property</h3>
 
473
<a class="indexterm" name="id2729457"></a><pre class="programlisting">  "gtk-entry"                GtkEntry              : Read</pre>
552
474
<p>The GTK entry.</p>
553
475
</div>
554
476
<hr>
555
477
<div class="refsect2" lang="en">
556
 
<a name="id2947938"></a><h3>
557
 
<a name="GnomeEntry--history-id"></a>The "<code class="literal">history-id</code>" property</h3>
558
 
<a class="indexterm" name="id2947955"></a><pre class="programlisting">  "history-id"               <a
559
 
href="../gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
560
 
>gchararray</a>            : Read / Write</pre>
 
478
<a name="id2729479"></a><h3>
 
479
<a name="GnomeEntry--history-id"></a>The <code class="literal">"history-id"</code> property</h3>
 
480
<a class="indexterm" name="id2729496"></a><pre class="programlisting">  "history-id"               gchararray            : Read / Write</pre>
561
481
<p>History ID.</p>
562
482
<p>Default value: NULL</p>
563
483
</div>
564
484
</div>
565
485
<div class="refsect1" lang="en">
566
 
<a name="id2947982"></a><h2>Signal Details</h2>
 
486
<a name="id2729523"></a><h2>Signal Details</h2>
567
487
<div class="refsect2" lang="en">
568
 
<a name="id2947992"></a><h3>
569
 
<a name="GnomeEntry-activate"></a>The "activate" signal</h3>
570
 
<a class="indexterm" name="id2948003"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *entry,
571
 
                                                        <a
572
 
href="../glib/glib-Basic-Types.html#gpointer"
573
 
>gpointer</a>    user_data)      : Run Last</pre>
 
488
<a name="id2729533"></a><h3>
 
489
<a name="GnomeEntry-activate"></a>The <code class="literal">"activate"</code> signal</h3>
 
490
<a class="indexterm" name="id2729549"></a><pre class="programlisting">void                user_function                      (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *entry,
 
491
                                                        gpointer    user_data)      : Run Last</pre>
574
492
<p>
575
493
 
576
494
</p>
578
496
<col align="left" valign="top">
579
497
<tbody>
580
498
<tr>
581
 
<td><p><span class="term"><em class="parameter"><code>entry</code></em>&#160;:</span></p></td>
 
499
<td><span class="term"><em class="parameter"><code>entry</code></em>&#160;:</span></td>
582
500
<td>the object which received the signal.
583
501
 
584
502
</td>
585
503
</tr>
586
504
<tr>
587
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
 
505
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
588
506
<td>user data set when the signal handler was connected.</td>
589
507
</tr>
590
508
</tbody>