mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-10 02:40:11 +00:00
103 lines
3.8 KiB
Plaintext
103 lines
3.8 KiB
Plaintext
Incompatible Changes from GTK+-1.0 to GTK+-1.2:
|
|
|
|
* GtkAcceleratorTable has been replaced with GtkAccelGroup
|
|
|
|
* GtkMenuFactory has been replaced with GtkItemFactory, although
|
|
a version of GtkMenuFactory is provided to ease compatibility.
|
|
|
|
* GtkButton has been changed to derive from GtkBin.
|
|
|
|
To access a button's child, use GTK_BIN (button)->child, instead
|
|
of the old GTK_BUTTON (button)->child.
|
|
|
|
* The selection API has been slightly modified:
|
|
|
|
gtk_selection_add_handler() and gtk_selection_add_handler_full()
|
|
have been removed. To supply the selection, one now register
|
|
the targets one is interested in with:
|
|
|
|
void gtk_selection_add_target (GtkWidget *widget,
|
|
GdkAtom selection,
|
|
GdkAtom target,
|
|
guint info);
|
|
|
|
or:
|
|
|
|
void gtk_selection_add_targets (GtkWidget *widget,
|
|
GdkAtom selection,
|
|
GtkTargetEntry *targets,
|
|
guint ntargets);
|
|
|
|
When a request for a selection is received, the new "selection_get"
|
|
signal will be called:
|
|
|
|
void "selection_get" (GtkWidget *widget,
|
|
GtkSelectionData *selection_data,
|
|
guint info,
|
|
guint time);
|
|
|
|
A "time" parameter has also been added to the "selection_received"
|
|
signal.
|
|
|
|
void "selection_received" (GtkWidget *widget,
|
|
GtkSelectionData *selection_data,
|
|
guint time);
|
|
|
|
* The old drag and drop API has been completely removed and replaced.
|
|
See the reference documentation for details on the new API.
|
|
|
|
* Support for Themes has been added. In general, this does
|
|
not affect application code, however, a few new rules should
|
|
be observed:
|
|
|
|
- To set a shape for a window, you must use
|
|
gtk_widget_shape_combine_mask() instead of
|
|
gdk_window_shape_combine_mask(), or the shape will be
|
|
reset when switching themes.
|
|
|
|
- It is no longer permissable to draw directly on an arbitrary
|
|
widget, or to set an arbitrary widget's background pixmap.
|
|
If you need to do that, use a GtkDrawingArea or (for a
|
|
toplevel) the new GtkDrawWindow widget.
|
|
|
|
* 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).
|
|
|
|
* the GTK_BASIC flag got removed, and with it the corresponding
|
|
macro and function GTK_WIDGET_BASIC() and gtk_widget_basic().
|
|
|
|
* all freeze/thaw methods in gtk work in an incremental way now.
|
|
code portions like:
|
|
gboolean frozen;
|
|
frozen = GTK_CLIST_FROZEN (clist);
|
|
gtk_clist_freeze (clist);
|
|
[...]
|
|
if (!frozen)
|
|
gtk_clist_thaw (clist);
|
|
will not work anymore, they have to be modified to simply:
|
|
gtk_clist_freeze (clist);
|
|
[...]
|
|
gtk_clist_thaw (clist);
|