summaryrefslogtreecommitdiff
path: root/docs/Changes-1.2.txt
diff options
context:
space:
mode:
authorOwen Taylor <otaylor@redhat.com>1998-11-24 19:33:01 +0000
committerOwen Taylor <otaylor@src.gnome.org>1998-11-24 19:33:01 +0000
commita425e6b5c21e4cfebc6c9aa0b7c5cd277face8a6 (patch)
treed45ff060a570f445757fb038666ca62f8ebcc8cd /docs/Changes-1.2.txt
parent1bb0d4c0f32d8cda26207a7c2048d647211f3340 (diff)
downloadgtk+-a425e6b5c21e4cfebc6c9aa0b7c5cd277face8a6.tar.gz
Edited section on the ScrolledWindow.
Tue Nov 24 11:31:06 1998 Owen Taylor <otaylor@redhat.com> * docs/Changes-1.2.txt: Edited section on the ScrolledWindow. * gtk/gtklayout.c (gtk_layout_set_[hv]adjustment): Remove some code duplication. * gtk/gtklayout.[ch] Fixed mapping and unmapping of child windows and child widgets when scrolling greater than 32k pixels. * testgtk.c: Modified layout test to test scrolling over long distances. * gtk/gtkplug.c: Added a few blank lines.
Diffstat (limited to 'docs/Changes-1.2.txt')
-rw-r--r--docs/Changes-1.2.txt44
1 files changed, 24 insertions, 20 deletions
diff --git a/docs/Changes-1.2.txt b/docs/Changes-1.2.txt
index 301991f415..83312b3dcd 100644
--- a/docs/Changes-1.2.txt
+++ b/docs/Changes-1.2.txt
@@ -60,24 +60,28 @@ Incompatible Changes from GTK+-1.0 to GTK+-1.2:
If you need to do that, use a GtkDrawingArea or (for a
toplevel) the new GtkDrawWindow widget.
-* Scrolled windows do not create an automatic viewport anymore, and
- self scrolling widgets do not provide their own scrollbars any
- further. Self scrolling widgets of the Gtk+ core currently are
- GtkViewport, GtkCList, GtkCTree, GtkText and GtkLayout. All of
- these widgets can be added to a scrolled window as normal children
- with gtk_container_add() and their scrolling abilities will be setup
- appropriatedly in an automatic manner.
- Widgets that do not implement own scrolling abilities but get added
- to a scrolled window in order to have their allocations scrollable
- inside of the scrolled window (e.g. a GtkList) have first to be added
- to a GtkViewport, and then the viewport needs to be added to the
- scrolled window.
- However, the scrolled window code provides a convenience function to
- achive this:
- gtk_scrolled_window_add_with_viewport() which will do exactly what
- it says, add a child widget to a viewport and put that viewport into
- the scrolled window.
- Scrollbar policy adjustment needs to be perfomed on the scrolled window
- with gtk_scrolled_window_set_policy() and is not longer maintained for
- the child widgets (e.g. GtkCList's gtk_clist_set_policy() got removed).
+* The ScrolledWindow widget no longer creates a Viewport
+ automatically. Instead, it has been generalized to accept
+ any "self-scrolling" widget.
+
+ The self-scrolling widgets in the Gtk+ core are GtkViewport,
+ GtkCList, GtkCTree, GtkText, and GtkLayout. All of these widgets can
+ be added to a scrolled window as normal children with
+ gtk_container_add() and scrollbars will be set up automatically.
+
+ To add scrollbars to a non self-scrolling widget, (such as a GtkList),
+ first add it to a viewport, then add the viewport to a scrolled window.
+ The scrolled window code provides a convenience function to do this:
+
+ void gtk_scrolled_window_add_with_viewport (GtkScrolledWindow *scrollwin,
+ GtkWidget *child);
+
+ This does exactly what it says - it creates a Viewport, adds the child
+ widget to it, then adds the Viewport to the scrolled window.
+
+ The scrollbars have been removed from the GtkCList and GtkCTree,
+ because they are now scrolled by simply adding them to a Scrolled
+ Window. The scrollbar policy is set on the scrolled window with
+ gtk_scrolled_window_set_policy() and not on the child widgets
+ (e.g. GtkCList's gtk_clist_set_policy() was removed).