callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add some docs.

Browse Source
This commit is contained in:
Matthias Clasen
2004-03-15 01:32:20 +00:00
parent 8312109e1a
commit f2e252a2c2
8 changed files with 67 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
ChangeLog
View File

@ -1,3 +1,8 @@
Mon Mar 15 02:36:07 2004 Matthias Clasen <maclas@gmx.de>
* gtk/gtkentrycompletion.c (gtk_entry_completion_class_init): Add
some signal docs.
Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org> Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org>
* gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func): * gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func):

5
ChangeLog.pre-2-10
View File

@ -1,3 +1,8 @@
Mon Mar 15 02:36:07 2004 Matthias Clasen <maclas@gmx.de>
* gtk/gtkentrycompletion.c (gtk_entry_completion_class_init): Add
some signal docs.
Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org> Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org>
* gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func): * gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func):

5
ChangeLog.pre-2-4
View File

@ -1,3 +1,8 @@
Mon Mar 15 02:36:07 2004 Matthias Clasen <maclas@gmx.de>
* gtk/gtkentrycompletion.c (gtk_entry_completion_class_init): Add
some signal docs.
Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org> Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org>
* gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func): * gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func):

5
ChangeLog.pre-2-6
View File

@ -1,3 +1,8 @@
Mon Mar 15 02:36:07 2004 Matthias Clasen <maclas@gmx.de>
* gtk/gtkentrycompletion.c (gtk_entry_completion_class_init): Add
some signal docs.
Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org> Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org>
* gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func): * gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func):

5
ChangeLog.pre-2-8
View File

@ -1,3 +1,8 @@
Mon Mar 15 02:36:07 2004 Matthias Clasen <maclas@gmx.de>
* gtk/gtkentrycompletion.c (gtk_entry_completion_class_init): Add
some signal docs.
Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org> Sun Mar 14 15:38:39 2004 Jonathan Blandford <jrb@gnome.org>
* gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func): * gtk/gtkentrycompletion.c (gtk_entry_completion_visible_func):

4
docs/reference/ChangeLog
View File

@ -1,3 +1,7 @@
Mon Mar 15 02:36:32 2004 Matthias Clasen <maclas@gmx.de>
* gtk/tmpl/gtkentrycompletion.sgml: Add some docs.
Tue Mar 9 09:34:10 2004 Owen Taylor <otaylor@redhat.com> Tue Mar 9 09:34:10 2004 Owen Taylor <otaylor@redhat.com>
* === Released 2.3.6 === * === Released 2.3.6 ===

16
docs/reference/gtk/tmpl/gtkentrycompletion.sgml
View File

@ -12,6 +12,22 @@ completion functionality for GtkEntry
#GtkTreeView with completion matches. #GtkTreeView with completion matches.
</para> </para>
<para> <para>
"Completion functionality" means that when the user modifies the text
in the entry, #GtkEntryCompletion checks which rows in the model match
the current content of the entry, and displays a list of matches.
By default, the matching is done by comparing the entry text
case-insensitively against the text column of the model (see
gtk_entry_completion_set_text_column()), but this can be overridden with
a custom match function (see gtk_entry_completion_set_match_func()).
</para>
<para>
When the user selects a completion, the content of the entry is updated.
By default, the content of the entry is replaced by the text column of the
model, but this can be overridden by connecting to the ::match-selected signal
and updating the entry in the signal handler. Note that you should return
%TRUE from the signal handler to suppress the default behaviour.
</para>
<para>
To add completion functionality to an entry, use gtk_entry_set_completion(). To add completion functionality to an entry, use gtk_entry_set_completion().
</para> </para>
<para> <para>

22
gtk/gtkentrycompletion.c
View File

@ -174,6 +174,19 @@ gtk_entry_completion_class_init (GtkEntryCompletionClass *klass)
object_class->get_property = gtk_entry_completion_get_property; object_class->get_property = gtk_entry_completion_get_property;
object_class->finalize = gtk_entry_completion_finalize; object_class->finalize = gtk_entry_completion_finalize;
/**
* GtkEntryCompletion::match-selected:
* @widget: the object which received the signal
* @model: the #GtkTreeModel containing the matches
* @iter: a #GtkTreeIter positioned at the selected match
*
* The ::match-selected signal is emitted when a match from the list
* is selected. The default behaviour is to replace the contents of the
* entry with the contents of the text column in the row pointed to by
* @iter.
*
* Return value: %TRUE if the signal has been handled
*/
entry_completion_signals[MATCH_SELECTED] = entry_completion_signals[MATCH_SELECTED] =
g_signal_new ("match_selected", g_signal_new ("match_selected",
G_TYPE_FROM_CLASS (klass), G_TYPE_FROM_CLASS (klass),
@ -184,6 +197,15 @@ gtk_entry_completion_class_init (GtkEntryCompletionClass *klass)
G_TYPE_BOOLEAN, 2, G_TYPE_BOOLEAN, 2,
GTK_TYPE_TREE_MODEL, GTK_TYPE_TREE_MODEL,
GTK_TYPE_TREE_ITER); GTK_TYPE_TREE_ITER);
/**
* GtkEntryCompletion::action-activated:
* @widget: the object which received the signal
* @index: the index of the activated action
*
* The ::action-activated signal is emitted when an action
* is activated.
*/
entry_completion_signals[ACTION_ACTIVATED] = entry_completion_signals[ACTION_ACTIVATED] =
g_signal_new ("action_activated", g_signal_new ("action_activated",
G_TYPE_FROM_CLASS (klass), G_TYPE_FROM_CLASS (klass),