From 4db4335225b3dc6d0c4f255467658dbf1e1d30e3 Mon Sep 17 00:00:00 2001 From: Dieter Verfaillie Date: Sat, 12 Mar 2011 20:40:36 +0100 Subject: reference: pygtk-gtkadjustment.xml: add configure() method (bug #623033) --- docs/reference/pygtk-gtkadjustment.xml | 55 ++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) (limited to 'docs') diff --git a/docs/reference/pygtk-gtkadjustment.xml b/docs/reference/pygtk-gtkadjustment.xml index e0337459..9d6df43d 100644 --- a/docs/reference/pygtk-gtkadjustment.xml +++ b/docs/reference/pygtk-gtkadjustment.xml @@ -613,6 +613,61 @@ of the adjustment to the specified value. + + gtk.Adjustment.configure + + + configure + value + lower + upper + step_increment + page_increment + page_size + + + + value : + the new value. + + + lower : + the new minimum value. + + + upper : + the new maximum value. + + + step_increment : + the new step increment. + + + page_increment : + the new page increment. + + + page_size : + the new page size. + + + + + This method is available in PyGTK 2.14 and above. + + + The configure() method sets all properties of the adjustment at once. + + This method is an alternative to avoid multiple emissions of the "changed" signal. When setting multiple + adjustment properties via their individual setters, multiple "changed" signals will be emitted. However, since the + emission of the "changed" signal is tied to the emission of the "GObject::notify" signals of the changed properties, + it's possible to compress the "changed" signals into one by calling + gobject.Gobject.freeze_notify() and + gobject.Gobject.thaw_notify() + around the calls to the individual setters. + + + gtk.Adjustment.get_lower -- cgit v1.2.1