Mercurial > pidgin
annotate finch/libgnt/gntentry.h @ 21212:b65f1bff6412
Allow binding key-shortcuts to menuitems.
For example, to bind ctrl+m to the 'Options -> Send IM...' menu, you would add:
[buddylist::menu]
c-m = send-im
in ~/.gntrc
author | Sadrul Habib Chowdhury <imadil@gmail.com> |
---|---|
date | Wed, 03 Oct 2007 06:51:26 +0000 |
parents | fe77cc691f78 |
children | 1f59065c606a |
rev | line source |
---|---|
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
1 /** |
18303
5c6f019e48f8
Generate doxy-help files for libgnt. And make it actually work.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17928
diff
changeset
|
2 * @file gntentry.h Entry API |
5c6f019e48f8
Generate doxy-help files for libgnt. And make it actually work.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17928
diff
changeset
|
3 * @ingroup gnt |
5c6f019e48f8
Generate doxy-help files for libgnt. And make it actually work.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17928
diff
changeset
|
4 */ |
5c6f019e48f8
Generate doxy-help files for libgnt. And make it actually work.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17928
diff
changeset
|
5 /* |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
6 * GNT - The GLib Ncurses Toolkit |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
7 * |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
8 * GNT is the legal property of its developers, whose names are too numerous |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
9 * to list here. Please refer to the COPYRIGHT file distributed with this |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
10 * source distribution. |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
11 * |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
12 * This library is free software; you can redistribute it and/or modify |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
13 * it under the terms of the GNU General Public License as published by |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
14 * the Free Software Foundation; either version 2 of the License, or |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
15 * (at your option) any later version. |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
16 * |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
17 * This program is distributed in the hope that it will be useful, |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
20 * GNU General Public License for more details. |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
21 * |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
22 * You should have received a copy of the GNU General Public License |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
23 * along with this program; if not, write to the Free Software |
19681
44b4e8bd759b
The FSF changed its address a while ago; our files were out of date.
John Bailey <rekkanoryo@rekkanoryo.org>
parents:
18303
diff
changeset
|
24 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
25 */ |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
26 |
15817 | 27 #ifndef GNT_ENTRY_H |
28 #define GNT_ENTRY_H | |
29 | |
30 #include "gntwidget.h" | |
31 #include "gnt.h" | |
32 #include "gntcolors.h" | |
33 #include "gntkeys.h" | |
34 | |
35 #define GNT_TYPE_ENTRY (gnt_entry_get_gtype()) | |
36 #define GNT_ENTRY(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), GNT_TYPE_ENTRY, GntEntry)) | |
37 #define GNT_ENTRY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), GNT_TYPE_ENTRY, GntEntryClass)) | |
38 #define GNT_IS_ENTRY(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), GNT_TYPE_ENTRY)) | |
39 #define GNT_IS_ENTRY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), GNT_TYPE_ENTRY)) | |
40 #define GNT_ENTRY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), GNT_TYPE_ENTRY, GntEntryClass)) | |
41 | |
42 #define GNT_ENTRY_FLAGS(obj) (GNT_ENTRY(obj)->priv.flags) | |
43 #define GNT_ENTRY_SET_FLAGS(obj, flags) (GNT_ENTRY_FLAGS(obj) |= flags) | |
44 #define GNT_ENTRY_UNSET_FLAGS(obj, flags) (GNT_ENTRY_FLAGS(obj) &= ~(flags)) | |
45 | |
46 #define ENTRY_CHAR '_' /* The character to use to fill in the blank places */ | |
47 | |
15928
f00f2e283ffb
Some define changes. This helps in generating the python bindings.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
15817
diff
changeset
|
48 typedef struct _GntEntry GntEntry; |
f00f2e283ffb
Some define changes. This helps in generating the python bindings.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
15817
diff
changeset
|
49 typedef struct _GntEntryPriv GntEntryPriv; |
f00f2e283ffb
Some define changes. This helps in generating the python bindings.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
15817
diff
changeset
|
50 typedef struct _GntEntryClass GntEntryClass; |
15817 | 51 |
52 typedef enum | |
53 { | |
54 GNT_ENTRY_FLAG_ALPHA = 1 << 0, /* Only alpha */ | |
55 GNT_ENTRY_FLAG_INT = 1 << 1, /* Only integer */ | |
56 GNT_ENTRY_FLAG_NO_SPACE = 1 << 2, /* No blank space is allowed */ | |
57 GNT_ENTRY_FLAG_NO_PUNCT = 1 << 3, /* No punctuations */ | |
58 GNT_ENTRY_FLAG_MASK = 1 << 4, /* Mask the inputs */ | |
59 } GntEntryFlag; | |
60 | |
61 #define GNT_ENTRY_FLAG_ALL (GNT_ENTRY_FLAG_ALPHA | GNT_ENTRY_FLAG_INT) | |
62 | |
15928
f00f2e283ffb
Some define changes. This helps in generating the python bindings.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
15817
diff
changeset
|
63 struct _GntEntry |
15817 | 64 { |
65 GntWidget parent; | |
66 | |
67 GntEntryFlag flag; | |
68 | |
69 char *start; | |
70 char *end; | |
71 char *scroll; /* Current scrolling position */ | |
72 char *cursor; /* Cursor location */ | |
73 /* 0 <= cursor - scroll < widget-width */ | |
74 | |
75 size_t buffer; /* Size of the buffer */ | |
76 | |
77 int max; /* 0 means infinite */ | |
78 gboolean masked; | |
79 | |
80 GList *history; /* History of the strings. User can use this by pressing ctrl+up/down */ | |
81 int histlength; /* How long can the history be? */ | |
82 | |
83 GList *suggests; /* List of suggestions */ | |
84 gboolean word; /* Are the suggestions for only a word, or for the whole thing? */ | |
85 gboolean always; /* Should the list of suggestions show at all times, or only on tab-press? */ | |
86 GntWidget *ddown; /* The dropdown with the suggested list */ | |
87 }; | |
88 | |
15928
f00f2e283ffb
Some define changes. This helps in generating the python bindings.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
15817
diff
changeset
|
89 struct _GntEntryClass |
15817 | 90 { |
91 GntWidgetClass parent; | |
92 | |
93 void (*text_changed)(GntEntry *entry); | |
94 void (*gnt_reserved1)(void); | |
95 void (*gnt_reserved2)(void); | |
96 void (*gnt_reserved3)(void); | |
97 void (*gnt_reserved4)(void); | |
98 }; | |
99 | |
100 G_BEGIN_DECLS | |
101 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
102 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
103 * @return GType for GntEntry. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
104 */ |
15817 | 105 GType gnt_entry_get_gtype(void); |
106 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
107 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
108 * Create a new GntEntry. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
109 * |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
110 * @param text The text in the new entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
111 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
112 * @return The newly created entry box. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
113 */ |
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
114 GntWidget * gnt_entry_new(const char *text); |
15817 | 115 |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
116 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
117 * Set the maximum length of the text in the entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
118 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
119 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
120 * @param max The maximum length for text. A value of 0 means infinite length. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
121 */ |
15817 | 122 void gnt_entry_set_max(GntEntry *entry, int max); |
123 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
124 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
125 * Set the text in an entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
126 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
127 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
128 * @param text The text to set in the box. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
129 */ |
15817 | 130 void gnt_entry_set_text(GntEntry *entry, const char *text); |
131 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
132 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
133 * Set flags an entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
134 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
135 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
136 * @param flag The flags to set for the entry box. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
137 */ |
15817 | 138 void gnt_entry_set_flag(GntEntry *entry, GntEntryFlag flag); |
139 | |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
140 /** |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
141 * Get the text in an entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
142 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
143 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
144 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
145 * @return The current text in the entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
146 */ |
15817 | 147 const char *gnt_entry_get_text(GntEntry *entry); |
148 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
149 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
150 * Clear the text in the entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
151 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
152 * @param entry The entry box. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
153 */ |
15817 | 154 void gnt_entry_clear(GntEntry *entry); |
155 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
156 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
157 * Set whether the text in the entry box should be masked for display. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
158 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
159 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
160 * @param set @c TRUE if the text should be masked, @c FALSE otherwise. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
161 */ |
15817 | 162 void gnt_entry_set_masked(GntEntry *entry, gboolean set); |
163 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
164 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
165 * Add a text to the history list for the text. The history length for the |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
166 * entry box needs to be set first by gnt_entry_set_history_length. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
167 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
168 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
169 * @param text A new entry for the history list. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
170 */ |
15817 | 171 void gnt_entry_add_to_history(GntEntry *entry, const char *text); |
172 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
173 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
174 * Set the length of history for the entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
175 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
176 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
177 * @param num The maximum length of the history. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
178 */ |
15817 | 179 void gnt_entry_set_history_length(GntEntry *entry, int num); |
180 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
181 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
182 * Set whether the suggestions are for the entire entry box, or for each |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
183 * individual word in the entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
184 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
185 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
186 * @param word @c TRUE if the suggestions are for individual words, @c FALSE otherwise. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
187 */ |
15817 | 188 void gnt_entry_set_word_suggest(GntEntry *entry, gboolean word); |
189 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
190 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
191 * Set whether to always display the suggestions list, or only when the |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
192 * tab-completion key is pressed (the TAB key, by default). |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
193 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
194 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
195 * @param always @c TRUE if the suggestion list should always be displayed. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
196 */ |
15817 | 197 void gnt_entry_set_always_suggest(GntEntry *entry, gboolean always); |
198 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
199 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
200 * Add an item to the suggestion list. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
201 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
202 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
203 * @param text An item to add to the suggestion list. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
204 */ |
15817 | 205 void gnt_entry_add_suggest(GntEntry *entry, const char *text); |
206 | |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
207 /** |
20751
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
208 * Remove an entry from the suggestion list. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
209 * |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
210 * @param entry The entry box. |
fe77cc691f78
Some doxygen stuff.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
19681
diff
changeset
|
211 * @param text The item to remove from the suggestion list. |
17928
8410511f4dbb
applied changes from 016401bd409e6229fae0ab1e80d9fef9365511b3
Eric Polino <aluink@pidgin.im>
parents:
15928
diff
changeset
|
212 */ |
15817 | 213 void gnt_entry_remove_suggest(GntEntry *entry, const char *text); |
214 | |
215 G_END_DECLS | |
216 | |
217 #endif /* GNT_ENTRY_H */ |