[gtkmm] ComboBox: Slight documentation improvements.



commit 6f500a8525898dff6d9001457d12b6b715c2147e
Author: Murray Cumming <murrayc murrayc com>
Date:   Tue Feb 8 09:41:33 2011 +0100

    ComboBox: Slight documentation improvements.
    
    * gtk/src/combobox.hg:
    * gtk/src/comboboxtext.hg: Update the class overview documentation to match
    recent additions in the C documentation and to reflect that we now have
    get_entry() in gtkmm (though still not in the C API).

 ChangeLog               |    9 +++++++++
 gtk/src/combobox.hg     |    3 ++-
 gtk/src/comboboxtext.hg |    3 +++
 3 files changed, 14 insertions(+), 1 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index ba710c4..eaa93d7 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2011-02-08  Murray Cumming  <murrayc murrayc com>
+
+	ComboBox: Slight documentation improvements.
+
+	* gtk/src/combobox.hg:
+	* gtk/src/comboboxtext.hg: Update the class overview documentation to match 
+	recent additions in the C documentation and to reflect that we now have 
+	get_entry() in gtkmm (though still not in the C API).
+
 2011-02-02  Murray Cumming  <murrayc murrayc com>
 
 	DragContext: Remove the deprecated constructor and create() method.
diff --git a/gtk/src/combobox.hg b/gtk/src/combobox.hg
index ddce91d..fb34ba4 100644
--- a/gtk/src/combobox.hg
+++ b/gtk/src/combobox.hg
@@ -49,7 +49,8 @@ namespace Gtk
  *
  * To allow the user to enter values not in the model, the 'has-entry'
  * property allows the ComboBox to contain a Gtk::Entry. This entry
- * can be accessed by calling Gtk::Bin::get_child() on the combo box.
+ * can be accessed by calling get_entry(), or you can just call get_entry_text() 
+ * to get the text from the Entry.
  *
  * For a simple list of textual choices, the model-view API of ComboBox
  * can be a bit overwhelming. In this case, ComboBoxText offers a
diff --git a/gtk/src/comboboxtext.hg b/gtk/src/comboboxtext.hg
index 3a381b0..ba4ffd8 100644
--- a/gtk/src/comboboxtext.hg
+++ b/gtk/src/comboboxtext.hg
@@ -29,6 +29,9 @@ namespace Gtk
 /** This is a simple variant of ComboBox that hides the model-view complexity for simple text-only use cases.
  * You can add items to a ComboBoxText with append(), insert() or prepend() and remove items with remove_text().
  *
+ * If the ComboBoxText contains an entry (via the 'has_entry' property), its contents can be retrieved using 
+ * get_active_text(). The entry itself can be accessed by calling ComboBox::get_entry() or ComboBox::get_entry_text(). 
+ *
  * @ingroup Widgets
  */
 class ComboBoxText



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]