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>
41
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2946239" class="shortcut">Top</a>
43
<a href="#id2946708" class="shortcut">Description</a>
45
<a href="#id2946516" class="shortcut">Object Hierarchy</a>
47
<a href="#id2946594" class="shortcut">Implemented Interfaces</a>
49
<a href="#id2946631" class="shortcut">Properties</a>
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>
43
<a href="#id2728249" class="shortcut">Description</a>
45
<a href="#id2728057" class="shortcut">Object Hierarchy</a>
47
<a href="#id2728135" class="shortcut">Implemented Interfaces</a>
49
<a href="#id2728172" class="shortcut">Properties</a>
51
<a href="#id2728222" class="shortcut">Signals</a></nobr></td></tr>
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>
58
<a name="id2946239"></a><span class="refentrytitle">GnomeEntry</span>
58
<a name="id2727780"></a><span class="refentrytitle">GnomeEntry</span>
68
68
#include <libgnomeui/libgnomeui.h>
71
<a class="link" href="GnomeEntry.html#GnomeEntryPrivate">GnomeEntryPrivate</a>;
72
<a class="link" href="GnomeEntry.html#GnomeEntry-struct">GnomeEntry</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);
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);
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,
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,
90
href="../glib/glib-Basic-Types.html#guint"
91
>guint</a> max_saved);
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,
97
href="../glib/glib-Basic-Types.html#gboolean"
100
href="../glib/glib-Basic-Types.html#gchar"
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,
104
href="../glib/glib-Basic-Types.html#gboolean"
107
href="../glib/glib-Basic-Types.html#gchar"
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,
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,
84
void <a href="GnomeEntry.html#gnome-entry-append-history">gnome_entry_append_history</a> (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry,
87
void <a href="GnomeEntry.html#gnome-entry-clear-history">gnome_entry_clear_history</a> (<a href="GnomeEntry.html" title="GnomeEntry">GnomeEntry</a> *gentry);
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">
118
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
121
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
122
>GInitiallyUnowned</a>
124
href="../gtk/GtkObject.html"
127
href="../gtk/GtkWidget.html"
130
href="../gtk/GtkContainer.html"
133
href="../gtk/GtkBox.html"
136
href="../gtk/GtkHBox.html"
139
href="../gtk/GtkCombo.html"
96
+----GInitiallyUnowned
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>
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>
154
<div class="refsect1" lang="en">
155
<a name="id2946631"></a><h2>Properties</h2>
156
<pre class="synopsis">
158
"<a class="link" href="GnomeEntry.html#GnomeEntry--gtk-entry">gtk-entry</a>" <a
159
href="../gtk/GtkEntry.html"
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
166
<div class="refsect1" lang="en">
167
<a name="id2946681"></a><h2>Signals</h2>
168
<pre class="synopsis">
170
"<a class="link" href="GnomeEntry.html#GnomeEntry-activate">activate</a>" : Run Last
173
<div class="refsect1" lang="en">
174
<a name="id2946708"></a><h2>Description</h2>
110
AtkImplementorIface, GtkBuildable and GtkEditable.</p>
112
<div class="refsect1" lang="en">
113
<a name="id2728172"></a><h2>Properties</h2>
114
<pre class="synopsis">
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
120
<div class="refsect1" lang="en">
121
<a name="id2728222"></a><h2>Signals</h2>
122
<pre class="synopsis">
124
"<a href="GnomeEntry.html#GnomeEntry-activate">activate</a>" : Run Last
127
<div class="refsect1" lang="en">
128
<a name="id2728249"></a><h2>Description</h2>
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>
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,
422
href="../glib/glib-Basic-Types.html#gboolean"
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,
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>
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>
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,
474
href="../glib/glib-Basic-Types.html#gboolean"
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,
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>
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>
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>
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>
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,
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>