widget set_scroll_adjustments docs

View: New views
2 Messages — Rating Filter:   Alert me  

widget set_scroll_adjustments docs

by Kevin Ryde :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

I saw the cute setups of the set-scroll-adjustments signal, but are they
being kept secret?  Perhaps a couple of words for the emitting funcs (or
cross references if already described elsewhere that I didn't see).


--- GtkWidget.xs 23 Jun 2008 09:14:24 +1000 1.73
+++ GtkWidget.xs 23 Jun 2008 11:09:18 +1000
@@ -638,10 +638,30 @@
  #gint       gtk_widget_send_expose         (GtkWidget           *widget,
  #   GdkEvent            *event);
 
+=for apidoc
+This function works by emitting an action signal nominated by the various
+widget subclasses.  The signal is normally called C<activate>, but it
+doesn't have to be.
+
+Currently if you make a widget subclass in Perl there's no way to
+nominate a signal to be emitted by C<< $widget->activate >>.  A signal
+merely named C<activate> is not automatically hooked up.
+=cut
 gboolean
 gtk_widget_activate (widget)
  GtkWidget * widget
 
+=for apidoc
+This function works by emitting a setter signal nominated by the
+various widget types which have "native" scrolling.  The signal is
+normally called C<set-scroll-adjustments>, but it doesn't have to be.
+
+If you make a widget subclass in Perl and create a signal in it called
+C<set-scroll-adjustments> taking two Gtk2::Adjustment parameters then
+the subclassing automatically hooks that up to be emitted by
+C<< $widget->set_scroll_adjustments >>.  (Your "class closure" default
+handler code should then store the adjustment objects somewhere.)
+=cut
 gboolean
 gtk_widget_set_scroll_adjustments (widget, hadjustment, vadjustment)
  GtkWidget     * widget

_______________________________________________
gtk-perl-list mailing list
gtk-perl-list@...
http://mail.gnome.org/mailman/listinfo/gtk-perl-list

Re: widget set_scroll_adjustments docs

by Torsten Schoenfeld :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Kevin Ryde wrote:
> I saw the cute setups of the set-scroll-adjustments signal, but are they
> being kept secret?  Perhaps a couple of words for the emitting funcs (or
> cross references if already described elsewhere that I didn't see).

Committed.  Thanks!

--
Bye,
-Torsten
_______________________________________________
gtk-perl-list mailing list
gtk-perl-list@...
http://mail.gnome.org/mailman/listinfo/gtk-perl-list
LightInTheBox - Buy quality products at wholesale price!