Commit adce3190 authored by Matthias Clasen's avatar Matthias Clasen

Apply a patch by Murray to improve comboboxentry docs

parent 8633322c
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
* gtk/gtkassistant.h: Correct the declaration of the prepare
......
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
* gtk/gtkassistant.h: Correct the declaration of the prepare
......
......@@ -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().
</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>
The convenience API to construct simple text-only #GtkComboBox<!-- -->es can
also be used with #GtkComboBoxEntry<!-- -->s which have been constructed
......
......@@ -534,10 +534,12 @@ gtk_combo_box_class_init (GtkComboBoxClass *klass)
* GtkComboBox::changed:
* @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
* a different item from the list, or due to a
* 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
*/
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment