summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDieter Verfaillie <dieterv@optionexplicit.be>2011-03-16 15:32:15 +0100
committerDieter Verfaillie <dieterv@optionexplicit.be>2011-03-18 20:21:39 +0100
commit12206c5a8f944b72f5bf306d72eb22122dc29f1c (patch)
tree4eaf422f62514f65f7e8b1b456b86adfc3a44f92
parent220fd37716fc2479a5a52c23a02772ab70d6c93f (diff)
downloadpygtk-12206c5a8f944b72f5bf306d72eb22122dc29f1c.tar.gz
reference: pygtk-gtkentrycompletion.xml: explain how to override default "match-selected" behaviour (bug 593386)
-rw-r--r--docs/reference/pygtk-gtkentrycompletion.xml6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/reference/pygtk-gtkentrycompletion.xml b/docs/reference/pygtk-gtkentrycompletion.xml
index dc08fb2f..bf69b6b5 100644
--- a/docs/reference/pygtk-gtkentrycompletion.xml
+++ b/docs/reference/pygtk-gtkentrycompletion.xml
@@ -328,6 +328,12 @@
them clearly from completion strings. When an action is selected, the
"action-activated" signal is emitted.</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
+ <literal>True</literal> from the signal handler to suppress the default behaviour.</para>
+
<para>A <link
linkend="class-gtktreemodel"><classname>gtk.TreeModel</classname></link>
(e.g. a <link