From 94760e50f27f2639e7a4fd027a7c049ff0fc4dec Mon Sep 17 00:00:00 2001 From: John Finlay Date: Wed, 6 Jul 2005 08:12:28 +0000 Subject: Add description of the "notify" signal. * pygtk-gobject.xml (Signals): Add description of the "notify" signal. --- docs/reference/pygtk-gobject.xml | 98 +++++++++++++++++++++++++++++++++++----- 1 file changed, 86 insertions(+), 12 deletions(-) (limited to 'docs/reference/pygtk-gobject.xml') diff --git a/docs/reference/pygtk-gobject.xml b/docs/reference/pygtk-gobject.xml index 76b82dea..81947606 100644 --- a/docs/reference/pygtk-gobject.xml +++ b/docs/reference/pygtk-gobject.xml @@ -133,18 +133,6 @@ linkend="method-gobject--chain">chain - - Description - The GObject class is the base class providing the common -attributes and methods for the PyGTK classes. The GObject class is not a -user interface widget class. - - The GObject class provides the signal management methods, the -object property access methods and the object data management -methods. - - - Attributes @@ -187,6 +175,37 @@ methods. + + Signal Prototypes + + + + "notify" + + callback + gobject + property_spec + user_param1 + ... + + + + + + + + + Description + The GObject class is the base class providing the common +attributes and methods for the PyGTK classes. The GObject class is not a +user interface widget class. + + The GObject class provides the signal management methods, the +object property access methods and the object data management +methods. + + + Methods @@ -785,4 +804,59 @@ still to be run will not be invoked. + + Signals + + + The GObject "notify" Signal + + + callback + gobject + property_spec + user_param1 + ... + + + + + gobject : + the gobject that received the +signal + + + property_spec : + the gobject.GParamSpec of the property that was +changed + + + user_param1 : + the first user parameter (if any) specified +with the connect() +method + + + ... : + additional user parameters (if +any) + + + + The "notify" signal is emitted on a gobject when one of its +properties has been changed. Note that getting this signal doesn't guarantee +that the value of the property has actually changed, it may also be emitted +when the setter for the property is called to reinstate the previous +value. For example to be notified of the change of the title of a gtk.Window you could +connect to the "notify" signal similar to: + + + window.connect("notify::title", callback) + + + + + + -- cgit v1.2.1