mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-12-26 21:51:08 +00:00
22a54ddf81
Mon Feb 1 19:25:54 1999 Owen Taylor <otaylor@redhat.com> * docs/gtk-config.txt (testinput_SOURCES): Put in some information about 'gtk-config --libs gthread'. * docs/Changes-1.2.txt: Updated section on threads.
248 lines
9.3 KiB
Plaintext
248 lines
9.3 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 currently still provided to ease
|
|
the migration phase.
|
|
|
|
* The GtkTypeInfo structures used in the gtk_*_type_init() functions have
|
|
changed a bit, the old format:
|
|
GtkTypeInfo bin_info =
|
|
{
|
|
"GtkBin",
|
|
sizeof (GtkBin),
|
|
sizeof (GtkBinClass),
|
|
(GtkClassInitFunc) gtk_bin_class_init,
|
|
(GtkObjectInitFunc) gtk_bin_init,
|
|
(GtkArgSetFunc) NULL,
|
|
(GtkArgGetFunc) NULL,
|
|
};
|
|
|
|
needs to be converted to:
|
|
|
|
static const GtkTypeInfo bin_info =
|
|
{
|
|
"GtkBin",
|
|
sizeof (GtkBin),
|
|
sizeof (GtkBinClass),
|
|
(GtkClassInitFunc) gtk_bin_class_init,
|
|
(GtkObjectInitFunc) gtk_bin_init,
|
|
/* reserved_1 */ NULL,
|
|
/* reserved_2 */ NULL,
|
|
(GtkClassInitFunc) NULL,
|
|
};
|
|
|
|
the GtkArgSetFunc and GtkArgGetFunc functions are not supported from the
|
|
type system anymore, and you should make sure that your code only fills
|
|
in these fields with NULL and doesn't use the deprecated function typedefs
|
|
(GtkArgSetFunc) and (GtkArgGetFunc) anymore.
|
|
|
|
* A number of Gtk functions were renamed. For compatibility, gtkcompat.h
|
|
#define's the old 1.0.x function names in terms of the new names.
|
|
To assure your Gtk program doesn't rely on outdated function
|
|
variants, compile your program with -DGTK_DISABLE_COMPAT_H to disable
|
|
the compatibility aliases.
|
|
|
|
Here is the list of the old names and replacements:
|
|
|
|
Old: Replacement:
|
|
|
|
gtk_accel_label_accelerator_width gtk_accel_label_get_accel_width
|
|
gtk_check_menu_item_set_state gtk_check_menu_item_set_active
|
|
gtk_container_border_width gtk_container_set_border_width
|
|
gtk_label_set gtk_label_set_text
|
|
gtk_notebook_current_page gtk_notebook_get_current_page
|
|
gtk_packer_configure gtk_packer_set_child_packing
|
|
gtk_paned_gutter_size gtk_paned_set_gutter_size
|
|
gtk_paned_handle_size gtk_paned_set_handle_size
|
|
gtk_scale_value_width gtk_scale_get_value_width
|
|
gtk_style_apply_default_pixmap gtk_style_apply_default_background (1)
|
|
gtk_toggle_button_set_state gtk_toggle_button_set_active
|
|
gtk_window_position gtk_window_set_position
|
|
|
|
(1) gtk_style_apply_default_background() has an additional
|
|
argument, gboolean set_bg. This parameter should be FALSE if
|
|
the background is being set for a NO_WINDOW widget, otherwise
|
|
true.
|
|
|
|
* During the development phase of the 1.1.x line of Gtk certain functions
|
|
were deprecated and later removed. Functions affected are:
|
|
|
|
Removed: Replacement:
|
|
gtk_clist_set_border gtk_clist_set_shadow_type
|
|
gtk_container_block_resize gtk_container_set_resize_mode
|
|
gtk_container_unblock_resize gtk_container_set_resize_mode
|
|
gtk_container_need_resize gtk_container_check_resize
|
|
gtk_ctree_show_stub gtk_ctree_set_show_stub
|
|
gtk_ctree_set_reorderable gtk_clist_set_reorderable
|
|
gtk_ctree_set_use_drag_icons gtk_clist_set_use_drag_icons
|
|
gtk_entry_adjust_scroll (1)
|
|
gtk_object_class_add_user_signal gtk_object_class_user_signal_new
|
|
gtk_preview_put_row gtk_preview_put
|
|
gtk_progress_bar_construct gtk_progress_set_adjustment
|
|
gtk_scrolled_window_construct gtk_scrolled_window_set_{h|v}adjustment
|
|
gtk_spin_button_construct gtk_spin_button_configure
|
|
gtk_widget_thaw_accelerators gtk_widget_unlock_accelerators
|
|
gtk_widget_freeze_accelerators gtk_widget_lock_accelerators
|
|
|
|
(1) This function is no longer needed as GtkEntry should automatically
|
|
keep the scroll adjusted properly.
|
|
|
|
* Additionally, all gtk_*_interp functions were removed.
|
|
gtk_*_full versions were provided as of GTK+-1.0 and should
|
|
be used instead.
|
|
|
|
* 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 "main loop" of GTK+ has been moved to GLib. This should not
|
|
affect existing programs, since compatibility functions have
|
|
been provided. However, you may want to consider migrating
|
|
your code to use the GLib main loop directly.
|
|
|
|
* the GTK_BASIC flag was removed, and with it the corresponding
|
|
macro and function GTK_WIDGET_BASIC() and gtk_widget_basic().
|
|
|
|
* All freeze/thaw methods are now recursive - that is, if you
|
|
freeze a widget n times, you must also thaw it n times.
|
|
|
|
Therefore, if you have code like:
|
|
|
|
gboolean frozen;
|
|
frozen = GTK_CLIST_FROZEN (clist);
|
|
gtk_clist_freeze (clist);
|
|
[...]
|
|
if (!frozen)
|
|
gtk_clist_thaw (clist);
|
|
|
|
it will not work anymore. It must be, simply:
|
|
|
|
gtk_clist_freeze (clist);
|
|
[...]
|
|
gtk_clist_thaw (clist);
|
|
|
|
* The thread safety in GTK+ 1.2 is slightly different than
|
|
that which appeared in early versions in the 1.1
|
|
development track. The main difference is that it relies on
|
|
the thread primitives in GLib, and on the thread-safe
|
|
GLib main loop.
|
|
|
|
This means:
|
|
|
|
- You must call g_thread_init() before executing any
|
|
other GTK+ or GDK functions in a threaded GTK+ program.
|
|
|
|
- Idles, timeouts, and input functions are executed outside
|
|
of the main GTK+ lock. So, if you need to call GTK+
|
|
inside of such a callback, you must surround the callback
|
|
with a gdk_threads_enter()/gdk_threads_leave() pair.
|
|
|
|
[ However, signals are still executed within the main
|
|
GTK+ lock ]
|
|
|
|
In particular, this means, if you are writing widgets
|
|
that might be used in threaded programs, you _must_
|
|
surround timeouts and idle functions in this matter.
|
|
|
|
As always, you must also surround any calls to GTK+
|
|
not made within a signal handler with a
|
|
gdk_threads_enter()/gdk_threads_leave() pair.
|
|
|
|
- There is no longer a special --with-threads configure
|
|
option for GTK+. To use threads in a GTK+ program, you
|
|
must:
|
|
|
|
a) If you want to use the native thread implementation,
|
|
make sure GLib found this in configuration, otherwise,
|
|
call you must provide a thread implementation to
|
|
g_thread_init().
|
|
|
|
b) Link with the libraries returned by:
|
|
|
|
gtk-config --libs gthread
|
|
|
|
and use the cflags from:
|
|
|
|
gtk-config --cflags gthread
|
|
|
|
You can get these CFLAGS and LIBS by passing gthread
|
|
as the fourth parameter to the AM_PATH_GTK automake
|
|
macro.
|