AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-12 20:00:09 +00:00
Code Issues Projects Releases Wiki Activity

Apply a patch by Murray to improve comboboxentry docs

Browse Source
This commit is contained in:
Matthias Clasen 2006-02-10 18:53:35 +00:00
parent 8633322c0e
commit adce3190f1
4 changed files with 32 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
ChangeLog
View File

@ -1,3 +1,13 @@
2006-02-10 Murray Cumming <murrayc@murrayc.com>
* docs/reference/gtk/tmpl/gtkcomboboxentry.sgml: Mention that
the changed signal is emitted when typing - not just when
selecting from the list. Suggest use of GtkEntry::action to
detect end of typing.
* gtk/gtkcombobox.c: (gtk_combo_box_class_init): changed signal
documentation: Mention that the GtkComboBoxEntry emits it when
the users types, not just when he selects from the list.
2006-02-10 Murray Cumming <murrayc@murrayc.com 2006-02-10 Murray Cumming <murrayc@murrayc.com
* gtk/gtkassistant.h: Correct the declaration of the prepare * gtk/gtkassistant.h: Correct the declaration of the prepare

10
ChangeLog.pre-2-10
View File

@ -1,3 +1,13 @@
2006-02-10 Murray Cumming <murrayc@murrayc.com>
* docs/reference/gtk/tmpl/gtkcomboboxentry.sgml: Mention that
the changed signal is emitted when typing - not just when
selecting from the list. Suggest use of GtkEntry::action to
detect end of typing.
* gtk/gtkcombobox.c: (gtk_combo_box_class_init): changed signal
documentation: Mention that the GtkComboBoxEntry emits it when
the users types, not just when he selects from the list.
2006-02-10 Murray Cumming <murrayc@murrayc.com 2006-02-10 Murray Cumming <murrayc@murrayc.com
* gtk/gtkassistant.h: Correct the declaration of the prepare * gtk/gtkassistant.h: Correct the declaration of the prepare

9
docs/reference/gtk/tmpl/gtkcomboboxentry.sgml
View File

@ -19,6 +19,15 @@ and the entry will show the content of the text column in the selected row. To
get the text from the entry, use gtk_combo_box_get_active_text(). get the text from the entry, use gtk_combo_box_get_active_text().
</para> </para>
<para>The changed signal will be emitted while typing into a GtkComboBoxEntry,
as well as when selecting an item from the GtkComboBoxEntry's list. Use
gtk_combo_box_get_active() or gtk_combo_box_get_active_iter() to discover
whether an item was actually selected from the list.
</para>
<para>Connect to the activate signal of the GtkEntry (use gtk_bin_get_child()) to
detect when the user actually finishes entering text.</para>
<para> <para>
The convenience API to construct simple text-only #GtkComboBox<!-- -->es can The convenience API to construct simple text-only #GtkComboBox<!-- -->es can
also be used with #GtkComboBoxEntry<!-- -->s which have been constructed also be used with #GtkComboBoxEntry<!-- -->s which have been constructed

4
gtk/gtkcombobox.c
View File

@ -534,10 +534,12 @@ gtk_combo_box_class_init (GtkComboBoxClass *klass)
* GtkComboBox::changed: * GtkComboBox::changed:
* @widget: the object which received the signal * @widget: the object which received the signal
* *
* The changed signal gets emitted when the active * The changed signal is emitted when the active
* item is changed. The can be due to the user selecting * item is changed. The can be due to the user selecting
* a different item from the list, or due to a * a different item from the list, or due to a
* call to gtk_combo_box_set_active_iter(). * call to gtk_combo_box_set_active_iter().
* It will also be emitted while typing into a GtkComboBoxEntry,
* as well as when selecting an item from the GtkComboBoxEntry's list.
* *
* Since: 2.4 * Since: 2.4
*/ */