Part IV. Migrating from Previous Versions of GTK+

This part describes what you need to change in programs use older versions of GTK+ so that they can use the new features. It also mentions how to convert applications using widgets found in the libgnomeui library to use their counterparts in GTK+.

Table of Contents

Migration Checklist

Implement GtkWidget::popup_menu
Use GdkEventExpose.region
Test for modifier keys correctly
Use named icons

Changes from 1.0 to 1.2 — Incompatible changes made between version 1.0 and version 1.2

Changes from 1.2 to 2.0 — Incompatible changes made between version 1.2 and version 2.0

Migrating from GtkFileSelection to GtkFileChooser

Creating a GtkFileChooserDialog
Selection Modes
Installing a Preview widget
Installing Extra Widgets
New features

Migrating from old menu and toolbar systems to GtkAction

Actions and Action Groups
User Interface Manager Object
Migrating from GnomeUIInfo

Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry

Migrating from GtkOptionMenu to GtkComboBox
Migrating from GtkCombo to GtkComboBoxEntry
New features

Migrating from GnomeIconList to GtkIconView

Migrating from GnomeAbout to GtkAboutDialog

Migrating from GnomeColorPicker to GtkColorButton

Migrating from GnomeDruid to GtkAssistant

Inserting pages
Decorating the assistant pages
Setting the page flow

Migrating from EggRecent to GtkRecentChooser

Managing the Recently Used Documents
Displaying the Recently Used Documents
Advanced usage

Migrating from GnomeHRef to GtkLinkButton

Migrating from libglade to GtkBuilder

Migrating from GtkTooltips to GtkTooltip